易快报对接打通金蝶云星空获取指定状态单据列表(包含已删除单据)接口与付款单新增接口

庄颜_qeasy

易快报对接打通金蝶云星空获取指定状态单据列表(包含已删除单据)接口与付款单新增接口

对接系统：易快报

易快报是敏捷的企业报销费控与聚合消费平台，为企业提供移动报销、聚合消费、全程费控、预算管理、发票管理等一站式解决方案。同时，易快报可集成多家银行及第三方支付平台，打通对公对私付款，对接财务软件自动生成凭证，实现申请-订购-报销-验票-支付-记账全流程，并可与企业现有ERP、OA、CRM等业务系统无缝集成，打破信息孤岛，激活数据价值。

写入目标:金蝶云星空

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

接口方案配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：易快报，并且选择对应的连接器（关于易快报的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的获取指定状态单据列表(包含已删除单据)接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的付款单新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

易快报接口明细

API：/api/openapi/v1/docSequences
NAME：获取指定状态单据列表(包含已删除单据)
METHOD：POST

请求参数

接口字段字段名称预设值描述 fields需要过滤掉的字段指定过滤掉的字段返回空值，从而缩小响应数据 fields.docData单据数据包含所有单据数据 fields.docData.logs审批日志 fields.docData.flowPlan审批流信息 fields.type单据类型expenseexpense : 报销单 loan : 借款单 repayment : 还款记录 payment : 付款单 requisition : 申请单 custom : 通用审批单 receipt : 收款单 fields.index分页查询的起始索引序号_function ({{LAST_SYNC_TIME}}000)*1例如 : 当 index = 1484498318240 时，会查询所有 index > 1484498318240 的单据 fields.count查询数据条数10最大不能超过 100 fields.state单据状态PAIDREJECTED : 已驳回 PAYING : 待支付 PROCESSING : 支付中 PAID : 已支付不传值时，查询四种状态单据

响应参数

