用友BIP和旺店通·企业奇门单据接口集成

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

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

接通系统：用友BIP

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

数据接口配置方案

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

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

API：wdt.stockin.order.query.purchase
NAME：查询采购入库单
METHOD：POST

请求参数

接口字段字段名称预设值描述 start_time开始时间{{LAST_SYNC_TIME datetime}}增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss end_time结束时间{{CURRENT_TIME datetime}}增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss status状态60,80入库单状态 10已取消20编辑中25待价格确认30待审核60待结算80已完成（默认80） src_order_no上层单据编号上层单据编号，默认为采购单号，传该字段可以不传开始时间和结束时间 warehouse_no仓库编号代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号) page_size分页大小{{PAGINATION_PAGE_SIZE}}每页返回的数据条数，输入值范围1_{100，不传本参数，输入值默认为40，使用举例单击这里} page_no页号{{PAGINATION_START_PAGE}}不传值默认从0页开始

响应参数

接口字段字段名称预设值描述 stockin_id入库单主键id入库单主键id order_no入库单号入库单号 status状态10已取消20编辑中25待价格确认30待审核60待结算80已完成 warehouse_no仓库编号代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置） warehouse_name仓库仓库 stockin_time修改时间修改时间，格式：yyyy-MM-dd HH:mm:ss check_time审核时间审核时间，格式：yyyy-MM-dd HH:mm:ss created_time创建时间创建时间，格式：yyyy-MM-dd HH:mm:ss src_order_no采购单号采购单号 remark备注备注 stockin_reason入库原因入库原因 order_type入库类型入库类型（该接口只返回采购入库类型） order_type_name入库类型名称入库类型名称（默认为采购入库） goods_amount货款总额货款总额 total_price总成本总成本 discount优惠优惠 tax_amount税后金额税后金额 post_fee邮费邮费 other_fee其他费用其他费用 logistics_type物流类型物流方式，详情介绍，单击这里 logistics_code物流公司编号旺店通系统内物流公司编号 logistics_name物流公司名称旺店通系统内物流公司名称 logistics_no物流单号物流单号 purchase_no采购单编号采购单编号 provider_no供应商编号供应商编号 provider_name供应商名称供应商名称 outer_no外部单号上层单据的采购单号可做该入库单的外部单号 goods_count货品总数量货品总数量 adjust_num纠错数量调整量，正数或者负数 adjust_price纠错金额纠错金额 right_nums调整后数量调整后数量 right_price调整后总金额调整后总金额 stockin_no入库单号入库单号 wms_outer_no仓储外部编号默认为''，仓储外部编号 wms_status外部状态默认为'0'，外部状态,与wms对接使用 0初始化 1失败 2成功 wms_result外部结果默认为''，外部结果,与wms对接使用 warehouse_id仓库id默认为'0'，仓库id src_order_type源单据类型1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库 src_order_id源单据id默认为'0'，源单据id reason_id原因默认为'0'，原因 fa_status财务同步状态默认为'0'，财务同步状态 logistics_id物流公司默认为'0'，物流公司 post_share_type邮费分摊类型默认为'0'，邮费分摊类型0,不分摊 1,按数量分摊2,按照金额分摊 operator_id操作员id操作员id check_operator_id审核人id默认为'0'，审核人id goods_type_count货品种类数默认为'0'，货品种类数 note_count便签数量默认为'0'，便签数量 flag_id标记默认为'0'，标记 modified最后修改时间最后修改时间 details_list明细节点响应参数的2级数据节点，包含采购入库货品明细属性信息,节点下数据字段详见下述“details_list” details_list.stockin_id入库单主键id入库单主键id details_list.rec_id入库明细主键入库明细主键 details_list.src_order_detail_id上层单据明细主键上层单据明细主键 details_list.spec_no商家编码代表单品(sku)所有属性的编码，SKU概念介绍,单击这里 details_list.goods_count货品数量货品数量 details_list.discount优惠金额优惠金额 details_list.cost_price单价单价 details_list.production_date生产日期生产日期，格式：yyyy-MM-dd HH:mm:ss details_list.validity_days有效期天数有效期天数 details_list.expire_date有效期有效期，格式：yyyy-MM-dd HH:mm:ss details_list.src_price原价原价 details_list.tax_price税后价税后价 details_list.tax_amount税后金额税后金额 details_list.tax税率税率 details_list.total_cost总成本总成本 details_list.remark备注备注 details_list.adjust_num纠错数量调整量，正数或者负数 details_list.adjust_price纠错金额纠错金额 details_list.right_num调整后数量调整后数量 details_list.right_price调整后单价调整后单价 details_list.right_cost调整后总金额调整后总金额 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.prop2自定义属性自定义属性 details_list.goods_unit单位名称单位名称 details_list.batch_no批次号批次号 details_list.batch_remark批次备注批次备注 details_list.position_no货位编号货位编号 details_list.src_order_type源单据类型1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库 details_list.org_stockin_detail_id原始入库单明细默认为'0'，原始入库单明细 details_list.spec_id规格id规格id details_list.batch_id批次默认为'0'，批次 details_list.position_id货位id默认为'0'，货位ID，入库时默认ID details_list.num数量默认为'0.0000'，数量 details_list.num2数量2默认为'0.0000'，辅助数量 details_list.unit_id辅助单位默认为'0'，辅助单位 details_list.base_unit_id基本单位默认为'0'，基本单位 details_list.unit_ratio单位换算关系默认为'1.0000'，单位换算关系 details_list.expect_num预期入库数量默认为'0.0000'，预期入库数量 details_list.cost_price2辅助成本价默认为'0.0000'，辅助成本价 details_list.share_post_cost邮资分摊成本默认为'0.0000'，邮资分摊成本 details_list.share_post_total邮资分摊总成本默认为'0.0000'，邮资分摊总成本 details_list.modified最后修改时间最后修改时间 details_list.created创建时间创建时间

