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

接入系统：旺店通·企业奇门

慧策最先以旺店通ERP切入商家核心管理痛点——订单管理，之后围绕电商经营管理中的核心管理诉求，先后布局流量获取、会员管理、仓库管理等其他重要经营模块。慧策的产品线从旺店通ERP起步，向前向后延伸，全面布局零售企业经营，整体构建一体化智能零售解决方案，打破数据孤岛，AI植入系统，实现智能决策，助力零售企业智能化转型。当前旗下拥有店+小程序、数智门店POS、旺店通ERP、旺店通WMS、卡米全渠道、客优CRM、云筹大数据等多个PssS、SaaS产品，从前端吸引流量到后端集约化管理，助力企业智慧决策

对接目标平台:用友BIP

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

接口方案配置

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

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

调用接口：wdt.stockout.order.query.return
接口名称：查询采购退货单
方法：POST

请求参数

字段字段名称类型配置值 start_time开始时间string{{LAST_SYNC_TIME datetime}} end_time结束时间string{{CURRENT_TIME datetime}} warehouse_no仓库编号string status出库单状态string110 page_no页号string{{PAGINATION_START_PAGE}} page_size分页大小string{{PAGINATION_PAGE_SIZE}} src_order_no上层单据编号string

响应参数

字段字段名称类型配置值 stockout_id出库单主键idstring order_no出库单号string src_order_no源单号string warehouse_no仓库编号string status状态string consign_time出库时间string order_type源单据类别string order_type_name源单据类型名称string subtype出库子类型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 stockout_reason出库原因string outer_no外部单号string operator_name操作人string receiver_area省市区string return_no采购退货单号string provider_no供应商编号string provider_name供应商名称string pr_api_outer_no采购退货单外部单号string last_load_purchase_no最后引用采购单号string picklist_print_status分拣单打印状态string logistics_print_status物流单打印状态string sendbill_print_status发货单打印状态string stockout_no出库单号string src_order_id源单据idstring wms_status处理状态string error_info错误信息string warehouse_type仓库类别string warehouse_id出库的仓库idstring customer_id客户idstring freeze_reason冻结原因string is_allocated是否分配string consign_status出库状态string ebill_status面单状态string operator_id制单人string goods_type_count货品种类数量string md5_strMD5字符串值string raw_goods_count预留字段string custom_type出库类别string receiver_ring接收环string to_deliver_time配送时间string pre_charge_time配送中心string logistics_id物流公司idstring unknown_goods_amount未知成本销售总额string calc_post_cost预估邮费成本string post_cost邮费成本string calc_weight预估重量string post_weight快递给的重量string package_id包装string package_cost包装成本string has_invoice是否包含发票string printer_id打单员string pick_error_count拣货出错次数string picker_id拣货操作员idstring sorter_id包裹分拣员idstring examiner_id验货操作员idstring consigner_id发货人idstring packager_id打包员string pack_score打包积分string pick_score拣货积分string checkouter_id签出员工idstring watcher_id监视员string picklist_no分拣单编号string picklist_seq分拣单中序号string invoice_print_status发票打印状态string flag_id颜色标记string logistics_template_id物流单模板idstring sendbill_template_id发货单模板idstring pos_allocate_mode货位分配方式string note_count便签条数string reason_id出库原因string lock_id锁定策略idstring reserve保留string block_reason截停原因string stock_check_time出库单审核时间string details_list货品列表节点array details_list.stockout_id出库单主键idstring details_list.goods_count货品数量string details_list.weight重量string details_list.remark备注string details_list.modified最后修改时间string details_list.src_order_type源单据类别string details_list.batch_no批次号string details_list.rec_id出库明细主键idstring details_list.spec_no商家编码string details_list.sell_price销售价string details_list.brand_no品牌编号string details_list.brand_name品牌名称string details_list.goods_name货品名称string details_list.goods_no货品编号string details_list.spec_name规格名称string details_list.spec_code规格编号string details_list.cost_price成本价string details_list.total_amount总货款string details_list.goods_type货品类别string details_list.goods_unit单位名称string details_list.batch_remark批次备注string details_list.expire_date有效期string details_list.goods_id货品idstring details_list.spec_id规格idstring details_list.src_order_detail_id源单据细节idstring details_list.base_unit_id基本单位string details_list.unit_id辅助单位string details_list.unit_ratio单位换算string details_list.num2辅助数量string details_list.num货品数量string details_list.price价格string details_list.batch_id出库批次string details_list.is_examined是否验货string details_list.is_package是否包装string details_list.is_zero_cost是否允许0成本string details_list.scan_type类型string details_list.created创建时间string details_list.position_list货位列表节点array details_list.position_list.position_id货位IDstring details_list.position_list.position_no货位编号string details_list.position_list.position_goods_count货位出库数量string

用友BIP接口明细

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

请求参数

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

系统打通概况

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

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