接口字段字段名称预设值描述 typetypeautoFillResponse idid_autoFillResponse corporationIdcorporationIdautoFillResponse ownerIdownerId_autoFillResponse dataTypedataTypeautoFillResponse remarkremark_autoFillResponse titletitleautoFillResponse updateTimeupdateTime_autoFillResponse specificationIdspecificationIdautoFillResponse ownerowner_autoFillResponse owner.ididautoFillResponse owner.namename_autoFillResponse owner.departmentsdepartmentsautoFillResponse owner.codecode_autoFillResponse owner.departmentdepartmentautoFillResponse owner.department.idid_autoFillResponse owner.department.namenameautoFillResponse owner.department.codecode_autoFillResponse owner.department.codecodeautoFillResponse owner.department.userPropsuserProps_autoFillResponse owner.department.userProps.payeeIdpayeeIdautoFillResponse owner.department.userProps.descriptiondescription_autoFillResponse owner.department.userProps.submitterIdsubmitterIdautoFillResponse owner.department.userProps.companyRealPaycompanyRealPay_autoFillResponse owner.department.userProps.specificationIdspecificationIdautoFillResponse owner.department.userProps.expenseDepartmentexpenseDepartment_autoFillResponse owner.department.userProps.companyRealPay_ratecompanyRealPay_rateautoFillResponse owner.department.userProps.companyRealPay_budgetcompanyRealPay_budget_autoFillResponse owner.department.userProps.companyRealPay_foreigncompanyRealPay_foreignautoFillResponse owner.department.userProps.companyRealPay_budgetRatecompanyRealPay_budgetRate_autoFillResponse owner.department.userProps.companyRealPay_budgetUnitcompanyRealPay_budgetUnitautoFillResponse owner.department.userProps.companyRealPay_budgetScalecompanyRealPay_budgetScale_autoFillResponse owner.department.userProps.companyRealPay_foreignUnitcompanyRealPay_foreignUnitautoFillResponse owner.department.userProps.companyRealPay_budgetSymbolcompanyRealPay_budgetSymbol_autoFillResponse owner.department.userProps.companyRealPay_standardUnitcompanyRealPay_standardUnitautoFillResponse owner.department.userProps.companyRealPay_budgetNumCodecompanyRealPay_budgetNumCode_autoFillResponse owner.department.userProps.companyRealPay_budgetStrCodecompanyRealPay_budgetStrCodeautoFillResponse owner.department.userProps.companyRealPay_foreignSymbolcompanyRealPay_foreignSymbol_autoFillResponse owner.department.userProps.companyRealPay_foreignNumCodecompanyRealPay_foreignNumCodeautoFillResponse owner.department.userProps.companyRealPay_foreignStrCodecompanyRealPay_foreignStrCode_autoFillResponse owner.department.userProps.companyRealPay_standardSymbolcompanyRealPay_standardSymbolautoFillResponse owner.department.userProps.companyRealPay_standardNumCodecompanyRealPay_standardNumCode_autoFillResponse owner.department.userProps.companyRealPay_standardStrCodecompanyRealPay_standardStrCodeautoFillResponse owner.department.userProps.statestate_autoFillResponse owner.department.userProps.projectprojectautoFillResponse owner.department.userProps.logslogs_autoFillResponse owner.department.userProps.flowPlanflowPlanautoFillResponse owner.department.userProps.sumAmountsumAmount_autoFillResponse owner.department.userProps.writeOffAmountwriteOffAmountautoFillResponse owner.department.userProps.expenseDateexpenseDate_autoFillResponse owner.department.userProps.detailsdetailsautoFillResponse owner.department.userProps.details.amountamount_autoFillResponse owner.department.userProps.details.amount_standardStrCodeamount_standardStrCodeautoFillResponse owner.department.userProps.details.amount_standardNumCodeamount_standardNumCode_autoFillResponse owner.department.userProps.details.amount_standardSymbolamount_standardSymbolautoFillResponse owner.department.userProps.details.amount_standardUnitamount_standardUnit_autoFillResponse owner.department.userProps.details.amount_rateamount_rateautoFillResponse owner.department.userProps.details.amount_foreignStrCodeamount_foreignStrCode_autoFillResponse owner.department.userProps.details.amount_foreignNumCodeamount_foreignNumCodeautoFillResponse owner.department.userProps.details.amount_foreignamount_foreign_autoFillResponse owner.department.userProps.details.amount_foreignSymbolamount_foreignSymbolautoFillResponse owner.department.userProps.details.amount_foreignUnitamount_foreignUnit_autoFillResponse owner.department.userProps.details.datedateautoFillResponse owner.department.userProps.details.remarkremark_autoFillResponse owner.department.userProps.details.feeTypeIdfeeTypeIdautoFillResponse owner.department.userProps.details.userPropsuserProps_autoFillResponse owner.department.userProps.details.invoiceCountinvoiceCountautoFillResponse owner.department.userProps.details.taxAmounttaxAmount_autoFillResponse owner.department.userProps.details.noTaxAmountnoTaxAmountautoFillResponse owner.department.userProps.details.invoicesinvoices_autoFillResponse owner.department.userProps.details.invoiceFormTypeinvoiceFormTypeautoFillResponse owner.department.userProps.details.payeeInfopayeeInfo_autoFillResponse owner.department.userProps.details.writtenOffRecordswrittenOffRecordsautoFillResponse owner.department.userProps.details.submitTimesubmitTime_autoFillResponse owner.department.userProps.details.payeeInfopayeeInfoautoFillResponse owner.department.userProps.details.payeeInfo.sortsort_autoFillResponse owner.department.userProps.details.payeeInfo.namenameautoFillResponse owner.department.userProps.details.payeeInfo.cardNocardNo_autoFillResponse owner.department.userProps.details.payeeInfo.bankbankautoFillResponse owner.department.userProps.details.payeeInfo.branchbranch_autoFillResponse owner.department.userProps.details.payeeInfo.typetypeautoFillResponse owner.department.userProps.details.payeeInfo.provinceprovince_autoFillResponse owner.department.userProps.details.payeeInfo.citycityautoFillResponse owner.department.userProps.details.payeeInfo.certificateTypecertificateType_autoFillResponse owner.department.userProps.details.payeeInfo.certificateNocertificateNoautoFillResponse owner.department.userProps.details.payeeInfo.bankLinkNobankLinkNo_autoFillResponse owner.department.userProps.details.payeeInfo.bankNamebankNameautoFillResponse owner.department.userProps.details.payeeInfo.swiftCodeswiftCode_autoFillResponse owner.department.userProps.details.payeeInfo.bankCodebankCodeautoFillResponse owner.department.userProps.details.payeeInfo.branchCodebranchCode_autoFillResponse owner.department.userProps.details.payeeInfo.remarkremarkautoFillResponse owner.department.userProps.details.payeeInfo.idid_autoFillResponse owner.department.userProps.details.payeeInfo.payorIdpayorIdautoFillResponse owner.department.userProps.details.payeeInfo.paymentChannelpaymentChannel_autoFillResponse owner.department.userProps.details.payeeInfo.paymentAccountIdpaymentAccountIdautoFillResponse owner.department.userProps.details.payeeInfo.payTimepayTime_autoFillResponse owner.department.userProps.details.payeeInfo.multiplePayeesModemultiplePayeesModeautoFillResponse owner.department.userProps.details.payeeInfo.channelTradeNochannelTradeNo_autoFillResponse owner.department.userProps.details.payeeInfo.payPlanpayPlanautoFillResponse owner.department.userProps.details.payeeInfo.receiptStatereceiptState_autoFillResponse owner.department.userProps.details.payeeInfo.paymentAccountpaymentAccount_autoFillResponse

