金蝶云星空和吉客云接口打通对接实战|轻易云数据集成平台

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

对接系统金蝶云星空

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

接入系统：吉客云

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

数据接口配置

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为吉客云，并且选择对应连接器（关于吉客云的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的erp.stock.createandstockin接口作为数据写入动作完成第一步的接口配置。

金蝶云星空接口明细

接口：executeBillQuery
接口名称：采购入库查询
接口方法：POST

请求参数

字段	名称	类型	描述
FInStockEntry_FEntryId	id	string
FID	实体主键	string
FBillNo	单据编号	string
FDocumentStatus	单据状态	string
FStockOrgId_FNumber	收料组织	string
FDate	入库日期	string
FBillTypeID_FNumber	单据类型	string
FOwnerTypeIdHead	货主类型	string
FOwnerIdHead_FNumber	货主	string
FDemandOrgId_FNumber	需求组织	string
FPurchaseOrgId_FNumber	采购组织	string
FSupplierId_FNumber	供应商	string
FStockerGroupId_FNumber	库存组	string
FStockDeptId_FNumber	收料部门	string
FCreateDate	创建日期	string
FCancelDate	作废日期	string
FDeliveryBill	送货单号	string
FTakeDeliveryBill	提货单号	string
FApproveDate	审核日期	string
FCancelStatus	作废状态	string
FSupplyId_FNumber	供货方	string
FSettleId_FNumber	结算方	string
FChargeId_FNumber	收款方	string
FBusinessType	业务类型	string
FSupplyAddress	供货方地址	string
FAPSTATUS	应付状态	string
FTransferBizType	跨组织业务类型	string
FDisassemblyFlag	拆单新单标识	string
FConfirmDate	确认日期	string
FConfirmStatus	确认状态	string
FSplitBillType	拆单类型	string
FPayOrgId_FNumber	付款组织	string
FSettleOrgId_FNumber	结算组织	string
FSettleCurrId_FNumber	结算币别	string
FBillCost	整单费用	string
FBillTaxAmount	税额	string
FBillCostAmount	总成本	string
FBillAllAmount	价税合计	string
FSettleTypeId	结算方式	string
FExchangeRate	汇率	string
FLocalCurrId_FNumber	本位币	string
FBillAmount	金额	string
FIsIncludedTax	含税	string
FOwnerCustomerID_FNumber	货主客户	string
FSettleSupplierID_FNumber	结算组织供应商	string
FISGENFORIOS	跨组织结算生成	string
FISPRICEEXCLUDETAX	价外税	string
FISINVOICEARLIER	先到票后入库	string
FMaterialId_FNumber	物料编码	string
FStockId_FNumber	仓库	string
FProduceDate	生产日期	string
FNote	备注	string
FSupplierLot	供应商批号	string
FGrossWeight	毛重	string
FNetWeight	净重	string
FContractlNo	合同单号	string
FReqTraceNo	需求跟踪号	string
FMustQty	应收数量	string
FRealQty	实收数量	string
FSRCRowId	源单行内码	string
FExpiryDate	有效期至	string
FIsFree	免费	string
FStockStatusId	库存状态	string
FBOMId	BOM版本	string
FTaxPrice	含税单价	string
FCostPrice	成本价	string
FEntryTaxRate	税率(%)	string
FEntryTaxAmount	税额	string
FDiscountRate	折扣率(%)	string
FPriceCoefficient	价格系数	string
FPriceUnitQty	计价数量	string
FTaxNetPrice	净价	string
FEntryCostAmount	总成本	string
FAllAmount	价税合计	string
FStockFlag	入库库存更新标志	string
FPOOrderNo	订单单号	string
FEXPUnit	保质期单位	string
FExpPeriod	保质期	string
FSRCBILLTYPEID	源单类型	string
FSRCBillNo	源单编号	string
FINVOICEDQTY	已开票数量	string
FBaseAPJoinQty	关联应付数量（计价基本）	string
FReceiveStockFlag	收货库存更新标志	string
FProcessFee	加工费	string
FMaterialCosts	材料成本	string
FLot	批号	string
FPrice	单价	string
FAmount	金额	string
FDiscount	折扣额	string
FReturnJoinQty	退料关联数量	string
FBFLowId	业务流程	string
FGiveAway	是否赠品	string
FWWInType	入库类型	string
FRowId	行标识	string
FCreatorId_FName	创建人	string
Limit	最大行数	string	金蝶的查询分页参数
StartRow	开始行索引	string	金蝶的查询分页参数
TopRowCount	返回总行数	int	金蝶的查询分页参数
FilterString	过滤条件	string	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys	需查询的字段key集合	array	金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder

