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

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

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

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

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

接口方案配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：旺店通·企业奇门的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星空，把获取的数据组装成目标系统需要的格式进行写入。

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

• API：wdt.stockout.order.query.trade

• NAME：查询销售出库单

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
start_time	开始时间	2022-11-01 00:00:00	增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
end_time	结束时间	{{CURRENT_TIME datetime}}	增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
status	状态		5已取消，55已审核，95已发货，105 部分打款，110已完成，113：异常发货
src_order_no	系统订单编号
src_tid	原始单号
stockout_no	出库单号
shop_no	店铺编号		代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺单据数据信息
warehouse_no	仓库编号		代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号)
page_size	分页大小	100	每页返回的数据条数，输入值范围1100，不传本参数，输入值默认为40，使用举例单击这里
page_no	页号	{{PAGINATION_START_PAGE}}	不传值默认从0页开始

响应参数

接口字段	字段名称	预设值	描述
order_no	出库单号		出库单号,唯一单号
src_order_no	源单号		源单号，旺店通系统单号（多默认为JY开头）
warehouse_no	仓库编号		仓库编号
consign_time	发货时间		销售出库单发货时间 时间格式：yyyy-MM-dd HH:mm:ss
order_type	出库单类型		出库单类型
trade_status	订单状态		订单状态 5已取消 10待付款 12待尾款 13待选仓 15等未付16延时审核 19预订单前处理 20前处理(赠品，合并，拆分)21委外前处理22抢单前处理 25预订单 27待抢单 30待客审 35待财审 40待递交仓库 45递交仓库中 50已递交仓库 53未确认 55已确认 95已发货 105部分打款 110已完成 113异常发货
order_type_name	出库单类型名称		固定名称“销售出库”
trade_type	订单类型		1网店销售 2线下零售 3售后换货 4批发业务 5保修换新 6保修完成 7订单补发 .. 101自定义类型1 102自定义类型2 103自定义类型3 104自定义类型4 105自定义类型5 106自定义类型6
subtype	出库子类型		出库子类型
goods_total_amount	货品总售价		货品总售价
goods_total_cost	货品总成本		货品总成本
post_fee	邮资成本		邮资成本
logistics_no	物流单号		物流单号
package_fee	包装费		包装费
receiver_name	收件人		收件人
receiver_country	国家		国家
receiver_province	省份		省份
receiver_city	城市		城市
receiver_district	地区		地区
receiver_address	详细地址		详细地址
receiver_mobile	收件人移动电话		收件人移动电话
receiver_telno	收件人固定电话		收件人固定电话
receiver_zip	邮编		邮编
receiver_dtb	大头笔		大头笔
logistics_type	物流公司类型		响应值为ERP定义的ID数值，数值对应的物流公司类型名称单击这里
logistics_code	物流公司编号		代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
logistics_name	物流公司名称		物流公司名称
print_remark	打印备注		打印备注
salesman_no	业务员编号		业务员编号
salesman_name	业务员名称		业务员名称
fullname	业务员名称		业务员名称
warehouse_name	仓库		仓库
created	创建时间		创建时间 时间格式：yyyy-MM-dd HH:mm:ss
stockout_reason	出库原因		出库原因
outer_no	外部单号		外部单号
trade_no	订单编号		系统订单编号，默认单号为JY开头，ERP内支持自定义（设置路径：设置——编码设置）
src_trade_no	原始单号		商城或电商平台的订单编号,合并订单的多个订单编号有逗号隔开
nick_name	网名		网名
customer_name	客户名称		客户名称（客户真实姓名，取自receiver_name）
customer_no	客户编号		客户编号
trade_time	交易时间		交易时间 时间格式：yyyy-MM-dd HH:mm:ss
pay_time	付款时间		付款时间 时间格式：yyyy-MM-dd HH:mm:ss
status	出库单状态		出库单状态 5 已取消 48未确认 50待审核 52待推送 53同步失败 55已审核 95 已发货 105部分打款 110已完成 113 异常发货 115回传失败 120回传成功
shop_name	店铺名称		店铺名称
shop_no	店铺编号		代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置）
buyer_message	买家留言		买家留言
cs_remark	客服备注		客服备注
flag_name	订单标记		订单标记
post_amount	邮费		从平台获取的销售订单的邮费
block_reason	截停原因		截停原因：1申请退款2已退款4地址被修改8发票被修改16物流被修改32仓库变化64备注修改128更换货品256添加货品512放弃抢单1024其他 2048 拦截赠品 4096 拦截天猫换货 8192 买家留言变更 16384 该换货订单存在退货/退款
invoice_type	发票类别		发票类别0 不需要，1普通发票，2普通增值税发票，3专用增值税发票
invoice_title	发票抬头		发票抬头
invoice_content	发票内容		发票内容
invoice_id	发票ID		发票ID，目前只设0-1，1表示已开发票
delivery_term	发货条件		发货条件 1款到发货 2货到付款(包含部分货到付款) 3分期付款 4挂账单
fenxiao_type	分销类别		0 非分销订单 1 转供销 2 代销 3经销
fenxiao_nick	分销商ID		分销订单的分销商id,或转供销时供应商id
cod_amount	货到付款金额		货到付款金额
id_card_type	证件类别		1 身份证
receiver_area	收件人地址		省市区空格分隔
shop_remark	店铺备注		店铺备注
platform_id	平台id		平台id
trade_id	订单表主键		订单表主键
checker_name	审单员编号		审单员编号
employee_no	审单员编号		审单员编号
operator_name	审核员		审核员
packager_no	打包员编号		打包员编号
packager_name	打包员		打包员
picker_no	拣货员编号		拣货员编号
picker_name	拣货员		拣货员
printer_no	打单员编号		打单员编号
printer_name	打单员		打单员
examiner_no	验货员编号		验货员编号
examiner_name	验货员		验货员
stockout_no	出库单号		出库单号
wms_status	处理状态		处理状态 0 待处理 1 推送失败 2 推送成功 3 接口取消成功系统驳回失败 4 服务器正在处理 5 WMS返回发货信息 6 异步标记,推送申请成功'
error_info	接口处理错误信息		接口处理错误信息
warehouse_type	仓库类别		仓库类别 0不限 1普通仓库 2自动流转外部 3京东仓储 4科捷 5百世物流 6 SKU360 7通天晓 8中联网仓 9顺丰仓储 10网仓2号 11奇门仓储 12旺店通仓储 13心怡仓储 14力威仓储 15京东沧海 16云集仓储 127其他
warehouse_id	出库仓库id		出库的仓库id
customer_id	客户id		客户id
freeze_reason	冻结原因		冻结原因
is_allocated	是否分配		是否分配stockout_order_detail_position
consign_status	出库状态		出库状态 1验货 2称重 4出库 8物流同步 16分拣 32档口, 64拣货 1073741824原始单已完成
ebill_status	电子面单状态		电子面单,获取状态（0 还未获取单号或获取单号和打印信息完毕；1 手动获取物流单号中；100-105 获取打印数据中）
operator_id	制单人		制单人
goods_type_count	货品种类数量		货品种类数量
md5_str	MD5字符串值		MD5字符串值,用于单据排序
custom_type	其他出库自定义子类别		其他出库自定义子类别0，1，2，3，4
receiver_ring	京东三环内		京东三环内
to_deliver_time	配送时间		配送时间，如周末
pre_charge_time	配送中心		配送中心
logistics_id	物流公司ID		物流公司ID
unknown_goods_amount	未知成本销售总额		未知成本销售总额
calc_post_cost	预估邮费成本		预估邮费成本
post_cost	邮费成本		邮费成本
calc_weight	预估重量		预估重量
post_weight	快递重量		快递给的重量
package_id	包装id		包装id
package_cost	包装成本		包装成本

