发票文件导入（含OCR识别）接口

说明

您可以通过调用该接口，来将您系统内的发票文件导入到每刻的报销系统中。接口识别验真后，会生成新费用或绑定到传入的费用中。

注意事项

1. 若是expenseCode有值，则仅将发票关联至费用，不对费用信息做更新。
2. 调用此接口前，请确认企业已开通识票（OCR识别）功能，否则调用失败；若开通验真功能（次数足够），则会触发验真校验。
3. 若导入费用成功，不管存在账本还是被报销单关联，都不允许再次导入相同发票（同一企业环境内会查重）。
4. 若传了expenseCode，且同一expenseCode多次调用，则会插入传入的发票文件而不是覆盖。
5. 同一费用导入多张机票时，费用舱位等级（planeCabinLevel）取所有机票中的最高舱位（非首张）。舱位等级顺序（由高到低）：FIRST 头等舱 > BUSINESS 商务舱 > SUPER_ECONOMY / LUXURY_ECONOMY 超级经济舱/豪华经济舱 > ECONOMY 经济舱；适用发票类型：航空运输电子客票行程单（国内）、电子发票（航空运输电子客票行程单）。该字段由系统按发票自动带入，不支持人工修改。

接口地址

/api/openapi/invoice/import-invoice-pic

接口限制

限流：2次/秒

请求类型

POST

请求参数

参数说明

参数样例

{
  "fileBase64":"eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJtYXljdXJfand0X2Rldl9p",
  "fileUrl":"https://ng.maycur.com/iamge/filename",
  "fileType":"JPG",
  "employeeId":"MK00001",
  "expenseCode":"FD231231",
  "allInvoiceBindToOneExpense":"true"
}

响应参数

响应参数说明(data)

InvoiceDto 发票

FileInfo 附件信息

lineItemsDto 货物明细

InvoiceTaxDto 发票抵扣

validateStatus(验真状态)对应validateStatusDesc(验真状态解释说明)

AmountInput 金额

错误码

响应参数样例

