旺店通·企业奇门对接打通用友BIP查询调拨单接口与转库保存接口
对接系统:旺店通·企业奇门
慧策(原旺店通)是一家技术驱动型智能零售服务商,基于云计算PaaS、SaaS模式,以一体化智能零售解决方案,帮助零售企业数字化智能化升级,实现企业规模化发展。
接通系统:用友BIP
YonBIP用友商业创新平台,是用友在数字经济时代面向成长型、大型企业及巨型企业,融合了先进且高可用技术平台和公共与关键商业应用与服务,支撑和运行客户的商业创新(业务创新、管理变革),并且具有数字化、智能化、高弹性、安全可信、社会化、全球化、平台化、生态化等特征的综合型服务平台。
数据对接方案
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:旺店通·企业奇门,源系统 API:查询调拨单,目标系统:用友BIP,目标系统 API转库保存。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
旺店通·企业奇门接口明细
- 接口:wdt.stock.transfer.query
- 接口名称:查询调拨单
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
start_time | 开始时间 | datetime | 增量获取数据,start_time作为开始时间,格式:yyyy-MM-dd HH:mm:ss |
end_time | 结束时间 | datetime | 增量获取数据,end_time作为结束时间,格式:yyyy-MM-dd HH:mm:ss |
from_warehouse_no | 源仓库 | string | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置),用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号) |
to_warehouse_no | 目标仓库 | string | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置),用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号) |
status | 调拨单状态 | string | 调拨单状态10已取消 20编辑中 30待审核 40已审核 42出库单待推送 44出库单推送失败 46待出库 50部分出库 60全部出库 62入库单待推送 64入库单推送失败 66待入库 70部分入库 80待结算 90调拨完成 (不传该字段默认返回全部状态的单据) |
page_size | 分页大小 | string | 每页返回的数据条数,输入值范围1~100,不传本参数,输入值默认为40,使用举例单击这里 |
page_no | 页号 | string | 不传值默认从0页开始 |
响应参数
字段 | 名称 | 类型 | 描述 |
transfer_id | 调拨主键id | string | 调拨主键id |
transfer_no | 调拨单号 | string | 系统调拨单的编号,默认TF开头 |
type | 调拨类型 | string | 调拨类型(0:分步调拨,1:快速调拨) |
mode | 调拨模式 | string | 调拨模式(0单品调拨 1货位调拨 2明细调拨) |
from_warehouse_no | 源仓库 | string | 源仓库编号,代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置) |
to_warehouse_no | 目标仓库 | string | 目标仓库编号,代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置) |
rec_id | 主键 | string | 主键 |
lock_id | 锁定策略ID | string | 锁定策略ID |
api_outer_no | 接口外部单号 | string | 接口外部单号 |
from_wms_order_no | 递交的出库仓库内的单号 | string | 递交的出库仓库内的单号 |
outer_no2 | 递交的入库委外单号 | string | 递交的入库委外单号 |
to_wms_order_no | 递交的入库仓库内的单号 | string | 递交的入库仓库内的单号 |
error_info | 仓储错误信息 | string | 仓储错误信息 |
wms_status | 操作状态 | string | 操作状态 |
from_warehouse_id | 调出仓库 | string | 调出仓库 |
to_warehouse_id | 目标仓库 | string | 目标仓库,货位调拨时,与from_warehouse_id相等 |
address | 目标仓库地址 | string | 目标仓库地址 |
logistics_id | 物流方式 | string | 物流方式 |
out_goods_amount | 调出货品金额 | string | 调出货品金额(成本价之和) |
in_goods_amount | 调入货品金额( | string | 调入货品金额(成本价之和) |
note_count | 便签条数 | string | 便签条数 |
flag_id | 标记 | string | 标记 |
status | 调拨单状态 | string | 调拨单状态10已取消 20编辑中 30待审核 40已审核 42出库单待推送 44出库单推送失败 46待出库 50部分出库 60全部出库 62入库单待推送 64入库单推送失败 66待入库 70部分入库 80待结算 90调拨完成 |
outer_no | 外部单号 | string | 外部单号 |
creator_id | 制单员ID | string | 制单员ID |
creator_name | 制单人姓名 | string | 调拨单管理的“创建者”字段 |
contact | 联系人 | string | 联系人 |
telno | 联系电话 | string | 联系电话 |
logistics_type | 物流类型 | string | 物流类型 |
logistics_no | 物流编号 | string | 代表物流所有属性的唯一编码,用于物流区分,ERP内支持自定义(ERP物流界面设置) |
logistics_name | 物流名称 | string | 旺店通里设置的物流公司名称 |
logistics_code | 物流单号 | string | 物流公司的运单号 |
goods_count | 货品数量 | string | 货品数量 |
goods_type_count | 货品种类数量 | string | 调拨单管理界面的“货品种类”字段 |
goods_in_count | 入库数量 | string | 入库数量 |
goods_out_count | 出库数量 | string | 出库数量 |
modified | 最后修改时间 | string | 最后修改时间,格式:YYYY-MM-DD HH:MM:SS |
created | 创建时间 | string | 创建时间,格式:YYYY-MM-DD HH:MM:SS |
remark | 备注 | string | 备注 |
to_warehouse_address | 目标仓库地址 | string | 目标仓库地址 |
details_list | sku详情节点 | array | sku详情节点 |
details_list.transfer_id | 调拨主键id | string | 调拨主键id |
details_list.rec_id | 调拨明细主键id | string | 调拨明细主键id |
details_list.goods_no | 货品编号 | string | 代表SPU所有属性的唯一编号,用于系统货品的区分,SPU概念介绍,单击这里 |
details_list.spec_no | 商家编码 | string | 代表所单品(sku)所有属性的唯一编码,用于获取系统单品的数据,SKU概念介绍,单击这里 |
details_list.spec_code | 规格码 | string | 规格码 |
details_list.spec_name | 规格名称 | string | 规格名称 |
details_list.unit | 单位 | string | 单位 |
details_list.num2 | 辅助数量 | string | 辅助数量 |
details_list.spec_id | 货品规格 | string | 货品规格 |
details_list.cost_diff | 计算平均成本价时的精度丢失 | string | 计算平均成本价时的精度丢失 |
details_list.flag_id | 标记 | string | 标记 |
details_list.modified | 最后修改时间 | string | 最后修改时间 |
details_list.created | 创建时间 | string | 创建时间 |
details_list.barcode | 条码 | string | 条码 |
details_list.out_cost_total | 调出总成本 | string | 调出总成本 |
details_list.batch_id | 批次ID | string | 批次ID |
details_list.batch_no | 货品批次 | string | 货品批次 |
details_list.batch_remark | 批次备注 | string | 批次备注 |
details_list.from_position | 源货位 | string | 源货位 |
details_list.to_position | 目标货位 | string | 目标货位 |
details_list.expire_date | 有效期 | string | 有效期 |
details_list.stock_num | 库存 | string | 调拨时的库存(显示用,不做依据) |
details_list.num | 调拨数量 | string | 调拨数量 |
details_list.out_num | 出库数量 | string | 出库数量 |
details_list.in_num | 入库数量 | string | 入库数量 |
details_list.unit_name | 基本单位 | string | 基本单位 |
details_list.aux_unit_name | 辅助单位 | string | 辅助单位 |
details_list.aux_num | 辅助数量 | string | 辅助数量 |
details_list.remark | 备注 | string | 备注 |
用友BIP接口明细
- 接口:/yonbip/scm/storetransfer/save
- 接口名称:转库保存
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
org | 库存组织code或id | string | 例:A23001 |
code | 单据编号,编码规则是手动时必填 | string | 例:ZK20210417000002 |
vouchdate | 单据日期 | string | 例:2021-04-17 00:00:00 |
businesstype | 交易类型code或id | string | 例:110000000000019 |
outWarehouse | 出库仓库code或id | string | 例:02 |
inWarehouse | 入库仓库code或id | string | 例:1920126858645760 |
id | 转库单主表ID,更新操作时必填 | string | 例:1920126858642000 |
memo | 备注 | string | 例:表头备注 |
totalQuantity | 整单数量 | string | 例:122 |
_status | 操作标识 | string | |
details | 转库单子表[st.storetrans.StoreTransDetail] | array | |
details.product | 物料id或code | string | 例:1920126858647891 |
details.product_cCode | 物料编码 | string | 例:CC00101 |
details.modelDescription | 规格说明 | string | 例:30g/包 |
details.productsku | 商品SKUid或编码 | string | 例:1920126858647892 |
details.productsku_cCode | 物料sku编码 | string | 例:CC00101-1 |
details.batchno | 批次号 | string | 例:bt001 |
details.producedate | 生产日期 | string | 例:2021-04-27 00:00:00 |
details.invaliddate | 有效期至 | string | 例:2021-10-27 00:00:00 |
details.expireDateNo | 保质期 | string | 例:1 |
details.expireDateUnit | 保质期单位 | string | |
details.id | 转库单子表ID,更新子表时必填 | string | 例:1920126858642001 |
details.detailsid | 转库单子表ID | string | 例:1920126858642001 |
details.qty | 数量 | string | 例:12 |
details.unit | 单位id或编码 | string | 例:1836523958194432 |
details.unitName | 主计量 | string | 例:件(精度2) |
details.invExchRate | 换算率 | string | 例:件(精度2) |
details.subQty | 件数 | string | 例:件(精度2) |
details.stockUnitId | 库存单位id或编码 | string | 例:1836523958194432 |
details.goodsposition | 出库货位id或编码 | string | 例:1836523958191100 |
details.ingoodsposition | 入库货位id或编码 | string | 例:1836523958191200 |
details.ingoodsposition_cName | 入库货位 | string | 例:入库货位A |
details.goodsposition_cName | 出库货位 | string | 例:出库货位A |
details.memo | 子表备注 | string | 例:表体备注 |
details._status | 操作标识 | string | 例:表体备注 |
数据对接效果
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。
系统数据对接方案元数据代码