金蝶云星空和金蝶云星空集成接口设计

金蝶云星空和金蝶云星空集成接口设计

来源系统:金蝶云星空

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

集成系统:金蝶云星空

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

接口方案配置

通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的付款单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的新增付款单接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。通过该系统数据集成平台的能力，可以集成的应用系统包括CRM、ERP、钉钉、企业微信、MES、飞书、用友、金蝶等 177 个不同应用系统之间的无代码接口集成，并且每周都在增加新的应用系统接入。

金蝶云星空接口明细

• 接口：executeBillQuery
• 接口名称：付款单查询
• 接口方法：POST

请求参数

字段名称类型 FMATERIALSEQ采购订单行号string FServiceChargeCurr手续费币别string FISFROMTRADEBANK来源交易明细string FReceiveBankCode收款银行代码string FClearParameter清算要求参数string FServiceLevel服务级别string FENTRYPREPAYORDERNO预付采购订单号string FDepartment部门string FPAYAMOUNT表头-付款金额本位币string FNDistrict地区string FRequestTime请求时间string FExContractNo兑换合约号string FUrgent加急string FRuZhangType入账类型string FReceiveBranchClear收款人本地清算分行代码string FBankCode银行状态码string FSETTLEPAYAMOUNT折后金额本位币string FINNERACCOUNTNAME内部账户名称string FISINIT是否期初单据string StartRow开始行索引string FNoteStatus电票状态string FModifyDate修改日期string FAgentBankAcnt代理行账号string FPURCHASEORGID采购组织string FApproveDate审核日期string FPRICEUNITID计价单位string FREFUNDQTY退款关联数量string FCOSTID费用项目string TopRowCount返回总行数int FScanPoint扫描点string FWRITTENOFFAMOUNT已核销金额本位币string FGYSALEORDERNO管易销售订单号string FModifierId修改人string FUnique行唯一标志string FOverseaPay境外支付string FOPPOSITEBANKACCOUNT对方银行账号string FRECTUNIT收款单位string FBillTypeID单据类型string FReceiveBankClear收款银行本地清算码string FCity城市（作废）string FWRITTENOFFAMOUNTFOR_D表体明细-已核销金额string FSubmitBankTime提交/撤销银行时间string FBUSINESSTYPE业务类型string FSETTLEORGID结算组织string FCURRENCYID币别string FMessageInstruct电文指示string FCNYTransactType人民币交易种类string FEBMSG银企处理详细信息string FCertNum收款人证件号码string FOtherPartyEmail对方邮箱string FieldKeys需查询的字段key集合array FASSTOTALAMOUNTFOR关联金额string FACCOUNTID我方银行账号string FOVERSHORTAGEFOR长短款string FormId业务对象表单Idstring FWRITTENOFFSTATUS核销状态string FPAYTOTALAMOUNT表体-应付金额本位币string FOPPOSITEBANKNAME对方开户行string FSETTLEMAINBOOKID结算本位币string FCONTACTUNIT往来单位string FCollectionCurr收款币别string FSOURCESYSTEM来源系统string FGYCUSTOMERID管易对应客户string FCNAPS联行号string FCHECKCODE流水号/对账码string FReturnMsg错误码string Limit最大行数string FCountry国别string FISPOST是否登账string FOUTCONTACTTYPE转出往来单位类型string FBookingDate期望付款日期string FAgentBankAddress代理行地址string FPRESETBASE1预设基础资料字段1string FCertType收款人证件类型string FSETTLEDISTAMOUNTFOR现金折扣string FBillNo单据编号string FAgentBankName代理行名称string FBANKMSG银行状态描述string FRMBPayMethod人民币付款方式string FBankDetail银行网点string FOUTCONTACTID转出往来单位string FPURCHASERID采购员string FBLEND勾对string FPURCHASEDEPTID采购部门string FByAgentBank通过代理行完成string FPOSTDATE登账日期string FCNAPSNumCNAPSNumstring FCancelStatus作废状态string FAgentBankArea代理行国家\地区string FReceiveBranchCode收款支行代码string FEXPENSEDEPTID_E费用承担部门string FGYSHOPNAME管易对应店铺string FCancelDate作废日期string FMatchMethodID核销方式string FMAINBOOKID本位币string FSETTLEPAYAMOUNTFOR折后金额string FResponseTme付款回调时间string FServiceChargeBear手续费承担方string FProvince省（作废）string FISCASHPURCHASE现购string FDistrict地区（作废）string FIsWriteOff是否转销string FWRITTENOFFSTATUS_D表体明细-核销状态string FNProvince省string FREALPAYAMOUNT_H表头-实付金额本位币string FQTY数量string FTOPAYMENTAMOUNTFOR保证金转货款金额string FCreateDate创建日期string FDOCUMENTSTATUS单据状态string FPURCHASEORDERID采购订单IDstring FMoreReceive多收款人string FSignature签名string FPAYTOTALAMOUNTFOR_H表头-应付金额string FNCity城市string FAgentSWIFTCodeSWIFT Code(代理行)string FPURCHASERGROUPID采购组string FVirIsSameAcctOrg是否同一核算组织string FFinishTime付款完成时间string FPayType支付类型string FPAYTOTALAMOUNTFOR表体-应付金额string FREALPAYAMOUNT_D表体-实付金额本位币string FCancellerId作废人string FPURPOSEID付款用途string FPRESETTEXT1预设文本字段1string FCONTACTUNITTYPE往来单位类型string FREALPAYAMOUNTFOR_H表头-实付金额string FHANDLINGCHARGEFOR手续费string FIsBorrow是否其他预付string FSubmitUser提交/撤销银行人string FISSAMEORG是否相同组织string FServiceChargeNo手续费账号string FREALPAY实报实付string FDistrictCode地区码string FOPPOSITECCOUNTNAME对方账户名称string FTransacType交易类型string FPAYAMOUNTFOR_E付款金额string FReceiveBankBIC收款银行BICstring FWBSETTLENO流水号string FPAYACCOUNTNAME我方账户名称string FOtherPartyAdress对方地址string FTaxAmt税额string FRecType收款类型string FPAYBANKID我方开户行string FCashAccount现金账号string FREMARK备注string FPURCHASEORDERNO采购订单号string FDATE业务日期string FEXCHANGERATE汇率string FIsCredit是否信贷业务string FREALPAYAMOUNTFOR_D表体-实付金额string FORDERENTRYID采购订单明细内码string FBankStatus银行处理状态string FPAYORGID付款组织string FOVERSHORTAGE长短款本位币string FCollectionAmount收款金额string FACCOUNTSYSTEM会计核算体系string FilterString过滤条件string FSETTLEEXCHANGETYPE结算汇率类型string FMATERIALID物料编码string FSETTLERATE结算汇率string FPRICE含税单价string FHANDLINGCHARGE手续费本位币string FLinkRowId关联行IDstring FISCARRYRATE是否下推携带汇率到结算汇率string FPAYITEMTYPE预付项目类型string FPAYAMOUNTFOR付款金额string FTHIRDBILLNO第三方单据编号string FSETTLEDISTAMOUNT现金折扣本位币string FRefundAmount退款关联金额string FPAYITEM采购订单string FBankInvoice银企开票string FServiceChargeBank手续费账号银行string FSwiftCodeSwiftCodestring FPRESETASSISTANT2预设辅助资料字段2string FPRESETTEXT2预设文本字段2string FCNYPayMethodCNY付款方式string FID实体主键string FCreatorId创建人string FSETTLETYPEID结算方式string FPayMethod付款方式string FCOMMENT备注string FSETTLECUR结算币别string FEXCHANGETYPE汇率类型string FGYACCOUNTWATERID管易财务流水内码string FRECTUNITTYPE收款单位类型string FNOTVERIFICATEAMOUNT未核销金额string FIsInvoice已电票开票string FPAYBILLENTRY_FEntryIDFPAYBILLENTRY_FEntryIDstring FAPPROVERID审核人string FPRESETASSISTANT1预设辅助资料字段1string FSETTLENO结算号string FSubmitStatus提交银行状态string FMATERIALNAME物料名称string FPAYTOTALAMOUNT_H表头-应付金额本位币string FOpenAddressRec开户行地址string FBankTypeRec收款银行（作废）string FPAYAMOUNT_E付款金额本位币string FINNERACCOUNTID内部账号string FPRESETBASE2预设基础资料字段2string

