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

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

MES与ERP集成

来源系统:旺店通·企业奇门

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

接入系统:用友BIP

用友BIP助力行业龙头企业、产业链核心企业以及平台型企业建设产业互联网运营平台,通过运营、管理、协同配置和共享资源,实现产业链上下游连接与协同,并保障安全。

数据集成方案配置

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

系统接口对接

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

  • 接口: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状态string5已取消,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出库单主键idstring出库单主键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订单类型string1网店销售 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实际重量stringERP系统称重功能记录的重量,如果没有使用称重功能默认使用货品档案维护的预估重量
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发票IDstring发票ID,目前只设0-1,1表示已开发票
delivery_term发货条件string发货条件 1款到发货 2货到付款(包含部分货到付款) 3分期付款 4挂账单
fenxiao_type分销类别string0 非分销订单 1 转供销 2 代销 3经销
fenxiao_nick分销商IDstring分销订单的分销商id,或转供销时供应商id
cod_amount货到付款金额string货到付款金额
id_card_type证件类别string1 身份证
receiver_area收件人地址string省市区空格分隔
shop_remark店铺备注string店铺备注
modified最后修改时间string最后修改时间   时间格式:yyyy-MM-dd HH:mm:ss
platform_id平台idstring平台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出库仓库idstring出库的仓库id
customer_id客户idstring客户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_strMD5字符串值stringMD5字符串值,用于单据排序
custom_type其他出库自定义子类别string其他出库自定义子类别0,1,2,3,4
receiver_ring京东三环内string京东三环内
to_deliver_time配送时间string配送时间,如周末
pre_charge_time配送中心string配送中心
logistics_id物流公司IDstring物流公司ID
unknown_goods_amount未知成本销售总额string未知成本销售总额
calc_post_cost预估邮费成本string预估邮费成本
post_cost邮费成本string邮费成本
calc_weight预估重量string预估重量
post_weight快递重量string快递给的重量
package_id包装idstring包装id
package_cost包装成本string包装成本
has_invoice是否包含发票string是否包含发票
printer_id打单员string打单员
pick_error_count拣货出错次数string拣货出错次数
picker_id拣货员idstring拣货操作员ID
sorter_id分拣员idstring包裹分拣员id
examiner_id验货员idstring验货操作员id
consigner_id发货人idstring发货人id
packager_id打包员idstring打包id
pack_score打包积分string打包积分
pick_score拣货积分string拣货积分
checkouter_id签出员工idstring签出员工id
watcher_id监视员idstring监视员
picklist_no分拣单编号string分拣单编号
picklist_seq分拣序号string订单在分拣单中序号
invoice_print_status发票打印状态string发票打印状态
flag_id颜色string颜色
logistics_template_id物流单模板idstring物流单模板id
sendbill_template_id发货单模板idstring发货单模板id
pos_allocate_mode货位分配方式string货位分配方式:0系统自动分配, 1手动指定货位分配 2手动指定有效期批次货位 3其它出库优化使用出库货位 4按批次出库
note_count便签条数string便签条数
reason_id其他出库原因string其他出库原因
lock_id锁定策略idstring锁定策略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打印批次stringERP中的单据的打印批次信息,如需该字段,请升级至2.4.0.8版本及以上
sendbill_print_status发货单打印状态string0未打印 1打印中 2已打印 3无需打印
logistics_print_status物流单打印状态string0未打印 1打印中 2已打印 3无需打印
picklist_print_status分拣单打印状态string0未打印 1打印中 2已打印 3无需打印
details_list货品列表节点array货品列表节点
details_list.rec_id出库明细主键string出库明细主键
details_list.stockout_id出库单主键idstring出库单主键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货品idstring货品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单据内部来源string1手机订单 2聚划算 4服务子订单 8家装 16二次付款 32开具电子发票 1024库存不足 2048当日达 4096次日达 8192预约时效
details_list.src_order_type源单据类别string源单据类别 以主单为准
details_list.src_order_detail_idsales_trade_order表的主键stringsales_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扫描方式string0未验货,1扫描验货,2手工验货,3快速验货,4无需验货
details_list.good_prop1货品档案自定义属性1string货品档案自定义属性1
details_list.good_prop2货品档案自定义属性2string货品档案自定义属性2
details_list.good_prop3货品档案自定义属性3string货品档案自定义属性3
details_list.good_prop4货品档案自定义属性4string货品档案自定义属性4
details_list.good_prop5货品档案自定义属性5string货品档案自定义属性5
details_list.good_prop6货品档案自定义属性6string货品档案自定义属性6
details_list.prop1单品列表自定义属性1string单品列表自定义属性1
details_list.prop2单品列表自定义属性2string单品列表自定义属性2
details_list.prop3单品列表自定义属性3string单品列表自定义属性3
details_list.prop4单品列表自定义属性4string单品列表自定义属性4
details_list.prop5单品列表自定义属性5string单品列表自定义属性5
details_list.prop6单品列表自定义属性6string单品列表自定义属性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货位IDstring货位ID
details_list.position_list.position_no货位编号string货位编号
details_list.position_list.stockout_order_detail_id出库单明细idstring出库单明细id
details_list.position_list.rec_id货位主键idstring货位主键id
details_list.position_list.stockin_detail_id入库单明细idstring入库单明细id
details_list.position_list.num货品数量string货品数量
details_list.position_list.stock_spec_detail_id入库单号明细idstring入库单号明细id
details_list.position_list.batch_id批次idstring批次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货位出库数量

