吉客云对接打通金蝶云星空分页查询货品信息接口与物料新增接口
源系统:吉客云
“吉客云”是一站式企业数字化解决方案系统，可实现业务、财务、办公、人事等一体化管理。相对于传统多套软件系统的集成方案，“吉客云”具有业务流程更流畅，数据共享更充分，使用成本更低廉等优势。不仅如此，通过“吉链”，可以快捷的与您的合作伙伴进行系统对接。同时“吉客云”还打造了供销关系、仓储委托关系、生产委外加工关系、物流代发关系等多种企业间数字化协作通道，数据对接就像加微信好友一样方便！
集成系统:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据对接方案
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取吉客云的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。
吉客云接口明细
- API：erp.storage.goodslist
- NAME：分页查询货品信息
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| pageIndex | 分页页码 | | |
| pageSize | 分页页数 | 50 | |
| goodsNo | 货品编号 | | |
| skuBarcode | 条码 | | |
| goodsName | 货品名称 | | |
| skuName | 规格名称 | | |
| abcCate | ABC分类(A类,B类,C类) | | |
| startDate | 创建起始时间 | | |
| endDate | 创建结束时间 | | |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| imgUrl | 图片地址 | | http:asasda.png |
| isMainImage | 是否主图 0-是 1-否 | | 1 |
| imagePosition | 图片位置main-主图 left-左侧图 right-右侧图 | | left |
| imgKey | 图片地址key | | 美美哒.png |
| skuIsBlockup | 规格是否停用 0 否 1 是 | | |
| abcCate | ABC分类(A类,B类,C类) | | A类 |
| skuLength | 长 | | 2 |
| skuWidth | 宽 | | 1 |
| skuHeight | 高 | | 4 |
| colorCode | 颜色编码 | | 1 |
| goodsId | 货品ID | | 1123123 |
| colorName | 颜色名称 | | 4 |
| goodsNo | 货品编号 | | 货品编号 |
| goodsName | 货品名称 | | 货品名称 |
| sizeCode | 尺码编号 | | 1 |
| sizeName | 尺寸名称 | | 2 |
| skuName | 规格名称 | | 规格名称 |
| skuWeight | 重量(g) | | 1.2 |
| skuId | 规格ID | | 1212 |
| volume | 体积（cm³） | | 1 |
| skuBarcode | 条码 | | code_0001 |
| goodsGmtModified | 货品修改时间 | | 1631020179000 |
| unitName | 单位 | | 个 |
| cateId | 分类ID | | 12 |
| cateName | 分类 | | 服装 |
| brandId | 品牌ID | | 12 |
| brandName | 品牌 | | 活鼎红 |
| skuCode | 外部货品code | | 123 |
| goodsDesc | 货品描述 | | 货品描述 |
| goodsAlias | 货品别名 | | 货品别名 |
| goodsField | 货品自定义字段，对应吉客云自定义属性 | | 货品自定义字段 |
| skuImgUrl | 规格图片 | | http:2qwuqweuq.png |
| extendValue | 自定义项 | | "{\"extend843337487958029056\":\"121.0000\",\"extend855097154722339968\":\"驱蚊器二去\"}", |
| imgUrlList | 货品图片详情 | | |
金蝶云星空接口明细
- 调用接口：batchSave
- 接口名称：物料新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FName | 名称 | string | |
| FNumber | 编码 | string | |
| FDescription | 描述 | string | |
| FCreateOrgId | 创建组织 | string | |
| FUseOrgId | 使用组织 | string | |
| FSpecification | 规格型号 | string | |
| FMnemonicCode | 助记码 | string | |
| FMaterialGroup | 物料分组 | string | |
| SubHeadEntity | 基本 | object | |
| SubHeadEntity.FErpClsID | 物料属性 | string | |
| SubHeadEntity.FBaseUnitId | 基本单位 | string | |
| SubHeadEntity.FCategoryID | 存货类别 | string | |
| 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资产的可插拔、可复用、可组成。