金蝶云星空接口明细

• API：batchSave

• NAME：[旺店通][销售出库单标准新增]-v1

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillTypeID	单据类型	WDTXSCKD
FBillNo	单据编号	{{order_no}}
FDate	日期	{{consign_date}}
FSaleOrgId	销售组织	findCollection find email from f9720649-c4cb-3d51-8bb0-e633ee48e23c where shop_no={{shop_no}}
FCustomerID	客户	{{shop_no}}
FSaleDeptID	销售部门	{{shop_no}}
FStockOrgId	发货组织	_findCollection find email from f9720649-c4cb-3d51-8bb0-e633ee48e23c where shop_no={{shop_no}}
FNOTE	备注
FEntity	明细信息	details
FEntity.FMaterialID	物料编码	{{details.details_list_goods_no}}
FEntity.FRealQty	实发数量	{{details.details_list_goods_count}}
FEntity.FEntryTaxRate	税率	{{tax_rate}}
FEntity.FTaxPrice	含税单价	function round({{details.details_list_paid}}/{{details.details_list_goods_count}},7)
FEntity.FAllAmount	价税合计
FEntity.FOwnerTypeId	货主类型	BD_OwnerOrg
FEntity.FOwnerId	货主	_findCollection find email from f9720649-c4cb-3d51-8bb0-e633ee48e23c where shop_no={{shop_no}}
FEntity.FStockID	仓库	{{warehouse_no}}
FEntity.FStockStatusID	库存状态	KCZT01_SYS
FEntity.SubHeadEntity	财务信息
FEntity.SubHeadEntity.FSettleOrgID	结算组织	_findCollection find email from f9720649-c4cb-3d51-8bb0-e633ee48e23c where shop_no={{shop_no}}
FEntity.SubHeadEntity.FSETTLECURRID	结算币别	PRE001
FEntity.SubHeadEntity.FormId	业务对象表单Id	SAL_OUTSTOCK
FEntity.SubHeadEntity.Operation	执行的操作	Save
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	true
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	false
FEntity.SubHeadEntity.SubSystemId	相应位置	21
FEntity.SubHeadEntity.InterationFlags	允许负库存	STK_InvCheckResult	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统集成总览

数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。