用友BIP接口明细

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

请求参数

字段名称类型描述
resubmitCheckKey保证请求的幂等性string保证请求的幂等性,该值由客户端生成,并且必须是全局唯一的,长度不能超过32位。更多信息,请参见«MDD幂等性»
salesOrgId销售组织string销售组织,传id或者code    示例:2282800216593664
transactionTypeId交易类型string交易类型,传id或者code    示例:2291507369660672
bizFlowbizFlowstring流程ID
bizFlow_versionbizFlow_versionstring
vouchdate单据日期string单据日期,格式为:yyyy-MM-dd HH:mm:ss    示例:2021-06-09 00:00:00
code单据编码string单据编码,以系统编码规则配置为准:系统设置为手工编号时必输,系统设置为自动编号时非必输;修改时必传    示例:UO-366420210609000004
invoiceTitle发票抬头string单据编码,以系统编码规则配置为准:系统设置为手工编号时必输,系统设置为自动编号时非必输;修改时必传    示例:UO-366420210609000004
taxNum纳税人识别号string单据编码,以系统编码规则配置为准:系统设置为手工编号时必输,系统设置为自动编号时非必输;修改时必传    示例:UO-366420210609000004
invoiceTelephone营业电话string单据编码,以系统编码规则配置为准:系统设置为手工编号时必输,系统设置为自动编号时非必输;修改时必传    示例:UO-366420210609000004
bankName开户银行string单据编码,以系统编码规则配置为准:系统设置为手工编号时必输,系统设置为自动编号时非必输;修改时必传    示例:UO-366420210609000004
subBankName银行支行string单据编码,以系统编码规则配置为准:系统设置为手工编号时必输,系统设置为自动编号时非必输;修改时必传    示例:UO-366420210609000004
bankAccount银行账号string单据编码,以系统编码规则配置为准:系统设置为手工编号时必输,系统设置为自动编号时非必输;修改时必传    示例:UO-366420210609000004
invoiceAddress营业地址string单据编码,以系统编码规则配置为准:系统设置为手工编号时必输,系统设置为自动编号时非必输;修改时必传    示例:UO-366420210609000004
agentId客户string客户,传id或者code    示例:2282507926999296
settlementOrgId开票组织string开票组织,传id或者code    示例:2282800216593664
source单据来源string单据来源, 0:PC、1:移动、2:导入、3:ERP、4:OPENAPI、    示例:0
orderPrices!currency币种string币种,传id或者code    示例:2281153755730176
orderPrices!exchRate汇率 string汇率    示例:1
orderPrices!exchangeRateType汇率类型string汇率类型,传id或者code    示例:0000KPC165PABLPTS60000
orderPrices!natCurrency本币string本币,传id或者code    示例:2281153755730176
orderPrices!taxInclusive单价含税 string单价含税    示例:true
invoiceAgentId开票客户string开票客户,传id或者code    示例:2282507926999296
invoiceUpcType发票类型string发票类型, 0:收据、1:增值税专用发票、2:增值税普通发票、3:增值税电子普通发票、4:机动车销售销售统一发票、    示例:0
payMoney合计含税金额string合计含税金额。可精确到6位小数,需等于表体含税金额的合计。    示例:77.28
orderDetails销售订单子表array销售订单子表[voucher.order.OrderDetail]
orderDetails.stockId仓库string仓库,传id或者code    示例:aaa
orderDetails.isExpiryDateManage是否有效期管理string是否有效期管理, true:是、false:否、    示例:false
orderDetails.orderDetailPrices!natSum本币含税金额  string本币含税金额    示例:77.28
orderDetails.orderDetailPrices!natMoney本币无税金额   string本币无税金额    示例:73.6
orderDetails.productId商品string商品,传id或者code    示例:2293858192511232
orderDetails.masterUnitId主计量单位string主计量单位,传id或者code    示例:2281391353483520
orderDetails.invExchRate销售换算率 string销售换算率    示例:4
orderDetails.unitExchangeTypePrice浮动(销售)string浮动(销售)    示例:0
orderDetails.orderDetailPrices!oriTax税额 string税额    示例:3.68
orderDetails.iProductAuxUnitId销售单位string销售单位,传id或者code    示例:2281391349666048
orderDetails.orderDetailPrices!natUnitPrice本币无税单价 string本币无税单价    示例:3.2
orderDetails.invPriceExchRate计价换算率string计价换算率    示例:1
orderDetails.isBatchManage是否批次管理string是否批次管理, true:是、false:否、    示例:false
orderDetails.oriSum含税金额string含税金额。可精确到6位小数。     示例:77.28
orderDetails.orderDetailPrices!oriMoney无税金额 string无税金额    示例:73.6
orderDetails.priceQty计价数量 string计价数量    示例:23
orderDetails.stockOrgId库存组织string库存组织id或库存组织code    示例:2282800216593664
orderDetails.iProductUnitId计价单位string计价单位,传id或者code    示例:2281391353483520
orderDetails.orderDetailPrices!natTaxUnitPrice本币含税单价 string本币含税单价    示例:3.36
orderDetails.orderProductType商品售卖类型string商品售卖类型, SALE:销售品、GIFT:赠品、MARKUP:加价购、REBATE:返利商品、    示例:SALE
orderDetails.subQty销售数量  string销售数量    示例:5.75
orderDetails.consignTime计划发货日期string计划发货日期,格式为:yyyy-MM-dd HH:mm:ss    示例:2021-06-23 00:00:00
orderDetails.skuId商品SKUid或SKUcode  string商品SKUid或SKUcode    示例:2293858201112832
orderDetails.taxId税目税率string税目税率,传id或者code    示例:2281153771049217
orderDetails.qty数量   string数量    示例:23
orderDetails.settlementOrgId开票组织string开票组织,传id或者code    示例:2282800216593664
orderDetails.oriTaxUnitPrice含税成交价string含税成交价,可精确到6位小数    示例:3.36
orderDetails.orderDetailPrices!natTax本币税额  string本币税额    示例:3.68
orderDetails.unitExchangeType浮动(计价) string浮动(计价)    示例:0
orderDetails.orderDetailPrices!oriUnitPrice无税成交价string无税成交价    示例:3.2
orderDetails.salesOrgId销售组织string销售组织,传id或者code    示例:2282800216593664
orderDetails.bodyFreeItem!define1子订单号string销售组织,传id或者code    示例:2282800216593664
orderDetails.bodyFreeItem!define2原始订单号string销售组织,传id或者code    示例:2282800216593664
orderDetails._status操作标识string操作标识, Insert:新增、Update:更新    示例:Insert
orderDetails.memo备注string
orderDetails._status操作标识string操作标识, Insert:新增、Update:更新    示例:Insert
orderDetails.memo备注  string备注    示例:222222
orderDetails.headFreeItem!define1销售类型string
orderDetails.wdt_xsckd旺店通销售出库单string
orderDetails.headFreeItem!define2原始单号string

数据对接效果

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

数据集成平台

系统数据对接方案元数据代码

联系我们

轻易云数据集成顾问,为您定制行业化集成解决方案

彭萍

19521079114

数据集成顾问

吕修远

13825030695

数据集成顾问

卢剑航

13760755942

数据集成顾问