{
  "code": "ACK",
  "message": null,
  "data": [
    {
      "invoiceDataCode": "INV123293506094510086",
      "userCode": "UI2012221C97WQDC",
      "expenseCode": "FD123293507650590747",
      "qrCode": "",
      "buyerName": "杭州每刻科技有限公司",
      "buyerTaxNumber": "91330108341927699X",
      "invoiceCode": "033002300611",
      "invoiceNumber": "99007885",
      "issueDate": 1719417600000,
      "totalPriceAmount": 3.67,
      "totalTaxAmount": 0.33,
      "totalPriceAndTax": 4.00,
      "supplierName": "杭州地铁运营有限公司",
      "supplierAddress": "浙江省杭州市上城区九和路466号3幢12层0571-96600",
      "invoiceTypeDesc": "增值税电子普通发票（客运服务）",
      "invoiceTypeEnum": "SHIPMENT_VAT",
      "attachments": [
        {
          "entCode": null,
          "code": "ATT123293506390202413",
          "resourceKey": "maycur001/caeaf520-db1f-47d9-a09b-f37a288efce1.pdf",
          "associatedWith": "invoice",
          "associatedCode": "INV123293506094510086",
          "createdBy": null,
          "createdAt": 1731293325217,
          "filename": "caeaf520-db1f-47d9-a09b-f37a288efce1.pdf",
          "type": "application/pdf",
          "isQrCodePic": false,
          "coordinates": "0,0,2000,1333",
          "orientation": 0.0,
          "mimeType": null,
          "originalUrl": "",
          "thumUrl": "",
          "ratioFixedThumbUrl": null,
          "imageUrl": null,
          "size": null,
          "downloadUrl": "",
          "pageNumber": 0,
          "isOriginalFile": true,
          "pdfDownLoadUrl": null,
          "originalFile": true,
          "qrCodePic": false,
          "validFileName": "caeaf520-db1f-47d9-a09b-f37a288efce1.pdf"
        }
      ],
      "attachmentFiles": null,
      "validateStatus": "VALIDATED",
      "validateStatusDesc": "已验真",
      "remark": "成功",
      "importedAt": 1731293325160,
      "importedAtYearMonth": "202411",
      "hasQrCodePic": false,
      "processing": false,
      "auditLogs": null,
      "invoicePDFUrl": null,
      "invoiceImgUrl": null,
      "invoiceDateStr": null,
      "invoiceStatus": null,
      "invoiceTitleConflict": false,
      "invoiceTitleConflictWithFee": false,
      "mainAttachment": null,
      "correlatedReimburseDataCode": null,
      "correlatedReimburseCode": null,
      "ticketData": {
        "consumeTime": 1719417600000,
        "machineCode": "661103102500",
        "city": "",
        "drawer": "田定河",
        "reviewer": "赵美红",
        "consumeStartDate": 1719417600000,
        "payee": "秦宁",
        "number": "",
        "province": "浙江省",
        "codeConfirm": "",
        "consumeEndDate": 1719417600000,
        "location": "domestic-ZH32-ZH32_1-ZH32_1_01",
        "numberConfirm": "",
        "invoiceSheetType": ""
      },
      "taxDedectCode": "",
      "approvedTaxAmount": {
        "amount": 0.00,
        "currency": "CNY",
        "customExchangeRate": 1,
        "amountStr": "￥0.00"
      },
      "approvedDeductionAmount": {
        "amount": 0.00,
        "currency": "CNY",
        "customExchangeRate": 1,
        "amountStr": "￥0.00"
      },
      "auditDetailJson": null,
      "customTaxFlag": false,
      "identityFlag": true,
      "errorMessage": null,
      "errorCode": null,
      "taxRate": 0,
      "valueAddedTaxRate": null,
      "supplierTaxNumber": "91330102MA7F72672F",
      "modify": false,
      "modifySwitch": false,
      "vouchers": null,
      "wxCardId": "",
      "wxEncryptCode": "",
      "wxOpenId": "",
      "billNum": null,
      "expenseTypeList": null,
      "expenseType": null,
      "employeeId": "",
      "employeeName": "",
      "buyerAddressPhone": "",
      "buyerAccount": "",
      "supplierAccount": "中国建设银行股份有限公司杭州秋涛支行营业部33050110438609666666",
      "reimburseStatus": null,
      "reimburseStatusDesc": null,
      "issueDateDesc": null,
      "source": "OPENAPI_IMPORT",
      "sourceDesc": "OPENAPI_IMPORT",
      "companySeal": true,
      "invoiceTaxDtoList": [],
      "updateRecord": [],
      "invoiceRemark": "",
      "invoiceSheet": 1,
      "agentMark": "",
      "cancellationMark": "NOT_INVALID",
      "cancellationMarkDesc": null,
      "sourceCode": "",
      "invoiceStateCode": null,
      "invoiceStateRemark": null,
      "validationResult": null,
      "complete": true,
      "thirdInvoiceDataCode": "",
      "invoiceDeductionStatus": null,
      "electronicVoucher": null,
      "electronicVoucherFiles": null,
      "verificaitonChannel": "",
      "title": "",
      "dynaFormCode": "MOCK_FORM_CODE_SHIPMENT_VAT",
      "electronic": true,
      "customObject": null,
      "cancellationMarkUpdateTime": null,
      "supplierUnusual": null,
      "supplierUnusualUpdateTime": null,
      "sourceScanner": null,
      "invoiceCodeNumber": "03300230061199007885",
      "notCanVerify": false,
      "checksum": "60258258882690380411",
      "type": "-997",
      "lineItems": [
        {
          "code": "IGI123293506352453681",
          "invoiceDataCode": "INV123293506094510086",
          "name": "*运输服务*地铁票",
          "priceAmount": 3.670000,
          "taxRate": 0.090000,
          "taxAmount": 0.330000,
          "num": 1.0,
          "specificationModel": "",
          "unit": "",
          "unitPrice": 3.669725,
          "taxRateMark": null,
          "taxRateMarkDesc": null,
          "expenseCode": "FD123293507650590747",
          "invoiceType": "-997"
        }
      ],
      "splitted": false
    }
  ],
  "errorCode": null,
  "success": true
}

修改记录

2023-02-08  新增发票文件导入（含OCR识别）接口文档