旺店通·企业奇门与金蝶云星辰V1对接集成查询货品档案连通商品新增(wk_物料同步)
对接源平台:旺店通·企业奇门
慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。
写入目标:金蝶云星辰V1
金蝶云星辰是金蝶集团公司为小微型工商贸企业定制的一款集财务、进销存、订货商城和税务管理为一体的SAAS云平台，有标准版和专业版两个版本，标准版适用于小型企业(10-50人)业财一体化管理，专业版面向小型(10-100人)企业管理需求。金蝶云星辰聚焦小型企业在线经营和数字化管理，赋能小型企业拓客开源、智能管理和实时决策。
接口方案配置
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取旺店通·企业奇门的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星辰V1中。轻易云集成平台的可视化配置轻松实现。
旺店通·企业奇门接口明细
- 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代表已删除 |
金蝶云星辰V1接口明细
- 接口：jdy/basedata/material_batch_save
- 接口名称：商品新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| items | items | array | |
| items.number | 商品编码 | string | 商品编码,不传递则由后台生成（不设置有编码规则和更新时必传） |
| items.name | 商品名称 | string | 商品名称 |
| items.baseunitid_id | 计量单位id | string | 计量单位id |
| items.parent_id | 商品类别id | string | 商品类别id |
| items.model | 规格型号 | string | 规格型号 |
| items.purchaseunitid_id | 采购单位 | string | 采购单位,单单位时传递计量单位 |
| items.saleunitid_id | 销售单位 | string | 销售单位,单单位时传递计量单位 |
| items.storeunitid_id | 库存单位 | string | 库存单位,单单位时传递计量单位 |
| items.producunitid_id | 库存单位 | string | 生产单位 |
| items.auxunitid_id | 报表辅助单位 | string | 库存单位,单单位时传递计量单位 |
| items.issale | 是否可销售 | string | 是否可销售 |
| items.ispurchase | 是否可采购 | string | 是否可采购 |
| items.issubpart | 是否可为子件 | string | 是否可为子件 |
| items.isassembly | 是否可为组件 | string | 是否可为组件 |
| items.inv_mgr_type | 库存管理方式 | string | 库存管理方式,0：统一库存，1：分仓库存,默认统一库存 |
| items.costmethod | 成本计算方法 | string | 成本计算方法,默认为移动平均法,1：移动平均法，2：加权平均法，3：先进先出法 |
| items.taxrate | 税率 | string | 税率 |
| items.stockid_id | 默认仓库 | string | 默认仓库 |
| items.spaceid_id | 默认仓位 | string | 默认仓位 |
| items.venderid_id | 默认供应商 | string | 默认供应商 |
| items.purchaseid_id | 采购员 | string | 采购员 |
| items.refistrationnumber | 注册证号 | string | 注册证号 |
| items.prolicense | 生产许可证 | string | 生产许可证 |
| items.gross_weight | 毛重 | string | 毛重 |
| items.net_weight | 净重 | string | 净重 |
| items.length | 长 | string | 长 |
| items.wide | 宽 | string | 宽 |
| items.high | 高 | string | 高 |
| items.volume | 体积 | string | 体积 |
| items.images | 商品图片 | string | 商品图片,商品图片服务器连接(上传图片接口的返回值)的集合，多个用英文逗号分隔 |
| items.ignorewarn | 是否忽略告警信息 | string | 是否忽略告警信息(如：商品名称已存在)保存商品，true:忽略 |
系统数据集成价值
通过数据集成平台可视化的快速配置调用接口打通旺店通·企业奇门与金蝶云星辰V1之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。
