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

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

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

对接目标平台:用友BIP

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

数据对接方案

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：旺店通·企业奇门，然后选择对应的连接器。选择对应的wdt.purchase.return.query作为数据对接来源。然后再写入目标平台配置目标系统为用友BIP，并且选择对应连接器（关于用友BIP的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的/yonbip/scm/purinrecord/mergeSourceData/save接口作为数据写入动作完成第一步的接口配置。

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

API：wdt.stockout.order.query.return
NAME：查询采购退货单
METHOD：POST

请求参数

接口字段字段名称预设值描述 start_time开始时间{{LAST_SYNC_TIME datetime}} end_time结束时间{{CURRENT_TIME datetime}}按最后修改时间增量获取数据,end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss warehouse_no仓库编号 status出库单状态出库单状态5：已取消，50：待审核，55：已审核，95：已发货，110：已完成（默认查已发货已完成单据） page_no页号{{PAGINATION_START_PAGE}} page_size分页大小{{PAGINATION_PAGE_SIZE}}每页返回的数据条数，输入值范围1_{30，不传本参数，输入值默认为30，} src_order_no上层单据编号

响应参数

接口字段字段名称预设值描述 stockout_id出库单主键id出库单主键id order_no出库单号系统出库单号，默认为CK开头 src_order_no源单号该源单号为退货单号 warehouse_no仓库编号代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置） status状态出库状态 consign_time出库时间出库时间，格式：yyyy-MM-dd HH:mm:ss order_type源单据类别源单据类别 1销售订单, 2调拨出库, 3采购退货出库, 4盘亏出库, 5生产出库, 6现款销售出库, 7其他出库, 8多发出库, 9纠错出库,10保修配件出库, 11初始化出库, 12jit拣货出库 13委外出库 order_type_name源单据类型名称源单据类型名称 subtype出库子类型出库子类型 goods_total_amount货品总售价货品总售价 goods_total_cost货品总成本货品总成本 post_fee邮费邮费 logistics_no物流编号代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置） package_fee包装费包装费 receiver_name收件人该字段已废弃 receiver_country国家国家 receiver_province省份省份 receiver_city城市城市 receiver_district地区地区 receiver_address详细地址该字段已废弃 receiver_mobile收件人移动电话该字段已废弃 receiver_telno收件人固定电话该字段已废弃 receiver_zip邮编邮编 stockout_reason出库原因出库原因 outer_no外部单号外部单号 operator_name操作人操作人 receiver_area省市区省市区空格分开 return_no采购退货单号采购退货单号 provider_no供应商编号代表供应商所有属性的唯一编码，用于供应商区分，ERP内支持自定义（ERP供应商界面设置） provider_name供应商名称供应商名称 pr_api_outer_no采购退货单外部单号采购退货单的外部单号 last_load_purchase_no最后引用采购单号最后引用采购单号 picklist_print_status分拣单打印状态默认为'0'，分拣单打印状态 0未打印 1打印中 2已打印 3无需打印 logistics_print_status物流单打印状态默认为'0'，物流单打印状态，0未打印 1打印中 2已打印 3无需打印 sendbill_print_status发货单打印状态默认为'0'，发货单打印状态，0未打印 1待打中 2已打印 3无需打印 stockout_no出库单号出库单号 src_order_id源单据id源单据id wms_status处理状态处理状态 0 待处理 1 推送失败 2 推送成功 3 接口取消成功系统驳回失败 4 服务器正在处理 5 WMS返回发货信息 6 异步标记,推送申请成功 error_info错误信息接口处理错误信息 warehouse_type仓库类别默认为'0'，仓库类别 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默认为'0'，客户id freeze_reason冻结原因默认为'0'，冻结原因 is_allocated是否分配默认为'0'，是否分配 consign_status出库状态默认为'0'，出库状态 1验货 2称重 4出库 8物流同步 16分拣 32档口, 64拣货 ebill_status面单状态默认为'0'，电子面单,获取状态 operator_id制单人默认为'0'，制单人 goods_type_count货品种类数量默认为'0'，货品种类数量 md5_strMD5字符串值默认为''，MD5字符串值,用于单据排序 raw_goods_count预留字段默认为'0'，预留字段 custom_type出库类别默认为'0'，其他出库自定义子类别0，1，2，3，4 receiver_ring接收环默认为''，京东三环内（未使用） to_deliver_time配送时间默认为''，配送时间 pre_charge_time配送中心默认为''，配送中心 logistics_id物流公司id默认为'0'，物流公司id unknown_goods_amount未知成本销售总额默认为'0.0000'，未知成本销售总额 calc_post_cost预估邮费成本默认为'0.0000'，预估邮费成本 post_cost邮费成本默认为'0.0000'，邮费成本 calc_weight预估重量默认为'0.0000'，预估重量 post_weight快递给的重量默认为'0.0000'，快递给的重量 package_id包装默认为'0'，包装 package_cost包装成本默认为'0.0000'，包装成本 has_invoice是否包含发票默认为'0'，是否包含发票 printer_id打单员默认为'0'，打单员 pick_error_count拣货出错次数默认为'0'，拣货出错次数 picker_id拣货操作员id默认为'0'，拣货操作员id sorter_id包裹分拣员id默认为'0'，包裹分拣员id examiner_id验货操作员id默认为'0'，验货操作员id consigner_id发货人id默认为'0'，发货人id packager_id打包员默认为'0'，打包员 pack_score打包积分默认为'0'，打包积分 pick_score拣货积分默认为'0'，拣货积分 checkouter_id签出员工id默认为'0'，签出员工id watcher_id监视员默认为'0'，监视员 picklist_no分拣单编号默认为''，分拣单编号 picklist_seq分拣单中序号默认为'0'，订单在分拣单中序号 invoice_print_status发票打印状态默认为'0'，发票打印状态 flag_id颜色标记默认为'0'，颜色标记 logistics_template_id物流单模板id默认为'0'，物流单模板id sendbill_template_id发货单模板id默认为'0'，发货单模板id pos_allocate_mode货位分配方式默认为'0'，货位分配方式：0系统自动分配, 1手动指定货位分配 2手动指定有效期批次货位 note_count便签条数默认为'0'，便签条数 reason_id出库原因默认为'0'，其他出库原因 lock_id锁定策略id默认为'0'，锁定策略id reserve保留默认为'0'，保留 block_reason截停原因默认为'0'，截停原因1申请退款2已退款4地址被修改8发票被修改16物流被修改32仓库变化64备注修改128更换货品256添加货品512放弃抢单1024其他原因2048拦截赠品4096拦截天猫换货8192买家留言变更16384货品平台规格名变更 stock_check_time出库单审核时间出库单审核时间 details_list货品列表节点响应参数的2级数据节点，包含的采购退货出库单及其明细的数据节点，节点下数据字段详见下述“detail_list”列表 details_list.stockout_id出库单主键id出库单主键id details_list.goods_count货品数量货品数量 details_list.weight重量重量 details_list.remark备注备注 details_list.modified最后修改时间最后修改时间 details_list.src_order_type源单据类别默认为'1'，源单据类别 1销售订单2,调拨出库3,采购出库4,生产出库5,盘亏出库6,其他出库 details_list.batch_no批次号批次号 details_list.rec_id出库明细主键id出库明细主键id details_list.spec_no商家编码代表单品（SKU）所有属性的唯一编号，用于系统单品的区分，SKU概念介绍单击这里 details_list.sell_price销售价销售价 details_list.brand_no品牌编号品牌编号 details_list.brand_name品牌名称品牌名称 details_list.goods_name货品名称货品名称 details_list.goods_no货品编号代表SPU所有属性的唯一编号，用于系统货品的区分，SPU概念介绍单击这里 details_list.spec_name规格名称规格名称 details_list.spec_code规格编号规格编号 details_list.cost_price成本价成本价 details_list.total_amount总货款总货款 details_list.goods_type货品类别1销售商品 2原材料 3包装 4周转材料5虚拟商品 0其它 details_list.goods_unit单位名称单位名称 details_list.batch_remark批次备注批次备注 details_list.expire_date有效期有效期，格式：yyyy-MM-dd HH:mm:ss details_list.goods_id货品id货品id details_list.spec_id规格id默认为'0'，规格id details_list.src_order_detail_id源单据细节idsales_trade_order表的主键 details_list.base_unit_id基本单位默认为'0'，基本单位 details_list.unit_id辅助单位默认为'0'，辅助单位 details_list.unit_ratio单位换算默认为'1.0000'，单位换算 details_list.num2辅助数量默认为'0.0000，辅助数量 details_list.num货品数量货品数量 details_list.price价格默认为'0.0000，最终价格 details_list.batch_id出库批次默认为'0'，指定出库批次 details_list.is_examined是否验货默认为'0'，是否验货，用于挂起，已标记为验货的不需要再验货 details_list.is_package是否包装默认为'0'，是否包装 details_list.is_zero_cost是否允许0成本默认为'0'，是否允许0成本 details_list.scan_type类型默认为'0'，0未验货,1扫描验货,2手工验货 details_list.created创建时间创建时间 details_list.position_list货位列表节点响应参数的3级数据节点，节点下数据字段详见下述“position_list”列表 details_list.position_list.position_id货位ID货位ID details_list.position_list.position_no货位编号货位编号 details_list.position_list.position_goods_count货位出库数量货位出库数量

