发票导入接口

说明

您可以通过调用该接口，来将您系统内的发票信息导入到每刻的报销系统中。您需要按照接口要求，来传递发票信息，之后每刻会自动将发票匹配到对应的费用类型，在指定用户的账户下，自动产生未报销的费用。

注意事项

1. 可以只导入发票编码、发票号、发票校验码等关键信息，作为查重条件。
   1. 示例，仅传invoiceNumber（发票号码），则以此参数查重；
   2. 示例，仅传invoiceCode（发票代码），则以此参数查重；
   3. 示例，传invoiceNumber（发票号码）、invoiceCode（发票代码），则以两个参数全部匹配才会查重；
2. 单次导入最多为10条数据，如果超过该数据量则会抛出异常信息。
3. 本接口采用部分失败模式，一条数据失败不影响其他正确数据，且返参repeatInvoices仅包含异常数据。
4. 如果接口传入了费用CODE（expenseCode），那么就不再自动生成费用，而是绑定在传入的费用CODE中。
5. 若只有发票url，可以调用发票文件导入（含OCR识别）接口导入发票，并自动OCR识别生成费用。
6. 若导入费用（含发票）成功，不管存在账本还是被报销单关联，都不允许再次导入相同发票（同一企业环境内会查重）。
7. 同一费用导入多张机票时，费用舱位等级（planeCabinLevel）取所有机票中的最高舱位（非首张）。舱位等级顺序（由高到低）：FIRST 头等舱 > BUSINESS 商务舱 > SUPER_ECONOMY / LUXURY_ECONOMY 超级经济舱/豪华经济舱 > ECONOMY 经济舱；适用发票类型：航空运输电子客票行程单（国内）、电子发票（航空运输电子客票行程单）。该字段由系统按发票自动带入，不支持人工修改。

接口地址

/api/openapi/invoice/import

请求类型

POST

请求参数

参数说明

InvoiceDto 发票对象

items 货物明细

参数样例

{
  "employeeId": "RE00001",
  "invoiceList":[
    {
      "invoiceCode": "033001700211",
      "expenseCode": "FD3215412416543",
      "invoiceNumber": "05163151",
      "checkCode": "61561293271279245060",
      "status": "VALIDATED",
      "buyerName": "杭州每刻科技",
      "buyerTaxNumber": "15260000000000000G",
      "invoiceType": "ELECTRONIC_SHIPMENT_VAT_INVOICE",
      "items": [{
        "name": "明细名称",
        "priceAmount": 200.00,
        "taxRate": 0.05,
        "taxAmount": 10.00,
        "num": 10,
        "specificationModel": "每刻-简易版",
        "unit": "人",
        "unitPrice": 20.00
      }],
      "supplierName": "杭州每刻科技",
      "supplierAddress": "杭州市未来科技城",
      "supplierTaxNumber": "15260000000000000G",
      "ticketData": {
        "subType": "PASSENGER_SERVICE",
        "subTypeName": "旅客运输服务",
        "invoiceSpecialItems": [
          {
            "client": "张三",
            "clientIdentityType": "201",
            "clientIdentityNo": "330102198001011234",
            "departureDate": "2026-03-05 00:00:00",
            "departureAddress": "物联网街|聚光中心",
            "arrivalAddress": "浦沿|江滨花园"
          }
        ]
      },
      "issueDate": 1580289383747,
      "totalPriceAndTax": 200.00,
      "totalPriceAmount": 190.00,
      "totalTaxAmount": 10.00,
      "invoicePDFUrl": "https:xxx.com/files/xxxx.pdf",
      "invoiceImgUrl": "https:xxx.com/images/xxxx.jpeg"
    }
  ]
}

响应参数

响应参数说明

InvoiceImportDto 发票导入结果

响应参数样例

{
  "code": "ACK",  
  "message": "更新成功", 
  "data": {
    "repeatInvoices": [  
      {
        "message": "该发票已被你录入费用", 
        "invoiceCode": "123001700211", 
        "invoiceNumber": "26163151"  
      }
    ]
  }
}

修改记录

2023-02-08  新增发票导入接口文档
2026-07-08  补充电子发票（普通发票）（客运服务）ticketData出行明细说明