金蝶云星空对接打通管易云物料查询接口与商品新增接口

数据源平台:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接系统:管易云
金蝶管易云是金蝶集团旗下以电商和新零售为核心业务的子公司,公司于2008年成立,拥有从事电商及新零售业务相关专业知识工作者超过1000人。为伊利、网易有道、东阿阿胶、金龙鱼、海康、科大讯飞等超过110000家企业客户提供专业服务,用户数超过100万人。金蝶管易云与淘宝、天猫、京东、拼多多、抖音等超过150+主流电商平台建立合作关系。
配置集成方案
使用系统数据集成平台对应的模块:数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统:金蝶云星空,然后选择对应的连接器。选择对应的物料查询作为数据对接来源。然后再通过写入目标平台配置目标系统为管易云,并且选择对应连接器(关于管易云的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的商品新增接口作为数据写入动作,既可以完成第一步的数据对接配置。

金蝶云星空接口明细
- 调用接口:executeBillQuery
- 接口名称:物料查询
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FMATERIALID | 实体主键 | string | FMATERIALID |
FNumber | 编码 | string | FNumber |
FName | 名称 | string | FName |
FSpecification | 规格型号 | string | FSpecification |
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 |
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 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' |
FieldKeys | 需查询的字段key集合 | array | |
FormId | 业务对象表单Id | string | BD_MATERIAL |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
FMATERIALID | 实体主键 | string | |
FNumber | 编码 | string | |
FName | 名称 | string | |
FSpecification | 规格型号 | 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 | |
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 | 商品简称 | | |
category_code | 商品分类code | {{FMaterialGroup_FNumber}} | |
supplier_code | 供应商code | | |
note | 备注 | | |
minusStock | 是否启用负库存 | false | |
item_add_attribute | 商品附加属性 | | |
pic_url | 图片url | | |
tax_code | 税收分类编码 | | |
tax_no | 商品税号 | | |
tax_rate | 商品税率 | | |
unit_code | 商品单位code | {{FBaseUnitId_FNumber}} | |
supplier_outer_id | 供应商货号 | | |
weight | 商品重量 | | |
length | 长 | {{FLENGTH}} | |
width | 宽 | {{FWIDTH}} | |
height | 高 | {{FHEIGHT}} | |
volume | 商品体积 | {{FVOLUME}} | |
package_point | 打包积分 | | |
sales_point | 销售积分 | | |
sales_price | 标准售价 | | |
purchase_price | 标准进价 | | |
cost_price | 成本价 | | |
agent_price | 代理售价 | | |
stock_status_code | 库存状态code | | |
skus | skus | | |
skus.sku_code | 规格代码 | {{FNumber}} | |
skus.sku_name | 规格名称 | {{FName}} | |
skus.sku_weight | 规格重量 | | |
skus.sku_purchase_price | 规格标准进价 | | |
skus.sku_sales_price | 规格标准售价 | | |
skus.sku_agent_price | 规格代理售价 | | |
skus.sku_cost_price | 规格成本价 | | |
skus.sku_package_point | 规格打包积分 | | |
skus.sku_sales_point | 规格销售积分 | | |
skus.sku_note | 规格备注 | | |
系统数据集成价值
异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下,这两个系统都是分别独立部署和运行的,各自拥有不同的技术栈和编程模型,甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案,可以满足客户的实际业务需求,推动软件工程的规范化,使开发人员遵循统一的概要设计开发实现,降低系统实现的风险,做到系统设计资料的规范性与全面性,以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合:打破企业内部数据孤岛,无需繁琐的处理工序,与数据集成服务完美结合,让数据真正通起来。 资源互补:汇集各种行业解决方案,资源互补,企业管理融合提升。

