查询增值税数据接口

接口描述

可获取企业增值税申报表的相关数据，包括销售额、销项税额、进项税额、应纳税额等关键信息，助力税务申报与管理。

业务规则

调用限制

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

数据排列

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

请求参数

Header 参数

X-App-Key

统一验签-AK

必需

X-App-Secret-Key

统一验签-SK

必需

X-Tenant-Id

租户ID

可选

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

返回响应

🟢200成功

application/json

Body

success

boolean

成功失败标识

可选

code

integer

状态码

可选

data

object

接口返回对象

可选

orderNo

string

订单号

可选

orgName

string

公司名称

可选

orgTaxNum

string

公司税号

可选

taxPeriodStart

string

税款所属期起

可选

taxPeriodEnd

string

税款所属期止

可选

data

array [object {6}]

结果

可选

errorMessage

string

服务失败信息

可选

示例

{
    "code": 200,
    "data": {
        "orderNo": "DSS174**********0859", //订单号
        "orgName": "嘉兴闹********有限公司", //公司名称
        "orgTaxNum": "91330*************2J5E", //公司税号
        "taxPeriodEnd": "2024-12-31", //税款所属期起
        "taxPeriodStart": "2023-01-01", //税款所属期止
        "data": [
            {
                "declareDate": "2023-02-03", //申报日期
                "taxCode": "010100", //税种编号
                "taxName": "增值税一般纳税人", //税种名称
                "taxPeriodEnd": "2023-01-31", //税款所属期止
                "taxPeriodStart": "2023-01-01" //税款所属期起
                "form": {
                    "vatXGMForm": null, //增值税小规模纳税人
                    "vatYBForm": //增值税一般纳税人
                    {
                        "vatGeneralTaxpayerReturnMainForm": //增值税一般纳税人主表
                        {
                            "mainContent": //主表主要内容
                            [
                                {
                                    "jzjtxmBnlj": null, //即征即退项目本年累计
                                    "jzjtxmBys": "0.00", //即征即退项目本月数
                                    "projectName": "上期留抵税额", //项目名称
                                    "projectType": "税款计算", //项目类型
                                    "ybxmBnlj": "0.00", //一般项目本年累计
                                    "ybxmBys": "1258886.30" //一般项目本月数
                                }
                            ]
                        }
                    }
                }
            },
            {
                "declareDate": "2024-04-16", //申报日期
                "taxCode": "010200", //税种编号
                "taxName": "增值税小规模纳税人",
                "taxPeriodEnd": "2024-03-31", //税款所属期止
                "taxPeriodStart": "2024-01-01" //税款所属期起
                "form": {
                    "vatXGMForm": //增值税小规模纳税人
                    {
                        "vatSmallScaleTaxpayerReturnMainForm": //增值税小规模纳税人主表
                        {
                            "mainContent": //主表主要内容
                            [
                                {
                                    "bnljFwbdchwxzc": "207636.96", //本年累计-服务、不动产和无形资产
                                    "bnljHwjlw": "0.00", //本年累计-货物及劳务
                                    "bqsFwbdchwxzc": "207636.96", //本期数-服务、不动产和无形资产
                                    "bqsHwjlw": "0.00", //本期数-货物及劳务
                                    "projectName": "其他增值税发票不含税销售额", //项目名称
                                    "projectType": "一、计税依据" //项目类型
                                }
                            ]
                        }
                    },
                    "vatYBForm": null //增值税一般纳税人
                }
            }
        ]
    },
    "errorMessage": null,
    "success": true
}

查询增值税数据接口

接口描述#

业务规则#

调用限制#

数据排列#

请求参数

示例代码

返回响应

接口描述

业务规则

调用限制

数据排列