金蝶云星空接口明细

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

请求参数

接口字段字段名称预设值描述 FBillNo单据编号function case when '{{details_userProps_u归属组织code}}'='' then '{{code}}{{userProps_u归属组织code}}-1' else '{{code}}{{details_userProps_u归属组织code}}-1' end FPAYORGID付款组织_function case when '{{FPAYORGID}}'>0 then '{{FPAYORGID}}' when '{{details_userProps_u归属组织code}}' in ('') then '{{userProps_u归属组织code}}' else '{{details_userProps_u归属组织code}}' end FSETTLEORGID结算组织function case when '{{details_userProps_u归属组织code}}'>0 then '{{details_userProps_u归属组织code}}' else '{{userProps_u归属组织code}}' end FCURRENCYID币别PRE001 FDATE业务日期_function FROM_UNIXTIME( ( {{payTime}} / 1000 ) ,'%Y-%m-%d %H:%i:%S' ) FBillTypeID单据类型function case when '{{userProps_specificationId_name}}' in ('差旅报销单') then 'clbxd' when '{{userProps_specificationId_name}}' in ('日常费用报销单') then 'rcfybxd' when '{{userProps_specificationId_name}}' in ('款项支付单') then 'kxzfd' when '{{userProps_specificationId_name}}' in ('固定资产报销单') then 'gdzcbxd' when '{{userProps_specificationId_name}}' in ('工艺费用结算单') then 'gyfyjsd' else 'sdhkd1' end FCONTACTUNITTYPE往来单位类型BD_Department FCONTACTUNIT往来单位_function case when '{{department_code}}' in ('') then 'BM000001' else '{{department_code}}' end FRECTUNITTYPE收款单位类型BD_Department FRECTUNIT收款单位function case when '{{department_code}}' in ('') then 'BM000001' else '{{department_code}}' end FDepartment部门_findCollection find code from 19c94f4e-612d-3b26-8952-edf9168371d5 where name={{department_name}} FPAYAMOUNTFOR付款金额function sum({{sumAmount}}-{{writeOffAmount}}) FEXCHANGETYPE汇率类型HLTX01_SYS FSETTLECUR结算币别PRE001 FREMARK备注_function left('{{remark}}',400) FPAYBILLENTRY付款单明细 FPAYBILLENTRY.FSETTLETYPEID结算方式function case when '{{paymentAccount_accountNo}}' in ('') then 'JSFS01_SYS' else 'JSFS04_SYS' end FPAYBILLENTRY.FPAYTOTALAMOUNTFOR付款金额_function sum({{sumAmount}}-{{writeOffAmount}}) FPAYBILLENTRY.FPURPOSEID收付款用途SFKYT12_SYS FPAYBILLENTRY.FACCOUNTID我方银行账号{{paymentAccount_accountNo}} FPAYBILLENTRY.FCOMMENT备注function left('{{details_remark}}',400) FPAYBILLENTRY.FCOSTID费用项目_findCollection find code from 0e3410bc-d1ad-3810-bd5f-639ce883690a where id={{details_feeTypeId}} FPAYBILLENTRY.FEXPENSEDEPTID_E费用承担部门findCollection find code from 19c94f4e-612d-3b26-8952-edf9168371d5 where id={{details_userProps_expenseDepartment}} FPAYBILLENTRY.F_wk_KH客户{{details_userProps_u_客户code}} FPAYBILLENTRY.F_PBLH_YKBHEXJE易快报核销金额 FPAYBILLENTRY.F_wk_bxje1报销金额{{sumAmount}} FPAYBILLENTRY.F_wk_hxje核销金额{{writeOffAmount}} FPAYBILLENTRY.F_wk_YG员工_function case when '{{userProps_u原借款人name}}'='' then '{{userProps_u实际报销人name}}' else '{{userProps_u原借款人name}}' end FPAYBILLENTRY.FormId业务对象表单IdAP_PAYBILL必须填写金蝶的表单ID如😛UR_PurchaseOrder FPAYBILLENTRY.Operation执行的操作BatchSave FPAYBILLENTRY.IsAutoSubmitAndAudit提交并审核false FPAYBILLENTRY.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统打通概况

使用全界面可视化配置集成流，快速应对企业的集成需求使得易快报与金蝶云星空之间的数据接口一站式的快速集成能力，构建企业数据通道，解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准，完成数据的采集、统一、分发、清洗、归集等，帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统，同时具备快速适配新系统的能力，集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统，都可以通过接口相互集成。