金蝶云星空和吉客云接口打通对接实战来源系统:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。写入目标:吉客云吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求，重新定位、全新设计推出的换代产品，从业务数字化和组织数字化两个方向出发，以构建流程的闭环为依归，致力于为企业的数字化升级提供落地工具。多系统对接方案配置集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：调拨单查询，目标系统：吉客云，目标系统 API创建入库申请单并入库。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。金蝶云星空接口明细 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 F_TANT_Price 结算单价 F_TANT_Price F_TANT_Amount 结算金额 F_TANT_Amount FCreatorId_FName 创建人名称 FCreatorId.FName Limit 最大行数 {{PAGINATION_PAGE_SIZE}} 金蝶的查询分页参数 FieldKeys 需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber TopRowCount 返回总行数金蝶的查询分页参数 FilterString 过滤条件 FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FDestStockId.F_TANT_CheckBox=1 示例写法 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 赠品 F_TANT_Price 结算单价 F_TANT_Amount 结算金额 FCreatorId_FName 创建人名称吉客云接口明细接口： erp.stock.createandstockin 接口名称：创建入库申请单并入库接口方法： POST 请求参数字段名称类型描述 vendCode 供应商编码 string applyDepartCode 部门编码 string 部门编号和公司编号要同时填否则部门信息会有偏差 applyCompanyCode 入库公司编码 string 公司编号和部门编号要同时填否则公司信息会有偏差 inWarehouseCode 仓库编码 string inType 入库类型 string 入库类型 101=采购入库 102=调拨入库 103=盘盈入库 104=其他入库 relDataId 关联单据编号 string 可随机，保证不重复即可 applyUserId 申请人 string applyUserName 申请人姓名 string 超级用户 applyDate 申请时间 string memo 备注 string operator 制单人 string source 写死：OPEN string logisticNo 物流单号 string logisticCode 物流公司编号 string stockInDetailViews 入库申请单明细 array stockInDetailViews.skuBarcode 货品编号 string 匹配货品信息的外部货品编号(按skuId>outSkuCode>skuBarcode匹配顺序，必传一个) stockInDetailViews.relDetailId 关联实际业务明细表的id string stockInDetailViews.skuCount 入库数量 string stockInDetailViews.isCertified 是否正品 string 是否正品，1是0否 stockInDetailViews.skuPrice 入库价格 string stockInDetailViews.totalAmount 入库金额 string 数据对接效果通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。

金蝶云星空和吉客云接口打通对接实战

庄颜_qeasy

金蝶云星空和吉客云接口打通对接实战

来源系统:金蝶云星空

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

写入目标:吉客云

吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求，重新定位、全新设计推出的换代产品，从业务数字化和组织数字化两个方向出发，以构建流程的闭环为依归，致力于为企业的数字化升级提供落地工具。

多系统对接方案配置

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：调拨单查询，目标系统：吉客云，目标系统 API创建入库申请单并入库。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

金蝶云星空接口明细

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
F_TANT_Price	结算单价	F_TANT_Price
F_TANT_Amount	结算金额	F_TANT_Amount
FCreatorId_FName	创建人名称	FCreatorId.FName
Limit	最大行数	{{PAGINATION_PAGE_SIZE}}	金蝶的查询分页参数
FieldKeys	需查询的字段key集合		金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
TopRowCount	返回总行数		金蝶的查询分页参数
FilterString	过滤条件	FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FDestStockId.F_TANT_CheckBox=1	示例写法 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	赠品
F_TANT_Price	结算单价
F_TANT_Amount	结算金额
FCreatorId_FName	创建人名称

吉客云接口明细

接口：erp.stock.createandstockin
接口名称：创建入库申请单并入库
接口方法：POST

请求参数

字段	名称	类型	描述
vendCode	供应商编码	string
applyDepartCode	部门编码	string	部门编号和公司编号要同时填否则部门信息会有偏差
applyCompanyCode	入库公司编码	string	公司编号和部门编号要同时填否则公司信息会有偏差
inWarehouseCode	仓库编码	string
inType	入库类型	string	入库类型 101=采购入库 102=调拨入库 103=盘盈入库 104=其他入库
relDataId	关联单据编号	string	可随机，保证不重复即可
applyUserId	申请人	string
applyUserName	申请人姓名	string	超级用户
applyDate	申请时间	string
memo	备注	string
operator	制单人	string
source	写死：OPEN	string
logisticNo	物流单号	string
logisticCode	物流公司编号	string
stockInDetailViews	入库申请单明细	array
stockInDetailViews.skuBarcode	货品编号	string	匹配货品信息的外部货品编号(按skuId>outSkuCode>skuBarcode匹配顺序，必传一个)
stockInDetailViews.relDetailId	关联实际业务明细表的id	string
stockInDetailViews.skuCount	入库数量	string
stockInDetailViews.isCertified	是否正品	string	是否正品，1是0否
stockInDetailViews.skuPrice	入库价格	string
stockInDetailViews.totalAmount	入库金额	string

数据对接效果

通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。