聚水潭对接打通金蝶云星空退货退款查询接口与[聚水潭][销售退货单标准新增]-v1接口源系统:聚水潭聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。接入系统：金蝶云星空金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。多系统对接方案配置集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：聚水潭，源系统 API：退货退款查询，目标系统：金蝶云星空，目标系统 API[聚水潭][销售退货单标准新增]-v1。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。聚水潭接口明细调用接口： /open/refund/single/query 接口名称：退货退款查询方法： POST 请求参数字段字段名称类型配置值 shop_id 店铺编号 string is_offline_shop shop_id为0且is_offline_shop为true查询线下店铺单据 string modified_begin 修改起始时间 string {{LAST_SYNC_TIME datetime}} modified_end 修改结束时间 string {{CURRENT_TIME datetime}} so_ids 线上订单号 string shop_buyer_ids 指定买家账号 string page_index 第几页，从第一页开始，默认1 string 1 page_size 每页多少条，默认30，最大50 string 50 响应参数字段字段名称类型配置值 as_id ERP售后单号 string as_date 申请时间 string outer_as_id 平台退货退款单号 string o_id 内部单号 string so_id 线上单号 string type 售后类型 string created 登记时间 string modified 修改时间 string status 状态 string shop_status 订单对应状态 string remark 备注 string question_type 问题类型 array warehouse 仓库 string refund 退款金额 string payment 补偿金额 string good_status 货物状态 string node 售后线下备注 string order_status 原订单状态 string shop_id 店铺编号 string logistics_company 物流公司 string l_id 物流单号 string wh_id 仓库编号 string wms_co_id 分仓编号 string confirm_date 最后确认日期 string freight 卖家应退运费 string drp_co_id_from 分销商编号 string receiver_mobile 收件人电话 string receiver_name 收件人名称 string shop_buyer_id 买家账号 string items 商品列表 array items.asi_id 售后子单号 string items.as_id ERP售后单号 string items.sku_id 商品编码 string items.qty 数量 string items.price 单价 string items.amount 金额 string items.name 商品名称 string items.pic 图片地址 string items.type 类型（退货，换货,补发） string items.properties_value 颜色规格 string items.outer_oi_id 子订单号 string items.sku_type 商品类型 string items.r_qty 实收退货数量 string items.i_id 款式编码 string items.batchs 批次集合 array items.batchs.batch_no 批次号 string items.batchs.sku_id 商品编码 string items.batchs.qty 商品数量 string items.batchs.product_date 批次日期 string items.batchs.supplier_id 供应商编号 string items.batchs.supplier_name 供应商名称 string 金蝶云星空接口明细调用接口： batchSave 接口名称： [聚水潭][销售退货单标准新增]-v1 方法： POST 请求参数字段字段名称类型配置值 FBillTypeID 单据类型 string XSTHD01_SYS FBillNo 单据编号 string {{as_id}} FSaleOrgId 销售组织 string {{shop_id}} FDate 日期 string {{created}} FStockOrgId 库存组织 string {{wms_co_id}} FRetcustId 退货客户 string {{shop_id}} FSettleCurrId 结算币别 string PRE001 FHeadNote 备注 string {{as_id}} FEntity 明细信息 array FEntity.FMaterialId 物料编码 string {{items.i_id}} FEntity.FRealQty 实退数量 string {{items.qty}} FEntity.FPrice 单价 string {{items.price}} FEntity.FTaxPrice 含税单价 string FEntity.FIsFree 是否赠品 string _function case '{{items_price}}' when '0' then true else false end FEntity.FEntryTaxRate 税率% string FEntity.FReturnType 退货类型 string THLX01_SYS FEntity.FOwnerTypeId 货主类型 string BD_OwnerOrg FEntity.FOwnerId 货主 string {{wms_co_id}} FEntity.FStockId 仓库 string {{wms_co_id}}{{wh_id}} FEntity.FNote 备注 string FEntity.SubHeadEntity 财务信息 object FEntity.SubHeadEntity.FSettleOrgId 结算组织 string {{shop_id}} FEntity.SubHeadEntity.FormId 业务对象表单Id string SAL_RETURNSTOCK FEntity.SubHeadEntity.Operation 执行的操作 string BatchSave FEntity.SubHeadEntity.IsAutoSubmitAndAudit 提交并审核 bool true FEntity.SubHeadEntity.IsVerifyBaseDataField 验证基础资料 bool false 系统对接概况从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通聚水潭到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。

聚水潭对接打通金蝶云星空退货退款查询接口与[聚水潭][销售退货单标准新增]-v1接口

小群青V

