金蝶云星空和聚水潭接口打通对接实战数据源系统:金蝶云星空金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。写入目标:聚水潭聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。随着客户需求的不断变化，如今聚水潭已经发展成为以SaaSERP为核心，集多种商家服务为一体的SaaS协同平台。经过8年多的发展，公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点，服务范围覆盖超过400个城镇，为客户提供及时、周到和专业的服务。系统对接接口配置轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：金蝶云星空的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：聚水潭，把获取的数据组装成目标系统需要的格式进行写入。金蝶云星空接口明细调用接口： executeBillQuery 接口名称：组装拆卸单查询(成品) 方法： POST 请求参数字段字段名称类型配置值 FID 实体主键 string FID FEntity_FEntryID 分录主键 string FEntity_FEntryID FBillNo 单据编号 string FBillNo FDocumentStatus 单据状态 string FDocumentStatus FStockOrgId_FNumber 库存组织 string FStockOrgId.FNumber FDate 日期 string FDate FBillTypeID_FNumber 单据类型 string FBillTypeID.FNumber FOwnerIdHead_FNumber 成品货主 string FOwnerIdHead.FNumber FAffairType 事务类型 string FAffairType FEE 费用 string FEE FDeptID_FNumber 部门 string FDeptID.FNumber FNote 备注 string FNote FSubProOwnerIdH_FNumber 子件货主 string FSubProOwnerIdH.FNumber FRowType 行类型 string FRowType FMaterialID_FNumber 物料编码 string FMaterialID.FNumber FUnitID 单位 string FUnitID FQty 数量 string FQty Fee_ETY 费用 string Fee_ETY FStockID_FNumber 仓库 string FStockID.FNumber FStockStatusID 库存状态 string FStockStatusID FDescription 备注 string FDescription FMTONO 计划跟踪号 string FMTONO FProjectNo 项目编号 string FProjectNo FOwnerTypeID 货主类型 string FOwnerTypeID FOwnerID_FNumber 货主 string FOwnerID.FNumber FKeeperTypeID 保管者类型 string FKeeperTypeID FKeeperID_FNumber 保管者 string FKeeperID.FNumber FBomID BOM版本 string FBomID FProduceDate 生产日期 string FProduceDate FEXPIRYDATE 有效期至 string FEXPIRYDATE FPrice 成本价 string FPrice FAmount 总成本 string FAmount FStockFlag 已更新库存 string FStockFlag FStockLocId 仓位 string FStockLocId FLOT 批号 string FLOT FSrcBillTypeId 源单类型 string FSrcBillTypeId FSrcBillNo 源单编号 string FSrcBillNo FInstockDate 入库日期 string FInstockDate 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 STK_AssembledApp 响应参数字段字段名称类型配置值 FID 实体主键 string FEntity_FEntryID 分录主键 string FBillNo 单据编号 string FDocumentStatus 单据状态 string FStockOrgId_FNumber 库存组织 string FDate 日期 string FBillTypeID_FNumber 单据类型 string FOwnerIdHead_FNumber 成品货主 string FAffairType 事务类型 string FEE 费用 string FDeptID_FNumber 部门 string FNote 备注 string FSubProOwnerIdH_FNumber 子件货主 string FRowType 行类型 string FMaterialID_FNumber 物料编码 string FUnitID 单位 string FQty 数量 string Fee_ETY 费用 string FStockID_FNumber 仓库 string FStockStatusID 库存状态 string FDescription 备注 string FMTONO 计划跟踪号 string FProjectNo 项目编号 string FOwnerTypeID 货主类型 string FOwnerID_FNumber 货主 string FKeeperTypeID 保管者类型 string FKeeperID_FNumber 保管者 string FBomID BOM版本 string FProduceDate 生产日期 string FEXPIRYDATE 有效期至 string FPrice 成本价 string FAmount 总成本 string FStockFlag 已更新库存 string FStockLocId 仓位 string FLOT 批号 string FSrcBillTypeId 源单类型 string FSrcBillNo 源单编号 string FInstockDate 入库日期 string 聚水潭接口明细 API： jushuitan.otherinout.upload NAME：新建其它出入库（新） METHOD： POST 请求参数接口字段字段名称预设值描述 is_confirm 是否自动确认单据 1 是否自动确认单据 wms_co_id 分仓编号 {{FStockID_FNumber}} 分仓编号 type 出入库类型: in是入库 out是出库 out 出入库类型: in是入库 out是出库 external_id 外部单号 {{FBillNo}}CXout 外部单号 warehouse 主仓=1，销退仓=2，进货仓=3，次品仓 = 4 1 主仓=1，销退仓=2，进货仓=3，次品仓 = 4 drp_co_name 出库类型拆卸成品出库出库类型 receiver_name 收件人姓名收件人姓名 receiver_mobile 收件人手机号收件人手机号 receiver_state 收件地址省收件地址省 receiver_city 收件地址市收件地址市 receiver_district 收件地址区县收件地址区县 receiver_address 收件详细地址收件详细地址 items 商品列表 items 商品列表 items.remark 备注备注 items.sku_id 商品编码 {{items.FMaterialID_FNumber}} 商品编码 items.qty 数量 {{items.FQty}} 数量 items.batch_id 批次单号，系统中需开启相关配置批次单号，系统中需开启相关配置 items.produced_date 生产日期，系统中需开启相关配置生产日期，系统中需开启相关配置 items.expiration_date 有效期至，系统中需开启相关配置有效期至，系统中需开启相关配置响应参数接口字段字段名称预设值描述 code 非0失败非0失败 msg 错误描述错误描述 data 返回内容返回内容 data.external_id 外部单号外部单号 data.io_id 系统内部单号系统内部单号系统对接总览全新的API数据集成模式，赋能企业业务创新传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：聚水潭与金蝶云星空之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。

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

