旺店通·企业奇门和金蝶云星辰V1接口打通对接实战|轻易云数据集成平台

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

对接源平台:旺店通·企业奇门

旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展

接通系统：金蝶云星辰V1

金蝶云星辰是金蝶集团公司为小微型工商贸企业定制的一款集财务、进销存、订货商城和税务管理为一体的SAAS云平台，有标准版和专业版两个版本，标准版适用于小型企业(10-50人)业财一体化管理，专业版面向小型(10-100人)企业管理需求。金蝶云星辰聚焦小型企业在线经营和数字化管理，赋能小型企业拓客开源、智能管理和实时决策。

数据集成方案配置

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：旺店通·企业奇门，然后选择对应的连接器。选择对应的wdt.stockout.order.query.return作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星辰V1，并且选择对应连接器（关于金蝶云星辰V1的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的jdy/pur/pur_rtn_save接口作为数据写入动作完成第一步的接口配置。

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

接口：wdt.stockout.order.query.return
接口名称：查询采购退货出库单
接口方法：POST

请求参数

字段	名称	类型	描述
start_time	开始时间	string
end_time	结束时间	string	按最后修改时间增量获取数据,end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
warehouse_no	仓库编号	string
status	出库单状态	string	出库单状态5：已取消，50：待审核，55：已审核，95：已发货，110：已完成（默认查已发货已完成单据）
page_no	页号	string
page_size	分页大小	string	每页返回的数据条数，输入值范围1~30，不传本参数，输入值默认为30，
src_order_no	上层单据编号	string

响应参数

