旺店通·企业奇门和金蝶云星空接口打通对接实战

源系统:旺店通·企业奇门

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

接通系统：金蝶云星空

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

数据接口配置方案

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：旺店通·企业奇门接口：查询退换管理通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：金蝶云星空接口：应收单新增，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：金蝶云星空写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

旺店通·企业奇门接口明细

接口：wdt.refund.query
接口名称：查询退换管理
接口方法：POST

请求参数

字段	名称	类型	描述
process_status	退换单处理状态	string	退换单处理状态 5 补款 10已取消 20待审核 30已同意 40已拒绝 50待财审 60待收货 63待推送 64推送失败 65委外待收货 69待收货(已结算) 70部分到货 71部分到货(已结算) 80待结算 90已完成
time_type	时间类型	string	0，最后更新时间，1，结算时间。默认值0
start_time	开始时间	string	按最后修改（结算）时间增量获取数据,start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
end_time	结束时间	string	按最后修改时间（结算）增量获取数据,end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
page_size	分页大小	string	每页返回的数据条数，输入值范围1_{40，不传本参数，输入值默认为40，使用举例单击这里}
shop_no	店铺编号	string	店铺编号
page_no	页号	string	不传值默认从0页开始
refund_no	Erp内退换单编号	string	Erp内退换单编号，传该字段可以不传时间
src_refund_no	平台原始退换单号	string	平台原始退换单号，传该字段可以不传时间
trade_no	系统订单编号	string	系统订单编号，传该字段可以不传时间
tid	原始单号	string	原始单号，传该字段可以不传时间

响应参数