用友BIP接口明细

API：/yonbip/scm/purinrecord/mergeSourceData/save
NAME：采购入库来源生单保存
METHOD：POST

请求参数

接口字段字段名称预设值描述 resubmitCheckKey保证请求的幂等性{{order_no}}该值由客户端生成,并且必须是全局唯一的长度不能超过32位。更多信息,请参见«MDD幂等性» mergeSourceData合并上游数据true固定值传入true。 code单据编号{{order_no}}以系统编码规则配置为准：系统设置为手工编号时必输。系统设置为自动编号时非必输 vouchdate单据日期{{consign_time}}日期格式:YYYYMMDD bustype交易类型idA15001或交易类型code；业务流中未配置交易类型且未设置默认交易类型时必输。 warehouse仓库id{{warehouse_no}}或仓库code；上游单据未指定仓库时必输 memo备注{{remark}} status操作标识InsertInsert:新增 purInRecords采购入库单子表batch_details purInRecords.makeRuleCode生单规则编码st_purchaseorder_return固定值。订单入库：st_purchaseorder订单退库：st_purchaseorder3，退货入库：st_purchaseorder_return，到货入库：pu_arrivalorder purInRecords.sourceid上游单据主表id_findCollection find new_id from 5c14ed3c-520d-3e66-9ce1-05b241f8d07b where code={{pr_api_outer_no}} product_cCode={{batch_details.goods_no}} purInRecords.sourceautoid上游单据子表idfindCollection find new_purchaseOrders_id from 5c14ed3c-520d-3e66-9ce1-05b241f8d07b where code={{pr_api_outer_no}} product_cCode={{batch_details.goods_no}} purInRecords.batchno批次号批次管理的物料必输 purInRecords.producedate生产日期效期管理的物料必输 purInRecords.goodsposition货位id或货位code；仓库为货位仓且开启了货位记存量时必输 purInRecords.qty数量_function {{batch_details.num}}*(-1)默认上游带入，若传入数量请确保表体行计算标识needCalcLines=true，并确认calcLinesKey是否符合实际业务场景 purInRecords.oriUnitPrice无税单价{{details_list.sell_price}}仅在表头参数表体行计算标识needCalcLines=true，且calcLinesKey指定当前字段为计算依据时生效。 purInRecords.oriTaxUnitPrice含税单价仅在表头参数表体行计算标识needCalcLines=true，且calcLinesKey指定当前字段为计算依据时生效。 purInRecords.natSum本币含税金额仅在表头参数表体行计算标识needCalcLines=true，且calcLinesKey指定当前字段为计算依据时生效。 purInRecords.memo备注 purInRecords._status操作标识InsertInsert:新增

数据对接价值

数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。

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