旺店通·企业奇门与金蝶云星空对接集成旺店通委外出入库单连通其他入库新增(旺店通委外入库单)

对接系统旺店通·企业奇门
慧策(原旺店通)是一家技术驱动型智能零售服务商,基于云计算PaaS、SaaS模式,以一体化智能零售解决方案,帮助零售企业数字化智能化升级,实现企业规模化发展。
写入目标:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据接口配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:旺店通·企业奇门,源系统 API:旺店通委外出入库单,目标系统:金蝶云星空,目标系统 API其他入库新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。


旺店通·企业奇门接口明细
- 接口: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 | |
FBillTypeID | 单据类型 | string | |
FStockOrgId | 库存组织 | string | |
FDate | 日期 | string | |
FSUPPLIERID | 供应商 | string | |
FDEPTID | 部门 | string | |
FNOTE | 备注 | string | |
FEntity | 明细信息 | array | |
FEntity.FMATERIALID | 物料编码 | string | |
FEntity.FCMKBarCode | 零售条形码 | string | |
FEntity.FSTOCKID | 收货仓库 | string | |
FEntity.FQty | 实收数量 | string | |
FEntity.FEntryNote | 备注 | string | |
FEntity.FormId | 业务对象表单Id | string | |
FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | |
FEntity.Operation | 执行的操作 | string | |
FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | |
系统打通概况
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统,实现流程端到端打通,复用已有的业务系统能力,让集成架构、服务关系更清晰 使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。
