数据服务
  1. 发票数据查询
数据服务
  • 接口鉴权(AK/SK 请求头校验)
  • 基本介绍
  • 订单管理
    • 查询数据采集订单接口
      POST
  • 采集数据查询
    • 企业信息
      • 查询企业基础信息数据
    • 发票数据查询
      • 查询发票数据接口
        POST
    • 申报表数据查询
      • 查询财务报表数据接口
      • 查询增值税数据接口
      • 查询企业所得税数据接口
  1. 发票数据查询

查询发票数据接口

正式环境
https://gateway.bigfintax.com/szyh-data-service
正式环境
https://gateway.bigfintax.com/szyh-data-service
POST
https://gateway.bigfintax.com/szyh-data-service
/api/v1/openapi/data/invoice/page

接口描述#

用于获取已采集的发票相关数据,如发票号码、开票日期、金额、税额、发票类型等详细信息,满足用户对发票数据的查询需求。

业务规则#

调用限制#

查询请求时,若采集任务未完成,将驳回请求,请您稍后再试。

数据排列#

返回的数据将按照“开票时间”正序排列,因采集任务不能采集当日开票数据,不存在“在查询请求期间发生数据更新”的情况。

请求参数

Header 参数
X-App-Key
string 
必需
X-App-Secret-Key
string 
必需
X-Tenant-Id
string 
可选
Body 参数application/json
platformNo
string 
平台编号
可选
orderNo
string 
订单序列号
必需
orgTaxNum
string 
税号
必需
collectionInvoiceType
string 
必需
发票类型
采集发票类型 INPUT 进项发票 OUTPUT 销项发票
startTime
string 
开始时间
可选
正则匹配:
^\d{4}-\d{2}-\d{2}$
endTime
string 
结束时间
可选
正则匹配:
^\d{4}-\d{2}-\d{2}$
pageNum
integer 
页码,默认1
可选
默认值:
1
pageSize
integer 
可选
页面大小,默认100
默认值:
100
示例
{
    "platformNo": "string",
    "orderNo": "string",
    "orgTaxNum": "string",
    "collectionInvoiceType": "string",
    "startTime": "string",
    "endTime": "string",
    "pageNum": 1,
    "pageSize": 100
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://gateway.bigfintax.com/szyh-data-service/api/v1/openapi/data/invoice/page' \
--header 'X-App-Key;' \
--header 'X-App-Secret-Key;' \
--header 'X-Tenant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "platformNo": "string",
    "orderNo": "string",
    "orgTaxNum": "string",
    "collectionInvoiceType": "string",
    "startTime": "string",
    "endTime": "string",
    "pageNum": 1,
    "pageSize": 100
}'

返回响应

🟢200成功
application/json
Body
success
boolean 
成功失败标识
可选
code
integer 
状态码
可选
data
object (OrderInvoiceOpenResp) 
接口返回对象
可选
data
array[object (AuthOrderInvoiceOpenResp) {27}] 
结果
可选
pageNum
integer 
页码,默认1
可选
默认值:
1
pageSize
integer 
可选
页面大小,默认500
默认值:
500
total
integer <int64>
总数
可选
pages
integer 
总页数
可选
errorMessage
string 
服务失败信息
可选
示例
{
  "success": false,
  "code": 0,
  "data": {
    "data": [
      {
        "taxNum": "",
        "invoiceType": "",
        "invoiceKind": "",
        "invoiceCode": "",
        "invoiceNo": "",
        "eInvoiceNo": "",
        "dateIssued": "",
        "invoiceStatus": "",
        "sellerTaxationNo": "",
        "sellerTaxationName": "",
        "buyerTaxationNo": "",
        "buyerTaxationName": "",
        "amount": "",
        "tax": "",
        "taxAmountTotal": "",
        "verifyCode": "",
        "sellerInfo": "",
        "sellerBankAccount": "",
        "buyerInfo": "",
        "buyerBankAccount": "",
        "password": "",
        "remark": "",
        "machineCode": "",
        "drawer": "",
        "payee": "",
        "reviewer": "",
        "detailList": [
          {
            "taxClassCode": "",
            "project": "",
            "specification": "",
            "unit": "",
            "quantity": "",
            "unitPrice": "",
            "amount": "",
            "taxRate": "",
            "tax": ""
          }
        ]
      }
    ],
    "pageNum": 0,
    "pageSize": 0,
    "total": 0,
    "pages": 0
  },
  "errorMessage": ""
}
修改于 2025-06-16 03:02:08
上一页
查询企业基础信息数据
下一页
查询财务报表数据接口
Built with