从旺店通·企业奇门到用友BIP通过接口配置打通数据

对接系统:旺店通·企业奇门
旺店通是北京掌上先机网络科技有限公司旗下品牌,国内的零售云服务提供商,基于云计算SaaS服务模式,以体系化解决方案,助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案,致力于帮助企业实现数字化转型,企业规模化发展
目标系统:用友BIP
面向数智化市场,用友倾力打造了全球领先的数智商业创新平台——用友BIP,定位为数智商业的应用级基础设施、企业服务产业的共创平台,服务企业数智化转型和商业创新,让企业云服务随需而用,让数智价值无处不在,让商业创新如此便捷。
接口方案配置
使用轻易云系统数据集成平台对应的模块:数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统:旺店通·企业奇门,然后选择对应的连接器。选择对应的查询调拨单作为数据对接来源。然后再通过写入目标平台配置目标系统为用友BIP,并且选择对应连接器(关于用友BIP的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的调拨订单保存接口作为数据写入动作,既可以完成第一步的数据对接配置。



旺店通·企业奇门接口明细
- API:wdt.stock.transfer.query
- 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 |
from_warehouse_no | 源仓库 | | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置),用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号) |
to_warehouse_no | 目标仓库 | | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置),用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号) |
status | 调拨单状态 | | 调拨单状态10已取消 20编辑中 30待审核 40已审核 42出库单待推送 44出库单推送失败 46待出库 50部分出库 60全部出库 62入库单待推送 64入库单推送失败 66待入库 70部分入库 80待结算 90调拨完成 (不传该字段默认返回全部状态的单据) |
page_size | 分页大小 | {{PAGINATION_PAGE_SIZE}} | 每页返回的数据条数,输入值范围1100,不传本参数,输入值默认为40,使用举例单击这里 |
page_no | 页号 | {{PAGINATION_START_PAGE}} | 不传值默认从0页开始 |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
transfer_id | 调拨主键id | | 调拨主键id |
transfer_no | 调拨单号 | | 系统调拨单的编号,默认TF开头 |
type | 调拨类型 | | 调拨类型(0:分步调拨,1:快速调拨) |
mode | 调拨模式 | | 调拨模式(0单品调拨 1货位调拨 2明细调拨) |
from_warehouse_no | 源仓库 | | 源仓库编号,代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置) |
to_warehouse_no | 目标仓库 | | 目标仓库编号,代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置) |
rec_id | 主键 | | 主键 |
lock_id | 锁定策略ID | | 锁定策略ID |
api_outer_no | 接口外部单号 | | 接口外部单号 |
from_wms_order_no | 递交的出库仓库内的单号 | | 递交的出库仓库内的单号 |
outer_no2 | 递交的入库委外单号 | | 递交的入库委外单号 |
to_wms_order_no | 递交的入库仓库内的单号 | | 递交的入库仓库内的单号 |
error_info | 仓储错误信息 | | 仓储错误信息 |
wms_status | 操作状态 | | 操作状态 |
from_warehouse_id | 调出仓库 | | 调出仓库 |
to_warehouse_id | 目标仓库 | | 目标仓库,货位调拨时,与from_warehouse_id相等 |
address | 目标仓库地址 | | 目标仓库地址 |
logistics_id | 物流方式 | | 物流方式 |
out_goods_amount | 调出货品金额 | | 调出货品金额(成本价之和) |
in_goods_amount | 调入货品金额( | | 调入货品金额(成本价之和) |
note_count | 便签条数 | | 便签条数 |
flag_id | 标记 | | 标记 |
status | 调拨单状态 | | 调拨单状态10已取消 20编辑中 30待审核 40已审核 42出库单待推送 44出库单推送失败 46待出库 50部分出库 60全部出库 62入库单待推送 64入库单推送失败 66待入库 70部分入库 80待结算 90调拨完成 |
outer_no | 外部单号 | | 外部单号 |
creator_id | 制单员ID | | 制单员ID |
creator_name | 制单人姓名 | | 调拨单管理的“创建者”字段 |
contact | 联系人 | | 联系人 |
telno | 联系电话 | | 联系电话 |
logistics_type | 物流类型 | | 物流类型 |
logistics_no | 物流编号 | | 代表物流所有属性的唯一编码,用于物流区分,ERP内支持自定义(ERP物流界面设置) |
logistics_name | 物流名称 | | 旺店通里设置的物流公司名称 |
logistics_code | 物流单号 | | 物流公司的运单号 |
goods_count | 货品数量 | | 货品数量 |
goods_type_count | 货品种类数量 | | 调拨单管理界面的“货品种类”字段 |
goods_in_count | 入库数量 | | 入库数量 |
goods_out_count | 出库数量 | | 出库数量 |
modified | 最后修改时间 | | 最后修改时间,格式:YYYY-MM-DD HH:MM:SS |
created | 创建时间 | | 创建时间,格式:YYYY-MM-DD HH:MM:SS |
remark | 备注 | | 备注 |
to_warehouse_address | 目标仓库地址 | | 目标仓库地址 |
details_list | sku详情节点 | | sku详情节点 |
details_list.transfer_id | 调拨主键id | | 调拨主键id |
details_list.rec_id | 调拨明细主键id | | 调拨明细主键id |
details_list.goods_no | 货品编号 | | 代表SPU所有属性的唯一编号,用于系统货品的区分,SPU概念介绍,单击这里 |
details_list.spec_no | 商家编码 | | 代表所单品(sku)所有属性的唯一编码,用于获取系统单品的数据,SKU概念介绍,单击这里 |
details_list.spec_code | 规格码 | | 规格码 |
details_list.spec_name | 规格名称 | | 规格名称 |
details_list.unit | 单位 | | 单位 |
details_list.num2 | 辅助数量 | | 辅助数量 |
details_list.spec_id | 货品规格 | | 货品规格 |
details_list.cost_diff | 计算平均成本价时的精度丢失 | | 计算平均成本价时的精度丢失 |
details_list.flag_id | 标记 | | 标记 |
details_list.modified | 最后修改时间 | | 最后修改时间 |
details_list.created | 创建时间 | | 创建时间 |
details_list.barcode | 条码 | | 条码 |
details_list.out_cost_total | 调出总成本 | | 调出总成本 |
details_list.batch_id | 批次ID | | 批次ID |
details_list.batch_no | 货品批次 | | 货品批次 |
details_list.batch_remark | 批次备注 | | 批次备注 |
details_list.from_position | 源货位 | | 源货位 |
details_list.to_position | 目标货位 | | 目标货位 |
details_list.expire_date | 有效期 | | 有效期 |
details_list.stock_num | 库存 | | 调拨时的库存(显示用,不做依据) |
details_list.num | 调拨数量 | | 调拨数量 |
details_list.out_num | 出库数量 | | 出库数量 |
details_list.in_num | 入库数量 | | 入库数量 |
details_list.unit_name | 基本单位 | | 基本单位 |
details_list.aux_unit_name | 辅助单位 | | 辅助单位 |
details_list.aux_num | 辅助数量 | | 辅助数量 |
details_list.remark | 备注 | | 备注 |
用友BIP接口明细
- 调用接口:/yonbip/scm/transferapply/save
- 接口名称:调拨订单保存
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
barcode | 条码 | string | {{barcode}} |
outorg | 调出组织id或code | string | findCollection find org_code from 4f73f755-1c4f-33e6-b5a1-7e3b8d894800 where code={{from_warehouse_no}} |
outaccount | 调出会计主体id或code | string | _findCollection find org_code from 4f73f755-1c4f-33e6-b5a1-7e3b8d894800 where code={{from_warehouse_no}} |
code | 单据编号 | string | {{transfer_no}} |
vouchdate | 单据日期 | string | {{modified}} |
bustype | 交易类型id或code | string | A03001 |
inorg | 调入组织id或code | string | findCollection find org_code from 4f73f755-1c4f-33e6-b5a1-7e3b8d894800 where code={{to_warehouse_no}} |
inaccount | 调入会计主体id或code | string | _findCollection find org_code from 4f73f755-1c4f-33e6-b5a1-7e3b8d894800 where code={{to_warehouse_no}} |
bizstatus | 单据状态 | string | |
srcBillType | 来源类型, | string | st_transferreq |
dplanshipmentdate | 计划发货日期 | string | |
dplanarrivaldate | 计划到货日期 | string | |
memo | 备注 | string | |
status | 操作标识, | string | Insert |
transferApplys | 调拨订单子表 | object | details_list |
transferApplys.product | 物料id或code | string | {{details_list.goods_no}} |
transferApplys.productsku | 物料SKUid或code | string | {{details_list.spec_no}} |
transferApplys.propertiesValue | 规格 | string | |
transferApplys.isExpiryDateManage | 是否效期管理 | string | |
transferApplys.isBatchManage | 是否批次管理 | string | |
transferApplys.batchno | 批次号 | string | {{details_list.batch_no}} |
transferApplys.producedate | 生产日期 | string | {{details_list.created}} |
transferApplys.invaliddate | 有效期至 | string | 2022-06-30 00:00:00 |
transferApplys.expireDateNo | 保质期 | string | |
transferApplys.qty | 数量 | string | {{details_list.num}} |
transferApplys.unit | 主计量id或code | string | _findCollection find code from f9eedcc9-f1ff-31c0-9081-6aee9cf21740 where name={{unit_name}} |
transferApplys.invExchRate | 换算率 | string | 1 |
transferApplys.subQty | 件数 | string | 1 |
transferApplys.stockUnitId | 库存单位id或code | string | findCollection find code from f9eedcc9-f1ff-31c0-9081-6aee9cf21740 where name={{unit_name}} |
transferApplys.unit_Precision | 主计量精度 | string | |
transferApplys.stockUnitId_Precision | 库存单位精度 | string | |
transferApplys.settlementPriceBy | 结算价格依据 | string | |
transferApplys.isCanModPrice | 价格可改 | string | |
transferApplys.taxUnitPriceTag | 价格含税 | string | |
transferApplys.oriUnitPrice | 无税单价 | string | |
transferApplys.oriTaxUnitPrice | 含税单价 | string | |
transferApplys.oriMoney | 无税金额 | string | |
transferApplys.oriSum | 含税金额 | string | |
transferApplys.oriTax | 税额 | string | |
transferApplys.taxRate | 税率 | string | |
transferApplys.natUnitPrice | 本币无税单价 | string | |
transferApplys.natTaxUnitPrice | 本币含税单价 | string | |
transferApplys.natMoney | 本币无税金额 | string | |
transferApplys.natSum | 本币含税金额 | string | |
transferApplys.natTax | 本币税额 | string | |
transferApplys.finishoutqty | 已出库数量 | string | |
transferApplys.finishoutnum | 已出库件数 | string | |
transferApplys.finishinqty | 已入库数量 | string | |
transferApplys.finishinnum | 已入库件数 | string | |
transferApplys.project | 项目id或code | string | |
transferApplys.project_name | 项目名称 | string | |
transferApplys.sourceid | 上游单据主表id | string | |
transferApplys.sourceautoid | 上游单据子表id | string | |
transferApplys.source | 上游单据类型 | string | |
transferApplys.upcode | 上游单据号 | string | |
transferApplys.memo | 备注 | string | |
transferApplys.makeRuleCode | 生单规则编号 | string | |
transferApplys._status | 操作标识 | string | Insert |
数据对接价值
随着企业数字化业务的深入发展,对于企业的 IT 或者 CIO 来讲,正在面临一个愈发重要的问题——系统的结构太复杂了,尤其是头部企业,至少有十多套系统,这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统,如何整合企业的现有IT资源,使企业中计算机孤岛式的应用向集体协作的方向发展,发挥资源效益的最大化,降低企业成本,正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上,操作统一,以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中,轻易云应用集成平台负责实现异构、分布式系统之间互联互通,实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。
