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

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

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

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

目标系统:金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

系统对接接口配置

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：旺店通·企业奇门，然后选择对应的连接器。选择对应的查询销售出库单作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器（关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的[标准][调拨单单新增]-v2接口作为数据写入动作，既可以完成第一步的数据对接配置。

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

接口：wdt.stockout.order.query.trade
接口名称：查询销售出库单
接口方法：POST

请求参数

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

响应参数

字段	名称	类型	描述
stockout_id	出库单主键id	string	出库单主键id
order_no	出库单号	string	出库单号,唯一单号
src_order_no	源单号	string	源单号，旺店通系统单号（多默认为JY开头）
warehouse_no	仓库编号	string	仓库编号
consign_time	发货时间	string	销售出库单发货时间时间格式：yyyy-MM-dd HH:mm:ss
order_type	出库单类型	string	出库单类型
trade_status	订单状态	string	订单状态 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	出库单类型名称	string	固定名称“销售出库”
trade_type	订单类型	string	1网店销售 2线下零售 3售后换货 4批发业务 5保修换新 6保修完成 7订单补发 .. 101自定义类型1 102自定义类型2 103自定义类型3 104自定义类型4 105自定义类型5 106自定义类型6
subtype	出库子类型	string	出库子类型
goods_count	数量	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	邮编
receiver_dtb	大头笔	string	大头笔
weight	实际重量	string	ERP系统称重功能记录的重量，如果没有使用称重功能默认使用货品档案维护的预估重量
logistics_type	物流公司类型	string	响应值为ERP定义的ID数值，数值对应的物流公司类型名称单击这里
logistics_code	物流公司编号	string	代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
logistics_name	物流公司名称	string	物流公司名称
print_remark	打印备注	string	打印备注
paid	已付金额	string	已付金额
refund_status	退款状态	string	退款状态： 0无退款，1取消退款，2已申请退款，3等待退货，4等待收货，5退款成功
salesman_no	业务员编号	string	业务员编号
salesman_name	业务员名称	string	业务员名称
fullname	业务员名称	string	业务员名称
warehouse_name	仓库	string	仓库
created	创建时间	string	创建时间时间格式：yyyy-MM-dd HH:mm:ss
remark	备注	string	备注
stockout_reason	出库原因	string	出库原因
outer_no	外部单号	string	外部单号
trade_no	订单编号	string	系统订单编号，默认单号为JY开头，ERP内支持自定义（设置路径：设置——编码设置）
src_trade_no	原始单号	string	商城或电商平台的订单编号,合并订单的多个订单编号有逗号隔开
nick_name	网名	string	网名
customer_name	客户名称	string	客户名称（客户真实姓名，取自receiver_name）
customer_no	客户编号	string	客户编号
trade_time	交易时间	string	交易时间时间格式：yyyy-MM-dd HH:mm:ss
pay_time	付款时间	string	付款时间时间格式：yyyy-MM-dd HH:mm:ss
status	出库单状态	string	出库单状态 5 已取消 48未确认 50待审核 52待推送 53同步失败 55已审核 95 已发货 105部分打款 110已完成 113 异常发货 115回传失败 120回传成功
shop_name	店铺名称	string	店铺名称
shop_no	店铺编号	string	代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置）
buyer_message	买家留言	string	买家留言
cs_remark	客服备注	string	客服备注
flag_name	订单标记	string	订单标记
post_amount	邮费	string	从平台获取的销售订单的邮费
block_reason	截停原因	string	截停原因：1申请退款2已退款4地址被修改8发票被修改16物流被修改32仓库变化64备注修改128更换货品256添加货品512放弃抢单1024其他 2048 拦截赠品 4096 拦截天猫换货 8192 买家留言变更 16384 该换货订单存在退货/退款
invoice_type	发票类别	string	发票类别0 不需要，1普通发票，2普通增值税发票，3专用增值税发票
invoice_title	发票抬头	string	发票抬头
invoice_content	发票内容	string	发票内容
invoice_id	发票ID	string	发票ID，目前只设0-1，1表示已开发票
delivery_term	发货条件	string	发货条件 1款到发货 2货到付款(包含部分货到付款) 3分期付款 4挂账单
fenxiao_type	分销类别	string	0 非分销订单 1 转供销 2 代销 3经销
fenxiao_nick	分销商ID	string	分销订单的分销商id,或转供销时供应商id
cod_amount	货到付款金额	string	货到付款金额
id_card_type	证件类别	string	1 身份证
receiver_area	收件人地址	string	省市区空格分隔
shop_remark	店铺备注	string	店铺备注
modified	最后修改时间	string	最后修改时间时间格式：yyyy-MM-dd HH:mm:ss
platform_id	平台id	string	平台id
trade_id	订单表主键	string	订单表主键
checker_name	审单员编号	string	审单员编号
employee_no	审单员编号	string	审单员编号
operator_name	审核员	string	审核员
packager_no	打包员编号	string	打包员编号
packager_name	打包员	string	打包员
picker_no	拣货员编号	string	拣货员编号
picker_name	拣货员	string	拣货员
printer_no	打单员编号	string	打单员编号
printer_name	打单员	string	打单员
examiner_no	验货员编号	string	验货员编号
examiner_name	验货员	string	验货员
stockout_no	出库单号	string	出库单号
src_order_type	源单据类别	string	源单据类别，1 销售订单
wms_status	处理状态	string	处理状态 0 待处理 1 推送失败 2 推送成功 3 接口取消成功系统驳回失败 4 服务器正在处理 5 WMS返回发货信息 6 异步标记,推送申请成功'
error_info	接口处理错误信息	string	接口处理错误信息
warehouse_type	仓库类别	string	仓库类别 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	客户id
freeze_reason	冻结原因	string	冻结原因
is_allocated	是否分配	string	是否分配stockout_order_detail_position
consign_status	出库状态	string	出库状态 1验货 2称重 4出库 8物流同步 16分拣 32档口, 64拣货 1073741824原始单已完成
ebill_status	电子面单状态	string	电子面单,获取状态（0 还未获取单号或获取单号和打印信息完毕；1 手动获取物流单号中；100-105 获取打印数据中）
operator_id	制单人	string	制单人
goods_type_count	货品种类数量	string	货品种类数量
md5_str	MD5字符串值	string	MD5字符串值,用于单据排序
custom_type	其他出库自定义子类别	string	其他出库自定义子类别0，1，2，3，4
receiver_ring	京东三环内	string	京东三环内
to_deliver_time	配送时间	string	配送时间，如周末
pre_charge_time	配送中心	string	配送中心
logistics_id	物流公司ID	string	物流公司ID
unknown_goods_amount	未知成本销售总额	string	未知成本销售总额
calc_post_cost	预估邮费成本	string	预估邮费成本
post_cost	邮费成本	string	邮费成本
calc_weight	预估重量	string	预估重量
post_weight	快递重量	string	快递给的重量
package_id	包装id	string	包装id
package_cost	包装成本	string	包装成本
has_invoice	是否包含发票	string	是否包含发票
printer_id	打单员	string	打单员
pick_error_count	拣货出错次数	string	拣货出错次数
picker_id	拣货员id	string	拣货操作员ID
sorter_id	分拣员id	string	包裹分拣员id
examiner_id	验货员id	string	验货操作员id
consigner_id	发货人id	string	发货人id
packager_id	打包员id	string	打包id
pack_score	打包积分	string	打包积分
pick_score	拣货积分	string	拣货积分
checkouter_id	签出员工id	string	签出员工id
watcher_id	监视员id	string	监视员
picklist_no	分拣单编号	string	分拣单编号
picklist_seq	分拣序号	string	订单在分拣单中序号
invoice_print_status	发票打印状态	string	发票打印状态
flag_id	颜色	string	颜色
logistics_template_id	物流单模板id	string	物流单模板id
sendbill_template_id	发货单模板id	string	发货单模板id
pos_allocate_mode	货位分配方式	string	货位分配方式：0系统自动分配, 1手动指定货位分配 2手动指定有效期批次货位 3其它出库优化使用出库货位 4按批次出库
note_count	便签条数	string	便签条数
reason_id	其他出库原因	string	其他出库原因
lock_id	锁定策略id	string	锁定策略id
reserve	保留	string	保留
batch_no	打印批次	string	打印批次
discount	优惠金额	string	优惠金额
src_tids	原始单号	string	原始单号，平台订单号
tax	税额	string	税额
tax_rate	税率	string	税率
currency	币种	string	币种
id_card	证件号码	string	证件号码
stock_check_time	出库单审核时间	string	出库单审核时间时间格式：yyyy-MM-dd HH:mm:ss
bad_reason	异常状态	string	需要通过异或的方式判断，异常订单(bit位)，1无库存记录 2地址发生变化 4发票变化 8仓库变化16备注变化32平台更换货品64退款…512抢单异常
print_batch_no	打印批次	string	ERP中的单据的打印批次信息，如需该字段，请升级至2.4.0.8版本及以上
sendbill_print_status	发货单打印状态	string	0未打印 1打印中 2已打印 3无需打印
logistics_print_status	物流单打印状态	string	0未打印 1打印中 2已打印 3无需打印
picklist_print_status	分拣单打印状态	string	0未打印 1打印中 2已打印 3无需打印
details_list	货品列表节点	array	货品列表节点
details_list.rec_id	出库明细主键	string	出库明细主键
details_list.stockout_id	出库单主键id	string	出库单主键id
details_list.spec_no	商家编码	string	代表单品(sku)所有属性的编码，SKU概念介绍,单击这里
details_list.goods_count	货品数量	string	货品数量
details_list.sell_price	销售价	string	销售价,最终交易价格,扣除优惠
details_list.brand_no	品牌编号	string	品牌编号
details_list.brand_name	品牌名称	string	品牌名称
details_list.goods_type	货品类型	string	货品类型： 1销售商品 2原材料 3包装 4周转材料5虚拟商品6固定资产 0其它
details_list.gift_type	是否是赠品	string	是否是赠品 0非赠品 1自动赠送 2手工赠送
details_list.goods_name	货品名称	string	货品名称
details_list.goods_no	货品编号	string	代表货品(spu)所有属性的编号，SPU概念介绍,单击这里
details_list.spec_name	规格名称	string	规格名称
details_list.spec_code	规格码	string	规格码
details_list.suite_no	来源组合装编码	string	来源组合装编码
details_list.cost_price	成本价	string	成本价
details_list.total_amount	总货款	string	总货款,sell_price * goods_count=total_amount
details_list.goods_id	货品id	string	货品id
details_list.spec_id	商品主键	string	商品主键
details_list.weight	估重	string	估重
details_list.remark	备注	string	备注
details_list.paid	已支付金额	string	已支付金额
details_list.refund_status	退款状态	string	退款状态
details_list.market_price	零售价	string	零售价
details_list.discount	总折扣金额	string	总折扣金额
details_list.share_amount	分摊后合计应收	string	分摊后合计应收
details_list.tax_rate	税率	string	税率
details_list.barcode	条码	string	条码
details_list.unit_name	基本单位	string	基本单位
details_list.sale_order_id	订单详情表主键	string	订单详情表主键
details_list.share_post	邮费分摊	string	邮费分摊
details_list.src_oid	原始子订单号	string	原始子订单号
details_list.src_tid	原始订单号	string	原始订单号
details_list.from_mask	单据内部来源	string	1手机订单 2聚划算 4服务子订单 8家装 16二次付款 32开具电子发票 1024库存不足 2048当日达 4096次日达 8192预约时效
details_list.src_order_type	源单据类别	string	源单据类别以主单为准
details_list.src_order_detail_id	sales_trade_order表的主键	string	sales_trade_order表的主键
details_list.base_unit_id	基本单位	string	基本单位
details_list.unit_id	辅助单位	string	辅助单位
details_list.unit_ratio	单位换算	string	单位换算
details_list.num	货品数量	string	货品数量
details_list.num2	辅助数量	string	辅助数量
details_list.price	最终价格	string	最终价格，share_price删掉，取代share_price
details_list.batch_id	指定出库批次	string	指定出库批次
details_list.is_examined	是否验货	string	是否验货，用于挂起，已标记为验货的不需要再验货
details_list.is_package	是否包装	string	是否包装
details_list.is_zero_cost	是否允许0成本	string	是否允许0成本
details_list.scan_type	扫描方式	string	0未验货,1扫描验货,2手工验货,3快速验货,4无需验货
details_list.good_prop1	货品档案自定义属性1	string	货品档案自定义属性1
details_list.good_prop2	货品档案自定义属性2	string	货品档案自定义属性2
details_list.good_prop3	货品档案自定义属性3	string	货品档案自定义属性3
details_list.good_prop4	货品档案自定义属性4	string	货品档案自定义属性4
details_list.good_prop5	货品档案自定义属性5	string	货品档案自定义属性5
details_list.good_prop6	货品档案自定义属性6	string	货品档案自定义属性6
details_list.prop1	单品列表自定义属性1	string	单品列表自定义属性1
details_list.prop2	单品列表自定义属性2	string	单品列表自定义属性2
details_list.prop3	单品列表自定义属性3	string	单品列表自定义属性3
details_list.prop4	单品列表自定义属性4	string	单品列表自定义属性4
details_list.prop5	单品列表自定义属性5	string	单品列表自定义属性5
details_list.prop6	单品列表自定义属性6	string	单品列表自定义属性6
details_list.batch_no	批次号	string	批次号
details_list.batch_remark	批次备注	string	批次备注
details_list.expire_date	有效期	string	有效期，时间格式：yyyy-MM-dd HH:mm:ss
details_list.position_list	货位节点列表	array	货位节点列表
details_list.position_list.position_id	货位ID	string	货位ID
details_list.position_list.position_no	货位编号	string	货位编号
details_list.position_list.stockout_order_detail_id	出库单明细id	string	出库单明细id
details_list.position_list.rec_id	货位主键id	string	货位主键id
details_list.position_list.stockin_detail_id	入库单明细id	string	入库单明细id
details_list.position_list.num	货品数量	string	货品数量
details_list.position_list.stock_spec_detail_id	入库单号明细id	string	入库单号明细id
details_list.position_list.batch_id	批次id	string	批次id
details_list.position_list.batch_no	批次号	string	批次号
details_list.position_list.modified	最后更新时间	string	最后更新时间
details_list.position_list.cost_price	成本价	string	成本价
details_list.position_list.position_goods_count	货位出库数量	string	货位出库数量

