从旺店通·企业奇门到金蝶云星空通过接口配置打通数据

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

旺店通·企业奇门接口明细
- 接口:wdt.stock.pd.order.query
- 接口名称:查询盘点单
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
start_time | 开始时间 | datetime | 增量获取数据,start_time作为开始时间,格式:yyyy-MM-dd HH:mm:ss |
end_time | 结束时间 | datetime | 增量获取数据,end_time作为结束时间,格式:yyyy-MM-dd HH:mm:ss |
warehouse_no | 仓库编号 | string | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置),用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号) |
page_size | 分页大小 | string | 每页返回的数据条数,输入值范围1100,不传本参数,输入值默认为40,使用举例单击这里 |
page_no | 页号 | string | 不传值默认从0页开始 |
响应参数
字段 | 名称 | 类型 | 描述 |
pd_id | 盘点单ID | string | 盘点单据主键 |
pd_no | 盘点单号 | string | 系统盘点单编号,默认PD开头 |
outer_no | 外部单号 | string | 外部单号 |
api_outer_no | 接口创建的单据的外部单号 | string | 接口创建的单据的外部单号 |
warehouse_no | 仓库编号 | string | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置) |
mode | 盘点模式 | string | 盘点模式 0单品盘点;1 货位盘点;2明细盘点 |
type | 盘点类型 | string | 盘点类型 0 正常开单盘点;1 快速盘点 |
remark | 备注 | string | 备注 |
rec_id | 主键 | string | 主键 |
creator_id | 制单人 | string | 制单人 |
Status | 状态 | string | 40 已盘点 |
note_count | 便签条数 | string | 便签条数 |
warehouse_id | 仓库ID | string | 仓库ID |
operator_name | 操作人 | string | 操作人 |
modified | 最后更新时间 | string | 最后更新时间,格式:yyyy-MM-dd HH:mm:ss |
created | 单据创建时间 | string | 单据创建时间,格式:yyyy-MM-dd HH:mm:ss |
details_list | 货品列表节点 | array | 响应参数的2级数据节点,包含盘点单的货品明细属性信息,节点下数据字段详见下述“details_list”列表 |
details_list.rec_id | 子单ID | string | 子单主键 |
details_list.pd_id | 盘点单主单ID | string | 盘点单据主键 |
details_list.spec_id | 商品ID | string | 单品主键 |
details_list.spec_no | 商家编码 | string | 代表所单品(sku)所有属性的唯一编码,用于获取系统单品的数据,SKU概念介绍,单击这里 |
details_list.spec_code | 规格码 | string | 规格码 |
details_list.spec_name | 规格名称 | string | 规格名称 |
details_list.barcode | 条码 | string | 条码 |
details_list.position_id | 货位ID | string | 货位ID |
details_list.batch_id | 批次 | string | 批次 |
details_list.modified | 最后修改时间 | string | 最后修改时间 |
details_list.created | 创建时间 | string | 创建时间 |
details_list.old_num | 盘点前库存 | string | 盘点前库存 |
details_list.input_num | 录入数量 | string | 录入数量 |
details_list.new_num | 盘点后库存 | string | 盘点后库存 |
details_list.cost_price | 盘点时成本价 | string | 盘点时成本价 |
details_list.goods_name | 货品名称 | string | 货品名称 |
details_list.goods_no | 货品编号 | string | 代表SPU所有属性的唯一编号,用于获取系统货品的数据,SPU概念介绍,单击这里 |
details_list.brand_name | 品牌名称 | string | 品牌名称 |
details_list.unit_name | 基本单位 | string | 基本单位 |
details_list.goods_unit | 辅助单位 | string | 辅助单位 |
details_list.remark | 备注 | string | 备注 |
details_list.expire_date | 有效期 | string | 有效期,格式:yyyy-MM-dd HH:mm:ss |
details_list.batch_no | 批次 | string | 批次 |
details_list.batch_remark | 批次备注 | string | 批次备注 |
details_list.position_no | 货位 | string | 货位 |
金蝶云星空接口明细
- API:batchSave
- NAME:其他入库新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FBillNo | 单据编号 | {{pd_no}} | |
FBillTypeID | 单据类型 | QTRKD02_SYS | |
FStockOrgId | 库存组织 | | |
FDate | 日期 | {{created}} | |
FSUPPLIERID | 供应商 | | |
FDEPTID | 部门 | 007.02 | |
FNOTE | 备注 | {{remark}} | |
FRKYY | 其他入库原因 | 1001 | |
FEntity | 明细信息 | | |
FEntity.FMATERIALID | 物料编码 | {{details_list.spec_no}} | |
FEntity.FCMKBarCode | 零售条形码 | | |
FEntity.FSTOCKID | 收货仓库 | {{warehouse_no}} | |
FEntity.FQty | 实收数量 | _function {{details_list.new_num}}-{{details_list.old_num}} | |
FEntity.FPrice | 成本价 | {{details_list.cost_price}} | |
FEntity.FEntryNote | 备注 | | |
FEntity.FormId | 业务对象表单Id | STK_MISCELLANEOUS | |
FEntity.IsVerifyBaseDataField | 验证基础资料 | false | |
FEntity.Operation | 执行的操作 | Save | |
FEntity.IsAutoSubmitAndAudit | 提交并审核 | true | |
系统集成总览
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。