响应参数

字段名称类型描述 FPAYBILLENTRY_FEntryIDFPAYBILLENTRY_FEntryIDstring FID实体主键string FBillNo单据编号string FDOCUMENTSTATUS单据状态string FCreatorId创建人string FAPPROVERID审核人string FCreateDate创建日期string FSETTLEORGID结算组织string FApproveDate审核日期string FPURCHASEORGID采购组织string FPAYTOTALAMOUNTFOR_H表头-应付金额string FCURRENCYID币别string FDATE业务日期string FModifyDate修改日期string FModifierId修改人string FWRITTENOFFSTATUS核销状态string FBillTypeID单据类型string FPURCHASERID采购员string FPURCHASERGROUPID采购组string FPURCHASEDEPTID采购部门string FREALPAYAMOUNTFOR_H表头-实付金额string FACCOUNTSYSTEM会计核算体系string FCancellerId作废人string FCancelStatus作废状态string FCancelDate作废日期string FCONTACTUNITTYPE往来单位类型string FCONTACTUNIT往来单位string FRECTUNITTYPE收款单位类型string FRECTUNIT收款单位string FSOURCESYSTEM来源系统string FBUSINESSTYPE业务类型string FISINIT是否期初单据string FDepartment部门string FPAYORGID付款组织string FISSAMEORG是否相同组织string FIsCredit是否信贷业务string FSETTLERATE结算汇率string FPAYAMOUNTFOR付款金额string FEXCHANGETYPE汇率类型string FMAINBOOKID本位币string FSETTLECUR结算币别string FPAYTOTALAMOUNT_H表头-应付金额本位币string FPAYAMOUNT表头-付款金额本位币string FREALPAYAMOUNT_H表头-实付金额本位币string FEXCHANGERATE汇率string FScanPoint扫描点string FIsWriteOff是否转销string FMatchMethodID核销方式string FREALPAY实报实付string FREMARK备注string FBookingDate期望付款日期string FTHIRDBILLNO第三方单据编号string FWBSETTLENO流水号string FSETTLEMAINBOOKID结算本位币string FSETTLEEXCHANGETYPE结算汇率类型string FISCASHPURCHASE现购string FOUTCONTACTID转出往来单位string FOUTCONTACTTYPE转出往来单位类型string FIsBorrow是否其他预付string FISFROMTRADEBANK来源交易明细string FGYACCOUNTWATERID管易财务流水内码string FISCARRYRATE是否下推携带汇率到结算汇率string FGYSHOPNAME管易对应店铺string FGYCUSTOMERID管易对应客户string FMoreReceive多收款人string FPRESETASSISTANT1预设辅助资料字段1string FPRESETASSISTANT2预设辅助资料字段2string FPRESETTEXT1预设文本字段1string FPRESETTEXT2预设文本字段2string FPRESETBASE1预设基础资料字段1string FPRESETBASE2预设基础资料字段2string FVirIsSameAcctOrg是否同一核算组织string FSETTLETYPEID结算方式string FSETTLEPAYAMOUNTFOR折后金额string FSETTLEDISTAMOUNTFOR现金折扣string FPAYTOTALAMOUNTFOR表体-应付金额string FSETTLEPAYAMOUNT折后金额本位币string FSETTLEDISTAMOUNT现金折扣本位币string FPAYTOTALAMOUNT表体-应付金额本位币string FWRITTENOFFSTATUS_D表体明细-核销状态string FWRITTENOFFAMOUNTFOR_D表体明细-已核销金额string FOPPOSITEBANKACCOUNT对方银行账号string FCOMMENT备注string FOPPOSITECCOUNTNAME对方账户名称string FPAYITEM采购订单string FHANDLINGCHARGEFOR手续费string FHANDLINGCHARGE手续费本位币string FREALPAYAMOUNTFOR_D表体-实付金额string FREALPAYAMOUNT_D表体-实付金额本位币string FASSTOTALAMOUNTFOR关联金额string FPAYITEMTYPE预付项目类型string FPURCHASEORDERID采购订单IDstring FACCOUNTID我方银行账号string FPAYACCOUNTNAME我方账户名称string FPAYBANKID我方开户行string FOPPOSITEBANKNAME对方开户行string FSETTLENO结算号string FBLEND勾对string FPURPOSEID付款用途string FOpenAddressRec开户行地址string FRecType收款类型string FCNAPS联行号string FBankTypeRec收款银行（作废）string FProvince省（作废）string FCity城市（作废）string FDistrict地区（作废）string FUrgent加急string FSubmitStatus提交银行状态string FSubmitUser提交/撤销银行人string FSubmitBankTime提交/撤销银行时间string FBankStatus银行处理状态string FBankCode银行状态码string FINNERACCOUNTID内部账号string FINNERACCOUNTNAME内部账户名称string FCOSTID费用项目string FRefundAmount退款关联金额string FCashAccount现金账号string FPAYAMOUNTFOR_E付款金额string FPAYAMOUNT_E付款金额本位币string FISPOST是否登账string FPOSTDATE登账日期string FMATERIALID物料编码string FMATERIALNAME物料名称string FPURCHASEORDERNO采购订单号string FMATERIALSEQ采购订单行号string FORDERENTRYID采购订单明细内码string FRuZhangType入账类型string FEBMSG银企处理详细信息string FOVERSHORTAGEFOR长短款string FOVERSHORTAGE长短款本位币string FEXPENSEDEPTID_E费用承担部门string FPayType支付类型string FPRICEUNITID计价单位string FPRICE含税单价string FQTY数量string FREFUNDQTY退款关联数量string FSwiftCodeSwiftCodestring FWRITTENOFFAMOUNT已核销金额本位币string FCHECKCODE流水号/对账码string FTOPAYMENTAMOUNTFOR保证金转货款金额string FTaxAmt税额string FNProvince省string FNCity城市string FNDistrict地区string FBankDetail银行网点string FCountry国别string FSignature签名string FGYSALEORDERNO管易销售订单号string FReturnMsg错误码string FFinishTime付款完成时间string FDistrictCode地区码string FBANKMSG银行状态描述string FResponseTme付款回调时间string FRequestTime请求时间string FCertType收款人证件类型string FCertNum收款人证件号码string FBankInvoice银企开票string FNoteStatus电票状态string FNOTVERIFICATEAMOUNT未核销金额string FENTRYPREPAYORDERNO预付采购订单号string FIsInvoice已电票开票string FUnique行唯一标志string FTransacType交易类型string FMessageInstruct电文指示string FServiceLevel服务级别string FPayMethod付款方式string FCNYPayMethodCNY付款方式string FExContractNo兑换合约号string FCollectionCurr收款币别string FCollectionAmount收款金额string FReceiveBankBIC收款银行BICstring FReceiveBankCode收款银行代码string FReceiveBranchCode收款支行代码string FServiceChargeBear手续费承担方string FServiceChargeNo手续费账号string FServiceChargeBank手续费账号银行string FServiceChargeCurr手续费币别string FCNAPSNumCNAPSNumstring FCNYTransactType人民币交易种类string FRMBPayMethod人民币付款方式string FByAgentBank通过代理行完成string FAgentBankAcnt代理行账号string FAgentBankName代理行名称string FAgentBankArea代理行国家\地区string FAgentSWIFTCodeSWIFT Code(代理行)string FAgentBankAddress代理行地址string FReceiveBankClear收款银行本地清算码string FReceiveBranchClear收款人本地清算分行代码string FClearParameter清算要求参数string FOtherPartyAdress对方地址string FOtherPartyEmail对方邮箱string FOverseaPay境外支付string FLinkRowId关联行IDstring