用友BIP接口明细

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

请求参数

接口字段字段名称预设值描述 resubmitCheckKey保证请求的幂等性{{order_no}}该值由客户端生成,并且必须是全局唯一的长度不能超过32位。更多信息,请参见«MDD幂等性» mergeSourceData合并上游数据true固定值传入true。 needCalcLines表体行计算标识true固定值传入true。 calcLinesKey表体行计算依据oriTaxUnitPrice固定值传入true。 code单据编号{{order_no}}以系统编码规则配置为准：系统设置为手工编号时必输。系统设置为自动编号时非必输 vouchdate单据日期{{check_time date}}日期格式:YYYYMMDD bustype交易类型idA15001或交易类型code；业务流中未配置交易类型且未设置默认交易类型时必输。 warehouse仓库id{{warehouse_no}}或仓库code；上游单据未指定仓库时必输 memo备注{{remark}} status操作标识InsertInsert:新增 purInRecords采购入库单子表details_list purInRecords.makeRuleCode生单规则编码st_purchaseorder固定值。订单入库：st_purchaseorder订单退库：st_purchaseorder3，退货入库：st_purchaseorder_return，到货入库：pu_arrivalorder purInRecords.sourceid上游单据主表id_findCollection find new_id from ff40fed7-afb6-3d42-b3cb-da2ef31b5d3a where code={{src_order_no}} product_cCode={{details_list.goods_no}} purInRecords.sourceautoid上游单据子表idfindCollection find new_purchaseOrders_id from ff40fed7-afb6-3d42-b3cb-da2ef31b5d3a where code={{src_order_no}} product_cCode={{details_list.goods_no}} purInRecords.qty数量{{details_list.right_num}}默认上游带入，若传入数量请确保表体行计算标识needCalcLines=true，并确认calcLinesKey是否符合实际业务场景 purInRecords.oriTaxUnitPrice含税单价_findCollection find oriTaxUnitPrice from ff40fed7-afb6-3d42-b3cb-da2ef31b5d3a where code={{src_order_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和旺店通·企业奇门单据接口集成