字段	名称	类型	描述
modified	最后修改时间	string	最后修改时间格式：yyyy-MM-dd HH:mm:ss
refund_id	退换单主键	string	退换单主键
refund_no	erp退换单号	string	erp退换单号，默认TK开头
finish_time	结算时间	string	旺店通内操作结算的时间格式：yyyy-MM-dd HH:mm:ss
customer_no	客户档案编号	string	客户档案编号
api_outer_no	API单号	string	接口创建退换单的外部单号
platform_id	平台类型	string	平台类型，响应值为代表平台的ID数字，ID对应的平台名称单击这里
customer_name	收件人姓名	string	收件人姓名（如需唯一值，以receiver_name为准）
src_no	平台退款单号	string	平台退款单号
swap_zip	收件人邮编	string	收件人邮编
swap_logistics_type	换货新订单物流公司类别	string	响应值为代表换货新订单物流公司类别的数字，数字对应的物流公司类别名称单击这里
type	类型	string	1退款(未发货，退款申请)2退货3换货4退款不退货5订单补款
process_status	处理状态	string	5补款10已取消20待审核30已同意40已拒绝50待财审60待收货63待推送64推送失败65委外待收货69待收货(已结算)70部分到货71部分到货(已结算)80待结算90已完成
swap_logistics_name	换货新订单物流公司名称	string	换货新订单物流公司名称
creator_name	建单员姓名	string	建单员姓名
status	平台状态	string	平台状态0表示为空，1取消退款，2已申请退款，3等待退货，4等待收货，5退款成功，10换货待处理，20待买家退货，30买家已退货待收货，40待买家修改，50待发出换货商品，55待买家收货，60换货改退货，70换货关闭，80换货成功
guarantee_mode	担保方式	string	担保方式1担保交易2非担保交易3非担保在线交易（ecshop）
error_msg	逆向物流错误信息	string	逆向物流错误信息
cs_status	退款阶段	string	退款阶段 0售中 1售后
created	创建时间	string	创建时间
shop_no	店铺编号	string	代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置）
outer_no	外部编号	string	默认为''，外部编号,与wms对接使用
shop_name	店铺名称	string	店铺名称
swap_trade_id	换出原始单id	string	换出原始单id
warehouse_id	仓库id	string	默认为'0'，期望退回的仓库
pay_account	买家支付帐号	string	买家支付帐号
shop_id	店铺id	string	店铺id
pay_no	支付订单号	string	支付订单号
advance_status	预先状态	string
goods_amount	退货金额	string	退货金额
refund_amount	买家申请退款金额	string	买家申请退款金额
is_goods_received	是否收到货品	string	默认为'0'，买家是否收到货
customer_id	客户id	string	默认为'0'，客户id
direct_refund_amount	线下退款金额	string	订单确认收货之后的退款金额
guarante_refund_amount	平台退款金额	string	平台退款金额
swap_warehouse_id	换出仓库id	string	默认为'0'，换出货品出库仓库
actual_refund_amount	实际退款/收款金额	string	实际退款/收款金额
swap_logistics_id	换出物流id	string	默认为'0'，换货新订单物流公司ID
warehouse_type	仓库类型	string
exchange_amount	换货金额	string	换货金额
post_amount	邮费金额	string	邮费金额
wms_status	wms状态	string	默认为'0'，外部状态,与wms对接使用0初始化1失败2成功
other_amount	其它金额	string	其它金额
wms_result	wms结果	string	默认为''，外部结果,与wms对接使用
wms_outer_no	外部仓库的单号	string	默认为''，对应外部仓库的单号
paid	已退款/已收款	string	已退款/已收款
from_type	建立方式	string	默认为'1'，建立方式1api抓单2手式建单3外部导入4天猫换货5菜鸟回传自动创建
tid	订单的原始单号	string	订单的原始单号
sales_trade_id	系统订单ID	string	系统订单ID
return_goods_count	退回货品数量	string	默认为'0'，退回货品数量
sales_tid	系统订单号	string	系统订单编号，默认单号为JY开头，ERP内支持自定义（设置路径：设置——编码设置）
op_constraint	约束	string	默认为'0'，1不允许拒绝2需要到网页版操作
buyer_nick	昵称	string	昵称
refund_version	退款版本	string	默认为''，退款版本,大于0后表明已经从平台下载完成，退款单不可修改
receiver_name	收件人姓名	string	收件人姓名
consign_mode	发货方式	string	默认为'0'，发货方式：0默认1审核退款单后立即生成换货订单2退货完成后生成换货订单
receiver_address	收件人地址	string	收件人地址
logistics_name	物流公司名称	string	默认为''，物流公司名称
receiver_telno	收件人电话	string	收件人电话
logistics_no	物流单号	string	默认为''，物流单号
push_no	物流递交单号	string	默认为''，物流递交单号
return_name	退货人姓名	string	退货人姓名
return_mobile	退货人手机号	string	退货人手机号
logistics_style	物流形式	string	默认为'0'，取件方式:0客户取件，1顺丰取件，2拒收退回
reason_id	原因	string	默认为'0'，原因
return_telno	退货人电话	string	退货人电话
revert_reason	驳回原因	string	默认为'0'，驳回原因
return_address	退回仓库地址	string	退回仓库地址
return_logistics_name	退回物流公司名称	string	退回物流公司名称
bad_reason	错误原因	string	默认为'0'，错误原因
return_mask	返回标志	string
return_logistics_no	退回物流单号	string	退回物流单号
swap_receiver	换货收件人姓名	string	换货收件人姓名
is_trade_charged	是否结算后生成订单	string	默认为'0'，是否结算后生成订单
swap_mobile	换收发件人姓名手机	string	换收发件人姓名手机
stockin_pre_no	预入库单	string	默认为''，预入库单
swap_telno	换货收件人姓名电话	string	换货收件人姓名电话
revert_reason_info	驳回原因名称	string	驳回原因名称
refund_order_list	退款子订单信息	array	退款子订单信息,refund_order_list结构
refund_order_list.order_id	货品明细主键	string	退换单退回货品明细主键
refund_order_list.refund_id	退换单主键	string	退换单主键
refund_order_list.oid	原始子订单id	string	原始子订单编号
refund_order_list.tid	订单子订单的原始单号	string	订单子订单的原始单号
refund_order_list.src_no	平台退款单号	string	平台退款单号
refund_order_list.process_status	处理状态	string	处理状态0已取消10待递交20待审核30已同意40已拒绝50待财审60待收货70部分到货80已完成
refund_order_list.sales_tid	销售订单编号	string	销售订单编号
refund_order_list.order_num	实际数量	string	实际数量
refund_order_list.price	价格	string	价格
refund_order_list.platform_id	平台类型	string	平台类型，响应值为代表平台的ID数字，ID对应的平台名称单击这里
refund_order_list.cost_price	成本价	string	成本价
refund_order_list.original_price	原价	string	原价
refund_order_list.discount	优惠	string	优惠
refund_order_list.paid	已付金额	string	已付金额
refund_order_list.market_price	单品市场价	string	单品市场价
refund_order_list.refund_num	退款数量	string	退款数量
refund_order_list.refund_order_amount	明细退款金额	string	明细退款金额，由主单退款金额分摊
refund_order_list.total_amount	退货金额	string	退货金额
refund_order_list.spec_id	erp商品主键	string	erp商品主键
refund_order_list.spec_no	商家编码	string	代表单品(sku)所有属性的唯一编码，用于系统单品区分，SKU概念介绍,单击这里
refund_order_list.goods_name	货品名称	string	货品名称
refund_order_list.goods_no	货品编号	string	代表货品(spu)所有属性的唯一编号，用于系统货品区分，，SPU概念介绍,单击这里
refund_order_list.spec_name	规格名称	string	规格名称
refund_order_list.spec_code	规格编码	string	规格编码
refund_order_list.suite_no	组合装编号	string	组合装编号
refund_order_list.suite_name	组合装名称	string	组合装名称
refund_order_list.suite_num	组合装数量	string	组合装数量
refund_order_list.stockin_num	退货入库数量	string	退货入库数量
refund_order_list.remark	退款说明	string	退换明细的备注
refund_order_list.is_sn_enable	是否启用序列号	string	默认为'0'，0不启用序列号1强序列号2弱序列号
refund_order_list.position_no	货位编号	string	货位编号
refund_order_list.position_id	货位ID	string	货位ID，入库时默认ID
refund_order_list.sales_trade_id	系统订单ID	string	系统订单ID
refund_order_list.sales_order_id	销售订单ID	string	默认为'0'
refund_order_list.goods_id	平台货品ID	string	平台货品ID
refund_order_list.suite_id	组合装ID	string	默认为'0'，组合装ID
refund_order_list.stockin_amount	退货入库总额	string	默认为'0.0000'，退货入库总额
refund_order_list.modified	最后修改时间	string	最后修改时间格式：yyyy-MM-dd HH:mm:ss
refund_order_list.created	创建时间	string	创建时间
refund_order_list.swap_province	换货收件人省份	string	换货收件人省份
refund_order_list.refund_out_goods_list	换出货品信息列表	array	换出货品信息列表,refund_out_goods_list结构
refund_order_list.swap_city	换货收件人城市	string	换货收件人城市
refund_order_list.swap_district	换货收件人区县	string	换货收件人区县
refund_order_list.swap_area	换货收件人省市区	string	换货收件人省市区
refund_order_list.swap_warehouse_no	换出货品出库仓库编号	string	换出货品出库仓库编号
refund_order_list.swap_address	换货收件人姓名地址	string	换货收件人姓名地址
refund_order_list.warehouse_no	期望退回的仓库编号	string	期望退回的仓库编号
refund_order_list.refund_time	退款创建时间	string	退款创建时间格式：yyyy-MM-dd HH:mm:ss
refund_order_list.remark	退款说明	string	退款说明
refund_order_list.refund_reason	退款原因	string	退款的具体原因说明
refund_order_list.swap_trade_no	换出原始单号	string	ERP生成的换出订单的原始订单编号

