金蝶云星空和管易云接口打通对接实战

数据源平台:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
目标系统:管易云
管易云是上海管易云计算软件有限公司旗下的专注提供电商企业管理软件服务的品牌,总部位于中国上海张江高科技产业园区。管易云旗下拥有管易云C-ERP、EC-OMS、EC-WMS、B2C/B2B/BBC/微商城开发、PDA无纸化仓储解决方案、新零售一体化解决方案等产品
配置集成方案
通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程,将金蝶云星空、管易云之间接口数据联通,支持数据在线预览、数据集成流程全过程调试,Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能,用户通过可视化的拖、拽即可完成数据处理逻辑,将数据加工处理后分发到下游业务系统或其他异构存储中。

金蝶云星空接口明细
- 调用接口:executeBillQuery
- 接口名称:物料查询
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| FMasterId | id | string | FMasterId |
| FNumber | 编码 | string | FNumber |
| FName | 名称 | string | FName |
| FSpecification | 规格型号 | string | FSpecification |
| FMnemonicCode | 助记码 | string | FMnemonicCode |
| FOldNumber | 旧物料编码 | string | FOldNumber |
| FBARCODE | 条码 | string | FBARCODE |
| FDescription | 描述 | string | FDescription |
| FMaterialGroup_FNumber | 物料分组 | string | FMaterialGroup.FNumber |
| FErpClsID | 物料属性 | string | FErpClsID |
| FDocumentStatus | 数据状态 | string | FDocumentStatus |
| FForbidStatus | 禁用状态 | string | FForbidStatus |
| FBaseUnitId_FNumber | 基本单位.编码 | string | FBaseUnitId.FNumber |
| FCreateOrgId_FNumber | 创建组织 | string | FCreateOrgId.FNumber |
| FUseOrgId_FNumber | 使用组织 | string | FUseOrgId.FNumber |
| FIsInventory | 允许库存 | string | FIsInventory |
| FIsSale | 允许销售 | string | FIsSale |
| FIsAsset | 允许资产 | string | FIsAsset |
| FIsSubContract | 允许委外 | string | FIsSubContract |
| FIsProduce | 允许生产 | string | FIsProduce |
| FIsPurchase | 允许采购 | string | FIsPurchase |
| FTAXRATEID_FNumber | 默认税率 | string | FTAXRATEID.FNumber |
| FStockId_FNumber | 仓库 | string | FStockId.FNumber |
| FPurchaseOrgId_FNumber | 采购组织.编码 | string | FPurchaseOrgId.FNumber |
| FPurchaseOrgId_FName | 采购组织 | string | FPurchaseOrgId.FName |
| FIsBatchManage | 启用批号管理 | string | FIsBatchManage |
| FIsKFPeriod | 启用保质期管理 | string | FIsKFPeriod |
| FIsSNManage | 启用序列号管理 | string | FIsSNManage |
| FSafeStock | 安全库存 | string | FSafeStock |
| FCategoryID | 存货类别 | string | FCategoryID |
| FExpPeriod | 保质期 | string | FExpPeriod |
| FOrderQty | 起订量 | string | FOrderQty |
| FMinQty | 最小批量 | string | FMinQty |
| FMaxQty | 最大批量 | string | FMaxQty |
| FDefaultVendor_FNumber | 默认供应商 | string | FDefaultVendor.FNumber |
| FMaxPOQty | 最大订货量 | string | FMaxPOQty |
| FMinPOQty | 最小订货量 | string | FMinPOQty |
| FIncreaseQty | 最小包装量 | string | FIncreaseQty |
| FFixLeadTime | 固定提前期 | string | FFixLeadTime |
| FVarLeadTime | 变动提前期 | string | FVarLeadTime |
| FPlanBatchSplitQty | 拆分批量 | string | FPlanBatchSplitQty |
| FProduceBillType_FNumber | 生产类型 | string | FProduceBillType.FNumber |
| FPOBillTypeId_FNumber | 采购类型 | string | FPOBillTypeId.FNumber |
| FSubBillType_FNumber | 委外类型 | string | FSubBillType.FNumber |
| FGROSSWEIGHT | 毛重 | string | FGROSSWEIGHT |
| FNETWEIGHT | 净重 | string | FNETWEIGHT |
| FWEIGHTUNITID_FNumber | 重量单位 | string | FWEIGHTUNITID.FNumber |
| FLENGTH | 长 | string | FLENGTH |
| FWIDTH | 宽 | string | FWIDTH |
| FHEIGHT | 高 | string | FHEIGHT |
| FVOLUME | 体积 | string | FVOLUME |
| FWARRANTY | 保修期 | string | FWARRANTY |
| FSalePrice_CMK | 零售价 | string | FSalePrice_CMK |
| FVIPPrice_CMK | 会员价 | string | FVIPPrice_CMK |
| FPurPrice_CMK | 采购单价 | string | FPurPrice_CMK |
| FComBrandId_CMK_FNumber | 品牌 | string | FComBrandId_CMK.FNumber |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FDOCUMENTSTATUS='C' and FMODIFYDATE>='{{LAST_SYNC_TIME dateTime}}' |
| FieldKeys | 需查询的字段key集合 | array | |
| FormId | 业务对象表单Id | string | BD_MATERIAL |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
| FMasterId | id | string | |
| FNumber | 编码 | string | |
| FName | 名称 | string | |
| FSpecification | 规格型号 | string | |
| FMnemonicCode | 助记码 | string | |
| FOldNumber | 旧物料编码 | string | |
| FBARCODE | 条码 | string | |
| FDescription | 描述 | string | |
| FMaterialGroup_FNumber | 物料分组 | string | |
| FErpClsID | 物料属性 | string | |
| FDocumentStatus | 数据状态 | string | |
| FForbidStatus | 禁用状态 | string | |
| FBaseUnitId_FNumber | 基本单位.编码 | string | |
| FCreateOrgId_FNumber | 创建组织 | string | |
| FUseOrgId_FNumber | 使用组织 | string | |
| FIsInventory | 允许库存 | string | |
| FIsSale | 允许销售 | string | |
| FIsAsset | 允许资产 | string | |
| FIsSubContract | 允许委外 | string | |
| FIsProduce | 允许生产 | string | |
| FIsPurchase | 允许采购 | string | |
| FTAXRATEID_FNumber | 默认税率 | string | |
| FStockId_FNumber | 仓库 | string | |
| FPurchaseOrgId_FNumber | 采购组织.编码 | string | |
| FPurchaseOrgId_FName | 采购组织 | string | |
| FIsBatchManage | 启用批号管理 | string | |
| FIsKFPeriod | 启用保质期管理 | string | |
| FIsSNManage | 启用序列号管理 | string | |
| FSafeStock | 安全库存 | string | |
| FCategoryID | 存货类别 | string | |
| FExpPeriod | 保质期 | string | |
| FOrderQty | 起订量 | string | |
| FMinQty | 最小批量 | string | |
| FMaxQty | 最大批量 | string | |
| FDefaultVendor_FNumber | 默认供应商 | string | |
| FMaxPOQty | 最大订货量 | string | |
| FMinPOQty | 最小订货量 | string | |
| FIncreaseQty | 最小包装量 | string | |
| FFixLeadTime | 固定提前期 | string | |
| FVarLeadTime | 变动提前期 | string | |
| FPlanBatchSplitQty | 拆分批量 | string | |
| FProduceBillType_FNumber | 生产类型 | string | |
| FPOBillTypeId_FNumber | 采购类型 | string | |
| FSubBillType_FNumber | 委外类型 | string | |
| FGROSSWEIGHT | 毛重 | string | |
| FNETWEIGHT | 净重 | string | |
| FWEIGHTUNITID_FNumber | 重量单位 | string | |
| FLENGTH | 长 | string | |
| FWIDTH | 宽 | string | |
| FHEIGHT | 高 | string | |
| FVOLUME | 体积 | string | |
| FWARRANTY | 保修期 | string | |
| FSalePrice_CMK | 零售价 | string | |
| FVIPPrice_CMK | 会员价 | string | |
| FPurPrice_CMK | 采购单价 | string | |
| FComBrandId_CMK_FNumber | 品牌 | string | |
管易云接口明细
- API:gy.erp.item.add
- NAME:商品新增
- METHOD:POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
| code | 商品代码 | {{FNumber}} | |
| name | 商品名称 | {{FName}} | |
| item_brand_id | 商品品牌id | | |
| item_brand_code | 商品品牌代码 | | |
| simple_name | 商品简称 | {{FName}} | |
| category_code | 商品分类code | | |
| supplier_code | 供应商code | | |
| note | 备注 | | |
| minusStock | 是否启用负库存 | | |
| item_add_attribute | 商品附加属性 | function case '{{FIsBatchManage}}' when '1' then 2 when '0' then '0' else '0' end | |
| pic_url | 图片url | | |
| tax_code | 税收分类编码 | | |
| tax_no | 商品税号 | | |
| tax_rate | 商品税率 | _function case '{{FTAXRATEID_FNumber}}' when 'SL01_SYS' then 17 when 'SL02_SYS' then 13 when 'SL03_SYS' then 7 when 'SL04_SYS' then 0 when 'SL05_SYS' then 11 when 'SL06_SYS' then 6 when 'SL07_SYS' then 3 when 'SL08_SYS' then 16 when 'SL45_SYS' then 12 when 'SL09_SYS' then 10 else 0 end | |
| unit_code | 商品单位code | | |
| supplier_outer_id | 供应商货号 | | |
| weight | 商品重量 | {{FNETWEIGHT}} | |
| length | 长 | {{FLENGTH}} | |
| width | 宽 | {{FWIDTH}} | |
| height | 高 | {{FHEIGHT}} | |
| volume | 商品体积 | {{FVOLUME}} | |
| package_point | 打包积分 | | |
| sales_point | 销售积分 | | |
| sales_price | 标准售价 | | |
| purchase_price | 标准进价 | | |
| cost_price | 成本价 | | |
| agent_price | 代理售价 | | |
| stock_status_code | 库存状态code | | |
系统集成总览
通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线,传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能,已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。 而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线,能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。
