金蝶云星空和旺店通·企业奇门单据接口对接

数据源平台:旺店通·企业奇门

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

写入目标:金蝶云星空

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

系统对接接口配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：旺店通·企业奇门，并且选择对应的连接器（关于旺店通·企业奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的查询销售出库单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的销售出库新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

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

API：wdt.stockout.order.query.trade
NAME：查询销售出库单
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
start_time	开始时间	{{LAST_SYNC_TIME datetime}}	增量获取数据，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	出库单号	CK202211044203,CK202211101759
shop_no	店铺编号		代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺单据数据信息
warehouse_no	仓库编号		代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号)
page_size	分页大小	100	每页返回的数据条数，输入值范围1_{100，不传本参数，输入值默认为40，使用举例单击这里}
page_no	页号		不传值默认从0页开始

响应参数

接口字段	字段名称	描述
stockout_id	出库单主键id	出库单主键id
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_count	数量	货品数量
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	大头笔	大头笔
weight	实际重量	ERP系统称重功能记录的重量，如果没有使用称重功能默认使用货品档案维护的预估重量
logistics_type	物流公司类型	响应值为ERP定义的ID数值，数值对应的物流公司类型名称单击这里
logistics_code	物流公司编号	代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
logistics_name	物流公司名称	物流公司名称
print_remark	打印备注	打印备注
paid	已付金额	已付金额
refund_status	退款状态	退款状态： 0无退款，1取消退款，2已申请退款，3等待退货，4等待收货，5退款成功
salesman_no	业务员编号	业务员编号
salesman_name	业务员名称	业务员名称
fullname	业务员名称	业务员名称
warehouse_name	仓库	仓库
created	创建时间	创建时间时间格式：yyyy-MM-dd HH:mm:ss
remark	备注	备注
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	店铺备注	店铺备注
modified	最后修改时间	最后修改时间时间格式：yyyy-MM-dd HH:mm:ss
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	出库单号	出库单号
src_order_type	源单据类别	源单据类别，1 销售订单
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	包装成本	包装成本
has_invoice	是否包含发票	是否包含发票
printer_id	打单员	打单员
pick_error_count	拣货出错次数	拣货出错次数
picker_id	拣货员id	拣货操作员ID
sorter_id	分拣员id	包裹分拣员id
examiner_id	验货员id	验货操作员id
consigner_id	发货人id	发货人id
packager_id	打包员id	打包id
pack_score	打包积分	打包积分
pick_score	拣货积分	拣货积分
checkouter_id	签出员工id	签出员工id
watcher_id	监视员id	监视员
picklist_no	分拣单编号	分拣单编号
picklist_seq	分拣序号	订单在分拣单中序号
invoice_print_status	发票打印状态	发票打印状态
flag_id	颜色	颜色
logistics_template_id	物流单模板id	物流单模板id
sendbill_template_id	发货单模板id	发货单模板id
pos_allocate_mode	货位分配方式	货位分配方式：0系统自动分配, 1手动指定货位分配 2手动指定有效期批次货位 3其它出库优化使用出库货位 4按批次出库
note_count	便签条数	便签条数
reason_id	其他出库原因	其他出库原因
lock_id	锁定策略id	锁定策略id
reserve	保留	保留
batch_no	打印批次	打印批次
discount	优惠金额	优惠金额
src_tids	原始单号	原始单号，平台订单号
tax	税额	税额
tax_rate	税率	税率
currency	币种	币种
id_card	证件号码	证件号码
stock_check_time	出库单审核时间	出库单审核时间时间格式：yyyy-MM-dd HH:mm:ss
bad_reason	异常状态	需要通过异或的方式判断，异常订单(bit位)，1无库存记录 2地址发生变化 4发票变化 8仓库变化16备注变化32平台更换货品64退款…512抢单异常
print_batch_no	打印批次	ERP中的单据的打印批次信息，如需该字段，请升级至2.4.0.8版本及以上
sendbill_print_status	发货单打印状态	0未打印 1打印中 2已打印 3无需打印
logistics_print_status	物流单打印状态	0未打印 1打印中 2已打印 3无需打印
picklist_print_status	分拣单打印状态	0未打印 1打印中 2已打印 3无需打印
details_list	货品列表节点	货品列表节点
details_list.rec_id	出库明细主键	出库明细主键
details_list.stockout_id	出库单主键id	出库单主键id
details_list.spec_no	商家编码	代表单品(sku)所有属性的编码，SKU概念介绍,单击这里
details_list.goods_count	货品数量	货品数量
details_list.sell_price	销售价	销售价,最终交易价格,扣除优惠
details_list.brand_no	品牌编号	品牌编号
details_list.brand_name	品牌名称	品牌名称
details_list.goods_type	货品类型	货品类型： 1销售商品 2原材料 3包装 4周转材料5虚拟商品6固定资产 0其它
details_list.gift_type	是否是赠品	是否是赠品 0非赠品 1自动赠送 2手工赠送
details_list.goods_name	货品名称	货品名称
details_list.goods_no	货品编号	代表货品(spu)所有属性的编号，SPU概念介绍,单击这里
details_list.spec_name	规格名称	规格名称
details_list.spec_code	规格码	规格码
details_list.suite_no	来源组合装编码	来源组合装编码
details_list.cost_price	成本价	成本价
details_list.total_amount	总货款	总货款,sell_price * goods_count=total_amount
details_list.goods_id	货品id	货品id
details_list.spec_id	商品主键	商品主键
details_list.weight	估重	估重
details_list.remark	备注	备注
details_list.paid	已支付金额	已支付金额
details_list.refund_status	退款状态	退款状态
details_list.market_price	零售价	零售价
details_list.discount	总折扣金额	总折扣金额
details_list.share_amount	分摊后合计应收	分摊后合计应收
details_list.tax_rate	税率	税率
details_list.barcode	条码	条码
details_list.unit_name	基本单位	基本单位
details_list.sale_order_id	订单详情表主键	订单详情表主键
details_list.share_post	邮费分摊	邮费分摊
details_list.src_oid	原始子订单号	原始子订单号
details_list.src_tid	原始订单号	原始订单号
details_list.from_mask	单据内部来源	1手机订单 2聚划算 4服务子订单 8家装 16二次付款 32开具电子发票 1024库存不足 2048当日达 4096次日达 8192预约时效
details_list.src_order_type	源单据类别	源单据类别以主单为准
details_list.src_order_detail_id	sales_trade_order表的主键	sales_trade_order表的主键
details_list.base_unit_id	基本单位	基本单位
details_list.unit_id	辅助单位	辅助单位
details_list.unit_ratio	单位换算	单位换算
details_list.num	货品数量	货品数量
details_list.num2	辅助数量	辅助数量
details_list.price	最终价格	最终价格，share_price删掉，取代share_price
details_list.batch_id	指定出库批次	指定出库批次
details_list.is_examined	是否验货	是否验货，用于挂起，已标记为验货的不需要再验货
details_list.is_package	是否包装	是否包装
details_list.is_zero_cost	是否允许0成本	是否允许0成本
details_list.scan_type	扫描方式	0未验货,1扫描验货,2手工验货,3快速验货,4无需验货
details_list.good_prop1	货品档案自定义属性1	货品档案自定义属性1
details_list.good_prop2	货品档案自定义属性2	货品档案自定义属性2
details_list.good_prop3	货品档案自定义属性3	货品档案自定义属性3
details_list.good_prop4	货品档案自定义属性4	货品档案自定义属性4
details_list.good_prop5	货品档案自定义属性5	货品档案自定义属性5
details_list.good_prop6	货品档案自定义属性6	货品档案自定义属性6
details_list.prop1	单品列表自定义属性1	单品列表自定义属性1
details_list.prop2	单品列表自定义属性2	单品列表自定义属性2
details_list.prop3	单品列表自定义属性3	单品列表自定义属性3
details_list.prop4	单品列表自定义属性4	单品列表自定义属性4
details_list.prop5	单品列表自定义属性5	单品列表自定义属性5
details_list.prop6	单品列表自定义属性6	单品列表自定义属性6
details_list.batch_no	批次号	批次号
details_list.batch_remark	批次备注	批次备注
details_list.expire_date	有效期	有效期，时间格式：yyyy-MM-dd HH:mm:ss
details_list.position_list	货位节点列表	货位节点列表
details_list.position_list.position_id	货位ID	货位ID
details_list.position_list.position_no	货位编号	货位编号
details_list.position_list.stockout_order_detail_id	出库单明细id	出库单明细id
details_list.position_list.rec_id	货位主键id	货位主键id
details_list.position_list.stockin_detail_id	入库单明细id	入库单明细id
details_list.position_list.num	货品数量	货品数量
details_list.position_list.stock_spec_detail_id	入库单号明细id	入库单号明细id
details_list.position_list.batch_id	批次id	批次id
details_list.position_list.batch_no	批次号	批次号
details_list.position_list.modified	最后更新时间	最后更新时间
details_list.position_list.cost_price	成本价	成本价
details_list.position_list.position_goods_count	货位出库数量	货位出库数量

