金蝶云星空和聚水潭接口打通对接实战数据源平台:金蝶云星空金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。对接目标系统:聚水潭聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。数据接口配置数据集成平台对应的配置金蝶云星空与聚水潭的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与聚水潭之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。金蝶云星空接口明细 API： executeBillQuery NAME：调拨单查询 METHOD： POST 请求参数接口字段字段名称预设值描述 FBillEntry_FEntryID FEntryID FBillEntry_FEntryID FID 实体主键 FID FBillNo 单据编号 FBillNo FDocumentStatus 单据状态 FDocumentStatus FStockOrgId_FNumber 调入库存组织 FStockOrgId.FNumber FDate 日期 FDate FBillTypeID_FNumber 单据类型 FBillTypeID.FNumber FTransferBizType 调拨类型 FTransferBizType FStockOutOrgId_FNumber 调出库存组织 FStockOutOrgId.FNumber FTransferDirect 调拨方向 FTransferDirect FNote 备注 FNote FBizType 业务类型 FBizType FSaleOrgId_FNumber 销售组织 FSaleOrgId.FNumber FSettleOrgId_FNumber 结算组织 FSettleOrgId.FNumber FCustID_FNumber 对应客户 FCustID.FNumber FSUPPLIERID_FNumber 对应供应商 FSUPPLIERID.FNumber FThirdSrcId 第三方源单内码 FThirdSrcId FThirdSrcBillNo 第三方源单编码 FThirdSrcBillNo FThirdSystem 第三方系统 FThirdSystem FMaterialId_FNumber 物料编码 FMaterialId.FNumber FLot 调出批号 FLot FSrcStockId_FNumber 调出仓库 FSrcStockId.FNumber FSrcStockLocId 调出仓位 FSrcStockLocId FDestStockId_FNumber 调入仓库 FDestStockId.FNumber FDestStockLocId 调入仓位 FDestStockLocId FQty 调拨数量 FQty FPrice 成本价 FPrice FAmount 总成本 FAmount FBomId BOM版本 FBomId FProduceDate 生产日期 FProduceDate FExpiryDate 有效期至 FExpiryDate FMtoNo 计划跟踪号 FMtoNo FSrcStockStatusId 调出库存状态 FSrcStockStatusId FDestStockStatusId 调入库存状态 FDestStockStatusId FOwnerId_FNumber 调入货主 FOwnerId.FNumber FOwnerOutId_FNumber 调出货主 FOwnerOutId.FNumber FSrcBillTypeId 源单类型 FSrcBillTypeId FSrcSeq 源单行号 FSrcSeq FOrderNo 订单编号 FOrderNo FNoteEntry 备注 FNoteEntry FSrcBillNo 源单编号 FSrcBillNo FBFLowId 业务流程 FBFLowId FConsignPrice 单价 FConsignPrice FTaxPrice 含税单价 FTaxPrice FTaxRate 税率% FTaxRate FDestLot 调入批号 FDestLot FQmEntryId 库存请检单EntryId FQmEntryId FConvertEntryId 库存状态转换EntryId FConvertEntryId FSOEntryId 销售订单EntryId FSOEntryId FThirdSrcEntryId 第三方源单分录编码 FThirdSrcEntryId FISFREE 赠品 FISFREE FMaterialId_FBARCODE 条码 FMaterialId.FBARCODE Limit 最大行数 {{PAGINATION_PAGE_SIZE}} 金蝶的查询分页参数 FieldKeys 需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber TopRowCount 返回总行数金蝶的查询分页参数 FilterString 过滤条件 FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FDocumentStatus = 'C' AND FSrcStockId.FNumber IN ('A9') 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FormId 业务对象表单Id STK_TransferDirect 必须填写金蝶的表单ID如😛UR_PurchaseOrder StartRow 开始行索引 {{PAGINATION_START_ROW}} 金蝶的查询分页参数响应参数接口字段字段名称预设值描述 FBillEntry_FEntryID FEntryID FID 实体主键 FBillNo 单据编号 FDocumentStatus 单据状态 FStockOrgId_FNumber 调入库存组织 FDate 日期 FBillTypeID_FNumber 单据类型 FTransferBizType 调拨类型 FStockOutOrgId_FNumber 调出库存组织 FTransferDirect 调拨方向 FNote 备注 FBizType 业务类型 FSaleOrgId_FNumber 销售组织 FSettleOrgId_FNumber 结算组织 FCustID_FNumber 对应客户 FSUPPLIERID_FNumber 对应供应商 FThirdSrcId 第三方源单内码 FThirdSrcBillNo 第三方源单编码 FThirdSystem 第三方系统 FMaterialId_FNumber 物料编码 FLot 调出批号 FSrcStockId_FNumber 调出仓库 FSrcStockLocId 调出仓位 FDestStockId_FNumber 调入仓库 FDestStockLocId 调入仓位 FQty 调拨数量 FPrice 成本价 FAmount 总成本 FBomId BOM版本 FProduceDate 生产日期 FExpiryDate 有效期至 FMtoNo 计划跟踪号 FSrcStockStatusId 调出库存状态 FDestStockStatusId 调入库存状态 FOwnerId_FNumber 调入货主 FOwnerOutId_FNumber 调出货主 FSrcBillTypeId 源单类型 FSrcSeq 源单行号 FOrderNo 订单编号 FNoteEntry 备注 FSrcBillNo 源单编号 FBFLowId 业务流程 FConsignPrice 单价 FTaxPrice 含税单价 FTaxRate 税率% FDestLot 调入批号 FQmEntryId 库存请检单EntryId FConvertEntryId 库存状态转换EntryId FSOEntryId 销售订单EntryId FThirdSrcEntryId 第三方源单分录编码 FISFREE 赠品 FMaterialId_FBARCODE 条码聚水潭接口明细接口： jushuitan.otherinout.upload 接口名称：新建其它出入库（新）接口方法： POST 请求参数字段名称类型描述 is_confirm 是否自动确认单据 string 是否自动确认单据 wms_co_id 分仓编号 string 分仓编号 type 出入库类型: in是入库 out是出库 string 出入库类型: in是入库 out是出库 external_id 外部单号 string 外部单号 warehouse 主仓=1，销退仓=2，进货仓=3，次品仓 = 4 string 主仓=1，销退仓=2，进货仓=3，次品仓 = 4 drp_co_name 出库类型 string 出库类型 receiver_name 收件人姓名 string 收件人姓名 receiver_mobile 收件人手机号 string 收件人手机号 receiver_state 收件地址省 string 收件地址省 receiver_city 收件地址市 string 收件地址市 receiver_district 收件地址区县 string 收件地址区县 receiver_address 收件详细地址 string 收件详细地址 items 商品列表 array 商品列表 items.remark 备注 string 备注 items.sku_id 商品编码 string 商品编码 items.qty 数量 string 数量 items.batch_id 批次单号，系统中需开启相关配置 string 批次单号，系统中需开启相关配置 items.produced_date 生产日期，系统中需开启相关配置 string 生产日期，系统中需开启相关配置 items.expiration_date 有效期至，系统中需开启相关配置 string 有效期至，系统中需开启相关配置响应参数字段名称类型描述 code 非0失败 string 非0失败 msg 错误描述 string 错误描述 data 返回内容 array 返回内容 data.external_id 外部单号 string 外部单号 data.io_id 系统内部单号 string 系统内部单号系统对接总览异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案，可以满足客户的实际业务需求，推动软件工程的规范化，使开发人员遵循统一的概要设计开发实现，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。

