从旺店通·企业奇门到用友BIP通过接口集成数据

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

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

接通系统：用友BIP

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

数据对接方案

数据集成平台对应的配置旺店通·企业奇门与用友BIP的对接只要三步就能完成两个系统之间的数据对接。第一步根据旺店通·企业奇门的接口参数要求记录在轻易云集成平台。第二步配置旺店通·企业奇门与用友BIP之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

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

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

请求参数

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

响应参数

字段名称类型描述 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接口明细

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

请求参数

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

系统数据集成价值

全新的API数据集成模式，赋能企业业务创新传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：用友BIP与旺店通·企业奇门之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。