查询财务报表数据接口

正式环境

https://gateway.bigfintax.com/szyh-data-service

POST

/api/v1/openapi/data/taxReturn/financial

接口描述

支持用户查询资产负债表、利润表、现金流量表等各类财务报表数据，以标准化的数据格式呈现，便于用户进行财务分析。

业务规则

调用限制

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

数据排列

返回的数据将按照“申报时间”正序排列，当查询数据时，可能会出现“在查询请求期间发生数据更新（更正申报）”的情况，更新的数据可能会被一同返回，为保证数据完整，可根据totalpage参数判断是否增加查询次数。

请求参数

Header 参数

X-App-Key

string

必需

X-App-Secret-Key

string

必需

X-Tenant-Id

string

可选

Body 参数application/json

orderNo

string

订单号

必需

taxPeriodStart

string

税款所属期起

可选

正则匹配:

^\d{4}-\d{2}-\d{2}$

taxPeriodEnd

string

税款所属期止

可选

正则匹配:

^\d{4}-\d{2}-\d{2}$

示例

{
    "orderNo": "string",
    "taxPeriodStart": "string",
    "taxPeriodEnd": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://gateway.bigfintax.com/szyh-data-service/api/v1/openapi/data/taxReturn/financial' \
--header 'X-App-Key;' \
--header 'X-App-Secret-Key;' \
--header 'X-Tenant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "orderNo": "string",
    "taxPeriodStart": "string",
    "taxPeriodEnd": "string"
}'

返回响应

🟢200成功

application/json

Body

success

boolean

成功失败标识

可选

code

integer

状态码

可选

data

object (FinancialOrderOpenResp)

接口返回对象

可选

orderNo

string

订单号

可选

orgName

string

公司名称

可选

orgTaxNum

string

公司税号

可选

taxPeriodStart

string

税款所属期起

可选

taxPeriodEnd

string

税款所属期止

可选

data

array[object (FinancialOrderOpenForm) {4}]

结果

可选

errorMessage

string

服务失败信息

可选

示例

{
  "success": false,
  "code": 0,
  "data": {
    "data": [
      {
        "taxPeriodStart": "",
        "taxPeriodEnd": "",
        "declareDate": "",
        "detail": {
          "": {}
        }
      }
    ],
    "orderNo": "",
    "orgName": "",
    "orgTaxNum": "",
    "taxPeriodStart": "",
    "taxPeriodEnd": ""
  },
  "errorMessage": ""
}

修改于 2025-06-16 03:02:08

查询发票数据接口

查询增值税数据接口

查询财务报表数据接口

接口描述#

业务规则#

调用限制#

数据排列#

请求参数

示例代码

返回响应

接口描述

业务规则

调用限制

数据排列