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

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

对接源平台:金蝶云星空

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

接通系统：金蝶云星空

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

多系统对接方案配置

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：金蝶云星空的接口参数设置，以及设定好目标平台：金蝶云星空的映射，即可启动方案进行测试数据管道ETL：构建一体化的数据融合平台。高级数据转换： 支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。

金蝶云星空接口明细

• API：executeBillQuery
• NAME：应付单查询1
• METHOD：POST

请求参数

接口字段名称预设值 FID实体主键FID FBillNo单据编号FBillNo FDOCUMENTSTATUS单据状态FDOCUMENTSTATUS FRelateHadPayAmount表头基本FRelateHadPayAmount FDATE业务日期FDATE FSETTLEORGID结算组织FSETTLEORGID FCURRENCYID币别FCURRENCYID FBillTypeID单据类型FBillTypeID FModifierId修改人FModifierId FAPPROVEDATE审核日期FAPPROVEDATE FCreateDate创建日期FCreateDate FModifyDate修改日期FModifyDate FAPPROVERID审核人FAPPROVERID FWRITTENOFFSTATUS付款核销状态FWRITTENOFFSTATUS FOPENSTATUS开票核销状态FOPENSTATUS FCreatorId创建人FCreatorId FALLAMOUNTFOR价税合计FALLAMOUNTFOR FENDDATE_H到期日FENDDATE_H FACCOUNTSYSTEM会计核算体系FACCOUNTSYSTEM FISTAX按含税单价录入FISTAX FCancellerId作废人FCancellerId FCancelDate作废日期FCancelDate FCancelStatus作废状态FCancelStatus FPayConditon付款条件FPayConditon FSUPPLIERID供应商FSUPPLIERID FPURCHASEORGID采购组织FPURCHASEORGID FBUSINESSTYPE业务类型FBUSINESSTYPE FPURCHASEDEPTID采购部门FPURCHASEDEPTID FPURCHASERGROUPID采购组FPURCHASERGROUPID FPURCHASERID采购员FPURCHASERID FSourceBillType源单类型FSourceBillType FISINIT是否期初单据FISINIT FINSTOCKBUSTYPE入库单业务类型FINSTOCKBUSTYPE FMRBBUSTYPE退料单业务类型FMRBBUSTYPE FPAYORGID付款组织FPAYORGID FISBYIV是发票审核自动生成FISBYIV FISGENHSADJ是否需要成本调整FISGENHSADJ FISTAXINCOST税额计入成本FISTAXINCOST FMatchMethodID核销方式FMatchMethodID FISPRICEEXCLUDETAX价外税FISPRICEEXCLUDETAX FAP_Remark备注FAP_Remark FSetAccountType立账类型FSetAccountType FISHookMatch参与暂估应付核销FISHookMatch FIsWriteOff转销FIsWriteOff FISINVOICEARLIER先到票后入库FISINVOICEARLIER FRedBlue红蓝字FRedBlue FByVerify生成方式FByVerify FScanPoint扫描点FScanPoint FISCASHPURCHASE现购FISCASHPURCHASE FOUTSUPPLIERID转出供应商FOUTSUPPLIERID FISINSIDEBILL外部单据FISINSIDEBILL FBILLMATCHLOGID开票核销记录序号FBILLMATCHLOGID FWBOPENQTY反写开票数量FWBOPENQTY FPRESETBASE1预设基础资料字段1FPRESETBASE1 FPRESETBASE2预设基础资料字段2FPRESETBASE2 FPRESETTEXT1预设文本字段1FPRESETTEXT1 FPRESETTEXT2预设文本字段2FPRESETTEXT2 FPRESETASSISTANT2预设辅助资料字段2FPRESETASSISTANT2 FPRESETASSISTANT1预设辅助资料字段1FPRESETASSISTANT1 FIsGeneratePlanByCostItem按费用项目生成计划FIsGeneratePlanByCostItem FEntryID实体主键FEntryID FMATERIALID物料编码FMATERIALID FMaterialName物料名称FMaterialName FModel规格型号FModel FMaterialType物料类别FMaterialType FPrice单价FPrice FTaxPrice含税单价FTaxPrice FPriceCoefficient价格系数FPriceCoefficient FPriceQty计价数量FPriceQty FDISCOUNTAMOUNTFOR折扣额FDISCOUNTAMOUNTFOR FEntryDiscountRate折扣率(%)FEntryDiscountRate FNoTaxAmountFor_D不含税金额FNoTaxAmountFor_D FEntryTaxRate税率(%)FEntryTaxRate FTAXAMOUNTFOR_D税额FTAXAMOUNTFOR_D FALLAMOUNTFOR_D价税合计FALLAMOUNTFOR_D FComment备注FComment FIVALLAMOUNTFOR采购发票价税合计FIVALLAMOUNTFOR FDISCOUNTAMOUNT折扣额本位币FDISCOUNTAMOUNT FTAXAMOUNT_D税额本位币FTAXAMOUNT_D FALLAMOUNT_D价税合计本位币FALLAMOUNT_D FNOTAXAMOUNT_D不含税金额本位币FNOTAXAMOUNT_D FOPENSTATUS_D开票核销状态FOPENSTATUS_D FOPENAMOUNTFOR_D已开票核销金额FOPENAMOUNTFOR_D FORDERNUMBER采购订单号FORDERNUMBER FPRICEUNITID计价单位FPRICEUNITID FBASICUNITID基本单位FBASICUNITID FBASICUNITQTY计价基本数量FBASICUNITQTY FPriceWithTax含税净价FPriceWithTax FBaseJoinQty基本单位关联数量FBaseJoinQty FSOURCETYPE源单类型FSOURCETYPE FSourceBillNo源单编号FSourceBillNo FTaxCombination税组合FTaxCombination FBUYIVBASICQTY采购发票基本单位数量FBUYIVBASICQTY FBUYIVQTY采购发票数量FBUYIVQTY FOPENQTY_D已开票核销数量FOPENQTY_D FTEMPTAXRATE卖家代扣增值税税率FTEMPTAXRATE FMatchNotTaxAmtFor已核销不含税金额FMatchNotTaxAmtFor FHadMatchAmountFor已开票金额FHadMatchAmountFor FSettleTran结算清单调拨类型FSettleTran FSpecialQTY特殊核销数量FSpecialQTY FSpecialAmountFor特殊核销金额FSpecialAmountFor FBizEntryId业务单据分录内码FBizEntryId FBizID业务单据内码FBizID FBizBillTypeId业务单据类型FBizBillTypeId FBizBillNo业务单据编号FBizBillNo FBizFormId业务单据名称FBizFormId FMaterialDesc物料说明FMaterialDesc FALLOCATESTATUS分配状态FALLOCATESTATUS FHOOKSTATUS勾稽状态FHOOKSTATUS FCOSTID费用项目编码FCOSTID FCostName费用项目名称FCostName FINCLUDECOST计入成本FINCLUDECOST FINSTOCKID入库单号FINSTOCKID FOUTSTOCKID出库单号FOUTSTOCKID FISOUTSTOCK是否有出库单号FISOUTSTOCK FCOSTDEPARTMENTID费用承担部门FCOSTDEPARTMENTID FAUXPROPID辅助属性FAUXPROPID FLot批号FLot FASSETID卡片编码FASSETID FASSETNAME资产名称FASSETNAME FMONUMBER生产订单编号FMONUMBER FMOENTRYSEQ生产订单行号FMOENTRYSEQ FOPNO工序计划号FOPNO FSEQNUMBER序列号FSEQNUMBER FOPERNUMBER工序号FOPERNUMBER FPROCESSID作业FPROCESSID FFPRODEPARTMENTID生产车间FFPRODEPARTMENTID FWWINTYPE入库类型FWWINTYPE FIsFree是否赠品FIsFree FStockUnitId库存单位FStockUnitId FStockBaseQty库存基本数量FStockBaseQty FStockQty库存数量FStockQty FPriceBaseDen计价基本分母FPriceBaseDen FStockBaseNum库存基本分子FStockBaseNum FOrderEntryID采购订单明细内码FOrderEntryID FORDERENTRYSEQ采购订单行号FORDERENTRYSEQ FPAYMENTAMOUNT已结算金额FPAYMENTAMOUNT FBUYIVINIQTY采购发票数量期初FBUYIVINIQTY FBUYIVINIBASICQTY采购发票基本单位数量期初FBUYIVINIBASICQTY FIVINIALLAMOUNTFOR采购发票价税合计期初FIVINIALLAMOUNTFOR FPushRedQty已下推负数财务应付数量FPushRedQty FSRCROWID源单行内码FSRCROWID FISINVOICEALLARRIVED已完全到票FISINVOICEALLARRIVED FBarcode零售条形码FBarcode FDIFFAMOUNT成本差异金额FDIFFAMOUNT FDIFFALLAMOUNT价税合计差异金额FDIFFALLAMOUNT FDIFFAMOUNTEXRATE成本汇率差异金额FDIFFAMOUNTEXRATE FDIFFALLAMOUNTEXRATE价税合计汇率差异金额FDIFFALLAMOUNTEXRATE FNORECEIVEAMOUNT未结算金额FNORECEIVEAMOUNT FNOINVOICEAMOUNT未开票核销金额FNOINVOICEAMOUNT FNOINVOICEQTY未开票核销数量FNOINVOICEQTY FROOTSETACCOUNTTYPE源立账类型FROOTSETACCOUNTTYPE FROOTSOURCETYPE源应付单源单类型FROOTSOURCETYPE FOPENAMOUNT已核销金额本位币FOPENAMOUNT Fmatchnottaxamt已核销不含税金额本位币Fmatchnottaxamt Limit最大行数{{PAGINATION_PAGE_SIZE}} StartRow开始行索引{{PAGINATION_START_ROW}} TopRowCount返回总行数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' FieldKeys需查询的字段key集合 FormId业务对象表单IdAP_Payable

