发票台账查询V2接口

说明

通过该接口，可以查询到结构化的发票数据。

注意事项

• 每次最多只能查询100条数据；
• 如果发票状态码为空，请传"" ，而不是null；
• formCode 为条件必填：默认需要提供；当 taskEndDateStart 与 taskEndDateEnd 构成合法且不超过90天的时间对，或 invoiceUpdateAtStart 与 invoiceUpdateAtEnd 构成合法且不超过90天的时间对时，可以不传。两组合法时间对也可以同时提供；
• invoiceUpdateAtStart 与 invoiceUpdateAtEnd 必须成对提供，使用正值 Unix 毫秒时间戳，开始时间不得晚于结束时间，跨度不得超过90天；开始等于结束及恰好90天均合法；
• 发票修改时间按闭区间 [start, end] 查询，开始和结束边界均包含，实际查询精度为分钟级；
• 仅能查询到被单据关联的发票，若发票为仅在账本，则不会被查到。

接口地址

/api/openapi/invoice-ledger/v2/list-invoice-info

请求类型

POST

请求参数

参数说明

参数样例

{
  "pageNo": 1,
  "pageSize": 10,
  "reimburseStatus": [
    "APPROVING",
    "AUDITING",
    "FORWARD",
    "SETTLEMENT",
    "COMPLETED",
    "CLOSED"
  ],
  "formCode": "XXX",
  "invoiceOutStateCodes": [
    "",
    "A"
  ],
  "startDate": 1336320000000,
  "endDate": 1336406400000,
  "buyerTaxNumber": "11010867663556711",
  "taskEndDateStart": 1672558087000,
  "taskEndDateEnd": 1675063687693,
  "invoiceUpdateAtStart": 1672558087000,
  "invoiceUpdateAtEnd": 1675063687693,
  "invoiceDataCodes": [],
  "signStatusList": [
    "NOT_STARTED",
    "SIGNING"
  ]
}

按发票修改时间增量查询样例

以下示例不传 formCode，通过发票修改时间和关联单据状态增量查询发票：

{
  "pageNo": 1,
  "pageSize": 100,
  "invoiceUpdateAtStart": 1782835200000,
  "invoiceUpdateAtEnd": 1785513540000,
  "reimburseStatus": [
    "AUDITING",
    "COMPLETED"
  ]
}

查询条件校验

以下请求会校验失败，具体错误结构和提示语以接口实际返回为准：

• 只提供 invoiceUpdateAtStart 或 invoiceUpdateAtEnd 中的一个字段；
• 发票修改时间的任一时间戳为0或负数；
• invoiceUpdateAtStart 晚于 invoiceUpdateAtEnd；
• 发票修改时间跨度超过90天；
• 未提供 formCode，且未提供任一组合法的单据结束时间对或发票修改时间对。

大跨度增量同步建议

首次同步或补偿同步的时间范围超过90天时，请拆分为每段不超过90天的连续窗口。由于发票修改时间使用分钟级精度和闭区间 [start, end]，建议相邻窗口保留边界重叠，例如依次查询 [T0, T1]、[T1, T2]，并由调用方按唯一的 invoiceDataCode 去重，避免遗漏边界数据或重复归档。

响应参数

响应参数说明

InvoiceDto 发票

FileInfo 附件信息

lineItemsDto 货物明细

InvoiceTaxDto 发票抵扣

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

AmountInput 金额

参数样例