响应参数

字段	名称	类型	描述
FInStockEntry_FEntryId	id	string
FID	实体主键	string
FBillNo	单据编号	string
FDocumentStatus	单据状态	string
FStockOrgId_FNumber	收料组织	string
FDate	入库日期	string
FBillTypeID_FNumber	单据类型	string
FOwnerTypeIdHead	货主类型	string
FOwnerIdHead_FNumber	货主	string
FDemandOrgId_FNumber	需求组织	string
FPurchaseOrgId_FNumber	采购组织	string
FSupplierId_FNumber	供应商	string
FStockerGroupId_FNumber	库存组	string
FStockDeptId_FNumber	收料部门	string
FCreateDate	创建日期	string
FCancelDate	作废日期	string
FDeliveryBill	送货单号	string
FTakeDeliveryBill	提货单号	string
FApproveDate	审核日期	string
FCancelStatus	作废状态	string
FSupplyId_FNumber	供货方	string
FSettleId_FNumber	结算方	string
FChargeId_FNumber	收款方	string
FBusinessType	业务类型	string
FSupplyAddress	供货方地址	string
FAPSTATUS	应付状态	string
FTransferBizType	跨组织业务类型	string
FDisassemblyFlag	拆单新单标识	string
FConfirmDate	确认日期	string
FConfirmStatus	确认状态	string
FSplitBillType	拆单类型	string
FPayOrgId_FNumber	付款组织	string
FSettleOrgId_FNumber	结算组织	string
FSettleCurrId_FNumber	结算币别	string
FBillCost	整单费用	string
FBillTaxAmount	税额	string
FBillCostAmount	总成本	string
FBillAllAmount	价税合计	string
FSettleTypeId	结算方式	string
FExchangeRate	汇率	string
FLocalCurrId_FNumber	本位币	string
FBillAmount	金额	string
FIsIncludedTax	含税	string
FOwnerCustomerID_FNumber	货主客户	string
FSettleSupplierID_FNumber	结算组织供应商	string
FISGENFORIOS	跨组织结算生成	string
FISPRICEEXCLUDETAX	价外税	string
FISINVOICEARLIER	先到票后入库	string
FMaterialId_FNumber	物料编码	string
FStockId_FNumber	仓库	string
FProduceDate	生产日期	string
FNote	备注	string
FSupplierLot	供应商批号	string
FGrossWeight	毛重	string
FNetWeight	净重	string
FContractlNo	合同单号	string
FReqTraceNo	需求跟踪号	string
FMustQty	应收数量	string
FRealQty	实收数量	string
FSRCRowId	源单行内码	string
FExpiryDate	有效期至	string
FIsFree	免费	string
FStockStatusId	库存状态	string
FBOMId	BOM版本	string
FTaxPrice	含税单价	string
FCostPrice	成本价	string
FEntryTaxRate	税率(%)	string
FEntryTaxAmount	税额	string
FDiscountRate	折扣率(%)	string
FPriceCoefficient	价格系数	string
FPriceUnitQty	计价数量	string
FTaxNetPrice	净价	string
FEntryCostAmount	总成本	string
FAllAmount	价税合计	string
FStockFlag	入库库存更新标志	string
FPOOrderNo	订单单号	string
FEXPUnit	保质期单位	string
FExpPeriod	保质期	string
FSRCBILLTYPEID	源单类型	string
FSRCBillNo	源单编号	string
FINVOICEDQTY	已开票数量	string
FBaseAPJoinQty	关联应付数量（计价基本）	string
FReceiveStockFlag	收货库存更新标志	string
FProcessFee	加工费	string
FMaterialCosts	材料成本	string
FLot	批号	string
FPrice	单价	string
FAmount	金额	string
FDiscount	折扣额	string
FReturnJoinQty	退料关联数量	string
FBFLowId	业务流程	string
FGiveAway	是否赠品	string
FWWInType	入库类型	string
FRowId	行标识	string
FCreatorId_FName	创建人	string

吉客云接口明细

接口：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.outSkuCode	货品编号	string	匹配货品信息的外部货品编号(按skuId>outSkuCode>skuBarcode匹配顺序，必传一个)
stockInDetailViews.relDetailId	关联实际业务明细表的id	string
stockInDetailViews.unitName	单位	string
stockInDetailViews.skuCount	数量	string
stockInDetailViews.skuPrice	单价	string

系统对接总览

通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与吉客云之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。