金蝶云星空与聚水潭对接集成物料查询连通商品上传(新)(物料对接聚水潭)

对接系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
对接目标系统:聚水潭
聚水潭成立于2014年,创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初,以电商SaaSERP切入市场,凭借出色的产品和服务,快速获得市场的肯定。随着客户需求的不断变化,如今聚水潭已经发展成为以SaaSERP为核心,集多种商家服务为一体的SaaS协同平台。经过8年多的发展,公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点,服务范围覆盖超过400个城镇,为客户提供及时、周到和专业的服务。
数据对接方案
通过轻易云系统数据集成平台新增创建集成方案,通过轻易云的方案市场可以一键复制,并且可以借鉴其他的方案配置完成方案制作,方案制作只需要两步,第一步先确定好对应的数据来源;源系统:金蝶云星空接口:物料查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统:聚水潭接口:商品上传(新),通过写入调度者匹配获取到的数据和写入的映射关系,即可自动生成符合目标系统:聚水潭写入的数据自动产生写入队列,通过运行概况,系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

金蝶云星空接口明细
- API:executeBillQuery
- NAME:物料查询
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FMATERIALID | 实体主键 | FMATERIALID | |
FNumber | 编码 | FNumber | |
FName | 名称 | FName | |
FSpecification | 规格型号 | FSpecification | |
FOldNumber | 旧物料编码 | FOldNumber | |
FBARCODE | 条码 | FBARCODE | |
FDescription | 描述 | FDescription | |
FMaterialGroup_FNumber | 物料分组 | FMaterialGroup.FNumber | |
FErpClsID | 物料属性 | FErpClsID | |
FDocumentStatus | 数据状态 | FDocumentStatus | |
FForbidStatus | 禁用状态 | FForbidStatus | |
FBaseUnitId_FNumber | 基本单位.编码 | FBaseUnitId.FNumber | |
FCreateOrgId_FNumber | 创建组织 | FCreateOrgId.FNumber | |
FUseOrgId_FNumber | 使用组织 | FUseOrgId.FNumber | |
FIsInventory | 允许库存 | FIsInventory | |
FIsSale | 允许销售 | FIsSale | |
FIsAsset | 允许资产 | FIsAsset | |
FIsSubContract | 允许委外 | FIsSubContract | |
FIsProduce | 允许生产 | FIsProduce | |
FIsPurchase | 允许采购 | FIsPurchase | |
FStockId_FNumber | 仓库 | FStockId.FNumber | |
FPurchaseOrgId_FNumber | 采购组织.编码 | FPurchaseOrgId.FNumber | |
FPurchaseOrgId_FName | 采购组织 | FPurchaseOrgId.FName | |
FIsBatchManage | 启用批号管理 | FIsBatchManage | |
FIsKFPeriod | 启用保质期管理 | FIsKFPeriod | |
FIsSNManage | 启用序列号管理 | FIsSNManage | |
FSafeStock | 安全库存 | FSafeStock | |
FCategoryID | 存货类别 | FCategoryID | |
FExpPeriod | 保质期 | FExpPeriod | |
FOrderQty | 起订量 | FOrderQty | |
FMinQty | 最小批量 | FMinQty | |
FMaxQty | 最大批量 | FMaxQty | |
FDefaultVendor_FNumber | 默认供应商 | FDefaultVendor.FNumber | |
FMaxPOQty | 最大订货量 | FMaxPOQty | |
FMinPOQty | 最小订货量 | FMinPOQty | |
FIncreaseQty | 最小包装量 | FIncreaseQty | |
FFixLeadTime | 固定提前期 | FFixLeadTime | |
FVarLeadTime | 变动提前期 | FVarLeadTime | |
FPlanBatchSplitQty | 拆分批量 | FPlanBatchSplitQty | |
FProduceBillType_FNumber | 生产类型 | FProduceBillType.FNumber | |
FPOBillTypeId_FNumber | 采购类型 | FPOBillTypeId.FNumber | |
FSubBillType_FNumber | 委外类型 | FSubBillType.FNumber | |
FGROSSWEIGHT | 毛重 | FGROSSWEIGHT | |
FNETWEIGHT | 净重 | FNETWEIGHT | |
FWEIGHTUNITID_FNumber | 重量单位 | FWEIGHTUNITID.FNumber | |
FLENGTH | 长 | FLENGTH | |
FWIDTH | 宽 | FWIDTH | |
FHEIGHT | 高 | FHEIGHT | |
FVOLUME | 体积 | FVOLUME | |
FWARRANTY | 保修期 | FWARRANTY | |
FSalePrice_CMK | 零售价 | FSalePrice_CMK | |
FVIPPrice_CMK | 会员价 | FVIPPrice_CMK | |
FPurPrice_CMK | 采购单价 | FPurPrice_CMK | |
FComBrandId_CMK_FNumber | 品牌 | FComBrandId_CMK.FNumber | |
Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
TopRowCount | 返回总行数 | | 金蝶的查询分页参数 |
FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' FUseOrgId.FNumber='101' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
FieldKeys | 需查询的字段key集合 | | 金蝶分录主键ID格式:FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
FormId | 业务对象表单Id | BD_MATERIAL | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
FMATERIALID | 实体主键 | | |
FNumber | 编码 | | |
FName | 名称 | | |
FSpecification | 规格型号 | | |
FOldNumber | 旧物料编码 | | |
FBARCODE | 条码 | | |
FDescription | 描述 | | |
FMaterialGroup_FNumber | 物料分组 | | |
FErpClsID | 物料属性 | | |
FDocumentStatus | 数据状态 | | |
FForbidStatus | 禁用状态 | | |
FBaseUnitId_FNumber | 基本单位.编码 | | |
FCreateOrgId_FNumber | 创建组织 | | |
FUseOrgId_FNumber | 使用组织 | | |
FIsInventory | 允许库存 | | |
FIsSale | 允许销售 | | |
FIsAsset | 允许资产 | | |
FIsSubContract | 允许委外 | | |
FIsProduce | 允许生产 | | |
FIsPurchase | 允许采购 | | |
FStockId_FNumber | 仓库 | | |
FPurchaseOrgId_FNumber | 采购组织.编码 | | |
FPurchaseOrgId_FName | 采购组织 | | |
FIsBatchManage | 启用批号管理 | | |
FIsKFPeriod | 启用保质期管理 | | |
FIsSNManage | 启用序列号管理 | | |
FSafeStock | 安全库存 | | |
FCategoryID | 存货类别 | | |
FExpPeriod | 保质期 | | |
FOrderQty | 起订量 | | |
FMinQty | 最小批量 | | |
FMaxQty | 最大批量 | | |
FDefaultVendor_FNumber | 默认供应商 | | |
FMaxPOQty | 最大订货量 | | |
FMinPOQty | 最小订货量 | | |
FIncreaseQty | 最小包装量 | | |
FFixLeadTime | 固定提前期 | | |
FVarLeadTime | 变动提前期 | | |
FPlanBatchSplitQty | 拆分批量 | | |
FProduceBillType_FNumber | 生产类型 | | |
FPOBillTypeId_FNumber | 采购类型 | | |
FSubBillType_FNumber | 委外类型 | | |
FGROSSWEIGHT | 毛重 | | |
FNETWEIGHT | 净重 | | |
FWEIGHTUNITID_FNumber | 重量单位 | | |
FLENGTH | 长 | | |
FWIDTH | 宽 | | |
FHEIGHT | 高 | | |
FVOLUME | 体积 | | |
FWARRANTY | 保修期 | | |
FSalePrice_CMK | 零售价 | | |
FVIPPrice_CMK | 会员价 | | |
FPurPrice_CMK | 采购单价 | | |
FComBrandId_CMK_FNumber | 品牌 | | |
聚水潭接口明细
- 调用接口:jushuitan.itemsku.upload
- 接口名称:商品上传(新)
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
sku_id | 商品编码 | string | {{FNumber}} |
unit | 单位 | string | {{FBaseUnitId_FName}} |
shelf_life | 保质期 | int | function case when '{{FExpPeriod}}'>0 then '1095' else '' end |
i_id | 款式编码 | string | {{FNumber}} |
brand | 品牌,可更新 | string | {{F_ABCD_ASSISTANT}} |
vc_name | 虚拟分类,可更新 | string | |
c_name | 商品分类,必须是[商品类目管理]中的叶子节点,可更新 | string | {{FMaterialGroup_Fname}} |
s_price | 基本售价,可更新 | float | 1 |
item_type | 商品属性,可选值["成品", "半成品", "原材料", "包材"],可更新 | string | 成品 |
l | 长,可更新 | float | |
w | 宽,可更新 | float | |
h | 高,可更新 | float | |
pic | 图片地址,可更新 | string | |
pic_big | 大图地址,可更新 | string | |
sku_pic | 商品图片,可更新 | string | |
name | 名称,可更新 | string | {{FName}} |
remark | 备注,可更新 | string | |
properties_value | 颜色及规格,可更新 | string | {{FSpecification}} |
short_name | 简称,可更新 | string | |
weight | 重量,可更新 | float | |
enabled | 是否启用,默认值1, 可选值: -1=禁用, 0=备用, 1=启用,可更新 | int | 1 |
supplier_name | 供应商名称,可更新 | string | |
supplier_sku_id | 供应商商品编码,可更新 | string | |
supplier_i_id | 供应商款式编码,可更新 | string | |
other_price_1 | 其它价格1,可更新 | float | |
other_price_2 | 其它价格2,可更新 | float | |
other_price_3 | 其它价格3,可更新 | float | |
other_price_4 | 其它价格4,可更新 | float | |
other_price_5 | 其它价格5,可更新 | float | |
other_1 | 其它属性1,可更新 | string | |
other_2 | 其它属性2,可更新 | string | |
other_3 | 其它属性3,可更新 | string | |
other_4 | 其它属性4,可更新 | string | |
other_5 | 其它属性5,可更新 | string | |
stock_disabled | 禁止同步,true=禁止,false=允许,可更新 | bool | false |
cost_price | 成本价,可更新 | float | |
market_price | 市场 | 吊牌价,可更新 | float | |
batch_enabled | 是否启用生产批次 | bool | _function case when '{{FIsBatchManage}}'=' ' then false else false end |
dataKey | dataKey | string | items |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
code | 错误码,0代表成功 | string | |
issuccess | true代表成功 | string | |
msg | 执行描述 | string | |
系统数据集成价值
采集并引入全业务、多终端、多形态的数据,经过处理以及对应平台接口的数据结构适配,形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施,将沉淀的业务数据进入到平台进行体系化的加工,再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。