{
  "code": "ACK",
  "message": "成功",
  "data": {
    "list": [
      {
        "invoiceDataCode": "INV20122912U89IWW",
        "reimburseCode": "MK118070203",
        "reimburseDataCode": "BX1807041LX7O64G",
        "buyerName": "",
        "buyerTaxNumber": "",
        "invoiceCode": "",
        "invoiceNumber": "",
        "issueDate": 1530673200000,
        "issueDateDesc": "2018-07-04",
        "procTaskEndTime": 1674631618000,
        "procTaskEndTimeDesc": "2023-01-25",
        "procTaskStartTime": 1672739570726,
        "procTaskStartTimeDesc": "2023-01-03",
        "checkCode": "",
        "totalPriceAmount": 0,
        "totalTaxAmount": 0,
        "totalPriceAndTax": 0,
        "untaxAmount": "0",
        "supplierName": "",
        "supplierAddress": "",
        "supplierTaxNumber": "12321231231",
        "invoiceType": "OTHER",
        "invoiceTypeDesc": "其他",
        "invoiceStateCode": "A",
        "cancellationMarkUpdateTime": 1672739570726,
        "supplierUnusual": "BLACK",
        "supplierUnusualUpdateTime": 1672739570726,
        "invoiceUpdateAt": "2023-01-03",
        "attachmentFiles": [
          {
            "code": "ATT1807051YCYYUBK",
            "resourceKey": "OSS1807051OM923NK/6c89c484-3da8-4f00-9184-258668ac696c.png",
            "mimeType": "image/png",
            "originalUrl": "https://dd-uat.oss-cn-hangzhou.aliyuncs.com/OSS1807051OM923NK/6c89c484-3da8-4f00-9184-258668ac696c.png?Expires=1594276388&OSSAccessKeyId=LTAIW3TdsFRisDtO&Signature=FI4lQ8soBEmw3L6nsf%2FOUrjdS00%3D&x-oss-process=image%2Fauto-orient%2C1",
            "thumUrl": "https://dd-uat.oss-cn-hangzhou.aliyuncs.com/OSS1807051OM923NK/6c89c484-3da8-4f00-9184-258668ac696c.png?Expires=1594276388&OSSAccessKeyId=LTAIW3TdsFRisDtO&Signature=dcUuR6JHu%2BUe6V5VXHOteZ%2FWkHU%3D&x-oss-process=image%2Fresize%2Cm_fixed%2Cw_100%2Ch_100",
            "filename": "屏幕快照 2018-05-21 下午2.35.51.png",
            "type": "image/png",
            "imageUrl": "https://dd-uat.oss-cn-hangzhou.aliyuncs.com/OSS1807051OM923NK/6c89c484-3da8-4f00-9184-258668ac696c.png?Expires=1594276388&OSSAccessKeyId=LTAIW3TdsFRisDtO&Signature=FI4lQ8soBEmw3L6nsf%2FOUrjdS00%3D&x-oss-process=image%2Fauto-orient%2C1",
            "size": 200483,
            "isQrCodePic": false,
            "withHandSignUrl": null,
            "qrCodePic": false
          }
        ],
        "validateStatus": "NOT_VALIDATION",
        "validateStatusDesc": "未验真",
        "ticketData": null,
        "approvedTaxAmount": {
          "amount": 0,
          "currency": "CNY",
          "amountStr": "￥0.00"
        },
        "approvedDeductionAmount": {
          "amount": 0,
          "currency": "CNY",
          "amountStr": "￥0.00"
        },
        "taxRate": 0,
        "buyerAddressPhone": null,
        "buyerAccount": "宁波银行杭州分行营业部71010122001844352",
        "supplierAccount": null,
        "source": null,
        "sourceDesc": null,
        "companySeal": null,
        "invoiceTaxDtoList": [
          {
            "taxableDetails": "*运输服务*地铁票",
            "taxRate": 0.09000,
            "approvedDeductionAmount": {
              "amount": 0.25,
              "currency": "CNY",
              "customExchangeRate": 1,
              "amountStr": "￥0.25"
            },
            "approvedTaxAmount": {
              "amount": 0.25,
              "currency": "CNY",
              "customExchangeRate": 1,
              "amountStr": "￥0.25"
            },
            "transferOut": false,
            "freeTax": false
          }
        ],
        "invoiceRemark": null,
        "lineItems": null,
        "departmentBizCode": "DI220",
        "departmentName": "部门",
        "signStatus": "NOT_STARTED"
      }
    ],
    "hasNextPage": false
  },
  "success": true
}

修改记录

2023-02-08  新增发票台账查询文档
2026-02-03  返参新增发票币种
2025-06-23  返参新增 untaxAmount（申报未税金额）
2026-08-06  DB-60885 补充按发票修改时间增量查询的条件、边界和同步建议