金蝶云星空和聚水潭接口打通对接实战

庄颜_qeasy

金蝶云星空和聚水潭接口打通对接实战

数据源平台:金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

对接目标系统:聚水潭

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

数据接口配置

数据集成平台对应的配置金蝶云星空与聚水潭的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与聚水潭之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

金蝶云星空接口明细

API：executeBillQuery
NAME：调拨单查询
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillEntry_FEntryID	FEntryID	FBillEntry_FEntryID
FID	实体主键	FID
FBillNo	单据编号	FBillNo
FDocumentStatus	单据状态	FDocumentStatus
FStockOrgId_FNumber	调入库存组织	FStockOrgId.FNumber
FDate	日期	FDate
FBillTypeID_FNumber	单据类型	FBillTypeID.FNumber
FTransferBizType	调拨类型	FTransferBizType
FStockOutOrgId_FNumber	调出库存组织	FStockOutOrgId.FNumber
FTransferDirect	调拨方向	FTransferDirect
FNote	备注	FNote
FBizType	业务类型	FBizType
FSaleOrgId_FNumber	销售组织	FSaleOrgId.FNumber
FSettleOrgId_FNumber	结算组织	FSettleOrgId.FNumber
FCustID_FNumber	对应客户	FCustID.FNumber
FSUPPLIERID_FNumber	对应供应商	FSUPPLIERID.FNumber
FThirdSrcId	第三方源单内码	FThirdSrcId
FThirdSrcBillNo	第三方源单编码	FThirdSrcBillNo
FThirdSystem	第三方系统	FThirdSystem
FMaterialId_FNumber	物料编码	FMaterialId.FNumber
FLot	调出批号	FLot
FSrcStockId_FNumber	调出仓库	FSrcStockId.FNumber
FSrcStockLocId	调出仓位	FSrcStockLocId
FDestStockId_FNumber	调入仓库	FDestStockId.FNumber
FDestStockLocId	调入仓位	FDestStockLocId
FQty	调拨数量	FQty
FPrice	成本价	FPrice
FAmount	总成本	FAmount
FBomId	BOM版本	FBomId
FProduceDate	生产日期	FProduceDate
FExpiryDate	有效期至	FExpiryDate
FMtoNo	计划跟踪号	FMtoNo
FSrcStockStatusId	调出库存状态	FSrcStockStatusId
FDestStockStatusId	调入库存状态	FDestStockStatusId
FOwnerId_FNumber	调入货主	FOwnerId.FNumber
FOwnerOutId_FNumber	调出货主	FOwnerOutId.FNumber
FSrcBillTypeId	源单类型	FSrcBillTypeId
FSrcSeq	源单行号	FSrcSeq
FOrderNo	订单编号	FOrderNo
FNoteEntry	备注	FNoteEntry
FSrcBillNo	源单编号	FSrcBillNo
FBFLowId	业务流程	FBFLowId
FConsignPrice	单价	FConsignPrice
FTaxPrice	含税单价	FTaxPrice
FTaxRate	税率%	FTaxRate
FDestLot	调入批号	FDestLot
FQmEntryId	库存请检单EntryId	FQmEntryId
FConvertEntryId	库存状态转换EntryId	FConvertEntryId
FSOEntryId	销售订单EntryId	FSOEntryId
FThirdSrcEntryId	第三方源单分录编码	FThirdSrcEntryId
FISFREE	赠品	FISFREE
FMaterialId_FBARCODE	条码	FMaterialId.FBARCODE
Limit	最大行数	{{PAGINATION_PAGE_SIZE}}	金蝶的查询分页参数
FieldKeys	需查询的字段key集合		金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
TopRowCount	返回总行数		金蝶的查询分页参数
FilterString	过滤条件	FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FDocumentStatus = 'C' AND FSrcStockId.FNumber IN ('A9')	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FormId	业务对象表单Id	STK_TransferDirect	必须填写金蝶的表单ID如😛UR_PurchaseOrder
StartRow	开始行索引	{{PAGINATION_START_ROW}}	金蝶的查询分页参数

