旺店通·企业奇门和金蝶云星空接口打通对接实战

数据源系统:旺店通·企业奇门
慧策最先以旺店通ERP切入商家核心管理痛点——订单管理,之后围绕电商经营管理中的核心管理诉求,先后布局流量获取、会员管理、仓库管理等其他重要经营模块。慧策的产品线从旺店通ERP起步,向前向后延伸,全面布局零售企业经营,整体构建一体化智能零售解决方案,打破数据孤岛,AI植入系统,实现智能决策,助力零售企业智能化转型。当前旗下拥有店+小程序、数智门店POS、旺店通ERP、旺店通WMS、卡米全渠道、客优CRM、云筹大数据等多个PssS、SaaS产品,从前端吸引流量到后端集约化管理,助力企业智慧决策
对接目标平台:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
数据接口配置
通过轻易云系统数据集成平台新增创建集成方案,然后在数据源平台中选择对应的源平台为:旺店通·企业奇门,并且选择对应的连接器(关于旺店通·企业奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息)。选择对应的旺店通委外出入库单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器。选择对应的其他出库新增接口作为数据写入动作,既可以完成第一步的数据对接配置;打破跨系统连接,让数据轻易互通成为现实。

旺店通·企业奇门接口明细
- 接口:wdt.vip.stock.outside.wms.query
- 接口名称:旺店通委外出入库单
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
warehouse_no | 仓库编号 | varchar | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置),用于获取指定仓库单据信息(不支持一次推送多个仓库编号) |
status | 单据状态 | int | 可选值:10 取消 20编辑中 30待审核 40待推送 50推送失败 60待出库 65待入库 70 部分出库 75部分入库 80 已完成 |
order_type | 出入类别 | int | 可选值:1(出库),2(入库) |
outer_no | 外部单号 | varchar | “vip_wms_stockinout_order_push.php(创建委外出入库单)”创建单据时推送过来的外部系统唯一标识编号。 |
api_outer_no | 接口外部单号 | varchar | 接口外部单号 |
order_no | 委外单号 | varchar | 创建委外出入库单成功后系统生产的单号,示例“WK201905280002”,通过“vip_wms_stockinout_order_push.php”创建委外出入库单成功后响应参数会返回此单号 |
start_time | 开始时间 | datetime | 按最后修改时间增量获取数据,start_time作为开始时间, 格式:yyyy-MM-dd HH:mm:ss |
end_time | 结束时间 | datetime | 按最后修改时间增量获取数据,end_time作为结束时间,格式:yyyy-MM-dd HH:mm:ss |
page_size | 分页大小 | int | 每页返回数据条数,参数输入值范围130,不传此参数默认page_size=30,使用举例单击这里 |
page_no | 页号 | int | 不传值默认从0页开始 |
响应参数
字段 | 名称 | 类型 | 描述 |
order_id | 单据主键id | int | 单据主键id |
order_no | 委外单号 | varchar | 委外单号,默认WK开头 |
warehouse_no | 仓库编号 | varchar | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置) |
receiver_country | 国家 | smallint | 国家 |
note_count | 便签条数 | smallint | 便签条数 |
status | 单据状态 | tinyint | 状态:10 取消 20编辑中 30待审核 40待推送 50推送失败 60待出库 65待入库 70 部分出库 75部分入库 80 已完成 |
wms_status | 处理状态 | tinyint | 状态:0 待处理,1 处理失败,2 处理成功,3 客户端处理中,4 服务器处理中 |
error_info | 推送信息 | varchar | 推送信息 |
operator_id | 制单人id | int | 制单人id |
check_operator_id | 审核人id | int | 审核人id |
warehouse_id | 仓库id | int | 仓库id |
warehouse_type | 仓库类型 | tinyint | 仓库类型 |
transport_mode | 运输模式 | tinyint | 运输模式:0.到仓自提,1.快递,2.干线物流 |
logistics_id | 物流公司id | int | 物流公司id |
logistics_fee | 物流费用 | decimal | 物流费用 |
created | 创建时间 | datetime | 创建时间,格式:yyyy-MM-dd HH:mm:ss |
remark | 备注 | varchar | 备注 |
order_type | 单据类别 | tinyint | 单据类别:1.委外出库单 2.委外入库单 |
other_fee | 其他费用 | decimal | 其他费用 |
goods_count | 货品数量 | decimal | 货品数量 |
goods_type_count | 货品种类数 | decimal | 货品种类数 |
goods_real_count | 实际数量 | decimal | 实际数量 |
check_time | 审核时间 | datetime | 审核时间,格式:yyyy-MM-dd HH:mm:ss |
modified | 最后修改时间 | datetime | 最后修改时间,格式:yyyy-MM-dd HH:mm:ss |
receiver_name | 联系人 | varchar | 联系人 |
receiver_province | 省份 | int | 省份代码 |
receiver_city | 城市 | int | 城市代码 |
receiver_district | 区县 | int | 区县代码 |
receiver_zip | 邮编 | varchar | 邮编信息 |
receiver_area | 省市区 | varchar | 省市区 |
receiver_address | 地址 | varchar | 地址 |
receiver_mobile | 移动电话 | varchar | 移动电话 |
receiver_telno | 固定电话 | varchar | 固定电话 |
prop1 | 自定义属性1 | varchar | 自定义属性1 |
prop2 | 自定义属性2 | varchar | 自定义属性2 |
prop3 | 自定义属性3 | varchar | 自定义属性3 |
prop4 | 自定义属性4 | varchar | 自定义属性4 |
api_outer_no | 接口外部单号 | varchar | 接口外部单号 |
outer_no | 外部单号 | varchar | 外部单号 |
wms_outer_no | 仓储单号 | varchar | 仓储单号 |
logistics_no | 物流单号 | varchar | 物流单号,获取此字段前需将版本升级至V2.3.9.1及以上的稳定版本 |
check_operator_name | 审核员名称 | varchar | 审核员名称 |
operator_name | 操作员名称 | varchar | 操作员名称 |
details_list | 货品列表节点 | array | 响应参数的2级数据节点,包含单个入库单所有货品属性信息的数据节点,节点下数据字段详见下述“stockin_list”列表 |
details_list.order_id | 单据主键id | int | 单据主键id |
details_list.rec_id | 主键 | int | 主键(与业务无关) |
details_list.order_no | 委外单号 | varchar | 委外单号,默认WK开头 |
details_list.spec_id | 规格ID | int | 规格ID |
details_list.num2 | 辅助单位量 | decimal | 辅助单位量 |
details_list.base_unit_id | 基本单位 | smallint | 基本单位 |
details_list.unit_ratio | 单位换算关系 | decimal | 单位换算关系 |
details_list.batch_id | 批次 | int | 批次 |
details_list.created | 创建时间 | datetime | 创建时间 |
details_list.modified | 最后修改时间 | datetime | 最后修改时间 |
details_list.goods_id | 货品id | int | 货品id |
details_list.short_name | 货品简称 | varchar | 货品简称 |
details_list.spec_no | 商家编码 | varchar | 代表单品(sku)所有属性的编码,SKU概念介绍,单击这里 |
details_list.barcode | 条形码 | varchar | 条形码 |
details_list.unit_id | 单位id | int | 单位id |
details_list.brand_id | 品牌id | int | 品牌id |
details_list.batch_no | 批次号 | varchar | 批次号 |
details_list.batch_remark | 批次备注 | varchar | 批次备注 |
details_list.position_id | 货位id | varchar | 货位id |
details_list.position_no | 货位编号 | varchar | 货位编号 |
details_list.num | 货品数量 | decimal | 货品数量 |
details_list.inout_num | 已出入库数量 | decimal | 已出入库数量 |
details_list.price | 成本价 | decimal | 成本价 |
details_list.remark | 备注 | varchar | 入库单备注 |
details_list.logistics_id | 物流公司id | int | 物流公司id |
details_list.logistics_no | 物流单号 | varchar | 物流单号 |
details_list.brand_name | 品牌名称 | varchar | 品牌名称 |
details_list.goods_name | 货品名称 | varchar | 货品名称 |
details_list.goods_no | 货品编号 | varchar | 代表货品(spu)所有属性的编号,SPU概念介绍,单击这里 |
details_list.spec_name | 规格名称 | varchar | 规格名称 |
details_list.spec_code | 规格码 | varchar | 规格码 |
details_list.goods_unit | 单位 | varchar | 货品单位 |
details_list.expire_date | 有效期 | datetime | 有效期,格式:yyyy-MM-dd HH:mm:ss |
金蝶云星空接口明细
- 调用接口:batchSave
- 接口名称:其他出库新增
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FBillNo | 单据编号 | string | {{order_no}} |
FBillTypeID | 单据类型 | string | QTCKD01_SYS |
FStockOrgId | 库存组织 | string | 100 |
FPickOrgId | 领用组织 | string | 100 |
FDate | 日期 | string | {{check_time}} |
FDeptId | 领料部门 | string | BM000002 |
FNote | 备注 | string | |
FEntity | 明细信息 | array | details_list |
FEntity.FMaterialId | 物料编码 | string | {{details_list.goods_no}} |
FEntity.FCMKBarCode | 零售条形码 | string | |
FEntity.FQty | 实发数量 | string | {{details_list.goods_count}} |
FEntity.FStockId | 发货仓库 | string | {{warehouse_no}} |
FEntity.FPrice | 成本价 | string | |
FEntity.FEntryNote | 备注 | string | |
FEntity.FormId | 业务对象表单Id | string | STK_MisDelivery |
FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | false |
FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | false |
FEntity.Operation | 执行的操作 | string | Save |
FEntity.InterationFlags | 允许负库存 | string | STK_InvCheckResult |
系统对接总览
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统,实现流程端到端打通,复用已有的业务系统能力,让集成架构、服务关系更清晰 使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。
