旺店通·企业奇门和用友BIP接口打通对接实战
接入系统:旺店通·企业奇门
慧策(原旺店通)是一家技术驱动型智能零售服务商,基于云计算PaaS、SaaS模式,以一体化智能零售解决方案,帮助零售企业数字化智能化升级,实现企业规模化发展。
接通系统:用友BIP
YonBIP用友商业创新平台,是用友在数字经济时代面向成长型、大型企业及巨型企业,融合了先进且高可用技术平台和公共与关键商业应用与服务,支撑和运行客户的商业创新(业务创新、管理变革),并且具有数字化、智能化、高弹性、安全可信、社会化、全球化、平台化、生态化等特征的综合型服务平台。
数据接口配置
系统对接前期需要通过调研公司的业务,规划出最便捷,效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地,轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台:旺店通·企业奇门的接口参数设置,以及设定好目标平台:用友BIP的映射,即可启动方案进行测试
旺店通·企业奇门接口明细
- 接口: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/othoutrecord/single/save
- 接口名称:其他出库单保存
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
resubmitCheckKey | 保证请求的幂等性 | string | 该值由客户端生成 |
code | 单据编号 | string | 以系统编码规则配置为准,系统设置为手工编号时必输,系统设置为自动编号时非必输;更新操作时必填 例:QTCK0000001 |
defines!define1 | defines!define1 | string | 以系统编码规则配置为准,系统设置为手工编号时必输,系统设置为自动编号时非必输;更新操作时必填 例:QTCK0000001 |
org | 库存组织 | string | 传入id或code 例:wzyqzn |
accountOrg | 会计主体 | string | 传入id或code 例:wzyqzn |
vouchdate | 单据日期 | string | 日期格式:yyyy-MM-dd 例:2021-03-05 |
bustype | 交易类型 | string | 传入id或code 例:A10001 |
warehouse | 仓库 | string | 传入id或code 例:ck01 |
memo | 备注 | string | 例:单子备注 |
_status | 操作标识 | string | Insert:新增、Update:更新 |
srcBillType | 来源上级单据类型 | string | 有来源时必填:出库申请退库:applyoutToOthoutrecordReturn;出库申请出库:applyoutToOthoutrecord |
othOutRecords | 其他出库单子表 | array | [st.othoutrecord.OthOutRecords] |
othOutRecords.product | 物料 | string | 传入id或code 例:PD0817000001 |
othOutRecords.productsku | 物料SKU | string | 例:PD08170000010004 |
othOutRecords.batchno | 批次号,批次管理商品必填 | string | 传入id或code 例:SH01 |
othOutRecords.producedate | 生产日期 | string | 例:2020-09-24 00:00:00 |
othOutRecords.invaliddate | 有效期至 | string | 例:2020-10-24 00:00:00 |
othOutRecords.contactsQuantity | 应发数量 | string | 例:10 |
othOutRecords.contactsPieces | 应发件数 | string | 例:10 |
othOutRecords.qty | 数量 | string | 有来源时:出库时正数,退库时负数 例:10 |
othOutRecords.invExchRate | 换算率 | string | 例:件(精度2) |
othOutRecords.subQty | 件数 | string | 例:件(精度2) |
othOutRecords.unit | 主计量单位,传入id或code | string | 例:KGM |
othOutRecords.unitExchangeType | 库存换算率换算方式 | string | 例:0 |
othOutRecords.stockUnitId | 库存单位 | string | 传入id或code例:KGM |
othOutRecords.goodsposition | 货位 | string | 传入id或code例:ck01_hw01 |
othOutRecords.project | 项目 | string | 传入id或code例:project01 |
othOutRecords.memo | 备注 | string | 例:备注信息 |
othOutRecords._status | 操作标识 | string | Insert:新增、Update:更新 |
othOutRecords.sourceid | 上游单据主表id | string | |
othOutRecords.sourceautoid | 上游单据子表id | string | |
othOutRecords.source | 上游单据类型 | string | 有来源必填:ustock.po_picking_requisition:出库申请 |
othOutRecords.upcode | 上游单据号 | string | |
othOutRecords.makeRuleCode | 生单规则编号 | string | 有来源必填:出库申请退库:applyoutToOthoutrecordReturn;出库申请出库:applyoutToOthoutrecord |
othOutRecords.autoCalcCost | 自动计算成本,有来源必填:true:是、false:否 | string | |
系统对接总览
全新的API数据集成模式,赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式,基于全新API战略中台的API新型集成方式通过解耦系统资源,降低系统间对接难度,实现快速业务需求响应,提升对接效率,助力企业满足快速业务交付需求,实现业务创新。通过构建API生态,助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产,可实现内部资源共享,满足内部开发人员资源使用需求,例如:用友BIP与旺店通·企业奇门之间数据集成;并将API资源对外可控开放,打造面向开发者的生态服务,为您打通自身和上下游合作伙伴,创造共赢价值链。开展API战略中台,重塑IT 帮助您基于内部资源构建不同业务能力中心,打造企业统一API战略中台,赋能企业发展,实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时,无需从“零”组建各业务模块,提升开发效率,重塑IT组织及交付能力。
系统数据对接方案元数据代码