响应参数

接口字段	字段名称	预设值	描述
FBillEntry_FEntryID	FEntryID
FID	实体主键
FBillNo	单据编号
FDocumentStatus	单据状态
FStockOrgId_FNumber	调入库存组织
FDate	日期
FBillTypeID_FNumber	单据类型
FTransferBizType	调拨类型
FStockOutOrgId_FNumber	调出库存组织
FTransferDirect	调拨方向
FNote	备注
FBizType	业务类型
FSaleOrgId_FNumber	销售组织
FSettleOrgId_FNumber	结算组织
FCustID_FNumber	对应客户
FSUPPLIERID_FNumber	对应供应商
FThirdSrcId	第三方源单内码
FThirdSrcBillNo	第三方源单编码
FThirdSystem	第三方系统
FMaterialId_FNumber	物料编码
FLot	调出批号
FSrcStockId_FNumber	调出仓库
FSrcStockLocId	调出仓位
FDestStockId_FNumber	调入仓库
FDestStockLocId	调入仓位
FQty	调拨数量
FPrice	成本价
FAmount	总成本
FBomId	BOM版本
FProduceDate	生产日期
FExpiryDate	有效期至
FMtoNo	计划跟踪号
FSrcStockStatusId	调出库存状态
FDestStockStatusId	调入库存状态
FOwnerId_FNumber	调入货主
FOwnerOutId_FNumber	调出货主
FSrcBillTypeId	源单类型
FSrcSeq	源单行号
FOrderNo	订单编号
FNoteEntry	备注
FSrcBillNo	源单编号
FBFLowId	业务流程
FConsignPrice	单价
FTaxPrice	含税单价
FTaxRate	税率%
FDestLot	调入批号
FQmEntryId	库存请检单EntryId
FConvertEntryId	库存状态转换EntryId
FSOEntryId	销售订单EntryId
FThirdSrcEntryId	第三方源单分录编码
FISFREE	赠品
FMaterialId_FBARCODE	条码

聚水潭接口明细

接口：jushuitan.otherinout.upload
接口名称：新建其它出入库（新）
接口方法：POST

请求参数

字段	名称	类型	描述
is_confirm	是否自动确认单据	string	是否自动确认单据
wms_co_id	分仓编号	string	分仓编号
type	出入库类型: in是入库 out是出库	string	出入库类型: in是入库 out是出库
external_id	外部单号	string	外部单号
warehouse	主仓=1，销退仓=2，进货仓=3，次品仓 = 4	string	主仓=1，销退仓=2，进货仓=3，次品仓 = 4
drp_co_name	出库类型	string	出库类型
receiver_name	收件人姓名	string	收件人姓名
receiver_mobile	收件人手机号	string	收件人手机号
receiver_state	收件地址省	string	收件地址省
receiver_city	收件地址市	string	收件地址市
receiver_district	收件地址区	县	string	收件地址区县
receiver_address	收件详细地址	string	收件详细地址
items	商品列表	array	商品列表
items.remark	备注	string	备注
items.sku_id	商品编码	string	商品编码
items.qty	数量	string	数量
items.batch_id	批次单号，系统中需开启相关配置	string	批次单号，系统中需开启相关配置
items.produced_date	生产日期，系统中需开启相关配置	string	生产日期，系统中需开启相关配置
items.expiration_date	有效期至，系统中需开启相关配置	string	有效期至，系统中需开启相关配置

响应参数

字段	名称	类型	描述
code	非0失败	string	非0失败
msg	错误描述	string	错误描述
data	返回内容	array	返回内容
data.external_id	外部单号	string	外部单号
data.io_id	系统内部单号	string	系统内部单号

系统对接总览

异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案，可以满足客户的实际业务需求，推动软件工程的规范化，使开发人员遵循统一的概要设计开发实现，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。