用友BIP和旺店通·企业奇门单据接口对接

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

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

写入目标:用友BIP

YonBIP用友商业创新平台，是用友在数字经济时代面向成长型、大型企业及巨型企业，融合了先进且高可用技术平台和公共与关键商业应用与服务，支撑和运行客户的商业创新（业务创新、管理变革），并且具有数字化、智能化、高弹性、安全可信、社会化、全球化、平台化、生态化等特征的综合型服务平台。

接口方案配置

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

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

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

请求参数

字段	字段名称	类型	配置值
start_time	开始时间	datetime	{{LAST_SYNC_TIME datetime}}
end_time	结束时间	datetime	{{CURRENT_TIME datetime}}
status	状态	string
src_order_no	系统订单编号	string
src_tid	原始单号	string
stockout_no	出库单号	string
shop_no	店铺编号	string
warehouse_no	仓库编号	string
page_size	分页大小	string	{{PAGINATION_PAGE_SIZE}}
page_no	页号	string	{{PAGINATION_START_PAGE}}

响应参数

字段	字段名称	类型
stockout_id	出库单主键id	string
order_no	出库单号	string
src_order_no	源单号	string
warehouse_no	仓库编号	string
consign_time	发货时间	string
consign_time_new	发货时间(短日期)	string
order_type	出库单类型	string
trade_status	订单状态	string
order_type_name	出库单类型名称	string
trade_type	订单类型	string
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
logistics_type	物流公司类型	string
logistics_code	物流公司编号	string
logistics_name	物流公司名称	string
print_remark	打印备注	string
paid	已付金额	string
refund_status	退款状态	string
salesman_no	业务员编号	string
salesman_name	业务员名称	string
fullname	业务员名称	string
warehouse_name	仓库	string
created	创建时间	string
remark	备注	string
stockout_reason	出库原因	string
outer_no	外部单号	string
trade_no	订单编号	string
src_trade_no	原始单号	string
nick_name	网名	string
customer_name	客户名称	string
customer_no	客户编号	string
trade_time	交易时间	string
pay_time	付款时间	string
status	出库单状态	string
shop_name	店铺名称	string
shop_no	店铺编号	string
buyer_message	买家留言	string
cs_remark	客服备注	string
flag_name	订单标记	string
post_amount	邮费	string
block_reason	截停原因	string
invoice_type	发票类别	string
invoice_title	发票抬头	string
invoice_content	发票内容	string
invoice_id	发票ID	string
delivery_term	发货条件	string
fenxiao_type	分销类别	string
fenxiao_nick	分销商ID	string
cod_amount	货到付款金额	string
id_card_type	证件类别	string
receiver_area	收件人地址	string
shop_remark	店铺备注	string
modified	最后修改时间	string
platform_id	平台id	string
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
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
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	包装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	打包员id	string
pack_score	打包积分	string
pick_score	拣货积分	string
checkouter_id	签出员工id	string
watcher_id	监视员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
batch_no	打印批次	string
discount	优惠金额	string
src_tids	原始单号	string
tax	税额	string
tax_rate	税率	string
currency	币种	string
id_card	证件号码	string
stock_check_time	出库单审核时间	string
bad_reason	异常状态	string
print_batch_no	打印批次	string
sendbill_print_status	发货单打印状态	string
logistics_print_status	物流单打印状态	string
picklist_print_status	分拣单打印状态	string
details_list	货品列表节点	array
details_list.rec_id	出库明细主键	string
details_list.stockout_id	出库单主键id	string
details_list.spec_no	商家编码	string
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
details_list.gift_type	是否是赠品	string
details_list.goods_name	货品名称	string
details_list.goods_no	货品编号	string
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
details_list.goods_id	货品id	string
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
details_list.src_order_type	源单据类别	string
details_list.src_order_detail_id	sales_trade_order表的主键	string
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
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.good_prop1	货品档案自定义属性1	string
details_list.good_prop2	货品档案自定义属性2	string
details_list.good_prop3	货品档案自定义属性3	string
details_list.good_prop4	货品档案自定义属性4	string
details_list.good_prop5	货品档案自定义属性5	string
details_list.good_prop6	货品档案自定义属性6	string
details_list.prop1	单品列表自定义属性1	string
details_list.prop2	单品列表自定义属性2	string
details_list.prop3	单品列表自定义属性3	string
details_list.prop4	单品列表自定义属性4	string
details_list.prop5	单品列表自定义属性5	string
details_list.prop6	单品列表自定义属性6	string
details_list.batch_no	批次号	string
details_list.batch_remark	批次备注	string
details_list.expire_date	有效期	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.stockout_order_detail_id	出库单明细id	string
details_list.position_list.rec_id	货位主键id	string
details_list.position_list.stockin_detail_id	入库单明细id	string
details_list.position_list.num	货品数量	string
details_list.position_list.stock_spec_detail_id	入库单号明细id	string
details_list.position_list.batch_id	批次id	string
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