聚水潭对接打通金蝶云星空退货退款查询接口与[聚水潭][销售退货单标准新增]-v1接口

源系统:聚水潭

聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。

接入系统：金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

多系统对接方案配置

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：聚水潭，源系统 API：退货退款查询，目标系统：金蝶云星空，目标系统 API[聚水潭][销售退货单标准新增]-v1。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

聚水潭接口明细

调用接口：/open/refund/single/query
接口名称：退货退款查询
方法：POST

请求参数

字段	字段名称	类型	配置值
shop_id	店铺编号	string
is_offline_shop	shop_id为0且is_offline_shop为true查询线下店铺单据	string
modified_begin	修改起始时间	string	{{LAST_SYNC_TIME datetime}}
modified_end	修改结束时间	string	{{CURRENT_TIME datetime}}
so_ids	线上订单号	string
shop_buyer_ids	指定买家账号	string
page_index	第几页，从第一页开始，默认1	string	1
page_size	每页多少条，默认30，最大50	string	50

响应参数

字段	字段名称	类型
as_id	ERP售后单号	string
as_date	申请时间	string
outer_as_id	平台退货退款单号	string
o_id	内部单号	string
so_id	线上单号	string
type	售后类型	string
created	登记时间	string
modified	修改时间	string
status	状态	string
shop_status	订单对应状态	string
remark	备注	string
question_type	问题类型	array
warehouse	仓库	string
refund	退款金额	string
payment	补偿金额	string
good_status	货物状态	string
node	售后线下备注	string
order_status	原订单状态	string
shop_id	店铺编号	string
logistics_company	物流公司	string
l_id	物流单号	string
wh_id	仓库编号	string
wms_co_id	分仓编号	string
confirm_date	最后确认日期	string
freight	卖家应退运费	string
drp_co_id_from	分销商编号	string
receiver_mobile	收件人电话	string
receiver_name	收件人名称	string
shop_buyer_id	买家账号	string
items	商品列表	array
items.asi_id	售后子单号	string
items.as_id	ERP售后单号	string
items.sku_id	商品编码	string
items.qty	数量	string
items.price	单价	string
items.amount	金额	string
items.name	商品名称	string
items.pic	图片地址	string
items.type	类型（退货，换货,补发）	string
items.properties_value	颜色规格	string
items.outer_oi_id	子订单号	string
items.sku_type	商品类型	string
items.r_qty	实收退货数量	string
items.i_id	款式编码	string
items.batchs	批次集合	array
items.batchs.batch_no	批次号	string
items.batchs.sku_id	商品编码	string
items.batchs.qty	商品数量	string
items.batchs.product_date	批次日期	string
items.batchs.supplier_id	供应商编号	string
items.batchs.supplier_name	供应商名称	string

金蝶云星空接口明细

调用接口：batchSave
接口名称：[聚水潭][销售退货单标准新增]-v1
方法：POST

请求参数

字段	字段名称	类型	配置值
FBillTypeID	单据类型	string	XSTHD01_SYS
FBillNo	单据编号	string	{{as_id}}
FSaleOrgId	销售组织	string	{{shop_id}}
FDate	日期	string	{{created}}
FStockOrgId	库存组织	string	{{wms_co_id}}
FRetcustId	退货客户	string	{{shop_id}}
FSettleCurrId	结算币别	string	PRE001
FHeadNote	备注	string	{{as_id}}
FEntity	明细信息	array
FEntity.FMaterialId	物料编码	string	{{items.i_id}}
FEntity.FRealQty	实退数量	string	{{items.qty}}
FEntity.FPrice	单价	string	{{items.price}}
FEntity.FTaxPrice	含税单价	string
FEntity.FIsFree	是否赠品	string	_function case '{{items_price}}' when '0' then true else false end
FEntity.FEntryTaxRate	税率%	string
FEntity.FReturnType	退货类型	string	THLX01_SYS
FEntity.FOwnerTypeId	货主类型	string	BD_OwnerOrg
FEntity.FOwnerId	货主	string	{{wms_co_id}}
FEntity.FStockId	仓库	string	{{wms_co_id}}{{wh_id}}
FEntity.FNote	备注	string
FEntity.SubHeadEntity	财务信息	object
FEntity.SubHeadEntity.FSettleOrgId	结算组织	string	{{shop_id}}
FEntity.SubHeadEntity.FormId	业务对象表单Id	string	SAL_RETURNSTOCK
FEntity.SubHeadEntity.Operation	执行的操作	string	BatchSave
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	bool	true
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	bool	false

系统对接概况

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通聚水潭到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。