庄颜_qeasy

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

数据源系统:金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

写入目标:聚水潭

聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。随着客户需求的不断变化，如今聚水潭已经发展成为以SaaSERP为核心，集多种商家服务为一体的SaaS协同平台。经过8年多的发展，公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点，服务范围覆盖超过400个城镇，为客户提供及时、周到和专业的服务。

系统对接接口配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：金蝶云星空的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：聚水潭，把获取的数据组装成目标系统需要的格式进行写入。

金蝶云星空接口明细

调用接口：executeBillQuery
接口名称：组装拆卸单查询(成品)
方法：POST

请求参数

字段	字段名称	类型	配置值
FID	实体主键	string	FID
FEntity_FEntryID	分录主键	string	FEntity_FEntryID
FBillNo	单据编号	string	FBillNo
FDocumentStatus	单据状态	string	FDocumentStatus
FStockOrgId_FNumber	库存组织	string	FStockOrgId.FNumber
FDate	日期	string	FDate
FBillTypeID_FNumber	单据类型	string	FBillTypeID.FNumber
FOwnerIdHead_FNumber	成品货主	string	FOwnerIdHead.FNumber
FAffairType	事务类型	string	FAffairType
FEE	费用	string	FEE
FDeptID_FNumber	部门	string	FDeptID.FNumber
FNote	备注	string	FNote
FSubProOwnerIdH_FNumber	子件货主	string	FSubProOwnerIdH.FNumber
FRowType	行类型	string	FRowType
FMaterialID_FNumber	物料编码	string	FMaterialID.FNumber
FUnitID	单位	string	FUnitID
FQty	数量	string	FQty
Fee_ETY	费用	string	Fee_ETY
FStockID_FNumber	仓库	string	FStockID.FNumber
FStockStatusID	库存状态	string	FStockStatusID
FDescription	备注	string	FDescription
FMTONO	计划跟踪号	string	FMTONO
FProjectNo	项目编号	string	FProjectNo
FOwnerTypeID	货主类型	string	FOwnerTypeID
FOwnerID_FNumber	货主	string	FOwnerID.FNumber
FKeeperTypeID	保管者类型	string	FKeeperTypeID
FKeeperID_FNumber	保管者	string	FKeeperID.FNumber
FBomID	BOM版本	string	FBomID
FProduceDate	生产日期	string	FProduceDate
FEXPIRYDATE	有效期至	string	FEXPIRYDATE
FPrice	成本价	string	FPrice
FAmount	总成本	string	FAmount
FStockFlag	已更新库存	string	FStockFlag
FStockLocId	仓位	string	FStockLocId
FLOT	批号	string	FLOT
FSrcBillTypeId	源单类型	string	FSrcBillTypeId
FSrcBillNo	源单编号	string	FSrcBillNo
FInstockDate	入库日期	string	FInstockDate
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	STK_AssembledApp

响应参数

字段	字段名称	类型
FID	实体主键	string
FEntity_FEntryID	分录主键	string
FBillNo	单据编号	string
FDocumentStatus	单据状态	string
FStockOrgId_FNumber	库存组织	string
FDate	日期	string
FBillTypeID_FNumber	单据类型	string
FOwnerIdHead_FNumber	成品货主	string
FAffairType	事务类型	string
FEE	费用	string
FDeptID_FNumber	部门	string
FNote	备注	string
FSubProOwnerIdH_FNumber	子件货主	string
FRowType	行类型	string
FMaterialID_FNumber	物料编码	string
FUnitID	单位	string
FQty	数量	string
Fee_ETY	费用	string
FStockID_FNumber	仓库	string
FStockStatusID	库存状态	string
FDescription	备注	string
FMTONO	计划跟踪号	string
FProjectNo	项目编号	string
FOwnerTypeID	货主类型	string
FOwnerID_FNumber	货主	string
FKeeperTypeID	保管者类型	string
FKeeperID_FNumber	保管者	string
FBomID	BOM版本	string
FProduceDate	生产日期	string
FEXPIRYDATE	有效期至	string
FPrice	成本价	string
FAmount	总成本	string
FStockFlag	已更新库存	string
FStockLocId	仓位	string
FLOT	批号	string
FSrcBillTypeId	源单类型	string
FSrcBillNo	源单编号	string
FInstockDate	入库日期	string

聚水潭接口明细

API：jushuitan.otherinout.upload
NAME：新建其它出入库（新）
METHOD：POST

请求参数

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

响应参数

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

系统对接总览

全新的API数据集成模式，赋能企业业务创新传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：聚水潭与金蝶云星空之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。