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

对接源平台:金蝶云星空
金蝶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 | 预设基础资料字段1 | FPRESETBASE1 |
FPRESETBASE2 | 预设基础资料字段2 | FPRESETBASE2 |
FPRESETTEXT1 | 预设文本字段1 | FPRESETTEXT1 |
FPRESETTEXT2 | 预设文本字段2 | FPRESETTEXT2 |
FPRESETASSISTANT2 | 预设辅助资料字段2 | FPRESETASSISTANT2 |
FPRESETASSISTANT1 | 预设辅助资料字段1 | FPRESETASSISTANT1 |
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 | 业务对象表单Id | AP_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 | 单据状态 | string | C |
FSETTLEORGID | 结算组织 | string | |
FEXCHANGETYPE | 汇率类型 | string | HLTX01_SYS |
FCURRENCYID | 币别 | string | PRE001 |
FDATE | 业务日期 | string | |
FBillTypeID | 单据类型 | string | SKDLX02_SYS |
FCancelStatus | 作废状态 | string | A |
FCONTACTUNITTYPE | 往来单位类型 | string | BD_Customer |
FCONTACTUNIT | 往来单位 | string | |
FPAYUNITTYPE | 付款单位类型 | string | BD_Customer |
FPAYUNIT | 付款单位 | string | |
FBUSINESSTYPE | 业务类型 | string | 1 |
FPAYORGID | 收款组织 | string | |
FSETTLECUR | 结算币别 | string | PRE001 |
FRECEIVEBILLENTRY | 收款单明细 | array | |
FRECEIVEBILLENTRY.FSETTLETYPEID | 结算方式 | string | JSFS01_SYS |
FRECEIVEBILLENTRY.FRECTOTALAMOUNTFOR | 表体-应收金额 | string | |
FRECEIVEBILLENTRY.FACCOUNTID | 我方银行账号 | string | |
FRECEIVEBILLENTRY.FPURPOSEID | 收款用途 | string | SFKYT02_SYS |
FRECEIVEBILLENTRY.FPOSTDATE1 | 登账日期 | string | |
FRECEIVEBILLENTRY.FormId | 业务对象表单Id | string | AR_RECEIVEBILL |
FRECEIVEBILLENTRY.Operation | 执行的操作 | string | BatchSave |
FRECEIVEBILLENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
FRECEIVEBILLENTRY.IsVerifyBaseDataField | 验证基础资料 | bool | false |
数据对接价值
大部分的企业都可能只用一套系统组织架构复杂,业务流程繁琐,内部同时有OA系统、BI系统、ERP系统......且各个系统都需要独立登陆,造成IT部门数据监管困难!如何在同一套中台系统上关联多管理系统呢?系统集成平台,就可以无缝集成各个业务系统,主数不统一、交易数据来回导出导入、业务融合等问题。通过轻易云系统集成平台完美结合:打破企业内部数据孤岛,无需繁琐的处理工序,与数据集成服务完美结合,让数据真正通起来。 资源互补:汇集各种行业解决方案,资源互补,企业管理融合提升。让对接开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。
