旺店通·企业奇门和金蝶云星空接口打通对接实战数据源系统:旺店通·企业奇门旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展对接目标系统:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。系统对接接口配置集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：旺店通·企业奇门，源系统 API：查询采购退货出库单，目标系统：金蝶云星空，目标系统 API采购退货新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。旺店通·企业奇门接口明细调用接口： wdt.stockout.order.query.return 接口名称：查询采购退货出库单方法： POST 请求参数字段字段名称类型配置值 start_time 开始时间 string {{LAST_SYNC_TIME datetime}} end_time 结束时间 string {{CURRENT_TIME datetime}} warehouse_no 仓库编号 string status 出库单状态 string page_no 页号 string {{PAGINATION_START_PAGE}} page_size 分页大小 string {{PAGINATION_PAGE_SIZE}} src_order_no 上层单据编号 string 响应参数字段字段名称类型配置值 stockout_id 出库单主键id string order_no 出库单号 string src_order_no 源单号 string warehouse_no 仓库编号 string status 状态 string consign_time 出库时间 string order_type 源单据类别 string order_type_name 源单据类型名称 string subtype 出库子类型 string goods_total_amount 货品总售价 string goods_total_cost 货品总成本 string post_fee 邮费 string logistics_no 物流编号 string 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 stockout_reason 出库原因 string outer_no 外部单号 string operator_name 操作人 string receiver_area 省市区 string return_no 采购退货单号 string provider_no 供应商编号 string provider_name 供应商名称 string pr_api_outer_no 采购退货单外部单号 string last_load_purchase_no 最后引用采购单号 string picklist_print_status 分拣单打印状态 string logistics_print_status 物流单打印状态 string sendbill_print_status 发货单打印状态 string stockout_no 出库单号 string src_order_id 源单据id string wms_status 处理状态 string error_info 错误信息 string warehouse_type 仓库类别 string warehouse_id 出库的仓库id string customer_id 客户id string freeze_reason 冻结原因 string is_allocated 是否分配 string consign_status 出库状态 string ebill_status 面单状态 string operator_id 制单人 string goods_type_count 货品种类数量 string md5_str MD5字符串值 string raw_goods_count 预留字段 string custom_type 出库类别 string receiver_ring 接收环 string to_deliver_time 配送时间 string pre_charge_time 配送中心 string logistics_id 物流公司id string unknown_goods_amount 未知成本销售总额 string calc_post_cost 预估邮费成本 string post_cost 邮费成本 string calc_weight 预估重量 string post_weight 快递给的重量 string package_id 包装 string package_cost 包装成本 string has_invoice 是否包含发票 string printer_id 打单员 string pick_error_count 拣货出错次数 string picker_id 拣货操作员id string sorter_id 包裹分拣员id string examiner_id 验货操作员id string consigner_id 发货人id string packager_id 打包员 string pack_score 打包积分 string pick_score 拣货积分 string checkouter_id 签出员工id string watcher_id 监视员 string picklist_no 分拣单编号 string picklist_seq 分拣单中序号 string invoice_print_status 发票打印状态 string flag_id 颜色标记 string logistics_template_id 物流单模板id string sendbill_template_id 发货单模板id string pos_allocate_mode 货位分配方式 string note_count 便签条数 string reason_id 出库原因 string lock_id 锁定策略id string reserve 保留 string block_reason 截停原因 string stock_check_time 出库单审核时间 string details_list 货品列表节点 array details_list.stockout_id 出库单主键id string details_list.goods_count 货品数量 string details_list.weight 重量 string details_list.remark 备注 string details_list.modified 最后修改时间 string details_list.src_order_type 源单据类别 string details_list.batch_no 批次号 string details_list.rec_id 出库明细主键id string details_list.spec_no 商家编码 string details_list.sell_price 销售价 string details_list.brand_no 品牌编号 string details_list.brand_name 品牌名称 string details_list.goods_name 货品名称 string details_list.goods_no 货品编号 string details_list.spec_name 规格名称 string details_list.spec_code 规格编号 string details_list.cost_price 成本价 string details_list.total_amount 总货款 string details_list.goods_type 货品类别 string details_list.goods_unit 单位名称 string details_list.batch_remark 批次备注 string details_list.expire_date 有效期 string details_list.goods_id 货品id string details_list.spec_id 规格id string details_list.src_order_detail_id 源单据细节id string details_list.base_unit_id 基本单位 string details_list.unit_id 辅助单位 string details_list.unit_ratio 单位换算 string details_list.num2 辅助数量 string details_list.num 货品数量 string details_list.price 价格 string details_list.batch_id 出库批次 string details_list.is_examined 是否验货 string details_list.is_package 是否包装 string details_list.is_zero_cost 是否允许0成本 string details_list.scan_type 类型 string details_list.created 创建时间 string details_list.position_list 货位列表节点 array details_list.position_list.position_id 货位ID string details_list.position_list.position_no 货位编号 string details_list.position_list.position_goods_count 货位出库数量 string 金蝶云星空接口明细调用接口： batchSave 接口名称：采购退货新增方法： POST 请求参数字段字段名称类型配置值 FBillTypeID 单据类型 string TLD01_SYS FBusinessType 业务类型 string CG FBillNo 单据编号 string {{order_no}}-TC FDate 退料日期 string {{consign_time}} FStockOrgId 退料组织 string 106 FPurchaseOrgId 采购组织 string 106 FSupplierID 供应商 string {{provider_no}} FDESCRIPTION 备注 string FMRMODE 退料方式 string B FDELIVERYNO 送货单号 string FCARRYNO 运输单号 string FTAKEDELIVERYNO 提货单号 string FPURMRBENTRY 明细信息 array details_list FPURMRBENTRY.FMATERIALID 物料编码 string {{details_list.spec_no}} FPURMRBENTRY.FBarcode 零售条形码 string FPURMRBENTRY.FRMREALQTY 实退数量 string {{details_list.goods_count}} FPURMRBENTRY.FREPLENISHQTY 补料数量 string FPURMRBENTRY.FKEAPAMTQTY 扣款数量 string FPURMRBENTRY.FSTOCKID 仓库 string {{warehouse_no}} FPURMRBENTRY.FNOTE 备注 string FPURMRBENTRY.FPrice 单价 string FPURMRBENTRY.FGiveAway 是否赠品 string FPURMRBENTRY.FLot 批号 string FPURMRBENTRY.FOWNERID 货主 string 106 FPURMRBENTRY.FOWNERTYPEID 货主类型 string BD_OwnerOrg FPURMRBENTRY.FENTRYTAXRATE 税率 string FPURMRBENTRY.FDISCOUNTRATE 折扣率(%) string FPURMRBENTRY.FTAXPRICE 含税单价 string findCollection find FAPPROVEPRICE_F from 6b95a3b6-1a26-3668-bc09-ed75e10203f1 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}} FPURMRBENTRY.FSRCBillTypeId 源单类型 string PUR_MRAPP FPURMRBENTRY.FSRCBillNo 源单编号 string _findCollection find FBillNo from 6b95a3b6-1a26-3668-bc09-ed75e10203f1 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}} FPURMRBENTRY.FORDERNO 订单单号 string findCollection find FORDERNO from 6b95a3b6-1a26-3668-bc09-ed75e10203f1 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}} FPURMRBENTRY.FCONTRACTNO 合同单号 string FPURMRBENTRY.FMtoNo 计划跟踪号 string FPURMRBENTRY.FPURMRBENTRY_Link 关联关系表 array FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FRuleId 转换规则 string PUR_MRAPP-PUR_MRB FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSTableName 源单表 string T_PUR_MRAPPENTRY FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSBillId 源单内码 string _findCollection find FID from 6b95a3b6-1a26-3668-bc09-ed75e10203f1 where FBillNo={{pr_api_outer_no}} FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSId 源单分录内码 string _findCollection find FEntity_FEntryID from 6b95a3b6-1a26-3668-bc09-ed75e10203f1 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}} FPURMRBENTRY.FormId 业务对象表单Id string PUR_MRB FPURMRBENTRY.Operation 执行的操作 string batchSave FPURMRBENTRY.IsAutoSubmitAndAudit 提交并审核 bool true FPURMRBENTRY.IsVerifyBaseDataField 验证基础资料 bool true FPURMRBENTRY.SubSystemId 系统模块 string 21 系统对接概况从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

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