响应参数

接口字段名称预设值 FID实体主键 FBillNo单据编号 FDOCUMENTSTATUS单据状态 FRelateHadPayAmount表头基本 FDATE业务日期 FSETTLEORGID结算组织 FCURRENCYID币别 FBillTypeID单据类型 FModifierId修改人 FAPPROVEDATE审核日期 FCreateDate创建日期 FModifyDate修改日期 FAPPROVERID审核人 FWRITTENOFFSTATUS付款核销状态 FOPENSTATUS开票核销状态 FCreatorId创建人 FALLAMOUNTFOR价税合计 FENDDATE_H到期日 FACCOUNTSYSTEM会计核算体系 FISTAX按含税单价录入 FCancellerId作废人 FCancelDate作废日期 FCancelStatus作废状态 FPayConditon付款条件 FSUPPLIERID供应商 FPURCHASEORGID采购组织 FBUSINESSTYPE业务类型 FPURCHASEDEPTID采购部门 FPURCHASERGROUPID采购组 FPURCHASERID采购员 FSourceBillType源单类型 FISINIT是否期初单据 FINSTOCKBUSTYPE入库单业务类型 FMRBBUSTYPE退料单业务类型 FPAYORGID付款组织 FISBYIV是发票审核自动生成 FISGENHSADJ是否需要成本调整 FISTAXINCOST税额计入成本 FMatchMethodID核销方式 FISPRICEEXCLUDETAX价外税 FAP_Remark备注 FSetAccountType立账类型 FISHookMatch参与暂估应付核销 FIsWriteOff转销 FISINVOICEARLIER先到票后入库 FRedBlue红蓝字 FByVerify生成方式 FScanPoint扫描点 FISCASHPURCHASE现购 FOUTSUPPLIERID转出供应商 FISINSIDEBILL外部单据 FBILLMATCHLOGID开票核销记录序号 FWBOPENQTY反写开票数量 FPRESETBASE1预设基础资料字段1 FPRESETBASE2预设基础资料字段2 FPRESETTEXT1预设文本字段1 FPRESETTEXT2预设文本字段2 FPRESETASSISTANT2预设辅助资料字段2 FPRESETASSISTANT1预设辅助资料字段1 FIsGeneratePlanByCostItem按费用项目生成计划 FMATERIALID物料编码 FMaterialName物料名称 FModel规格型号 FMaterialType物料类别 FPrice单价 FTaxPrice含税单价 FPriceCoefficient价格系数 FPriceQty计价数量 FDISCOUNTAMOUNTFOR折扣额 FEntryDiscountRate折扣率(%) FNoTaxAmountFor_D不含税金额 FEntryTaxRate税率(%) FTAXAMOUNTFOR_D税额 FALLAMOUNTFOR_D价税合计 FComment备注 FIVALLAMOUNTFOR采购发票价税合计 FDISCOUNTAMOUNT折扣额本位币 FTAXAMOUNT_D税额本位币 FALLAMOUNT_D价税合计本位币 FNOTAXAMOUNT_D不含税金额本位币 FOPENSTATUS_D开票核销状态 FOPENAMOUNTFOR_D已开票核销金额 FORDERNUMBER采购订单号 FPRICEUNITID计价单位 FBASICUNITID基本单位 FBASICUNITQTY计价基本数量 FPriceWithTax含税净价 FBaseJoinQty基本单位关联数量 FSOURCETYPE源单类型 FSourceBillNo源单编号 FTaxCombination税组合 FBUYIVBASICQTY采购发票基本单位数量 FBUYIVQTY采购发票数量 FOPENQTY_D已开票核销数量 FTEMPTAXRATE卖家代扣增值税税率 FMatchNotTaxAmtFor已核销不含税金额 FHadMatchAmountFor已开票金额 FSettleTran结算清单调拨类型 FSpecialQTY特殊核销数量 FSpecialAmountFor特殊核销金额 FBizEntryId业务单据分录内码 FBizID业务单据内码 FBizBillTypeId业务单据类型 FBizBillNo业务单据编号 FBizFormId业务单据名称 FMaterialDesc物料说明 FALLOCATESTATUS分配状态 FHOOKSTATUS勾稽状态 FCOSTID费用项目编码 FCostName费用项目名称 FINCLUDECOST计入成本 FINSTOCKID入库单号 FOUTSTOCKID出库单号 FISOUTSTOCK是否有出库单号 FCOSTDEPARTMENTID费用承担部门 FAUXPROPID辅助属性 FLot批号 FASSETID卡片编码 FASSETNAME资产名称 FMONUMBER生产订单编号 FMOENTRYSEQ生产订单行号 FOPNO工序计划号 FSEQNUMBER序列号 FOPERNUMBER工序号 FPROCESSID作业 FFPRODEPARTMENTID生产车间 FWWINTYPE入库类型 FIsFree是否赠品 FStockUnitId库存单位 FStockBaseQty库存基本数量 FStockQty库存数量 FPriceBaseDen计价基本分母 FStockBaseNum库存基本分子 FOrderEntryID采购订单明细内码 FORDERENTRYSEQ采购订单行号 FPAYMENTAMOUNT已结算金额 FBUYIVINIQTY采购发票数量期初 FBUYIVINIBASICQTY采购发票基本单位数量期初 FIVINIALLAMOUNTFOR采购发票价税合计期初 FPushRedQty已下推负数财务应付数量 FSRCROWID源单行内码 FISINVOICEALLARRIVED已完全到票 FBarcode零售条形码 FDIFFAMOUNT成本差异金额 FDIFFALLAMOUNT价税合计差异金额 FDIFFAMOUNTEXRATE成本汇率差异金额 FDIFFALLAMOUNTEXRATE价税合计汇率差异金额 FNORECEIVEAMOUNT未结算金额 FNOINVOICEAMOUNT未开票核销金额 FNOINVOICEQTY未开票核销数量 FROOTSETACCOUNTTYPE源立账类型 FROOTSOURCETYPE源应付单源单类型 FOPENAMOUNT已核销金额本位币 Fmatchnottaxamt已核销不含税金额本位币

