聚水潭对接打通金蝶云星空退货退款查询接口与销售退货新增接口
来源系统:聚水潭
聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。随着客户需求的不断变化，如今聚水潭已经发展成为以SaaSERP为核心，集多种商家服务为一体的SaaS协同平台。经过8年多的发展，公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点，服务范围覆盖超过400个城镇，为客户提供及时、周到和专业的服务。
对接系统：金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
配置集成方案
通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：聚水潭，并且选择对应的连接器（关于聚水潭的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的退货退款查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的销售退货新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
聚水潭接口明细
- API：refund.single.query
- NAME：退货退款查询
- METHOD：POST
请求参数
接口字段字段名称预设值描述
shop_id店铺编号店铺编号
is_offline_shopshop_id为0且is_offline_shop为true查询线下店铺单据shop_id为0且is_offline_shop为true查询线下店铺单据
modified_begin修改起始时间{{LAST_SYNC_TIME datetime}}修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
modified_end修改结束时间{{CURRENT_TIME datetime}}修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
so_ids线上订单号指定线上订单号，和时间段不能同时为空
shop_buyer_ids指定买家账号指定买家账号，最多50
page_index第几页，从第一页开始，默认11第几页，从第一页开始，默认1
page_size每页多少条，默认30，最大5050每页多少条，默认30，最大50
响应参数
接口字段字段名称预设值描述
as_date申请时间申请时间
as_id售后单号申请时间
outer_as_id平台退货退款单号平台退货退款单号
o_id内部单号内部单号
so_id线上单号线上单号
created登记时间登记时间
modified修改时间修改时间
status状态状态（WaitConfirm:待确认,Confirmed:已确认,Cancelled:作废,Merged:被合并）
shop_status订单对应状态WAIT_SELLER_AGREE:买家已经申请退款，等待卖家同意,WAIT_BUYER_RETURN_GOODS:卖家已经同意退款，等待买家退货,WAIT_SELLER_CONFIRM_GOODS:买家已经退货，等待卖家确认收货,SELLER_REFUSE_BUYER:卖家拒绝退款,CLOSED:退款关闭,SUCCESS:退款成功
remark备注备注
question_type问题类型问题类型
warehouse仓库仓库
refund退款金额退款金额
payment补偿金额补偿金额
good_status货物状态货物状态（BUYER_NOT_RECEIVED:买家未收到货,BUYER_RECEIVED:买家已收到货,BUYER_RETURNED_GOODS:买家已退货,SELLER_RECEIVED:卖家已收到退货）
node售后线下备注售后线下备注
order_status原订单状态原订单状态
shop_id店铺编号店铺编号
logistics_company物流公司物流公司
l_id物流单号物流单号
wh_id仓库编号仓库编号
wms_co_id分仓编号分仓编号
confirm_date最后确认日期最后确认日期
freight卖家应退运费卖家应退运费
drp_co_id_from分销商编号分销商编号
receiver_mobile收件人电话收件人电话
receiver_name收件人名称收件人名称
shop_buyer_id买家账号买家账号
items商品列表商品列表
items.as_idERP售后单号ERP售后单号
items.type类型（退货，换货,补发）类型（退货，换货,补发）
items.asi_id售后子单号售后子单号
items.price单价单价
items.amount金额金额
items.name商品名称商品名称
items.pic图片地址图片地址
items.properties_value颜色规格颜色规格
items.outer_oi_id子订单号子订单号
items.sku_type商品类型商品类型
items.r_qty实收退货数量实收退货数量
items.batchs批次集合
items.batchs.sku_id商品编码
items.batchs.qty商品数量
items.batchs.batch_no批次号
items.batchs.product_date批次日期
items.batchs.supplier_id供应商编号
items.batchs.supplier_name供应商名称
金蝶云星空接口明细
- 调用接口：batchSave
- 接口名称：销售退货新增
- 方法：POST
请求参数
字段字段名称类型配置值
FBillTypeID单据类型stringXSXSTHD
FBillNo单据编号string{{bfn_num}}
FSaleOrgId销售组织string
findCollection find F_XC_Base_Fnumber from 8ea1287e-05cd-3ce7-b0e6-4a9a7daa783e where FNumber={{shop_id}}
FDate日期string{{items_receive_date}}
FStockOrgId库存组织string100
FRetcustId退货客户string{{shop_id}}
FHeadNote备注string{{remark}}
F_XC_Text业务员string_findCollection find so_id from 64023c69-0029-319b-932b-a5bce3416df4 where o_id={{o_id}}
FEntity明细信息array
FEntity.FMaterialId物料编码string{{items_sku_id}}
FEntity.FBarcode零售条形码string
FEntity.FRealQty实退数量string{{items_r_qty}}
FEntity.FPrice单价string
FEntity.FTaxPrice含税单价string
function {{items_amount}}/{{items_r_qty}}
FEntity.FIsFree是否赠品string
FEntity.FEntryTaxRate税率%string
FEntity.FReturnType退货类型string
FEntity.FOwnerTypeId货主类型stringBD_OwnerOrg
FEntity.FOwnerId货主string100
FEntity.FStockId仓库string{{wms_co_id}}
FEntity.FLot批号string{{items_batch_no}}
FEntity.FProduceDate生产日期string{{items_product_date}}
FEntity.FDeliveryDate退货日期string
FEntity.F_XC_TEXT4快递单号string{{l_id}}
FEntity.FNote备注string
FEntity.F_XC_TEXT5电商单号string_findCollection find so_id from 64023c69-0029-319b-932b-a5bce3416df4 where o_id={{o_id}}
FEntity.SubHeadEntity财务信息object
FEntity.SubHeadEntity.FSettleOrgId结算组织string_findCollection find F_XC_Base_Fnumber from 8ea1287e-05cd-3ce7-b0e6-4a9a7daa783e where FNumber={{shop_id}}
FEntity.SubHeadEntity.FSETTLECURRID结算币别stringPRE001
FEntity.SubHeadEntity.FormId业务对象表单IdstringSAL_RETURNSTOCK
FEntity.SubHeadEntity.Operation执行的操作stringSave
FEntity.SubHeadEntity.IsAutoSubmitAndAudit提交并审核booltrue
FEntity.SubHeadEntity.IsVerifyBaseDataField验证基础资料boolfalse
FEntity.SubHeadEntity.SubSystemId系统模块string21
数据对接效果
当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
