金蝶云星空对接打通金蝶云星空应付单查询1接口与应付单新增接口

224 阅读17分钟

金蝶云星空对接打通金蝶云星空应付单查询1接口与应付单新增接口

CRM与ERP接口互通

对接源平台:金蝶云星空

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

集成系统:金蝶云星空

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

数据对接方案

集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:金蝶云星空,源系统 API:应付单查询1,目标系统:金蝶云星空,目标系统 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预设基础资料字段1
FPRESETBASE2预设基础资料字段2FPRESETBASE2预设基础资料字段2
FPRESETTEXT1预设文本字段1FPRESETTEXT1预设文本字段1
FPRESETTEXT2预设文本字段2FPRESETTEXT2预设文本字段2
FPRESETASSISTANT2预设辅助资料字段2FPRESETASSISTANT2预设辅助资料字段2
FPRESETASSISTANT1预设辅助资料字段1FPRESETASSISTANT1预设辅助资料字段1
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}}'示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys需查询的字段key集合金蝶分录主键ID格式:FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId业务对象表单IdAP_Payable必须填写金蝶的表单ID如:PUR_PurchaseOrder

响应参数

接口字段字段名称预设值描述
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预设基础资料字段1
FPRESETBASE2预设基础资料字段2预设基础资料字段2
FPRESETTEXT1预设文本字段1预设文本字段1
FPRESETTEXT2预设文本字段2预设文本字段2
FPRESETASSISTANT2预设辅助资料字段2预设辅助资料字段2
FPRESETASSISTANT1预设辅助资料字段1预设辅助资料字段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

请求参数

字段字段名称类型配置值
FormId业务对象表单IdstringAP_Payable
Operation执行的操作stringBatchSave
IsVerifyBaseDataField验证基础资料boolfalse
IsAutoSubmitAndAudit提交并审核booltrue

系统对接概况

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