旺店通·企业奇门与金蝶云星空对接集成查询货品档案连通物料新增(货品档案)
源系统:旺店通·企业奇门
慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。
接入系统：金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
系统对接接口配置
通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：旺店通·企业奇门，并且选择对应的连接器（关于旺店通·企业奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的查询货品档案接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的物料新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
旺店通·企业奇门接口明细
- API：wdt.goods.query
- NAME：查询货品档案
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| deleted | 已删除货品 | | 默认为0, 0：只返回未删除货品 1：返回未删除和已删除货品 |
| barcode | 条码 | | |
| start_time | 开始时间 | {{LAST_SYNC_TIME datetime}} | 按最后修改时间增量查询数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss |
| end_time | 结束时间 | {{CURRENT_TIME datetime}} | |
| page_size | 分页大小 | {{PAGINATION_PAGE_SIZE}} | 每页返回的数据条数，输入值范围1100，不传本参数，输入值默认为40，使用举例单击这里 |
| page_no | 页号 | {{PAGINATION_START_PAGE}} | 不传值默认从0页开始 |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| goods_id | 货品ID | | 货品表主键 |
| goods_no | 货品编号 | | 代表SPU所有属性的唯一编号，用于系统货品的区分，SPU概念介绍，单击这里 |
| goods_name | 货品名称 | | 货品名称 |
| short_name | 简称 | | 简称 |
| alias | 货品别名 | | 货品别名 |
| goods_type | 货品类别 | | 货品类别 0:其它, 1:销售货品, 2:原材料, 3:包装物, 4:周转材料, 5:虚拟商品, 6:固定资产,7:保修配件 |
| spec_count | 规格数 | | 规格数 |
| pinyin | 拼音 | | 拼音 |
| brand_no | 品牌编号 | | 品牌编号 |
| brand_name | 品牌 | | 品牌名称 |
| remark | 备注 | | 备注 |
| prop1 | 自定义属性1 | | 自定义属性1 |
| prop2 | 自定义属性2 | | 自定义属性2 |
| prop3 | 自定义属性3 | | 自定义属性3 |
| prop4 | 自定义属性4 | | 自定义属性4 |
| prop5 | 自定义属性5 | | 自定义属性5 |
| prop6 | 自定义属性6 | | 自定义属性6 |
| origin | 产地 | | 产地 |
| class_id | 分类id | | 分类id |
| class_name | 分类 | | 分类名称 |
| brand_id | 品牌id | | 品牌ID |
| unit | 基本单位 | | 基本单位 |
| aux_unit | 辅助单位 | | 辅助单位 |
| flag_id | 标记 | | 标记 |
| properties | 属性 | | 属性 |
| version_id | 版本号 | | 版本号，用来检查同时修改的 |
| modified | 最后修改时间 | | 最后修改时间 格式：yyyy-MM-dd HH:mm:ss |
| created | 创建时间 | | 创建时间 格式：yyyy-MM-dd HH:mm:ss |
| unit_name | 基本单位 | | 基本单位名称 |
| aux_unit_name | 辅助单位 | | 辅助单位名称 |
| flag_name | 标记名称 | | 标记名称 |
| goods_created | 创建时间 | | 格式：yyyy-MM-dd HH:mm:ss。ERP客户端需升级至V2.3.8.6及以上版本可获取此字段 |
| goods_modified | 最后修改时间 | | 格式：yyyy-MM-dd HH:mm:ss |
| deleted | 是否已删除 | | 是否已删除： 0：未删除 >0代表已删除 |
| spec_list | 单品节点 | | 响应参数的2级数据节点，包含sku所有属性信息的数据节点,节点下数据字段详见下述"spec_list" |
| spec_list.spec_id | 规格ID | | 规格ID |
| spec_list.spec_no | 商家编码 | | 代表单品（SKU）所有属性的唯一编号，用于系统单品的区分，SKU概念介绍，单击这里 |
| spec_list.spec_code | 规格码 | | 规格码 |
| spec_list.barcode | 主条码 | | 主条码，单品下如果有多个条码，会随机返回其中一条条码 |
| spec_list.spec_name | 规格名称 | | 规格名称 |
| spec_list.lowest_price | 最低价 | | 最低价 |
| spec_list.retail_price | 零售价 | | 零售价 |
| spec_list.wholesale_price | 批发价 | | 批发价 |
| spec_list.member_price | 会员价 | | 会员价 |
| spec_list.market_price | 市场价 | | 市场价 |
| spec_list.custom_price1 | 自定义价格1 | | 自定义价格1 |
| spec_list.custom_price2 | 自定义价格2 | | 自定义价格2 |
| spec_list.sale_score | 销售积分 | | 销售积分 |
| spec_list.pack_score | 打包积分 | | 打包积分 |
| spec_list.pick_score | 拣货积分 | | 拣货积分 |
| spec_list.validity_days | 有效期天数 | | 保质期 |
| spec_list.sales_days | 最佳销售天数 | | 最佳销售天数 |
| spec_list.receive_days | 最佳收获天数 | | 最佳收获天数 |
| spec_list.weight | 重量 | | 重量 |
| spec_list.length | 长 | | 长(CM) |
| spec_list.width | 宽 | | 宽(CM) |
| spec_list.height | 高 | | 高(CM) |
| spec_list.is_sn_enable | 启用序列号 | | 0不启用序列号 1强序列号 2弱序列号 |
| spec_list.is_allow_neg_stock | 是否允许负库存 | | 0（不允许负库存）;1（允许负库存） |
| spec_list.is_not_need_examine | 是否出库不验货 | | 0（出库不验货）;1（出库必须验货） |
| spec_list.is_zero_cost | 是否允许0成本 | | 0（不允许0成本）;1（允许0成本） |
| spec_list.is_lower_cost | 是否允许低于成本价 | | 0（不允许低于成本价）;1（允许低于成本价） |
| spec_list.is_not_use_air | 是否航空禁运 | | 0(航空不禁运) 1(航空禁运); |
| spec_list.tax_rate | 税率 | | 税率 |
| spec_list.large_type | 大件类别 | | 0非大件1普通大件2独立大件 |
| spec_list.remark | 备注 | | 备注 |
| spec_list.spec_created | 创建时间 | | 格式：YYYY-MM-DD HH:MM:SS。ERP客户端需升级至V2.3.8.6及以上版本可获取此字段 |
| spec_list.spec_modified | 最后修改时间 | | 格式：YYYY-MM-DD HH:MM:SS |
| spec_list.prop1 | 自定义1 | | 自定义1 |
| spec_list.prop2 | 自定义2 | | 自定义2 |
| spec_list.prop3 | 自定义3 | | 自定义3 |
| spec_list.prop4 | 自定义4 | | 自定义4 |
| spec_list.prop5 | 自定义5 | | 自定义5 |
| spec_list.prop6 | 自定义6 | | 自定义6 |
| spec_list.img_url | 图片 | | 图片url |
| spec_list.tax_code_id | 税务编码 | | 关联税务表税务编码 |
| spec_list.is_single_batch | 是否使用同一批次 | | 是否启用同一批次， 0,不使用同一批次，1,使用同一批次 |
| spec_list.washing_label | 水洗标 | | 水洗标 |
| spec_list.unit | 基本单位 | | 基本单位 |
| spec_list.aux_unit | 辅助单位 | | 辅助单位 |
| spec_list.flag_id | 标记 | | 标记 |
| spec_list.img_key | 图片在外部空间的key | | 看图片在外部空间的key 比如说 云盘的一个 外链 |
| spec_list.barcode_count | 条码个数 | | 条码个数 |
| spec_list.plat_spec_count | 平台货品数量 | | 平台货品数量(不包含删除的) |
| spec_list.postfix_val | sn自增数 | | sn自增数 |
| spec_list.last_date | 最后日期 | | 最后日期 格式：yyyy-MM-dd HH:mm:ss |
| spec_list.replenish_type | 补货方式 | | 补货方式 0持续补货 1不补货 2低于警戒库存补货 |
| spec_list.is_popular | 是否畅销 | | 是否畅销 0非畅销 1畅销 |
| spec_list.replace_no | 备注换货匹配码 | | 备注换货匹配码 |
| spec_list.spec_mask | 单品标记二进制位 | | 单品标记二进制位 1同款备注换货虚拟规格 2是否在备注换货界面展示 |
| spec_list.replace_proportion | 同款备注换货 | | 同款备注换货--虚拟货品换货比例 |
| spec_list.extra_3 | 扩展字段 | | 扩展字段 |
| spec_list.tax_code | 税务编码 | | 税务编码 |
| spec_list.modified | 最后修改时间 | | 最后修改时间 格式：yyyy-MM-dd HH:mm:ss |
| spec_list.created | 创建时间 | | 创建时间 格式：yyyy-MM-dd HH:mm:ss |
| spec_list.spec_unit_name | 基本单位 | | 基本单位名称 |
| spec_list.spec_aux_unit_name | 辅助单位 | | 辅助单位名称 |
| spec_list.deleted | 是否已删除 | | 是否已删除：0：未删除 >0代表已删除 |
金蝶云星空接口明细
- 调用接口：batchSave
- 接口名称：物料新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FName | 名称 | string | {{goods_name}} |
| FNumber | 编码 | string | {{goods_no}} |
| FDescription | 描述 | string | |
| FCreateOrgId | 创建组织 | string | 100 |
| FUseOrgId | 使用组织 | string | 100 |
| FSpecification | 规格型号 | string | {{spec_list.spec_name}} |
| FMnemonicCode | 助记码 | string | |
| F_wyg_Base | 品牌 | string | {{brand_no}} |
| SubHeadEntity | 基本 | object | |
| SubHeadEntity.FErpClsID | 物料属性 | string | 1 |
| SubHeadEntity.FBaseUnitId | 基本单位 | string | Pcs |
| SubHeadEntity.FCategoryID | 存货类别 | string | CHLB01_SYS |
| SubHeadEntity.FBARCODE | 条形码 | string | |
| SubHeadEntity.SubHeadEntity1 | 库存 | object | |
| SubHeadEntity.SubHeadEntity1.FStockId | 仓库 | string | |
| SubHeadEntity.SubHeadEntity1.FSafeStock | 安全库存 | string | |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2 | 销售 | object | |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.FMaxQty | 最大批量 | string | |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.FMinQty | 最小批量 | string | |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3 | 采购 | object | |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FDefaultVendor | 默认供应商 | string | |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FPurchaseOrgId | 采购组织 | string | |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FormId | 业务对象表单Id | string | BD_MATERIAL |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.Operation | 执行的操作 | string | Save |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.IsVerifyBaseDataField | 验证基础资料 | bool | false |
系统对接总览
当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
