接口配置打通用友BIP和旺店通·企业奇门数据对接

接口配置打通用友BIP和旺店通·企业奇门数据对接

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

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

写入目标:用友BIP

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

配置集成方案

在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用

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

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

请求参数

字段名称类型 page_no页号string src_order_no系统订单编号string page_size分页大小string stockout_no出库单号string shop_no店铺编号string status状态string warehouse_no仓库编号string src_tid原始单号string end_time结束时间datetime 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接口明细

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

请求参数

字段名称类型 orderDetails.orderProductType商品售卖类型string orderDetails.invExchRate销售换算率 string orderDetails.settlementOrgId开票组织string orderDetails.orderDetailPrices!oriTax税额 string orderDetails.stockOrgId库存组织string payMoney合计含税金额string orderDetails.orderDetailPrices!natTax本币税额  string orderDetails.status操作标识string invoiceUpcType发票类型string resubmitCheckKey保证请求的幂等性string orderDetails.oriSum含税金额string orderDetails.masterUnitId主计量单位string bizFlowbizFlowstring orderDetails.orderDetailPrices!natTaxUnitPrice本币含税单价 string orderDetails.producedateproducedatestring orderDetails.headFreeItem!define1销售类型string orderDetails.orderDetailPrices!natSum本币含税金额  string orderDetails.qty数量   string orderDetails.stockId仓库string salesOrgId销售组织string bizFlow_versionbizFlow_versionstring orderDetails.iProductUnitId计价单位string orderPrices!exchangeRateType汇率类型string orderDetails.orderDetailPrices!oriMoney无税金额 string orderDetails.oriTaxUnitPrice含税成交价string orderDetails销售订单子表array orderDetails.priceQty计价数量 string orderDetails.productId商品string orderDetails.memo备注  string invoiceAgentId开票客户string orderDetails.salesOrgId销售组织string orderDetails.invPriceExchRate计价换算率string orderDetails.skuId商品SKUid或SKUcode  string transactionTypeId交易类型string orderDetails.unitExchangeTypePrice浮动（销售）string vouchdate单据日期string orderPrices!currency币种string agentId客户string orderPrices!natCurrency本币string orderPrices!exchRate汇率 string settlementOrgId开票组织string orderPrices!taxInclusive单价含税 string orderDetails.consignTime计划发货日期string orderDetails.iProductAuxUnitId销售单位string orderDetails.orderDetailPrices!natUnitPrice本币无税单价 string orderDetails.isBatchManage是否批次管理string orderDetails.batch_nobatch_nostring orderDetails.memo备注string code单据编码string orderDetails.invaliddateinvaliddatestring orderDetails.orderDetailPrices!natMoney本币无税金额   string orderDetails.unitExchangeType浮动（计价） string orderDetails.subQty销售数量  string orderDetails.taxId税目税率string orderDetails.orderDetailPrices!oriUnitPrice无税成交价string orderDetails.isExpiryDateManage是否有效期管理string source单据来源string orderDetails._status操作标识string

系统对接总览

异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案，可以满足客户的实际业务需求，推动软件工程的规范化，使开发人员遵循统一的概要设计开发实现，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。 资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。