金蝶云星空接口明细

• API：batchSave
• NAME：新增付款单
• METHOD：POST

请求参数

接口字段名称预设值 FBillNo单据编号{{FBillNo}}测试 FDOCUMENTSTATUS单据状态C FSETTLEORGID结算组织103 FCURRENCYID币别PRE001 FDATE业务日期2022-04-18 03:56:06 FBillTypeID单据类型FKDLX04_SYS FCancelStatus作废状态A FCONTACTUNITTYPE往来单位类型FIN_OTHERS FCONTACTUNIT往来单位{{FCONTACTUNIT}} FRECTUNITTYPE收款单位类型FIN_OTHERS FRECTUNIT收款单位{{FRECTUNIT}} FBUSINESSTYPE业务类型3 FPAYORGID付款组织103 FSETTLECUR结算币别PRE001 FREMARK备注{{FREMARK}} FPAYBILLENTRY付款单明细 FPAYBILLENTRY.FSETTLETYPEID结算方式JSFS04_SYS FPAYBILLENTRY.FPAYTOTALAMOUNTFOR表体-应付金额{{FPAYTOTALAMOUNTFOR_H}} FPAYBILLENTRY.FCOMMENT备注{{FCOMMENT}} FPAYBILLENTRY.FHANDLINGCHARGEFOR手续费{{FHANDLINGCHARGEFOR}} FPAYBILLENTRY.FACCOUNTID我方银行账号{{FACCOUNTID}} FPAYBILLENTRY.FPURPOSEID付款用途SFKYT42_SYS FPAYBILLENTRY.FRecType收款类型 FPAYBILLENTRY.FISPOST是否登账true FPAYBILLENTRY.FPOSTDATE登账日期{{FPOSTDATE}} FPAYBILLENTRY.FMATERIALID物料编码{{FMATERIALID}} FPAYBILLENTRY.FRuZhangType入账类型1 FPAYBILLENTRY.FEXPENSEDEPTID_E费用承担部门{{FEXPENSEDEPTID_E}} FPAYBILLENTRY.FPayType支付类型A FPAYBILLENTRY.FPRICEUNITID计价单位{{FPRICEUNITID}} FPAYBILLENTRY.FQTY数量{{FQTY}} FPAYBILLENTRY.FTaxAmt税额{{FTaxAmt}} FPAYBILLENTRY.FormId业务对象表单IdAP_PAYBILL FPAYBILLENTRY.Operation执行的操作BatchSave FPAYBILLENTRY.IsAutoSubmitAndAudit提交并审核true FPAYBILLENTRY.IsVerifyBaseDataField验证基础资料false

系统数据对接

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。