发票导入接口

说明

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

注意事项

1. 可以只导入发票编码、发票号、发票校验码等关键信息，作为查重条件。
2. 单次导入最多为10条数据，如果超过该数据量则会抛出异常信息。
3. 本接口采用部分失败模式，一条数据失败不影响其他正确数据，且返参repeatInvoices仅包含异常数据。
4. 如果接口传入了费用CODE（expenseCode），那么就不再自动生成费用，而是绑定在传入的费用CODE中。
5. 若只有发票url，可以调用发票文件导入（含OCR识别）接口导入发票，并自动OCR识别生成费用。
6. 若导入费用（含发票）成功，不管存在账本还是被报销单关联，都不允许再次导入相同发票（每刻会查重）。

接口地址

/api/openapi/invoice/import

请求类型

POST

请求参数

参数说明

InvoiceDto 发票对象

items 货物明细

参数样例

{
  "employeeId": "RE00001",
  "invoiceList":[
    {
      "invoiceCode": "033001700211",
      "expenseCode": "FD3215412416543",
      "invoiceNumber": "05163151",
      "checkCode": "61561293271279245060",
      "status": "VALIDATED",
      "buyerName": "杭州每刻科技",
      "buyerTaxNumber": "15260000000000000G",
      "invoiceType": "VAT_PAPER",
      "items": [{
        "name": "明细名称",
        "priceAmount": 200.00,
        "taxRate": 0.05,
        "taxAmount": 10.00,
        "num": 10,
        "specificationModel": "每刻-简易版",
        "unit": "人",
        "unitPrice": 20.00
      }],
      "supplierName": "杭州每刻科技",
      "supplierAddress": "杭州市未来科技城",
      "supplierTaxNumber": "15260000000000000G",
      "ticketData": {

      },
      "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  新增发票导入接口文档