字段	名称	类型	描述
stockout_id	出库单主键id	string	出库单主键id
order_no	出库单号	string	系统出库单号，默认为CK开头
src_order_no	源单号	string	该源单号为退货单号
warehouse_no	仓库编号	string	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置）
status	状态	string	出库状态
consign_time	出库时间	string	出库时间，格式：yyyy-MM-dd HH:mm:ss
order_type	源单据类别	string	源单据类别 1销售订单, 2调拨出库, 3采购退货出库, 4盘亏出库, 5生产出库, 6现款销售出库, 7其他出库, 8多发出库, 9纠错出库,10保修配件出库, 11初始化出库, 12jit拣货出库 13委外出库
order_type_name	源单据类型名称	string	源单据类型名称
subtype	出库子类型	string	出库子类型
goods_count	货品数量	string	货品数量
goods_total_amount	货品总售价	string	货品总售价
goods_total_cost	货品总成本	string	货品总成本
post_fee	邮费	string	邮费
logistics_no	物流编号	string	代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
package_fee	包装费	string	包装费
receiver_name	收件人	string	该字段已废弃
receiver_country	国家	string	国家
receiver_province	省份	string	省份
receiver_city	城市	string	城市
receiver_district	地区	string	地区
receiver_address	详细地址	string	该字段已废弃
receiver_mobile	收件人移动电话	string	该字段已废弃
receiver_telno	收件人固定电话	string	该字段已废弃
receiver_zip	邮编	string	邮编
weight	重量	string	重量
remark	备注	string	备注
stockout_reason	出库原因	string	出库原因
outer_no	外部单号	string	外部单号
operator_name	操作人	string	操作人
receiver_area	省市区	string	省市区空格分开
return_no	采购退货单号	string	采购退货单号
provider_no	供应商编号	string	代表供应商所有属性的唯一编码，用于供应商区分，ERP内支持自定义（ERP供应商界面设置）
provider_name	供应商名称	string	供应商名称
modified	出库单更新时间	string	出库单的最后更新时间，格式：YYYY-MM-DD HH:MM:SS
pr_api_outer_no	采购退货单外部单号	string	采购退货单的外部单号
last_load_purchase_no	最后引用采购单号	string	最后引用采购单号
picklist_print_status	分拣单打印状态	string	默认为'0'，分拣单打印状态 0未打印 1打印中 2已打印 3无需打印
logistics_print_status	物流单打印状态	string	默认为'0'，物流单打印状态，0未打印 1打印中 2已打印 3无需打印
sendbill_print_status	发货单打印状态	string	默认为'0'，发货单打印状态，0未打印 1待打中 2已打印 3无需打印
stockout_no	出库单号	string	出库单号
src_order_type	源单据类别	string	源单据类别 1销售订单, 2调拨出库, 3采购退货出库, 4盘亏出库, 5生产出库, 6现款销售出库, 7其他出库, 8多发出库, 9纠错出库,10保修配件出库, 11初始化出库, 12jit拣货出库 13委外出库'
src_order_id	源单据id	string	源单据id
wms_status	处理状态	string	处理状态 0 待处理 1 推送失败 2 推送成功 3 接口取消成功系统驳回失败 4 服务器正在处理 5 WMS返回发货信息 6 异步标记,推送申请成功
error_info	错误信息	string	接口处理错误信息
warehouse_type	仓库类别	string	默认为'0'，仓库类别 0不限 1普通仓库 2自动流转外部 3京东仓储 4科捷 5百世物流 6 SKU360 7通天晓 8中联网仓 9顺丰仓储 10网仓2号 11奇门仓储 12旺店通仓储 13心怡仓储 14力威仓储 15京东沧海 16云集仓储 127其他
warehouse_id	出库的仓库id	string	出库的仓库id
customer_id	客户id	string	默认为'0'，客户id
freeze_reason	冻结原因	string	默认为'0'，冻结原因
is_allocated	是否分配	string	默认为'0'，是否分配
consign_status	出库状态	string	默认为'0'，出库状态 1验货 2称重 4出库 8物流同步 16分拣 32档口, 64拣货
ebill_status	面单状态	string	默认为'0'，电子面单,获取状态
operator_id	制单人	string	默认为'0'，制单人
goods_type_count	货品种类数量	string	默认为'0'，货品种类数量
md5_str	MD5字符串值	string	默认为''，MD5字符串值,用于单据排序
raw_goods_count	预留字段	string	默认为'0'，预留字段
custom_type	出库类别	string	默认为'0'，其他出库自定义子类别0，1，2，3，4
receiver_ring	接收环	string	默认为''，京东三环内（未使用）
to_deliver_time	配送时间	string	默认为''，配送时间
pre_charge_time	配送中心	string	默认为''，配送中心
logistics_id	物流公司id	string	默认为'0'，物流公司id
unknown_goods_amount	未知成本销售总额	string	默认为'0.0000'，未知成本销售总额
calc_post_cost	预估邮费成本	string	默认为'0.0000'，预估邮费成本
post_cost	邮费成本	string	默认为'0.0000'，邮费成本
calc_weight	预估重量	string	默认为'0.0000'，预估重量
post_weight	快递给的重量	string	默认为'0.0000'，快递给的重量
package_id	包装	string	默认为'0'，包装
package_cost	包装成本	string	默认为'0.0000'，包装成本
has_invoice	是否包含发票	string	默认为'0'，是否包含发票
printer_id	打单员	string	默认为'0'，打单员
pick_error_count	拣货出错次数	string	默认为'0'，拣货出错次数
picker_id	拣货操作员id	string	默认为'0'，拣货操作员id
sorter_id	包裹分拣员id	string	默认为'0'，包裹分拣员id
examiner_id	验货操作员id	string	默认为'0'，验货操作员id
consigner_id	发货人id	string	默认为'0'，发货人id
packager_id	打包员	string	默认为'0'，打包员
pack_score	打包积分	string	默认为'0'，打包积分
pick_score	拣货积分	string	默认为'0'，拣货积分
checkouter_id	签出员工id	string	默认为'0'，签出员工id
watcher_id	监视员	string	默认为'0'，监视员
picklist_no	分拣单编号	string	默认为''，分拣单编号
picklist_seq	分拣单中序号	string	默认为'0'，订单在分拣单中序号
invoice_print_status	发票打印状态	string	默认为'0'，发票打印状态
flag_id	颜色标记	string	默认为'0'，颜色标记
logistics_template_id	物流单模板id	string	默认为'0'，物流单模板id
sendbill_template_id	发货单模板id	string	默认为'0'，发货单模板id
pos_allocate_mode	货位分配方式	string	默认为'0'，货位分配方式：0系统自动分配, 1手动指定货位分配 2手动指定有效期批次货位
note_count	便签条数	string	默认为'0'，便签条数
reason_id	出库原因	string	默认为'0'，其他出库原因
lock_id	锁定策略id	string	默认为'0'，锁定策略id
reserve	保留	string	默认为'0'，保留
block_reason	截停原因	string	默认为'0'，截停原因1申请退款2已退款4地址被修改8发票被修改16物流被修改32仓库变化64备注修改128更换货品256添加货品512放弃抢单1024其他原因2048拦截赠品4096拦截天猫换货8192买家留言变更16384货品平台规格名变更
batch_no	打印批次	string	默认为''，打印批次
stock_check_time	出库单审核时间	string	出库单审核时间
detail_list	货品列表节点	array	响应参数的2级数据节点，包含的采购退货出库单及其明细的数据节点，节点下数据字段详见下述“detail_list”列表
detail_list.rec_id	出库明细主键id	string	出库明细主键id
detail_list.stockout_id	出库单主键id	string	出库单主键id
detail_list.spec_no	商家编码	string	代表单品（SKU）所有属性的唯一编号，用于系统单品的区分，SKU概念介绍单击这里
detail_list.goods_count	货品数量	string	货品数量
detail_list.sell_price	销售价	string	销售价
detail_list.brand_no	品牌编号	string	品牌编号
detail_list.brand_name	品牌名称	string	品牌名称
detail_list.goods_name	货品名称	string	货品名称
detail_list.goods_no	货品编号	string	代表SPU所有属性的唯一编号，用于系统货品的区分，SPU概念介绍单击这里
detail_list.spec_name	规格名称	string	规格名称
detail_list.spec_code	规格编号	string	规格编号
detail_list.cost_price	成本价	string	成本价
detail_list.total_amount	总货款	string	总货款
detail_list.weight	重量	string	重量
detail_list.goods_type	货品类别	string	1销售商品 2原材料 3包装 4周转材料5虚拟商品 0其它
detail_list.goods_unit	单位名称	string	单位名称
detail_list.batch_no	批次号	string	批次号
detail_list.batch_remark	批次备注	string	批次备注
detail_list.expire_date	有效期	string	有效期，格式：yyyy-MM-dd HH:mm:ss
detail_list.remark	备注	string	备注
detail_list.goods_id	货品id	string	货品id
detail_list.spec_id	规格id	string	默认为'0'，规格id
detail_list.position_id	货位	string	默认为'0'，货位，指出库货位
detail_list.src_order_type	源单据类别	string	默认为'1'，源单据类别 1销售订单2,调拨出库3,采购出库4,生产出库5,盘亏出库6,其他出库
detail_list.src_order_detail_id	源单据细节id	string	sales_trade_order表的主键
detail_list.base_unit_id	基本单位	string	默认为'0'，基本单位
detail_list.unit_id	辅助单位	string	默认为'0'，辅助单位
detail_list.unit_ratio	单位换算	string	默认为'1.0000'，单位换算
detail_list.num2	辅助数量	string	默认为'0.0000，辅助数量
detail_list.num	货品数量	string	货品数量
detail_list.price	价格	string	默认为'0.0000，最终价格
detail_list.batch_id	出库批次	string	默认为'0'，指定出库批次
detail_list.is_examined	是否验货	string	默认为'0'，是否验货，用于挂起，已标记为验货的不需要再验货
detail_list.is_package	是否包装	string	默认为'0'，是否包装
detail_list.is_zero_cost	是否允许0成本	string	默认为'0'，是否允许0成本
detail_list.scan_type	类型	string	默认为'0'，0未验货,1扫描验货,2手工验货
detail_list.modified	最后修改时间	string	最后修改时间
detail_list.created	创建时间	string	创建时间
detail_list.position_list	货位列表节点	array	响应参数的3级数据节点，节点下数据字段详见下述“position_list”列表
detail_list.position_list.position_id	货位ID	string	货位ID
detail_list.position_list.position_no	货位编号	string	货位编号
detail_list.position_list.position_goods_count	货位出库数量	string	货位出库数量

