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

来源系统:金蝶云星空

金蝶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	业务对象表单Id	string
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	预设基础资料字段1	string
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
FCNAPSNum	CNAPSNum	string
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	采购订单ID	string
FMoreReceive	多收款人	string
FSignature	签名	string
FPAYTOTALAMOUNTFOR_H	表头-应付金额	string
FNCity	城市	string
FAgentSWIFTCode	SWIFT Code(代理行)	string
FPURCHASERGROUPID	采购组	string
FVirIsSameAcctOrg	是否同一核算组织	string
FFinishTime	付款完成时间	string
FPayType	支付类型	string
FPAYTOTALAMOUNTFOR	表体-应付金额	string
FREALPAYAMOUNT_D	表体-实付金额本位币	string
FCancellerId	作废人	string
FPURPOSEID	付款用途	string
FPRESETTEXT1	预设文本字段1	string
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	收款银行BIC	string
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	关联行ID	string
FISCARRYRATE	是否下推携带汇率到结算汇率	string
FPAYITEMTYPE	预付项目类型	string
FPAYAMOUNTFOR	付款金额	string
FTHIRDBILLNO	第三方单据编号	string
FSETTLEDISTAMOUNT	现金折扣本位币	string
FRefundAmount	退款关联金额	string
FPAYITEM	采购订单	string
FBankInvoice	银企开票	string
FServiceChargeBank	手续费账号银行	string
FSwiftCode	SwiftCode	string
FPRESETASSISTANT2	预设辅助资料字段2	string
FPRESETTEXT2	预设文本字段2	string
FCNYPayMethod	CNY付款方式	string
FID	实体主键	string
FCreatorId	创建人	string
FSETTLETYPEID	结算方式	string
FPayMethod	付款方式	string
FCOMMENT	备注	string
FSETTLECUR	结算币别	string
FEXCHANGETYPE	汇率类型	string
FGYACCOUNTWATERID	管易财务流水内码	string
FRECTUNITTYPE	收款单位类型	string
FNOTVERIFICATEAMOUNT	未核销金额	string
FIsInvoice	已电票开票	string
FPAYBILLENTRY_FEntryID	FPAYBILLENTRY_FEntryID	string
FAPPROVERID	审核人	string
FPRESETASSISTANT1	预设辅助资料字段1	string
FSETTLENO	结算号	string
FSubmitStatus	提交银行状态	string
FMATERIALNAME	物料名称	string
FPAYTOTALAMOUNT_H	表头-应付金额本位币	string
FOpenAddressRec	开户行地址	string
FBankTypeRec	收款银行（作废）	string
FPAYAMOUNT_E	付款金额本位币	string
FINNERACCOUNTID	内部账号	string
FPRESETBASE2	预设基础资料字段2	string

响应参数

字段	名称	类型
FPAYBILLENTRY_FEntryID	FPAYBILLENTRY_FEntryID	string
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	预设辅助资料字段1	string
FPRESETASSISTANT2	预设辅助资料字段2	string
FPRESETTEXT1	预设文本字段1	string
FPRESETTEXT2	预设文本字段2	string
FPRESETBASE1	预设基础资料字段1	string
FPRESETBASE2	预设基础资料字段2	string
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	采购订单ID	string
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
FSwiftCode	SwiftCode	string
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
FCNYPayMethod	CNY付款方式	string
FExContractNo	兑换合约号	string
FCollectionCurr	收款币别	string
FCollectionAmount	收款金额	string
FReceiveBankBIC	收款银行BIC	string
FReceiveBankCode	收款银行代码	string
FReceiveBranchCode	收款支行代码	string
FServiceChargeBear	手续费承担方	string
FServiceChargeNo	手续费账号	string
FServiceChargeBank	手续费账号银行	string
FServiceChargeCurr	手续费币别	string
FCNAPSNum	CNAPSNum	string
FCNYTransactType	人民币交易种类	string
FRMBPayMethod	人民币付款方式	string
FByAgentBank	通过代理行完成	string
FAgentBankAcnt	代理行账号	string
FAgentBankName	代理行名称	string
FAgentBankArea	代理行国家\地区	string
FAgentSWIFTCode	SWIFT Code(代理行)	string
FAgentBankAddress	代理行地址	string
FReceiveBankClear	收款银行本地清算码	string
FReceiveBranchClear	收款人本地清算分行代码	string
FClearParameter	清算要求参数	string
FOtherPartyAdress	对方地址	string
FOtherPartyEmail	对方邮箱	string
FOverseaPay	境外支付	string
FLinkRowId	关联行ID	string

金蝶云星空接口明细

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	业务对象表单Id	AP_PAYBILL
FPAYBILLENTRY.Operation	执行的操作	BatchSave
FPAYBILLENTRY.IsAutoSubmitAndAudit	提交并审核	true
FPAYBILLENTRY.IsVerifyBaseDataField	验证基础资料	false

系统数据对接

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