金蝶云星空接口明细

调用接口：batchSave
接口名称：应收单新增
方法：POST

请求参数

字段	字段名称	类型	配置值
FID	实体主键	string
FBillNo	单据编号	string	{{refund_no}}
FDocumentStatus	单据状态	string
FDATE	业务日期	string	{{modified}}
FCURRENCYID	币别	string	{{PRE001}}
FBillTypeID	单据类型	string	FSYSD
FAPPROVEDATE	审核日期	string
FCreateDate	创建日期	string
FModifyDate	修改日期	string
FALLAMOUNTFOR	价税合计	string
FOWNERTYPE	货主类型	string
FOWNERID	货主	string
FCUSTOMERID	客户	string	{{shop_no}}
FSALESBUSTYPE	销售业务类型	string
FBUSINESSTYPE	业务类型	string
FEntityDetail	明细	array	refund_order_list
FEntityDetail.FMATERIALID	物料编码	string	{{refund_order_list.spec_no}}
FEntityDetail.FMaterialName	物料名称	string
FEntityDetail.FMaterialType	物料类别	string
FEntityDetail.FTaxPrice	含税单价	string	{{refund_order_list.price}}
FEntityDetail.FPriceQty	计价数量	string	{{refund_order_list.refund_num}}
FEntityDetail.FComment	备注	string
FEntityDetail.FORDERNUMBER	销售订单号	string
FEntityDetail.FPRICEUNITID	计价单位	string
FEntityDetail.FBASICUNITID	基本单位	string
FEntityDetail.FBASICUNITQTY	计价基本数量	string
FEntityDetail.FPriceWithTax	含税净价	string
FEntityDetail.FBizBillTypeId	业务单据类型	string
FEntityDetail.FBizBillNo	业务单据编号	string
FEntityDetail.FBizFormId	业务单据名称	string
FEntityDetail.FCOSTID	费用项目编码	string
FEntityDetail.FCOSTNAME	费用项目名称	string
FEntityDetail.FCOSTDEPARTMENTID	费用承担部门	string
FEntityDetail.FSalUnitId	销售单位	string
FEntityDetail.FSalQty	销售数量	string	{{refund_order_list.refund_num}}
FEntityDetail.FCOSTAMTSUM	成本金额	string
FEntityDetail.FRECEIVEAMOUNT	已结算金额	string
FEntityDetail.FCustMatID	客户物料编码	string
FEntityDetail.FCustMatName	客户物料名称	string
FEntityDetail.F_LJT_Base_KH	客户-店铺	string	{{shop_no}}
FEntityDetail.FSETTLEORGID	结算组织	string	function case when '{{shop_name}}' like '%古神%' then '102' when '{{shop_name}}' like '%广州格物%' then '101' when '{{shop_name}}' like '%广西格物%' then '103' else '100' end
FEntityDetail.FSALEORGID	销售组织	string	_function case when '{{shop_name}}' like '%古神%' then '102' when '{{shop_name}}' like '%广州格物%' then '101' when '{{shop_name}}' like '%广西格物%' then '103' else '100' end
FEntityDetail.F_adaf_refundtime	退货时间	string	{{refund_time}}
FEntityDetail.F_adaf_LastTime	最后修改时间	string	{{modified}}
FEntityDetail.F_wk_pttkje	平台退款金额	string	{{guarante_refund_amount}}
FEntityDetail.F_wk_Refundphase	退款阶段	string
FEntityDetail.F_LJT_Text_DH	原始退换单号	string	{{tid}}
FEntityDetail.FormId	业务对象表单Id	string	AR_receivable
FEntityDetail.Operation	执行的操作	string	BatchSave
FEntityDetail.IsAutoSubmitAndAudit	提交并审核	bool	true
FEntityDetail.IsVerifyBaseDataField	验证基础资料	bool	false

数据对接效果

通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接旺店通·企业奇门和金蝶云星空，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。