金蝶云星辰V1对接打通锐思WMS商品查询接口与物料新增接口
对接源平台:金蝶云星辰V1
金蝶云星辰是金蝶集团公司为小微型工商贸企业定制的一款集财务、进销存、订货商城和税务管理为一体的SAAS云平台，有标准版和专业版两个版本，标准版适用于小型企业(10-50人)业财一体化管理，专业版面向小型(10-100人)企业管理需求。金蝶云星辰聚焦小型企业在线经营和数字化管理，赋能小型企业拓客开源、智能管理和实时决策。
对接系统：锐思WMS
仓库管理(WMS)解决方案通过协调和优化资源使用和物料流动，助力企业充分利用劳动力、空间和所投资的设备。具体而言，WMS系统旨在满足整个供应链的需求，包括分销、制造、资产密集型和服务业务。
接口方案配置
通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星辰V1，然后选择对应的连接器。选择对应的jdy/basedata/material_list作为数据对接来源。然后再写入目标平台配置目标系统为锐思WMS，并且选择对应连接器（关于锐思WMS的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的/material/add接口作为数据写入动作完成第一步的接口配置。
金蝶云星辰V1接口明细
- 接口：/jdy/v2/bd/material
- 接口名称：商品查询
- 接口方法：GET
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| enable | 可用状态 | string | 可用状态，1：可用，0：禁用,-1：全部 |
| search | 模糊搜索 | string | 模糊搜索-名称、编码、规格、条形码 |
| parent | 商品类别 | string | 商品类别ID |
| isdataperm | 数据权限 | string | 是否添加数据权限校验，默认false |
| create_start_time | 创建开始时间戳 | string | 开始时间（格式：“时间戳”，-1表示不过滤），创建时间 |
| create_end_time | 创建结束时间戳 | string | 结束时间（格式：“时间戳”，-1表示不过滤），创建时间 |
| modify_start_time | 修改开始时间戳 | string | 开始时间（格式：“时间戳”，-1表示不过滤），修改时间 |
| modify_end_time | 修改结束时间戳 | string | 结束时间（格式：“时间戳”，-1表示不过滤），修改时间 |
| page | 当前页 | string | 当前页（默认1） |
| page_size | 每页显示条数 | string | 每页显示条数（默认10，最大100） |
| show_units | 多单位信息 | string | 是否返回多单位信息，true：返回，默认false |
| show_images | 图片信息 | string | 是否返回图片信息，true：返回，默认false |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| id | ID | string | |
| number | 编码 | string | |
| name | 名称 | string | |
| parent_id | 类别id | string | |
| parent_name | 类别名称 | string | |
| parent_number | 类别编码 | string | |
| ismulti_unit | 是否多单位 | string | |
| isserial | 是否序列号 | string | |
| isasstattr | 是否辅助属性是 | string | |
| isweight | 启用称重 | string | |
| iskfperiod | 是否保质期 | string | |
| isbatch | 是否批次 | string | |
| url | 商品主图 | string | |
| model | 商品规格 | string | |
| barcode | 商品条形码 | string | |
| isshowauxbarcode | 是否开启辅助属性条码 | string | |
| mullabel | 商品标签 | string | |
| checktype | 商品类别1：普通2：套装3：服务 | string | |
| brandid_id | 品牌id | string | |
| brandid_name | 品牌名称 | string | |
| brandid_number | 品牌编码 | string | |
| producingpace | 产地 | string | |
| helpcode | 助记码 | string | |
| baseunitid_id | 计量单位id | string | |
| baseunitid_number | 计量单位编码 | string | |
| baseunitid_name | 计量单位名称 | string | |
| remark | 备注 | string | |
锐思WMS接口明细
- 接口：/material/add
- 接口名称：物料新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| materialNo | 物料编码 | string | |
| materialName | 物料 | string | |
| mgNo | 物料分类编码 | string | |
| barcode | 条码 | string | |
| caseBarcode | 外箱条码 | string | |
| isHp | 重物轻物 | string | |
| status | 物料状态 | string | |
| baseUnit | 辅助计量单位编码 | string | |
| minUnit | 最小计量单位编码 | string | |
| weight | 重量 | string | |
| weightUnit | 重量单位编码 | string | |
| volume | 体积 | string | |
| volumeUnit | 体积单位编码 | string | |
| wholeQty | 盘码规则 | string | |
| isKfperiod | 是否启用生产日期 | string | |
| isUseLot | 是否启用批次 | string | |
| coefficient | 转换系数 | string | |
| expiryDay | 保质期(天) | string | |
| safetyStock | 安全库存 | string | |
| memo | 备注 | string | |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| code | 状态码 | string | |
| datetime | 返回值 | string | |
| message | 消息 | string | |
| result | 返回信息(LIST) | string | |
| flag | 操作结果 | string | |
| data | 返回值 | string | |
| materialNo | 物料编码 | string | |
| info | 消息 | string | |
系统对接总览
通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。 而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。
