旺店通·企业奇门和用友BIP接口打通对接实战

旺店通·企业奇门和用友BIP接口打通对接实战

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

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

对接目标系统:用友BIP

面向数智化市场，用友倾力打造了全球领先的数智商业创新平台——用友BIP，定位为数智商业的应用级基础设施、企业服务产业的共创平台，服务企业数智化转型和商业创新，让企业云服务随需而用，让数智价值无处不在，让商业创新如此便捷。

多系统对接方案配置

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：旺店通·企业奇门的接口参数设置，以及设定好目标平台：用友BIP的映射，即可启动方案进行测试

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

• 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	出库单号
shop_no	店铺编号		代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺单据数据信息
warehouse_no	仓库编号		代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号)
page_size	分页大小	{{PAGINATION_PAGE_SIZE}}	每页返回的数据条数，输入值范围1100，不传本参数，输入值默认为40，使用举例单击这里
page_no	页号	{{PAGINATION_START_PAGE}}	不传值默认从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	货位出库数量		货位出库数量

用友BIP接口明细

• 调用接口：/yonbip/sd/voucherorder/singleSave
• 接口名称：销售订单单个保存
• 方法：POST

请求参数

字段	字段名称	类型	配置值
resubmitCheckKey	保证请求的幂等性	string	{{order_no}}
salesOrgId	销售组织	string	findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}
transactionTypeId	交易类型	string	SO021
bizFlow	bizFlow	string	4420f835-f5e0-11ec-9896-6c92bf477043
bizFlow_version	bizFlow_version	string	V1.0
vouchdate	单据日期	string	{{consign_time_new}}
code	单据编码	string	{{order_no}}
invoiceTitle	发票抬头	string	1
taxNum	纳税人识别号	string	1
invoiceTelephone	营业电话	string	1
bankName	开户银行	string	银行
subBankName	银行支行	string	银行支行
bankAccount	银行账号	string	1
invoiceAddress	营业地址	string	地址
agentId	客户	string	_findCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}
settlementOrgId	开票组织	string	findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}
source	单据来源	string	4
orderPrices!currency	币种	string	CNY
orderPrices!exchRate	汇率	string	1
orderPrices!exchangeRateType	汇率类型	string	01
orderPrices!natCurrency	本币	string	CNY
orderPrices!taxInclusive	单价含税	string	true
invoiceAgentId	开票客户	string	_findCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}
invoiceUpcType	发票类型	string	1
payMoney	合计含税金额	string	{{details.details_list_paid}}
orderDetails	销售订单子表	array	details_list
orderDetails.stockId	仓库	string	{{details_list.warehouse_no}}
orderDetails.isExpiryDateManage	是否有效期管理	string	false
orderDetails.orderDetailPrices!natSum	本币含税金额	string	{{details_list.total_amount}}
orderDetails.orderDetailPrices!natMoney	本币无税金额	string	function round({{details_list.total_amount}}/(1+{{details_list.tax_rate}}/100),2)
orderDetails.productId	商品	string	{{details_list.spec_no}}
orderDetails.masterUnitId	主计量单位	string	_findCollection find code from f9eedcc9-f1ff-31c0-9081-6aee9cf21740 where name={{details_list.unit_name}}
orderDetails.invExchRate	销售换算率	string	1
orderDetails.unitExchangeTypePrice	浮动（销售）	string
orderDetails.orderDetailPrices!oriTax	税额	string	function round(({{details_list.total_amount}}{{details_list.tax_rate}}/100)/(1+{{details_list.tax_rate}}/100),2)
orderDetails.iProductAuxUnitId	销售单位	string	_findCollection find code from f9eedcc9-f1ff-31c0-9081-6aee9cf21740 where name={{details_list.unit_name}}
orderDetails.orderDetailPrices!natUnitPrice	本币无税单价	string	function {{details_list.details_list_total_amount}}/(1+{{details_list.details_list_tax_rate}}/100)
orderDetails.invPriceExchRate	计价换算率	string	1
orderDetails.isBatchManage	是否批次管理	string	false
orderDetails.oriSum	含税金额	string	{{details_list.total_amount}}
orderDetails.orderDetailPrices!oriMoney	无税金额	string	_function {{details_list.total_amount}}/(1+{{details_list.tax_rate}}/100)
orderDetails.priceQty	计价数量	string	{{details_list.goods_count}}
orderDetails.stockOrgId	库存组织	string	findCollection find org_code from 4f73f755-1c4f-33e6-b5a1-7e3b8d894800 where code={{warehouse_no}}
orderDetails.iProductUnitId	计价单位	string	_findCollection find code from f9eedcc9-f1ff-31c0-9081-6aee9cf21740 where name={{details_list.unit_name}}
orderDetails.orderDetailPrices!natTaxUnitPrice	本币含税单价	string	function round(({{details_list.total_amount}}/{{details_list.goods_count}}),6)
orderDetails.orderProductType	商品售卖类型	string	SALE
orderDetails.subQty	销售数量	string	{{details_list.goods_count}}
orderDetails.consignTime	计划发货日期	string	{{details_list.consign_time_new}}
orderDetails.skuId	商品SKUid或SKUcode	string	{{details_list.spec_no}}
orderDetails.taxId	税目税率	string	{{details_list.tax_rate}}
orderDetails.qty	数量	string	{{details_list.goods_count}}
orderDetails.settlementOrgId	开票组织	string	_findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}
orderDetails.oriTaxUnitPrice	含税成交价	string	function round({{details_list.total_amount}}/{{details_list.goods_count}},2)
orderDetails.orderDetailPrices!natTax	本币税额	string	_function round(({{details_list.total_amount}}*{{details_list.tax_rate}}/100)/(1+{{details_list.tax_rate}}/100),2)
orderDetails.unitExchangeType	浮动（计价）	string
orderDetails.orderDetailPrices!oriUnitPrice	无税成交价	string	function round(({{details_list.total_amount}}/{{details_list.goods_count}})/(1+{{details_list.tax_rate}}/100),2)
orderDetails.salesOrgId	销售组织	string	_findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}
orderDetails.status	操作标识	string	Insert
orderDetails.memo	备注	string	{{details_list.batch_no}}
orderDetails.batch_no	batch_no	string
orderDetails.producedate	producedate	string
orderDetails.invaliddate	invaliddate	string
orderDetails._status	操作标识	string	Insert
orderDetails.memo	备注	string	{{warehouse_no}}
orderDetails.headFreeItem!define1	销售类型	string	网店销售

数据对接效果

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