从旺店通·企业奇门到金蝶云星空通过接口配置打通数据|轻易云数据集成平台

从旺店通·企业奇门到金蝶云星空通过接口配置打通数据

对接系统：旺店通·企业奇门

慧策最先以旺店通ERP切入商家核心管理痛点——订单管理，之后围绕电商经营管理中的核心管理诉求，先后布局流量获取、会员管理、仓库管理等其他重要经营模块。慧策的产品线从旺店通ERP起步，向前向后延伸，全面布局零售企业经营，整体构建一体化智能零售解决方案，打破数据孤岛，AI植入系统，实现智能决策，助力零售企业智能化转型。当前旗下拥有店+小程序、数智门店POS、旺店通ERP、旺店通WMS、卡米全渠道、客优CRM、云筹大数据等多个PssS、SaaS产品，从前端吸引流量到后端集约化管理，助力企业智慧决策

对接目标平台:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

数据集成方案配置

数据集成平台对应的配置旺店通·企业奇门与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据旺店通·企业奇门的接口参数要求记录在轻易云集成平台。第二步配置旺店通·企业奇门与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

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

接口：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

请求参数

字段	名称	类型	描述
FBillTypeID	单据类型	string	单据类型
FBillNo	单据编号	string	单据编号
FSaleOrgId	销售组织	string	组织
FDate	日期	string	日期
FStockOrgId	库存组织	string	组织
FRetcustId	退货客户	string	基础资料
FHeadNote	备注	string	多行文本
FEntity	明细信息	array
FEntity.FMaterialId	物料编码	string	基础资料
FEntity.FRealQty	实退数量	string	数量
FEntity.FReturnType	退换货类型	string	数量
FEntity.FTaxPrice	含税单价	string	单价
FEntity.FStockId	仓库	string	基础资料
FEntity.FNote	备注	string	文本
FEntity.SubHeadEntity	财务信息	object
FEntity.SubHeadEntity.FSettleOrgId	结算组织	string	组织
FEntity.SubHeadEntity.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
FEntity.SubHeadEntity.Operation	执行的操作	string
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	bool
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FEntity.SubHeadEntity.SubSystemId	系统模块	string	默认仓库模块

数据对接效果

使用全界面可视化配置集成流，快速应对企业的集成需求使得旺店通·企业奇门与金蝶云星空之间的数据接口一站式的快速集成能力，构建企业数据通道，解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准，完成数据的采集、统一、分发、清洗、归集等，帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统，同时具备快速适配新系统的能力，集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统，都可以通过接口相互集成。