金蝶云星空接口明细

接口：batchSave
接口名称：[标准][调拨单单新增]-v2
接口方法：POST

请求参数

字段	名称	类型	描述
FBillNo	单据编号	string	单据编号
FBillTypeID	单据类型	string	单据类型
FBizType	业务类型	string	下拉列表
FTransferDirect	调拨方向	string	下拉列表
FTransferBizType	调拨类型	string	下拉列表
FSaleOrgId	销售组织	string	组织
FSettleOrgId	结算组织	string	组织
FStockOutOrgId	调出库存组织	string	组织
FOwnerTypeOutIdHead	调出货主类型	string	多类别基础资料列表
FOwnerOutIdHead	调出货主	string	多类别基础资料
FStockOrgId	调入库存组织	string	组织
FSETTLECURRID	结算币别	string	基础资料
FDate	日期	string	日期
FNote	备注	string	多行文本
FBaseKeHu	客户	string
FBillEntry	明细信息	array	1
FBillEntry.FMaterialId	物料编码	string	基础资料
FBillEntry.FCMKBarCode	零售条形码	string	文本
FBillEntry.FQty	调拨数量	string	数量
FBillEntry.FLot	调出批号	string	批次
FBillEntry.FSrcStockId	调出仓库	string	基础资料
FBillEntry.FDestStockId	调入仓库	string	基础资料
FBillEntry.FNoteEntry	备注	string	多行文本
FBillEntry.FDestStockStatusId	调入库存状态	string
FBillEntry.FBaseKeHu	客户	string
FBillEntry.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
FBillEntry.Operation	执行的操作	string
FBillEntry.IsAutoSubmitAndAudit	提交并审核	bool
FBillEntry.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统打通概况

基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接旺店通·企业奇门接口抽取数据后再自动分发到金蝶云星空，解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。