用友BIP和旺店通·企业奇门单据接口对接
对接系统:旺店通·企业奇门
慧策(原旺店通)是一家技术驱动型智能零售服务商,基于云计算PaaS、SaaS模式,以一体化智能零售解决方案,帮助零售企业数字化智能化升级,实现企业规模化发展。
集成系统:用友BIP
YonBIP用友商业创新平台,是用友在数字经济时代面向成长型、大型企业及巨型企业,融合了先进且高可用技术平台和公共与关键商业应用与服务,支撑和运行客户的商业创新(业务创新、管理变革),并且具有数字化、智能化、高弹性、安全可信、社会化、全球化、平台化、生态化等特征的综合型服务平台。
数据接口配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:旺店通·企业奇门,源系统 API:查询出库单管理,目标系统:用友BIP,目标系统 API调出保存。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
旺店通·企业奇门接口明细
- 接口:wdt.stockout.order.query
- 接口名称:查询出库单管理
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
start_time | 开始时间 | string | 按最后修改时间增量获取数据,start_time作为开始时间,格式:yyyy-MM-dd HH:mm:ss |
end_time | 结束时间 | string | 按最后修改时间增量获取数据,end_time作为结束时间,格式:yyyy-MM-dd HH:mm:ss |
order_type | 出库单类型 | string | 2调拨出库,3采购退货出库,4盘亏出库,5生产出库,7其他出库,8多发出库,9纠错出库,10保修配件出库,11初始化出库,12jit拣货出库,13委外出库 |
status | 出库单状态 | string | 出库单状态5:已取消,50:待审核,55:已审核,95:已发货,110:已完成(默认查已发货已完成单据),113:异常发货 |
warehouse_no | 仓库编号 | string | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置)(不支持一次推送多个仓库编号) |
src_order_no | 源单号 | string | 源单号 |
stockout_no | 出库单号 | string | 出库单号,传该字段可以不传时间 |
page_size | 分页大小 | string | 每页返回的数据条数,输入值范围1~100,不传本参数,输入值默认为40,使用举例单击这里 |
page_no | 页号 | string | 不传值默认从0页开始 |
响应参数
字段 | 名称 | 类型 | 描述 |
stockout_id | 出库单主键id | string | 出库单主键id |
order_no | 出库单号 | string | 出库单号 |
src_order_no | 源单号 | string | 源单号,上层单据的业务单号 |
warehouse_no | 仓库编号 | string | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置),用于获取指定仓库数据信息 |
status | 状态 | string | 出库单状态 |
consign_time | 出库时间 | string | 出库时间,格式:yyyy-MM-dd HH:mm:ss |
order_type | 出库单类型 | string | 出库单类型 |
order_type_name | 出库单类型名称 | string | 出库单类型名称 |
subtype | 出库单子类型 | string | 出库单子类型 |
stockout_reason | 出库原因 | string | 出库原因 |
goods_count | 数量 | string | 货品数量 |
goods_total_amount | 货品总销售金额 | string | 货品总销售金额 |
goods_total_cost | 货品总成本金额 | string | 货品总成本金额 |
post_fee | 邮费 | string | 邮费 |
logistics_no | 物流单号 | string | 物流单号(该出库单的运单号) |
package_fee | 包装费 | string | 包装费 |
receiver_name | 收件人 | string | 该字段已废弃 |
receiver_country | 国家 | string | 国家 |
receiver_province | 省份 | string | 省份 |
receiver_city | 城市 | string | 城市 |
receiver_district | 地区 | string | 地区 |
receiver_address | 详细地址 | string | 该字段已废弃 |
receiver_mobile | 收件人移动电话 | string | 该字段已废弃 |
receiver_telno | 收件人固定电话 | string | 该字段已废弃 |
receiver_zip | 邮编 | string | 邮编 |
weight | 重量 | string | 重量 |
remark | 备注 | string | 备注 |
outer_no | 外部单号 | string | 外部单号 |
operator_name | 操作员姓名 | string | 操作员姓名 |
logistics_type | 物流方式 | string | 响应值为代表物流方式的数字,数字对应的物流方式名称单击这里 |
logistics_code | 物流编号 | string | 代表物流所有属性的唯一编码,用于物流区分,ERP内支持自定义(ERP物流界面设置) |
logistics_name | 物流公司名称 | string | erp对应的物流公司名称 |
details_list | Sku详情节点 | array | 响应参数的2级数据节点,包含当出库单货品属性信息的数据节点,节点下数据字段详见下述"details_list" |
details_list.stockout_id | 出库单主键id | string | 出库单主键id |
details_list.rec_id | 出库单明细id | string | 出库单明细id |
details_list.spec_no | 商家编码 | string | 代表所单品(sku)所有属性的唯一编码,用于获取系统单品的数据,SKU概念介绍,单击这里 |
details_list.goods_count | 货品数量 | string | 货品数量 |
details_list.sell_price | 销售价 | 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.cost_price | 成本价 | string | 成本价 |
details_list.total_amount | 总销售金额 | string | 总销售金额 |
details_list.weight | 重量 | string | 重量 |
details_list.remark | 备注 | string | 备注 |
details_list.goods_unit | 单位 | string | 货品单位 |
details_list.batch_no | 批次号 | string | 批次号 |
details_list.batch_remark | 批次备注 | string | 批次备注 |
details_list.expire_date | 有效期 | string | 有效期,格式:yyyy-MM-dd HH:mm:ss |
details_list.position_list | 货位列表节点 | array | 响应参数的3级数据节点,节点下数据字段详见下述“position_list”列表 |
details_list.position_list.position_id | 货位ID | string | 货位ID |
details_list.position_list.position_no | 货位编号 | string | 货位编号 |
details_list.position_list.position_goods_count | 货位出库数量 | string | 货位出库数量 |
details_list.position_list.stockout_order_detail_id | 出库单明细id | string | 出库单明细id |
details_list.position_list.rec_id | 货位主键id | string | 货位主键id |
details_list.position_list.stock_spec_detail_id | 入库单号明细id | string | 入库单号明细id |
details_list.position_list.stockin_detail_id | 入库单明细id | string | 入库单明细id |
details_list.position_list.batch_id | 批次id | string | 批次id |
details_list.position_list.batch_no | 批次号 | string | 批次号 |
details_list.position_list.cost_price | 成本价 | string | 成本价 |
details_list.position_list.modified | 最后更新时间 | string | 最后修改时间,格式:yyyy-MM-dd HH:mm:ss |
details_list.position_list.v_stock_spec_detail_id | 先进先出计价用 | string | 先进先出计价用 |
details_list.position_list.expire_date | 有效期 | string | 有效期,格式:yyyy-MM-dd HH:mm:ss |
details_list.position_list.created | 创建时间 | string | 创建时间,格式:yyyy-MM-dd HH:mm:ss |
用友BIP接口明细
- 接口:/yonbip/scm/storeout/save
- 接口名称:调出保存
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
code | 单据编号 | string | 单据编号 |
outorg | 调出组织id或code | string | 调出组织id或code |
inaccount | 调入会计主体id或code | string | 调入会计主体id或code |
vouchdate | 单据日期 | string | 单据日期 |
inorg | 调入组织id或code | string | 调入组织id或code |
outaccount | 调出会计主体id或code | string | 调出会计主体id或code |
bustype | 交易类型id或code | string | 交易类型id或code |
bizType | 自动调拨 | string | 自动调拨 默认值为0,0:手工,1:订单审核自动调出调入,2:调出保存自动调入,5:订单审核自动调出 |
breturn | 调拨退货 | string | 调拨退货, true:是、false:否 |
inwarehouse | 调入仓库id或code | int | 调入仓库id或code |
outwarehouse | 调出仓库id或code | string | 调出仓库id或code |
memo | 备注 | string | 备注 |
srcBillNO | 来源单据 | string | 来源单据 |
srcBillType | 来源上级单据类型 | string | 来源上级单据类型, st_transferapply:调拨订单、st_storeout:调出单、st_storein:调入单、 |
srcBill | 来源单据id | string | 时间戳,格式为:yyyy-MM-dd HH:mm:ss |
_status | 操作标识 | string | 操作标识, Insert:新增、Update:更新 |
details | 调出单子表 | array | 调出单子表[st.storeout.StoreOutDetail] |
details.product | 物料id或code | long | 物料id或code |
details.product_cCode | 物料编码 | string | 物料编码 |
details.product_cName | 物料名称 | string | 物料名称 |
details.productsku | 商品SKUid或code | long | 商品SKUid或code |
details.productsku_cCode | 物料sku编码 | string | 物料sku编码 |
details.productsku_cName | 物料sku名称 | string | 物料sku名称 |
details.batchno | 批次号 | string | 批次号 |
details.producedate | 生产日期 | string | 生产日期 |
details.invaliddate | 有效期至 | string | 有效期至 |
details.pubts | 时间戳 | string | 时间戳,格式为:yyyy-MM-dd HH:mm:ss |
details.contactsQuantity | 应发数量 | BigDecimal | 应发数量 |
details.contactsPieces | 应发件数 | BigDecimal | 应发件数 |
details.qty | 数量 | BigDecimal | 数量 |
details.unit | 主计量id或code | long | 主计量id或code |
details.invExchRate | 换算率 | int | 换算率 |
details.subQty | 件数 | BigDecimal | 件数 |
details.stockUnitId | 库存单位id或code | long | 库存单位id或code |
details.costprice | 成本价 | BigDecimal | 成本价 |
details.firstsource | 源头单据类型, st_transferapply:调拨订单、st_storeout:调出单、st_storein:调入单、 | long | 物料id或code |
details.firstsourceid | 源头单据主表id | long | 物料id或code |
details.firstsourceautoid | 源头单据子表id | long | 物料id或code |
details.firstupcode | 源头单据编码 | long | 物料id或code |
details.firstuplineno | 源头单据行号 | long | 物料id或code |
details.source | 上游单据类型 | string | 上游单据类型, st_transferapply:调拨订单、st_storeout:调出单、st_storein:调入单、 |
details.sourceid | 上游单据主表id | long | 上游单据主表id |
details.sourceautoid | 上游单据子表id | long | 上游单据子表id |
details.upcode | 上游单据号 | string | 上游单据号 |
details.uplineno | 来源单据行号 | string | 上游单据号 |
details.makeRuleCode | 生单规则编号 | string | 生单规则编号 |
details.memo | 备注 | string | 备注 |
details.autoCalcCost | 自动计算成本 | string | 自动计算成本, true:是、false:否、 |
details._status | 操作标识 | string | 操作标识, Insert:新增、Update:更新 |
系统数据集成价值
通过数据集成平台可视化的快速配置调用接口打通旺店通·企业奇门与用友BIP之间的数据接口,使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具,基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎,通过可视化配置,快速实现客户灵活多变的动态集成需求,让集成开发简单、执行过程可靠、问题风险可控。
系统数据对接方案元数据代码