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

对接系统:旺店通·企业奇门
慧策(原旺店通)是一家技术驱动型智能零售服务商,基于云计算PaaS、SaaS模式,以一体化智能零售解决方案,帮助零售企业数字化智能化升级,实现企业规模化发展。
接通系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据集成方案配置
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线,所以对接方案的配置极其重要,方案可以选择一键复制,轻易云有海量的对接方案可支持一键复制,复制后直接启动使用(对接方案借鉴可以在轻易云系统数据集成交流社区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
请求参数
字段 | 名称 | 类型 | 描述 |
FBillType | 单据类型 | string | |
FDATE | 单据日期 | string | |
FBillNo | 单据编号 | string | |
FSubOrgId | 委外组织 | string | |
FTreeEntity | 明细 | array | |
FTreeEntity.FMaterialId | 物料编码 | string | |
FTreeEntity.FQty | 数量 | string | |
FTreeEntity.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
FTreeEntity.Operation | 执行的操作 | string | |
FTreeEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | |
FTreeEntity.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
数据对接效果
大部分的企业都可能只用一套系统组织架构复杂,业务流程繁琐,内部同时有OA系统、BI系统、ERP系统......且各个系统都需要独立登陆,造成IT部门数据监管困难!如何在同一套中台系统上关联多管理系统呢?系统集成平台,就可以无缝集成各个业务系统,主数不统一、交易数据来回导出导入、业务融合等问题。通过轻易云系统集成平台完美结合:打破企业内部数据孤岛,无需繁琐的处理工序,与数据集成服务完美结合,让数据真正通起来。 资源互补:汇集各种行业解决方案,资源互补,企业管理融合提升。让对接开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。

