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

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

数据源系统:金蝶云星空

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

集成系统:金蝶云星空

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

系统对接接口配置

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

金蝶云星空接口明细

• API：executeBillQuery
• NAME：销售订单查询
• METHOD：POST

请求参数

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

响应参数

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

金蝶云星空接口明细

• 接口：batchSave
• 接口名称：销售订单新增
• 接口方法：POST

请求参数

字段名称类型 FSaleOrderEntry.FormId业务对象表单Idstring FDate日期string FSaleOrderEntry.FEntryNote备注string FNote备注string FSaleOrderEntry.Operation执行的操作string FSaleOrderEntry.FQty销售数量string FSaleOrderEntry.FMaterialId物料编码string FSaleOrderEntry.FTaxPrice含税单价string FSaleOrderEntry订单明细array FSaleOrderEntry.IsVerifyBaseDataField验证基础资料bool FSaleOrderEntry.FSalerId销售员string FBillNo单据编号string FSaleOrgId销售组织string FBillTypeID单据类型string FSaleOrderEntry.IsAutoSubmitAndAudit提交并审核bool FCustId客户string

系统集成总览

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。