金蝶云星空和轻易云集成平台接口打通对接实战

对接系统：金蝶云星空

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

对接目标系统:轻易云集成平台

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成

接口方案配置

使用系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的销售订单查询作为数据对接来源。然后再通过写入目标平台配置目标系统为轻易云集成平台,并且选择对应连接器（关于轻易云集成平台的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的客户新增接口作为数据写入动作，既可以完成第一步的数据对接配置。

金蝶云星空接口明细

接口：executeBillQuery
接口名称：销售订单查询
接口方法：POST

请求参数

字段	名称	类型	描述
FSaleOrderEntry_FEntryID	FSaleOrderEntry_FEntryID	string
FID	FID	string
FBillNo	单据编号	string
FDocumentStatus	单据状态	string
FSaleOrgId_FNumber	销售组织	string
FDate	日期	string
FCustId_FNumber	客户	string
FSaleDeptId_Fnumber	销售部门	string
FSaleGroupId	销售组	string
FSalerId	销售员	string
FReceiveId	收货方	string
FSettleId	结算方	string
FSettleAddress	结算方地址	string
FChargeId	付款方	string
FCreatorId	创建人	string
FCreateDate	创建日期	string
FModifierId	最后修改人	string
FModifyDate	最后修改日期	string
FApproverId	审核人	string
FApproveDate	审核日期	string
FCloseStatus	关闭状态	string
FCloserId	关闭人	string
FCloseDate	关闭日期	string
FCancelStatus	作废状态	string
FCancellerId	作废人	string
FCancelDate	作废日期	string
FVersionNo	版本号	string
FChangerId	变更人	string
FChangeDate	变更日期	string
FChangeReason	变更原因	string
FBillTypeID_Fnumber	单据类型	string
FBusinessType	业务类型	string
FHeadDeliveryWay	交货方式	string
FReceiveAddress	收货方地址	string
FHEADLOCID	交货地点	string
FCreditCheckResult	信用检查结果	string
FReceiveContact	收货方联系人	string
FNetOrderBillNo	移动销售订单编号	string
FNetOrderBillId	移动销售订单ID	string
FOppID	商机内码	array
FSalePhaseID	销售阶段	string
FISINIT	是否期初单据	string
FNote	备注	string
FSignStatus	签收状态	string
FManualClose	是否手工关闭	string
FLinkMan	收货人姓名	string
FLinkPhone	联系电话	string
FSOFrom	订单来源	string
FMaterialId_Fnumber	物料编码	string
FMaterialName	物料名称	string
FMaterialModel	规格型号	string
FMaterialType	物料类别	string
FUnitID_Fnumber	销售单位	string
FPrice	单价	string
FTaxPrice	含税单价	string
FBomId	BOM版本	string
FPriceUnitId	计价单位	string
FPriceUnitQty	计价数量	string
FPriceCoefficient	价格系数	string
FDiscountRate	折扣率%	string
FDiscount	折扣额	string
FEntryTaxRate	税率%	string
FEntryTaxAmount	税额	string
FAllAmount	价税合计	string
FTaxNetPrice	净价	string
FBaseUnitQty	销售基本数量	string
FDeliveryControl	控制发货数量	string
FDeliveryMaxQty	发货上限	string
FDeliveryMinQty	发货下限	string
FTransportLeadTime1	运输提前期	string
FBefDisAllAmt	折前价税合计	string
FBefDisAmt	折前金额	string
FTaxAmount_LC	税额（本位币）	string
FAmount_LC	金额（本位币）	string
FAllAmount_LC	价税合计（本位币）	string
FMrpCloseStatus	业务关闭	string
FMrpFreezeStatus	业务冻结	string
FFreezerId	冻结人	string
FFreezeDate	冻结日期	string
FMrpTerminateStatus	业务终止	string
FTerminaterId	终止人	string
FTerminateDate	终止日期	string
FBaseDeliJoinQty	（代码有用）关联发货通知数量（销售基本）	string
FDeliQty	累计发货通知数量	string
FStockOutQty	累计出库数量	string
FRetNoticeQty	累计退货通知数量（销售）	string
FReturnQty	累计退货数量（销售）	string
FRemainOutQty	剩余未出数量（销售）	string
FBaseInvoiceJoinQty	关联开票数量（基本）(作废)	string
FInvoiceJoinQty	关联开票数量(作废)	string
FInvoiceQty	累计开票数量(作废)	string
FInvoiceAmount	累计开票金额(作废)	string
FReceiveAmount	累计收款金额	string
FBasePurJoinQty	关联采购/生产数量（销售基本）	string
FPurJoinQty	关联采购/生产数量	string
FPurReqQty	累计采购申请数量	string
FPurOrderQty	累计采购订单数量	string
FReceiptOrgId	收款组织	string
FSettleOrgIds	结算组织	string
FAmount	金额	string
FEntryNote	备注	string
FQty	销售数量	string
FLimitDownPrice	最低限价	string
FSysPrice	系统定价	string
FStockOrgId	库存组织	string
FBaseStockOutQty	累计出库数量（销售基本）	string
FBaseDeliQty	累计发货通知数量（销售基本）	string
FBaseRetNoticeQty	累计退货通知数量（销售基本）	string
FBaseReturnQty	累计退货数量（销售基本）	string
FBasePurReqQty	累计采购申请数量（销售基本）	string
FBasePurOrderQty	累计采购订单数量（销售基本）	string
FBaseUnitId	基本单位	string
FChangeFlag	变更标志	string
FMapId	客户物料编码	string
FOwnerTypeId	货主类型	string
FOwnerId	货主	string
FIsFree	是否赠品	string
FLOCKQTY	锁库/预留数量(库存单位)	string
FLOCKFLAG	锁库/预留标识	string
FProduceDate	生产日期	string
FExpiryDate	有效期至	string
FExpUnit	保质期单位	string
FExpPeriod	保质期	string
FMaterialIsProduce	物料允许生产属性	string
FTaxCombination	税组合	string
FLot	批号	string
FMapName	客户物料名称	string
FAuxPropId	辅助属性	string
FReturnType	退补类型	string
FDeliveryDate	要货日期	string
FTransJoinQty	累计调拨数量	string
FBaseTransJoinQty	累计调拨数量(销售基本)	string
FSrcType	源单类型	string
FSrcBillNo	源单编号	string
FBaseDeliveryMaxQty	发货上限（基本）	string
FBaseDeliveryMinQty	发货下限（基本）	string
FOEMInStockJoinQty	关联受托材料入库套数	string
FBaseOEMInStockJoinQty	关联受托材料入库套数(库存基本)	string
FBaseARJoinQty	关联应收数量（计价基本）	string
FIsReturn	物料允许退货属性	string
FBFLowId	业务流程	string
FIsInventory	物料允许库存属性	string
FBASEARQTY	累计应收数量（销售基本）	string
FARJOINAMOUNT	关联应收金额	string
FARAMOUNT	累计应收金额	string
FBaseRemainOutQty	剩余未出数量（销售基本）	string
FReBackQty	累计退货补货数量（销售）	string
FBaseReBackQty	累计退货补货数量（销售基本）	string
FARQTY	累计应收数量（销售）	string
FMaterialIsSubContract	物料允许委外属性	string
FCanOutQty	可出数量（销售）	string
FBaseCanOutQty	可出数量（销售基本）	string
FCanReturnQty	可退数量（销售）	string
FBaseCanReturnQty	可退数量（销售基本）	string
FBASEAPQTY	累计应付数量(基本单位)	string
FAPAMOUNT	累计应付金额	string
FMtoNo	计划跟踪号	string
FPriority	需求优先级	string
FReserveType	预留类型	string
FMinPlanDeliveryDate	计划交货日期	string
FDeliveryStatus	发货状态	string
FOldQty	原数量	string
FPromotionMatchType	促销匹配类型	string
FPriceListEntry	行价目表	string
FSupplyOrgId	供应组织	string
FNetOrderEntryId	供应商协同平台订单分录ID	string
FPriceBaseQty	计价基本数量	string
FSetPriceUnitID	定价单位	string
FStockUnitID	库存单位	string
FStockQty	库存数量	string
FStockBaseQty	库存基本数量	string
FStockBaseCanOutQty	可出数量（库存基本）	string
FStockBaseCanReturnQty	可退数量（库存基本）	string
FStockBaseARJoinQty	关联应收数量（库存基本）	string
FStockBaseTransJoinQty	累计调拨数量（库存基本）	string
FStockBasePurJoinQty	关联采购/生产数量（库存基本）	string
FSalBaseNum	源单基本分子	string
FStockBaseDen	库存基本分母	string
FSRCBIZUNITID	携带主单位	string
FPurBaseQty	采购基本数量	string
FPurUnitID	采购单位	string
FPurQty	采购数量	string
FSalBaseARJoinQty	关联应收数量（销售基本）	string
FSTOCKBASESTOCKOUTQTY	累计出库数量（库存基本）	string
FSTOCKBASEREBACKQTY	累计退货补货数量（库存基本）	string
FOUTLMTUNIT	超发控制单位类型	string
FOutLmtUnitID	超发控制单位	string
FTRANSRETURNQTY	累计调拨退货数量	string
FTRANSRETURNBASEQTY	累计调拨退货数量（销售基本）	string
FCONSIGNSETTQTY	寄售结算数量	string
FCONSIGNSETTBASEQTY	寄售结算数量（销售基本）	string
FLeftQty	待锁库/待预留数量(库存单位)	string
FRowType	产品类型	string
FParentMatId	父项产品	string
FRowId	行标识	string
FParentRowId	父行标识	string
FInStockPrice	最新采购入库价	string
FSOStockId_Fnumber	仓库	string
FSOStockLocalId	仓位	string
FPurPriceUnitId	采购计价单位	string
FISMRP	已计划运算	string
FBarcode	零售条形码	string
FBranchId	发货门店	string
FRetailSaleProm	是否零售促销	string
FBASEFINARQTY	先开票数量（计价基本）	string
FSALBASEFINARQTY	先开票数量（销售基本）	string
FEntryDiscountList	行折扣表	string
FPriceDiscount	单价折扣	string
FZHJStockQty	智慧记上报库存	string
FSPMENTRYID	促销政策ID	string
FSPMANDRPMCONTENT	促销内容	string
FTransReturnStockBaseQty	累计调拨退货数量（库存基本）	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如😛UR_PurchaseOrder

