金蝶云星空与金蝶云星空对接集成付款单查询打通[标准][付款单新增]-v1

金蝶云星空与金蝶云星空对接集成付款单查询打通[标准][付款单新增]-v1

对接源平台:金蝶云星空

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

集成系统:金蝶云星空

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

多系统对接方案配置

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：金蝶云星空接口：付款单查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：金蝶云星空接口：[标准][付款单新增]-v1，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：金蝶云星空写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

金蝶云星空接口明细

• API：executeBillQuery
• NAME：付款单查询
• METHOD：POST

请求参数

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

响应参数

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

金蝶云星空接口明细

• API：batchSave
• NAME：[标准][付款单新增]-v1
• METHOD：POST

请求参数

接口字段字段名称预设值描述 FBillNo单据编号{{FBillNo}}单据编号 FPAYORGID 付款组织100付款组织 FSETTLEORGID 结算组织100结算组织 FDATE 业务日期{{FCreateDate}}业务日期 FBillTypeID 单据类型FKDLX04_SYS单据类型 FCONTACTUNITTYPE 往来单位类型BD_Department往来单位类型 FCONTACTUNIT 往来单位{{FCONTACTUNIT}}往来单位 FRECTUNITTYPE收款单位类型BD_Department收款单位类型 FRECTUNIT收款单位{{FRECTUNIT}}收款单位 FDepartment部门部门 FPAYAMOUNTFOR付款金额付款金额 FEXCHANGETYPE汇率类型HLTX01_SYS汇率类型 FSETTLECUR结算币别PRE001结算币别 FREMARK备注备注 FPAYBILLENTRY付款单明细付款单明细 FPAYBILLENTRY.FSETTLETYPEID结算方式JSFS01_SYS结算方式 FPAYBILLENTRY.FPAYTOTALAMOUNTFOR付款金额{{FPAYTOTALAMOUNTFOR}}付款金额 FPAYBILLENTRY.FPURPOSEID收付款用途SFKYT10_SYS收付款用途 FPAYBILLENTRY.FACCOUNTID我方银行账号我方银行账号 FPAYBILLENTRY.FCOMMENT备注备注 FPAYBILLENTRY.FCOSTID费用项目费用项目 FPAYBILLENTRY.FEXPENSEDEPTID_E费用承担部门费用承担部门 FPAYBILLENTRY.FormId业务对象表单IdAP_PAYBILL必须填写金蝶的表单ID如😛UR_PurchaseOrder FPAYBILLENTRY.Operation执行的操作BatchSave FPAYBILLENTRY.IsAutoSubmitAndAudit提交并审核true FPAYBILLENTRY.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统数据对接

从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。