用友BIP接口明细

API：/yonbip/sd/voucherorder/singleSave
NAME：销售订单单个保存
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
resubmitCheckKey	保证请求的幂等性	{{src_order_no}}	保证请求的幂等性,该值由客户端生成,并且必须是全局唯一的，长度不能超过32位。更多信息,请参见«MDD幂等性»
salesOrgId	销售组织	findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}	销售组织，传id或者code 示例：2282800216593664
transactionTypeId	交易类型	SO021	交易类型，传id或者code 示例：2291507369660672
bizFlow	bizFlow	4420f835-f5e0-11ec-9896-6c92bf477043	流程ID
bizFlow_version	bizFlow_version	V1.0
vouchdate	单据日期	{{consign_time_new}}	单据日期,格式为:yyyy-MM-dd HH:mm:ss 示例：2021-06-09 00:00:00
code	单据编码	{{src_order_no}}	单据编码，以系统编码规则配置为准：系统设置为手工编号时必输，系统设置为自动编号时非必输；修改时必传示例：UO-366420210609000004
invoiceTitle	发票抬头	1	单据编码，以系统编码规则配置为准：系统设置为手工编号时必输，系统设置为自动编号时非必输；修改时必传示例：UO-366420210609000004
taxNum	纳税人识别号	1	单据编码，以系统编码规则配置为准：系统设置为手工编号时必输，系统设置为自动编号时非必输；修改时必传示例：UO-366420210609000004
invoiceTelephone	营业电话	1	单据编码，以系统编码规则配置为准：系统设置为手工编号时必输，系统设置为自动编号时非必输；修改时必传示例：UO-366420210609000004
bankName	开户银行	银行	单据编码，以系统编码规则配置为准：系统设置为手工编号时必输，系统设置为自动编号时非必输；修改时必传示例：UO-366420210609000004
subBankName	银行支行	银行支行	单据编码，以系统编码规则配置为准：系统设置为手工编号时必输，系统设置为自动编号时非必输；修改时必传示例：UO-366420210609000004
bankAccount	银行账号	1	单据编码，以系统编码规则配置为准：系统设置为手工编号时必输，系统设置为自动编号时非必输；修改时必传示例：UO-366420210609000004
invoiceAddress	营业地址	地址	单据编码，以系统编码规则配置为准：系统设置为手工编号时必输，系统设置为自动编号时非必输；修改时必传示例：UO-366420210609000004
agentId	客户	_findCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}	客户，传id或者code 示例：2282507926999296
settlementOrgId	开票组织	findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}	开票组织，传id或者code 示例：2282800216593664
source	单据来源	4	单据来源, 0：PC、1：移动、2：导入、3：ERP、4：OPENAPI、示例：0
orderPrices!currency	币种	CNY	币种，传id或者code 示例：2281153755730176
orderPrices!exchRate	汇率	1	汇率示例：1
orderPrices!exchangeRateType	汇率类型	01	汇率类型，传id或者code 示例：0000KPC165PABLPTS60000
orderPrices!natCurrency	本币	CNY	本币，传id或者code 示例：2281153755730176
orderPrices!taxInclusive	单价含税	true	单价含税示例：true
invoiceAgentId	开票客户	_findCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}	开票客户，传id或者code 示例：2282507926999296
invoiceUpcType	发票类型	1	发票类型, 0:收据、1:增值税专用发票、2:增值税普通发票、3:增值税电子普通发票、4:机动车销售销售统一发票、示例：0
payMoney	合计含税金额	{{batch_details.paid}}	合计含税金额。可精确到6位小数，需等于表体含税金额的合计。示例：77.28
orderDetails	销售订单子表	details_list	销售订单子表[voucher.order.OrderDetail]
orderDetails.stockId	仓库	{{details_list.warehouse_no}}	仓库，传id或者code 示例：aaa
orderDetails.isExpiryDateManage	是否有效期管理	true	是否有效期管理, true:是、false:否、示例：false
orderDetails.orderDetailPrices!natSum	本币含税金额	function round({{details_list.total_amount}},2)	本币含税金额示例：77.28
orderDetails.orderDetailPrices!natMoney	本币无税金额	_function round({{details_list.total_amount}}/(1+{{details_list.tax_rate}}),2)	本币无税金额示例：73.6
orderDetails.productId	商品	{{details_list.spec_no}}	商品，传id或者code 示例：2293858192511232
orderDetails.masterUnitId	主计量单位	findCollection find code from f9eedcc9-f1ff-31c0-9081-6aee9cf21740 where name={{details_list.unit_name}}	主计量单位，传id或者code 示例：2281391353483520
orderDetails.invExchRate	销售换算率	1	销售换算率示例：4
orderDetails.unitExchangeTypePrice	浮动（销售）		浮动（销售）示例：0
orderDetails.orderDetailPrices!oriTax	税额	_function abs(round({{details_list.total_amount}}/(1+{{details_list.tax_rate}}),2)-{{details_list.total_amount}})	税额示例：3.68
orderDetails.iProductAuxUnitId	销售单位	findCollection find code from f9eedcc9-f1ff-31c0-9081-6aee9cf21740 where name={{details_list.unit_name}}	销售单位，传id或者code 示例：2281391349666048
orderDetails.orderDetailPrices!natUnitPrice	本币无税单价	_function round(({{details_list.total_amount}}/{{details_list.goods_count}})/(1+{{details_list.tax_rate}}),2)	本币无税单价示例：3.2
orderDetails.invPriceExchRate	计价换算率	1	计价换算率示例：1
orderDetails.isBatchManage	是否批次管理	true	是否批次管理, true:是、false:否、示例：false
orderDetails.oriSum	含税金额	function round({{details_list.total_amount}},2)	含税金额。可精确到6位小数。示例：77.28
orderDetails.orderDetailPrices!oriMoney	无税金额	_function round({{details_list.total_amount}}/(1+{{details_list.tax_rate}}),2)	无税金额示例：73.6
orderDetails.priceQty	计价数量	{{details_list.goods_count}}	计价数量示例：23
orderDetails.stockOrgId	库存组织	findCollection find org_code from 4f73f755-1c4f-33e6-b5a1-7e3b8d894800 where code={{warehouse_no}}	库存组织id或库存组织code 示例：2282800216593664
orderDetails.iProductUnitId	计价单位	_findCollection find code from f9eedcc9-f1ff-31c0-9081-6aee9cf21740 where name={{details_list.unit_name}}	计价单位，传id或者code 示例：2281391353483520
orderDetails.orderDetailPrices!natTaxUnitPrice	本币含税单价	function round(({{details_list.total_amount}}/{{details_list.goods_count}}),2)	本币含税单价示例：3.36
orderDetails.orderProductType	商品售卖类型	SALE	商品售卖类型, SALE:销售品、GIFT:赠品、MARKUP:加价购、REBATE:返利商品、示例：SALE
orderDetails.subQty	销售数量	{{details_list.goods_count}}	销售数量示例：5.75
orderDetails.consignTime	计划发货日期	{{consign_time_new}}	计划发货日期,格式为:yyyy-MM-dd HH:mm:ss 示例：2021-06-23 00:00:00
orderDetails.skuId	商品SKUid或SKUcode	{{details_list.spec_no}}	商品SKUid或SKUcode 示例：2293858201112832
orderDetails.taxId	税目税率	{{details_list.tax_rate}}	税目税率，传id或者code 示例：2281153771049217
orderDetails.qty	数量	{{details_list.goods_count}}	数量示例：23
orderDetails.settlementOrgId	开票组织	_findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}	开票组织，传id或者code 示例：2282800216593664
orderDetails.oriTaxUnitPrice	含税成交价	function round({{details_list.total_amount}}/{{details_list.goods_count}},2)	含税成交价，可精确到6位小数示例：3.36
orderDetails.orderDetailPrices!natTax	本币税额	_function abs(round({{details_list.total_amount}}/(1+{{details_list.tax_rate}}),2)-{{details_list.total_amount}})	本币税额示例：3.68
orderDetails.unitExchangeType	浮动（计价）		浮动（计价）示例：0
orderDetails.orderDetailPrices!oriUnitPrice	无税成交价	function round(({{details_list.total_amount}}/{{details_list.goods_count}})/(1+{{details_list.tax_rate}}),2)	无税成交价示例：3.2
orderDetails.salesOrgId	销售组织	_findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}	销售组织，传id或者code 示例：2282800216593664
orderDetails.bodyFreeItem!define1	子订单号	{{details_list.src_oid}}	销售组织，传id或者code 示例：2282800216593664
orderDetails.bodyFreeItem!define2	原始订单号	{{details_list.src_tid}}	销售组织，传id或者code 示例：2282800216593664
orderDetails.status	操作标识	Insert	操作标识, Insert:新增、Update:更新示例：Insert
orderDetails.memo	备注	{{details_list.remark}}
orderDetails._status	操作标识	Insert	操作标识, Insert:新增、Update:更新示例：Insert
orderDetails.memo	备注	{{cs_remark}}	备注示例：222222
orderDetails.headFreeItem!define1	销售类型	{{trade_type}}
orderDetails.wdt_xsckd	旺店通销售出库单	{{stockout_no}}
orderDetails.headFreeItem!define2	原始单号	{{details_list.src_tid}}

系统对接概况

通过数据集成平台可视化的快速配置调用接口打通旺店通·企业奇门与用友BIP之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。