金蝶云星辰V1接口明细

接口：jdy/pur/pur_rtn_save
接口名称：采购退货单保存新增
接口方法：POST

请求参数

字段	名称	类型	描述
billno	单据编码	string	单据编码
billdate	单据日期	string	单据日期
deptid_id	部门	string	部门
deptid_number	部门number	string	部门number
empid_id	业务员	string	业务员
empid_number	业务员number	string	业务员number
supplierid_id	供应商	string	供应商
remark	备注	string	备注
alldebt	应付余额	string	应付余额
lastdebt	上次欠款	string	上次欠款
returnreason	原因	string	原因
contact_info	联系信息	string	联系信息
bill_dis_amount	整单折扣额	string	整单折扣额
bill_dis_rate	整单折扣率	string	整单折扣率
totalamount	本次应退账款	string	本次应退账款
totalinsamount	退款合计	string	退款合计
totalunsettleamount	本单未退	string	本单未退
material_entity	商品分录	array	商品分录
material_entity.materialid_id	商品	string	商品
material_entity.stockid_id	仓库	string	仓库
material_entity.qty	数量	string	数量
material_entity.barcode	条形码	string	条形码
material_entity.batchno	批次号	string	批次号 (批次商品必填)
material_entity.proplace	产地	string	产地
material_entity.proregno	注册证号	string	注册证号
material_entity.prolicense	生产许可证号	string	生产许可证号
material_entity.snlistid	序列号流转id	string	序列号流转id；单据新增后会在单据详情中带回这个字段信息，*序列号商品修改时必填
material_entity.sn_list	序列号	string	序列号格式如：001:备注1;002:备注2 （序列号:序列号备注多个序列号以英文分号字符;分隔）,*序列号商品必填
material_entity.price	单价	string	单价（如果在“系统参数”的“基础资料参数”中勾选了“商品价格为含税单价”，则price指示含税单价）
material_entity.comment	行备注	string	行备注
material_entity.srcbillno	源单编码	string	源单编码
material_entity.srcbilltypeid_id	源单类型	string	源单类型
material_entity.srcinterid	源单内码	string	源单内码
material_entity.src_billdate	源单日期	string	源单日期
material_entity.srcseq	源单行号	string	源单行号
material_entity.srcentryid	源单分录内码	string	源单分录内码

系统对接总览

全面支持数据集成操作可视化、拖拽流式开发，无代码完成多套异构系统集成，降低使用门槛，提升交付速度。特别是在面向旺店通·企业奇门、金蝶云星辰V1间API接口集成时，通过对API的设计、创建、测试、部署、集成、管理、运维、下线等全生命周期管理，帮助企业洞察运营状况，进一步优化流程，提高企业商业价值。基于Web图形界面，通过拖拽、连接、配置完成流程设计，数据整合和集成，高效打通业务系统，通过面向运营的统计报表，直观查看API各项指标，实现对全局和项目层级双维度的监控管理。再通过轻易云数据集成中台通过统一门户注册管理，将业务以API的方式对外开放，实现业务创新、能力输出。