聚水潭和金蝶云星空单据接口集成数据源平台:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。对接系统：聚水潭聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。接口方案配置通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将金蝶云星空、聚水潭之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。金蝶云星空接口明细 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 系统打通概况当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

聚水潭和金蝶云星空单据接口集成

汪淼_轻易云

聚水潭和金蝶云星空单据接口集成

数据源平台:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

对接系统：聚水潭

聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。

接口方案配置

通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将金蝶云星空、聚水潭之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。

金蝶云星空接口明细

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

系统打通概况

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。