7、全量发票查询 - 发票云(标准版)API文档

请求参数

Query 参数

access_token

string

必需

发票云租户授权token

示例值:

发票云租户授权token

reqid

string

必需

链路id，用于跟踪排查问题，建议不少于13位

示例值:

链路id，用于跟踪排查问题，建议不少于13位

taxNo

string

授权对应的企业税号

必需

示例值:

授权对应的企业税号

name

string

可选

数电模式：可不传，也可指定长链接name，请求将由与name对应的客户端向税局发送请求；税盘模式，使用客户端生成的长链接name即可

示例值:

数电模式：可不传，也可指定长链接name，请求将由与name对应的客户端向税局发送请求；税盘模式，使用客户端生成的长链接name即可

Body 参数application/json

account

string

可选

电子税局账号，选填，不传则使用配置的默认电子税局账号

request_path

string

必需

/fpdk/queryFullInvoices

taxNo

string

企业税号

必需

searchOpt

object

必需

dataType

number

1、进项，2销项

必需

qdInvoiceNo

string

全电发票号码

可选

invoiceCode

string

发票代码

可选

invoiceNo

string

发票号码

可选

invoiceStatus

string

可选

发票状态，默认全部状态

invoiceType

number

必需

发票类型 1、普通电子发票, 2、电子发票专票, 3、普通纸质发票, 4、专用纸质发票, 5、普通纸质卷票发票、12机动车发票，13、二手车销售统一发票、15通行费发票、26、数电票-普通发票、27、数电票-增值税专用发票

startTime

string

开票开始日期

必需

endTime

string

必需

开票结束日期，时间范围不能超过31天

pageNo

number

可选

页码，默认不传时返回全部

pageSize

number

可选

分页数量，默认500

示例

{
  "account": "string",
  "request_path": "string",
  "taxNo": "string",
  "searchOpt": {
    "dataType": 0,
    "qdInvoiceNo": "string",
    "invoiceCode": "string",
    "invoiceNo": "string",
    "invoiceStatus": "string",
    "invoiceType": 0,
    "startTime": "string",
    "endTime": "string",
    "pageNo": 0,
    "pageSize": 0
  }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api-dev.piaozone.com/test/?access_token=发票云租户授权token&reqid=链路id，用于跟踪排查问题，建议不少于13位&taxNo=授权对应的企业税号' \
--header 'Content-Type: application/json' \
--data-raw '{
    "account": "string",
    "request_path": "string",
    "taxNo": "string",
    "searchOpt": {
        "dataType": 0,
        "qdInvoiceNo": "string",
        "invoiceCode": "string",
        "invoiceNo": "string",
        "invoiceStatus": "string",
        "invoiceType": 0,
        "startTime": "string",
        "endTime": "string",
        "pageNo": 0,
        "pageSize": 0
    }
}'

返回响应

🟢200成功

application/json

Body

traceId

string

必需

traceId用于排查异常

errcode

string

错误码

必需

pageNo

number

可选

页码，查询参数有pageNo时返回

pageSize

number

可选

分页数量，查询参数有pageNo时返回

totalElement

number

可选

合计，查询参数有pageNo时返回

data

array [object {27}]

必需

invoiceSource

string

发票来源

可选

invoiceRiskLevel

string

发票风险等级

可选

invoiceType

number

发票类型

可选

invoiceCode

string

发票代码

可选

etaxInvoiceNo

string

纸质数电票号码

可选

invoiceNo

string

发票号码

可选

invoiceDate

string

开票日期

可选

invoiceStatus

string

发票状态

可选

salerTaxNo

string

销方税号

可选

salerName

string

销方名称

可选

buyerTaxNo

string

购方税号

可选

buyerName

string

购方名称

可选

invoiceAmount

string

不含税金额

可选

totalTaxAmount

string

总税额

可选

totalAmount

string

总金额

可选

checkCode

string

可选

校验码，暂时返回为空字符串

salerAddressPhone

string

暂时返回为空字符串

可选

salerAccount

string

暂时返回为空字符串

可选

buyerAddressPhone

string

暂时返回为空字符串

可选

buyerAccount

string

暂时返回为空字符串

可选

password

string

暂时返回为空字符串

可选

remark

string

暂时返回为空字符串

可选

machineNo

string

暂时返回为空字符串

可选

drawer

string

暂时返回为空字符串

可选

payee

string

暂时返回为空字符串

可选

reviewer

string

暂时返回为空字符串

可选

items

array [object {10}]

发票明细

可选

tongjiInfo

object

统计信息

必需

totalAmount

string

总金额

必需

totalTaxAmount

string

总税额

必需

invoiceAmount

string

总不含税金额

必需

invoiceNum

number

总份数

必需

示例

{
  "traceId": "string",
  "errcode": "string",
  "pageNo": 0,
  "pageSize": 0,
  "totalElement": 0,
  "data": [
    {
      "invoiceSource": "string",
      "invoiceRiskLevel": "string",
      "invoiceType": 0,
      "invoiceCode": "string",
      "etaxInvoiceNo": "string",
      "invoiceNo": "string",
      "invoiceDate": "string",
      "invoiceStatus": "string",
      "salerTaxNo": "string",
      "salerName": "string",
      "buyerTaxNo": "string",
      "buyerName": "string",
      "invoiceAmount": "string",
      "totalTaxAmount": "string",
      "totalAmount": "string",
      "checkCode": "string",
      "salerAddressPhone": "string",
      "salerAccount": "string",
      "buyerAddressPhone": "string",
      "buyerAccount": "string",
      "password": "string",
      "remark": "string",
      "machineNo": "string",
      "drawer": "string",
      "payee": "string",
      "reviewer": "string",
      "items": [
        {
          "goodsCode": "string",
          "goodsName": "string",
          "specModel": "string",
          "unit": "string",
          "num": "string",
          "unitPrice": "string",
          "detailAmount": "string",
          "taxRate": "string",
          "taxAmount": "string",
          "specificBusType": "string"
        }
      ]
    }
  ],
  "tongjiInfo": {
    "totalAmount": "string",
    "totalTaxAmount": "string",
    "invoiceAmount": "string",
    "invoiceNum": 0
  }
}