金蝶云星空接口明细

• 调用接口：batchSave
• 接口名称：收款单新增
• 方法：POST

请求参数

字段字段名称类型配置值 FBillNo单据编号string FDOCUMENTSTATUS单据状态stringC FSETTLEORGID结算组织string FEXCHANGETYPE汇率类型stringHLTX01_SYS FCURRENCYID币别stringPRE001 FDATE业务日期string FBillTypeID单据类型stringSKDLX02_SYS FCancelStatus作废状态stringA FCONTACTUNITTYPE往来单位类型stringBD_Customer FCONTACTUNIT往来单位string FPAYUNITTYPE付款单位类型stringBD_Customer FPAYUNIT付款单位string FBUSINESSTYPE业务类型string1 FPAYORGID收款组织string FSETTLECUR结算币别stringPRE001 FRECEIVEBILLENTRY收款单明细array FRECEIVEBILLENTRY.FSETTLETYPEID结算方式stringJSFS01_SYS FRECEIVEBILLENTRY.FRECTOTALAMOUNTFOR表体-应收金额string FRECEIVEBILLENTRY.FACCOUNTID我方银行账号string FRECEIVEBILLENTRY.FPURPOSEID收款用途stringSFKYT02_SYS FRECEIVEBILLENTRY.FPOSTDATE1登账日期string FRECEIVEBILLENTRY.FormId业务对象表单IdstringAR_RECEIVEBILL FRECEIVEBILLENTRY.Operation执行的操作stringBatchSave FRECEIVEBILLENTRY.IsAutoSubmitAndAudit提交并审核booltrue FRECEIVEBILLENTRY.IsVerifyBaseDataField验证基础资料boolfalse

数据对接价值

大部分的企业都可能只用一套系统组织架构复杂，业务流程繁琐，内部同时有OA系统、BI系统、ERP系统......且各个系统都需要独立登陆，造成IT部门数据监管困难！如何在同一套中台系统上关联多管理系统呢？系统集成平台，就可以无缝集成各个业务系统，主数不统一、交易数据来回导出导入、业务融合等问题。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。 资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。让对接开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。