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

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

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

接入系统：用友BIP

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

数据集成方案配置

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

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

接口：wdt.stockin.order.query.purchase
接口名称：查询采购入库单
接口方法：POST

请求参数

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

响应参数

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

用友BIP接口明细

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

请求参数

字段名称类型描述 resubmitCheckKey保证请求的幂等性string该值由客户端生成,并且必须是全局唯一的长度不能超过32位。更多信息,请参见«MDD幂等性» mergeSourceData合并上游数据string固定值传入true。 needCalcLines表体行计算标识string固定值传入true。 calcLinesKey表体行计算依据string固定值传入true。 code单据编号string以系统编码规则配置为准：系统设置为手工编号时必输。系统设置为自动编号时非必输 vouchdate单据日期string日期格式:YYYYMMDD bustype交易类型idstring或交易类型code；业务流中未配置交易类型且未设置默认交易类型时必输。 warehouse仓库idstring或仓库code；上游单据未指定仓库时必输 memo备注string status操作标识stringInsert:新增 purInRecords采购入库单子表array purInRecords.makeRuleCode生单规则编码string固定值。订单入库：st_purchaseorder订单退库：st_purchaseorder3，退货入库：st_purchaseorder_return，到货入库：pu_arrivalorder purInRecords.sourceid上游单据主表idstring purInRecords.sourceautoid上游单据子表idstring purInRecords.qty数量string默认上游带入，若传入数量请确保表体行计算标识needCalcLines=true，并确认calcLinesKey是否符合实际业务场景 purInRecords.oriTaxUnitPrice含税单价string仅在表头参数表体行计算标识needCalcLines=true，且calcLinesKey指定当前字段为计算依据时生效。 purInRecords.memo备注string purInRecords._status操作标识stringInsert:新增

数据对接价值

通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接旺店通·企业奇门和用友BIP，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。

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