发票台账查询V2接口

说明

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

注意事项

• 每次最多只能查询100条数据；
• 如果发票状态码为空，请传"" ，而不是null；
• 当入参中同时包含 taskEndDateStart 与 taskEndDateEnd 两个字段，且它们所指定的时间范围在90天以内，formCode字段非必填；

接口地址

/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
}

响应参数

响应参数说明

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,
        "supplierName": "",
        "supplierAddress": "",
        "supplierTaxNumber": "12321231231",
        "invoiceType": "OTHER",
        "invoiceTypeDesc": "其他",
        "invoiceStateCode": "A",
        "cancellationMarkUpdateTime": 1672739570726,
        "supplierUnusual": "BLACK",
        "supplierUnusualUpdateTime": 1672739570726,
        "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
      }
    ],
    "hasNextPage": false
  },
  "success": true
}

修改记录

2023-02-08  新增发票台账查询文档