文森特

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

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

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

对接目标系统:金蝶云星空

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

系统对接接口配置

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

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

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

请求参数

字段	字段名称	类型	配置值
start_time	开始时间	string	{{LAST_SYNC_TIME datetime}}
end_time	结束时间	string	{{CURRENT_TIME datetime}}
warehouse_no	仓库编号	string
status	出库单状态	string
page_no	页号	string	{{PAGINATION_START_PAGE}}
page_size	分页大小	string	{{PAGINATION_PAGE_SIZE}}
src_order_no	上层单据编号	string

响应参数

字段	字段名称	类型
stockout_id	出库单主键id	string
order_no	出库单号	string
src_order_no	源单号	string
warehouse_no	仓库编号	string
status	状态	string
consign_time	出库时间	string
order_type	源单据类别	string
order_type_name	源单据类型名称	string
subtype	出库子类型	string
goods_total_amount	货品总售价	string
goods_total_cost	货品总成本	string
post_fee	邮费	string
logistics_no	物流编号	string
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
stockout_reason	出库原因	string
outer_no	外部单号	string
operator_name	操作人	string
receiver_area	省市区	string
return_no	采购退货单号	string
provider_no	供应商编号	string
provider_name	供应商名称	string
pr_api_outer_no	采购退货单外部单号	string
last_load_purchase_no	最后引用采购单号	string
picklist_print_status	分拣单打印状态	string
logistics_print_status	物流单打印状态	string
sendbill_print_status	发货单打印状态	string
stockout_no	出库单号	string
src_order_id	源单据id	string
wms_status	处理状态	string
error_info	错误信息	string
warehouse_type	仓库类别	string
warehouse_id	出库的仓库id	string
customer_id	客户id	string
freeze_reason	冻结原因	string
is_allocated	是否分配	string
consign_status	出库状态	string
ebill_status	面单状态	string
operator_id	制单人	string
goods_type_count	货品种类数量	string
md5_str	MD5字符串值	string
raw_goods_count	预留字段	string
custom_type	出库类别	string
receiver_ring	接收环	string
to_deliver_time	配送时间	string
pre_charge_time	配送中心	string
logistics_id	物流公司id	string
unknown_goods_amount	未知成本销售总额	string
calc_post_cost	预估邮费成本	string
post_cost	邮费成本	string
calc_weight	预估重量	string
post_weight	快递给的重量	string
package_id	包装	string
package_cost	包装成本	string
has_invoice	是否包含发票	string
printer_id	打单员	string
pick_error_count	拣货出错次数	string
picker_id	拣货操作员id	string
sorter_id	包裹分拣员id	string
examiner_id	验货操作员id	string
consigner_id	发货人id	string
packager_id	打包员	string
pack_score	打包积分	string
pick_score	拣货积分	string
checkouter_id	签出员工id	string
watcher_id	监视员	string
picklist_no	分拣单编号	string
picklist_seq	分拣单中序号	string
invoice_print_status	发票打印状态	string
flag_id	颜色标记	string
logistics_template_id	物流单模板id	string
sendbill_template_id	发货单模板id	string
pos_allocate_mode	货位分配方式	string
note_count	便签条数	string
reason_id	出库原因	string
lock_id	锁定策略id	string
reserve	保留	string
block_reason	截停原因	string
stock_check_time	出库单审核时间	string
details_list	货品列表节点	array
details_list.stockout_id	出库单主键id	string
details_list.goods_count	货品数量	string
details_list.weight	重量	string
details_list.remark	备注	string
details_list.modified	最后修改时间	string
details_list.src_order_type	源单据类别	string
details_list.batch_no	批次号	string
details_list.rec_id	出库明细主键id	string
details_list.spec_no	商家编码	string
details_list.sell_price	销售价	string
details_list.brand_no	品牌编号	string
details_list.brand_name	品牌名称	string
details_list.goods_name	货品名称	string
details_list.goods_no	货品编号	string
details_list.spec_name	规格名称	string
details_list.spec_code	规格编号	string
details_list.cost_price	成本价	string
details_list.total_amount	总货款	string
details_list.goods_type	货品类别	string
details_list.goods_unit	单位名称	string
details_list.batch_remark	批次备注	string
details_list.expire_date	有效期	string
details_list.goods_id	货品id	string
details_list.spec_id	规格id	string
details_list.src_order_detail_id	源单据细节id	string
details_list.base_unit_id	基本单位	string
details_list.unit_id	辅助单位	string
details_list.unit_ratio	单位换算	string
details_list.num2	辅助数量	string
details_list.num	货品数量	string
details_list.price	价格	string
details_list.batch_id	出库批次	string
details_list.is_examined	是否验货	string
details_list.is_package	是否包装	string
details_list.is_zero_cost	是否允许0成本	string
details_list.scan_type	类型	string
details_list.created	创建时间	string
details_list.position_list	货位列表节点	array
details_list.position_list.position_id	货位ID	string
details_list.position_list.position_no	货位编号	string
details_list.position_list.position_goods_count	货位出库数量	string