金蝶云星空接口明细

接口：batchSave
接口名称：销售出库新增
接口方法：POST

请求参数

字段	名称	类型	描述
FBillTypeID	单据类型	string	单据类型
FBillNo	单据编号	string	单据编号
FDate	日期	string	日期
FSaleOrgId	销售组织	string	组织
FCustomerID	客户	string	基础资料
FCarriageNO	运输单号	string	文本
FStockOrgId	发货组织	string	组织
FLinkPhone	联系电话	string	文本
FLinkMan	收货人姓名	string	文本
FReceiveAddress	收货方地址	string	文本
SubHeadEntity	财务信息	object
SubHeadEntity.FSettleTypeID	结算方式	string	基础资料
SubHeadEntity.FReceiverAddress	收货人地址	string	文本
SubHeadEntity.FReceiverName	收货人	string	文本
SubHeadEntity.FReceiverMobile	收货人手机	string	文本
SubHeadEntity.FEntity	明细信息	array
SubHeadEntity.FEntity.FMaterialID	物料编码	string	基础资料
SubHeadEntity.FEntity.FRealQty	实发数量	string	数量
SubHeadEntity.FEntity.FTaxPrice	含税单价	string	单价
SubHeadEntity.FEntity.FStockID	仓库	string	基础资料
SubHeadEntity.FEntity.FStockStatusID	库存状态	string
SubHeadEntity.FEntity.FOwnerIdHead	货主组织	string
SubHeadEntity.FEntity.F_wk_wdtysdh	原始单号	string
SubHeadEntity.FEntity.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如😛UR_PurchaseOrder
SubHeadEntity.FEntity.Operation	执行的操作	string
SubHeadEntity.FEntity.IsAutoSubmitAndAudit	提交并审核	bool
SubHeadEntity.FEntity.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
SubHeadEntity.FEntity.SubSystemId	系统模块	string	默认仓库模块
SubHeadEntity.FEntity.InterationFlags	允许负库存	string

系统数据对接

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。