响应参数

字段	名称	类型
FSaleOrderEntry_FEntryID	FSaleOrderEntry_FEntryID	string
FID	FID	string
FBillNo	单据编号	string
FDocumentStatus	单据状态	string
FSaleOrgId_FNumber	销售组织	string
FDate	日期	string
FCustId_FNumber	客户	string
FSaleDeptId_Fnumber	销售部门	string
FSaleGroupId	销售组	string
FSalerId	销售员	string
FReceiveId	收货方	string
FSettleId	结算方	string
FSettleAddress	结算方地址	string
FChargeId	付款方	string
FCreatorId	创建人	string
FCreateDate	创建日期	string
FModifierId	最后修改人	string
FModifyDate	最后修改日期	string
FApproverId	审核人	string
FApproveDate	审核日期	string
FCloseStatus	关闭状态	string
FCloserId	关闭人	string
FCloseDate	关闭日期	string
FCancelStatus	作废状态	string
FCancellerId	作废人	string
FCancelDate	作废日期	string
FVersionNo	版本号	string
FChangerId	变更人	string
FChangeDate	变更日期	string
FChangeReason	变更原因	string
FBillTypeID_Fnumber	单据类型	string
FBusinessType	业务类型	string
FHeadDeliveryWay	交货方式	string
FReceiveAddress	收货方地址	string
FHEADLOCID	交货地点	string
FCreditCheckResult	信用检查结果	string
FReceiveContact	收货方联系人	string
FNetOrderBillNo	移动销售订单编号	string
FNetOrderBillId	移动销售订单ID	string
FOppID	商机内码	array
FSalePhaseID	销售阶段	string
FISINIT	是否期初单据	string
FNote	备注	string
FSignStatus	签收状态	string
FManualClose	是否手工关闭	string
FLinkMan	收货人姓名	string
FLinkPhone	联系电话	string
FSOFrom	订单来源	string
FMaterialId_Fnumber	物料编码	string
FMaterialName	物料名称	string
FMaterialModel	规格型号	string
FMaterialType	物料类别	string
FUnitID_Fnumber	销售单位	string
FPrice	单价	string
FTaxPrice	含税单价	string
FBomId	BOM版本	string
FPriceUnitId	计价单位	string
FPriceUnitQty	计价数量	string
FPriceCoefficient	价格系数	string
FDiscountRate	折扣率%	string
FDiscount	折扣额	string
FEntryTaxRate	税率%	string
FEntryTaxAmount	税额	string
FAllAmount	价税合计	string
FTaxNetPrice	净价	string
FBaseUnitQty	销售基本数量	string
FDeliveryControl	控制发货数量	string
FDeliveryMaxQty	发货上限	string
FDeliveryMinQty	发货下限	string
FTransportLeadTime1	运输提前期	string
FBefDisAllAmt	折前价税合计	string
FBefDisAmt	折前金额	string
FTaxAmount_LC	税额（本位币）	string
FAmount_LC	金额（本位币）	string
FAllAmount_LC	价税合计（本位币）	string
FMrpCloseStatus	业务关闭	string
FMrpFreezeStatus	业务冻结	string
FFreezerId	冻结人	string
FFreezeDate	冻结日期	string
FMrpTerminateStatus	业务终止	string
FTerminaterId	终止人	string
FTerminateDate	终止日期	string
FBaseDeliJoinQty	（代码有用）关联发货通知数量（销售基本）	string
FDeliQty	累计发货通知数量	string
FStockOutQty	累计出库数量	string
FRetNoticeQty	累计退货通知数量（销售）	string
FReturnQty	累计退货数量（销售）	string
FRemainOutQty	剩余未出数量（销售）	string
FBaseInvoiceJoinQty	关联开票数量（基本）(作废)	string
FInvoiceJoinQty	关联开票数量(作废)	string
FInvoiceQty	累计开票数量(作废)	string
FInvoiceAmount	累计开票金额(作废)	string
FReceiveAmount	累计收款金额	string
FBasePurJoinQty	关联采购/生产数量（销售基本）	string
FPurJoinQty	关联采购/生产数量	string
FPurReqQty	累计采购申请数量	string
FPurOrderQty	累计采购订单数量	string
FReceiptOrgId	收款组织	string
FSettleOrgIds	结算组织	string
FAmount	金额	string
FEntryNote	备注	string
FQty	销售数量	string
FLimitDownPrice	最低限价	string
FSysPrice	系统定价	string
FStockOrgId	库存组织	string
FBaseStockOutQty	累计出库数量（销售基本）	string
FBaseDeliQty	累计发货通知数量（销售基本）	string
FBaseRetNoticeQty	累计退货通知数量（销售基本）	string
FBaseReturnQty	累计退货数量（销售基本）	string
FBasePurReqQty	累计采购申请数量（销售基本）	string
FBasePurOrderQty	累计采购订单数量（销售基本）	string
FBaseUnitId	基本单位	string
FChangeFlag	变更标志	string
FMapId	客户物料编码	string
FOwnerTypeId	货主类型	string
FOwnerId	货主	string
FIsFree	是否赠品	string
FLOCKQTY	锁库/预留数量(库存单位)	string
FLOCKFLAG	锁库/预留标识	string
FProduceDate	生产日期	string
FExpiryDate	有效期至	string
FExpUnit	保质期单位	string
FExpPeriod	保质期	string
FMaterialIsProduce	物料允许生产属性	string
FTaxCombination	税组合	string
FLot	批号	string
FMapName	客户物料名称	string
FAuxPropId	辅助属性	string
FReturnType	退补类型	string
FDeliveryDate	要货日期	string
FTransJoinQty	累计调拨数量	string
FBaseTransJoinQty	累计调拨数量(销售基本)	string
FSrcType	源单类型	string
FSrcBillNo	源单编号	string
FBaseDeliveryMaxQty	发货上限（基本）	string
FBaseDeliveryMinQty	发货下限（基本）	string
FOEMInStockJoinQty	关联受托材料入库套数	string
FBaseOEMInStockJoinQty	关联受托材料入库套数(库存基本)	string
FBaseARJoinQty	关联应收数量（计价基本）	string
FIsReturn	物料允许退货属性	string
FBFLowId	业务流程	string
FIsInventory	物料允许库存属性	string
FBASEARQTY	累计应收数量（销售基本）	string
FARJOINAMOUNT	关联应收金额	string
FARAMOUNT	累计应收金额	string
FBaseRemainOutQty	剩余未出数量（销售基本）	string
FReBackQty	累计退货补货数量（销售）	string
FBaseReBackQty	累计退货补货数量（销售基本）	string
FARQTY	累计应收数量（销售）	string
FMaterialIsSubContract	物料允许委外属性	string
FCanOutQty	可出数量（销售）	string
FBaseCanOutQty	可出数量（销售基本）	string
FCanReturnQty	可退数量（销售）	string
FBaseCanReturnQty	可退数量（销售基本）	string
FBASEAPQTY	累计应付数量(基本单位)	string
FAPAMOUNT	累计应付金额	string
FMtoNo	计划跟踪号	string
FPriority	需求优先级	string
FReserveType	预留类型	string
FMinPlanDeliveryDate	计划交货日期	string
FDeliveryStatus	发货状态	string
FOldQty	原数量	string
FPromotionMatchType	促销匹配类型	string
FPriceListEntry	行价目表	string
FSupplyOrgId	供应组织	string
FNetOrderEntryId	供应商协同平台订单分录ID	string
FPriceBaseQty	计价基本数量	string
FSetPriceUnitID	定价单位	string
FStockUnitID	库存单位	string
FStockQty	库存数量	string
FStockBaseQty	库存基本数量	string
FStockBaseCanOutQty	可出数量（库存基本）	string
FStockBaseCanReturnQty	可退数量（库存基本）	string
FStockBaseARJoinQty	关联应收数量（库存基本）	string
FStockBaseTransJoinQty	累计调拨数量（库存基本）	string
FStockBasePurJoinQty	关联采购/生产数量（库存基本）	string
FSalBaseNum	源单基本分子	string
FStockBaseDen	库存基本分母	string
FSRCBIZUNITID	携带主单位	string
FPurBaseQty	采购基本数量	string
FPurUnitID	采购单位	string
FPurQty	采购数量	string
FSalBaseARJoinQty	关联应收数量（销售基本）	string
FSTOCKBASESTOCKOUTQTY	累计出库数量（库存基本）	string
FSTOCKBASEREBACKQTY	累计退货补货数量（库存基本）	string
FOUTLMTUNIT	超发控制单位类型	string
FOutLmtUnitID	超发控制单位	string
FTRANSRETURNQTY	累计调拨退货数量	string
FTRANSRETURNBASEQTY	累计调拨退货数量（销售基本）	string
FCONSIGNSETTQTY	寄售结算数量	string
FCONSIGNSETTBASEQTY	寄售结算数量（销售基本）	string
FLeftQty	待锁库/待预留数量(库存单位)	string
FRowType	产品类型	string
FParentMatId	父项产品	string
FRowId	行标识	string
FParentRowId	父行标识	string
FInStockPrice	最新采购入库价	string
FSOStockId_Fnumber	仓库	string
FSOStockLocalId	仓位	string
FPurPriceUnitId	采购计价单位	string
FISMRP	已计划运算	string
FBarcode	零售条形码	string
FBranchId	发货门店	string
FRetailSaleProm	是否零售促销	string
FBASEFINARQTY	先开票数量（计价基本）	string
FSALBASEFINARQTY	先开票数量（销售基本）	string
FEntryDiscountList	行折扣表	string
FPriceDiscount	单价折扣	string
FZHJStockQty	智慧记上报库存	string
FSPMENTRYID	促销政策ID	string
FSPMANDRPMCONTENT	促销内容	string
FTransReturnStockBaseQty	累计调拨退货数量（库存基本）	string

轻易云集成平台接口明细

API：/customer/add
NAME：客户新增
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FormId	业务对象表单Id		必须填写金蝶的表单ID如😛UR_PurchaseOrder
Operation	执行的操作	BatchSave
IsAutoSubmitAndAudit	提交并审核	true
IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统打通概况

数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。