金蝶云星空接口明细

调用接口：batchSave
接口名称：采购退货新增
方法：POST

请求参数

字段	字段名称	类型	配置值
FBillTypeID	单据类型	string	TLD01_SYS
FBusinessType	业务类型	string	CG
FBillNo	单据编号	string	{{order_no}}-TC
FDate	退料日期	string	{{consign_time}}
FStockOrgId	退料组织	string	106
FPurchaseOrgId	采购组织	string	106
FSupplierID	供应商	string	{{provider_no}}
FDESCRIPTION	备注	string
FMRMODE	退料方式	string	B
FDELIVERYNO	送货单号	string
FCARRYNO	运输单号	string
FTAKEDELIVERYNO	提货单号	string
FPURMRBENTRY	明细信息	array	details_list
FPURMRBENTRY.FMATERIALID	物料编码	string	{{details_list.spec_no}}
FPURMRBENTRY.FBarcode	零售条形码	string
FPURMRBENTRY.FRMREALQTY	实退数量	string	{{details_list.goods_count}}
FPURMRBENTRY.FREPLENISHQTY	补料数量	string
FPURMRBENTRY.FKEAPAMTQTY	扣款数量	string
FPURMRBENTRY.FSTOCKID	仓库	string	{{warehouse_no}}
FPURMRBENTRY.FNOTE	备注	string
FPURMRBENTRY.FPrice	单价	string
FPURMRBENTRY.FGiveAway	是否赠品	string
FPURMRBENTRY.FLot	批号	string
FPURMRBENTRY.FOWNERID	货主	string	106
FPURMRBENTRY.FOWNERTYPEID	货主类型	string	BD_OwnerOrg
FPURMRBENTRY.FENTRYTAXRATE	税率	string
FPURMRBENTRY.FDISCOUNTRATE	折扣率(%)	string
FPURMRBENTRY.FTAXPRICE	含税单价	string	findCollection find FAPPROVEPRICE_F from 6b95a3b6-1a26-3668-bc09-ed75e10203f1 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}}
FPURMRBENTRY.FSRCBillTypeId	源单类型	string	PUR_MRAPP
FPURMRBENTRY.FSRCBillNo	源单编号	string	_findCollection find FBillNo from 6b95a3b6-1a26-3668-bc09-ed75e10203f1 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}}
FPURMRBENTRY.FORDERNO	订单单号	string	findCollection find FORDERNO from 6b95a3b6-1a26-3668-bc09-ed75e10203f1 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}}
FPURMRBENTRY.FCONTRACTNO	合同单号	string
FPURMRBENTRY.FMtoNo	计划跟踪号	string
FPURMRBENTRY.FPURMRBENTRY_Link	关联关系表	array
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FRuleId	转换规则	string	PUR_MRAPP-PUR_MRB
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSTableName	源单表	string	T_PUR_MRAPPENTRY
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSBillId	源单内码	string	_findCollection find FID from 6b95a3b6-1a26-3668-bc09-ed75e10203f1 where FBillNo={{pr_api_outer_no}}
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSId	源单分录内码	string	_findCollection find FEntity_FEntryID from 6b95a3b6-1a26-3668-bc09-ed75e10203f1 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}}
FPURMRBENTRY.FormId	业务对象表单Id	string	PUR_MRB
FPURMRBENTRY.Operation	执行的操作	string	batchSave
FPURMRBENTRY.IsAutoSubmitAndAudit	提交并审核	bool	true
FPURMRBENTRY.IsVerifyBaseDataField	验证基础资料	bool	true
FPURMRBENTRY.SubSystemId	系统模块	string	21

系统对接概况

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。