金蝶云星空对接打通伯俊ERP付款单查询接口与创建新的记录接口

接入系统：金蝶云星空

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

对接目标系统:伯俊ERP

伯俊科技拥有近千人的团队、出色的本地化服务能力及强劲的研发创新实力，在深耕零售行业24年中，成功研发企业级ERP系统、OMS订单管理系统、门店收银系统、门店管理软硬件一体机等。探索零售行业数字化的进程中，伯俊科技成功落地百余全渠道项目，积累丰富的业务中台、数据中台落地经验。

数据对接方案

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：付款单查询，目标系统：伯俊ERP，目标系统 API创建新的记录。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

金蝶云星空接口明细

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}}' and FBillNo like 'PY%'示例写法 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

伯俊ERP接口明细

API：/rest/excute
NAME：创建新的记录
METHOD：POST

请求参数

接口字段字段名称预设值描述 table表名25812 FBILLNO付款单编号{{FBillNo}}{"name":"StringToArray","params":","} FPAYTIME付款时间{{modify_date_new}}{"name":"StringToArray","params":","} FPAYPRICE付款单金额{{FPAYAMOUNTFOR}}{"name":"StringToArray","params":","} FPAYER付款人张建华{"name":"StringToArray","params":","} FBANKACCOUNT付款银行账号{{FACCOUNTID}}{"name":"StringToArray","params":","} command操作命令ObjectCreate

系统数据对接

通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与伯俊ERP之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。

金蝶云星空对接打通伯俊ERP付款单查询接口与创建新的记录接口