旺店通·企业奇门与用友BIP对接集成查询采购退货单打通采购入库来源生单保存

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

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

对接目标平台:用友BIP

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

数据集成方案配置

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取旺店通·企业奇门的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到用友BIP中。轻易云集成平台的可视化配置轻松实现。

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

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出库单状态110出库单状态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接口明细

调用接口：/yonbip/scm/purinrecord/mergeSourceData/save
接口名称：采购入库来源生单保存
方法：POST

请求参数

字段字段名称类型配置值 resubmitCheckKey保证请求的幂等性string{{order_no}} mergeSourceData合并上游数据stringtrue needCalcLines表体行计算标识stringtrue calcLinesKey表体行计算依据stringoriTaxUnitPrice code单据编号string{{order_no}} vouchdate单据日期string{{consign_time date}} bustype交易类型idstringA20003 warehouse仓库idstring{{warehouse_no}} memo备注string{{remark}} status操作标识stringInsert purInRecords采购入库单子表arraydetails_list purInRecords.makeRuleCode生单规则编码stringst_purchaseorder_return purInRecords.sourceid上游单据主表idstring_findCollection find new_id from 5c14ed3c-520d-3e66-9ce1-05b241f8d07b where code={{pr_api_outer_no}} product_cCode={{details_list.goods_no}} purInRecords.sourceautoid上游单据子表idstringfindCollection find new_purchaseOrders_id from 5c14ed3c-520d-3e66-9ce1-05b241f8d07b where code={{pr_api_outer_no}} product_cCode={{details_list.goods_no}} purInRecords.qty数量string_function {{details_list.goods_count}}*(-1) purInRecords.oriUnitPrice无税单价string{{details_list.sell_price}} purInRecords.oriTaxUnitPrice含税单价stringfindCollection find oriTaxUnitPrice from 5c14ed3c-520d-3e66-9ce1-05b241f8d07b where code={{pr_api_outer_no}} product_cCode={{details_list.goods_no}} purInRecords.memo备注string{{details_list.remark}} purInRecords._status操作标识stringInsert

系统数据集成价值

通过数据集成平台可视化的快速配置调用接口打通旺店通·企业奇门与用友BIP之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。

旺店通·企业奇门与用友BIP对接集成查询采购退货单打通采购入库来源生单保存