从旺店通·企业奇门到用友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 | 每页返回的数据条数,输入值范围1100,不传本参数,输入值默认为40,使用举例单击这里 |
page_no | 页号 | string | 不传值默认从0页开始 |
响应参数
字段 | 名称 | 类型 | 描述 |
stockin_id | 入库单主键id | string | 入库单主键id |
order_no | 入库单号 | string | 入库单号 |
status | 状态 | string | 10已取消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 | 仓库id | string | 默认为'0',仓库id |
src_order_type | 源单据类型 | string | 1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库 |
src_order_id | 源单据id | string | 默认为'0',源单据id |
reason_id | 原因 | string | 默认为'0',原因 |
fa_status | 财务同步状态 | string | 默认为'0',财务同步状态 |
logistics_id | 物流公司 | string | 默认为'0',物流公司 |
post_share_type | 邮费分摊类型 | string | 默认为'0',邮费分摊类型0,不分摊 1,按数量分摊2,按照金额分摊 |
operator_id | 操作员id | string | 操作员id |
check_operator_id | 审核人id | string | 默认为'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 | 入库单主键id | string | 入库单主键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 | 源单据类型 | string | 1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库 |
details_list.org_stockin_detail_id | 原始入库单明细 | string | 默认为'0',原始入库单明细 |
details_list.spec_id | 规格id | string | 规格id |
details_list.batch_id | 批次 | string | 默认为'0',批次 |
details_list.position_id | 货位id | string | 默认为'0',货位ID,入库时默认ID |
details_list.num | 数量 | string | 默认为'0.0000',数量 |
details_list.num2 | 数量2 | string | 默认为'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 | {{order_no}} |
mergeSourceData | 合并上游数据 | string | true |
needCalcLines | 表体行计算标识 | string | true |
calcLinesKey | 表体行计算依据 | string | oriTaxUnitPrice |
code | 单据编号 | string | {{order_no}} |
vouchdate | 单据日期 | string | {{check_time date}} |
bustype | 交易类型id | string | A15001 |
warehouse | 仓库id | string | {{warehouse_no}} |
memo | 备注 | string | {{remark}} |
status | 操作标识 | string | Insert |
purInRecords | 采购入库单子表 | array | batch_details |
purInRecords.makeRuleCode | 生单规则编码 | string | st_purchaseorder |
purInRecords.sourceid | 上游单据主表id | string | _findCollection find new_id from 2293f65a-b357-3bfc-b77a-e97b91d88b7f where code={{src_order_no}} product_cCode={{batch_details.goods_no}} |
purInRecords.sourceautoid | 上游单据子表id | string | findCollection find new_purchaseOrders_id from 2293f65a-b357-3bfc-b77a-e97b91d88b7f where code={{src_order_no}} product_cCode={{batch_details.goods_no}} |
purInRecords.batchno | 批次号 | string | |
purInRecords.producedate | 生产日期 | string | |
purInRecords.goodsposition | 货位id | string | |
purInRecords.qty | 数量 | string | {{batch_details.right_num}} |
purInRecords.oriUnitPrice | 无税单价 | string | |
purInRecords.oriTaxUnitPrice | 含税单价 | string | _findCollection find oriTaxUnitPrice from 2293f65a-b357-3bfc-b77a-e97b91d88b7f where code={{src_order_no}} product_cCode={{batch_details.goods_no}} |
purInRecords.natSum | 本币含税金额 | string | |
purInRecords.memo | 备注 | string | |
purInRecords._status | 操作标识 | string | Insert |
数据对接效果
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。
