上传各税种申报表数据

POST

/v2/tax/qys/writeTaxData

接口描述

上传各税种整表数据（每次只能上传一个税种），需要整表数据。例如一般人增值税主表需要包含本年累计列。

错误码

错误代码	错误信息	解决方案
PARAMETER_ERROR	企业Id(aggOrgId)不能为空!
PARAMETER_ERROR	请求参数不能为空!
BUSINESS_ERROR	任务不支持待上线
PARAMETERCheck	请求参数year或period不能为空！
PARAMETERCheck	请求参数year或period不能为零！
PARAMETER_ERROR	请求参数duration不能小于30
PARAMETERCheck	请求参数isDirectDeclare=true和exAction=1参数非法！
PARAMETERCheck	上传报文，参数校验失败，请检查！
PARAMETERCheck	上传报文，校验异常，请联系管理员！
PARAMETERCheck	上传报文，业务校验失败，请检查！
PARAMETERCheck	参数格式不合法,不是有效的json格式!
INTERFACE_ERROR	接口异常,请联系管理员
INTERFACE_ERROR	系统繁忙，请降低调用频率！
BUSINESS_ERROR	预约扣款情况，预约扣款日期必填并且是yyyy-MM-dd格式，当前错误值：XXX

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

access_token

string

必需

通过调用access_token接口返回的access_token值

示例值:

req_date

string

必需

当前时间转为的毫秒数

示例值:

req_sign

string

签名算法得到的签名

必需

示例值:

Body 参数application/json

year

integer

年

必需

period

integer

月

必需

aggOrgId

integer

企业id

必需

isDirectDeclare

boolean | null

是否上传后直接申报

可选

默认false

usePresetDialog

boolean

使用预置弹窗信息

必需

true=使用 flase = 不使用（以当期上传弹窗为准，未上传则认定为未预置）默认true

bsswjg

string | null

税务机关名称 (只针对房产税，城镇土地使用税)

可选

exAction

integer | null

发起税局暂存任务

可选

0 上传不发起税局暂存任务；1 上传发起税局暂存任务

allowRepeatDeclare

boolean | null

是否允许重复申报

可选

true 表示不校验清册申报状态，即使清册已申报，允许重复发起申报；
false 表示校验清册申报状态，如果清册状态显示已申报，则不允许重复申报

waitResult

boolean

是否等待结果

必需

（仅针对浙江、云南、海南地区）

kkfs

integer

扣款方式

可选

1：手动扣款，2：预约扣款。仅浙江、海南、云南需要，其它地区忽略该字段

yykkrq

string

预约扣款日期

可选

yyyy-MM-dd格式，如2023-12-13，仅当扣款方式(kkfs)为2时必传

jrwc

string

是否兼容一分钱尾差

可选

Y兼容，N不兼容。默认不兼容。

ybData

object | null

一般纳税人增值税及附加税报文

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

xgmData

object | null

小规模增值税及附加税报文

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

sdsaData

object | null

企业所得税类预缴报文

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

whsyjsfData

object | null

文化事业建设费报文

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

yhsData

object | null

印花税新版报文

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

ghjfData

object | null

通用申报（工会经费和水利建设基金,垃圾处理费联动申报报文）

可选

JSON格式，按照税局要求宁夏、内蒙古、陕西、湖南四个地区的垃圾处理费合并在通用申报一起申报。报文结构参考申报附录中的报文结构相应报文

fssrTysbData

object | null

非税收入通用申报表（垃圾处理费独立申报报文）

可选

JSON格式，按照税局要求除宁夏、内蒙古、陕西、湖南以外地区的垃圾处理费需分开申报，新增非税收入通用申报表代替此申报表。报文结构参考申报附录中的报文结构相应报文

xfsData

object | null

消费税报文

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

hbsData

object | null

环境保护税报文

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

fcsData

object | null

房产税报文

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

cztdsData

object | null

城镇土地使用税报文

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

zysData

object | null

资源税税报文

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

szyData

object | null

水资源报文

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

cbjData

object | null

残疾人就业保障金

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

ccsData

object | null

车船税

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

clgzsData

object | null

车辆购置税

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

qsData

object | null

契税

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

hsqjData

object | null

汇算清缴

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

glywData

string | null

企业年度关联业务往来报告表

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

ccxwshbData

string | null

财产行为税合并纳税申报（房土）

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

cbnbData

string

财务报表年报文件上传

可选

JSON格式，报文结构参考申报附录中的报文结构相应报文

sdsDkdjData

string

企业所得税(代扣代缴)

必需

JSON格式，报文结构参考申报附录中的报文结构相应报文

zzsDkdjData

string

代扣代缴、代收代缴税款报告表

必需

JSON格式，报文结构参考申报附录中的报文结构相应报文

optionCodeList

array [object {4}] | null

多条弹窗设置明细

可选

optionCode

string | null

选项code

可选

memoJson

string | null

备注信息

可选

fileCode

string | null

文件编码

可选

base64加密后的串，非必传。只有optionCode为强制申报使用

fileName

string | null

文件名称

可选

示例

{
    "orgId": 452681066557440,
    "isDirectDeclare": true,
    "period": 3,
    "year": 2023,
    "ybData": object
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://prod-cn.your-api-server.com/v2/tax/qys/writeTaxData' \
--header 'access_token: {{access_token}}' \
--header 'access_token;' \
--header 'req_date: {{req_date}}' \
--header 'req_date;' \
--header 'req_sign: {{req_sign}}' \
--header 'req_sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "orgId": 452681066557440,
    "isDirectDeclare": true,
    "period": 3,
    "year": 2023,
    "ybData": object
}'

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位

code

string | null

错误码

必需

错误码

success

boolean

是否成功标记

必需

接口是否成功（是否发生业务异常）

message

string | null

错误信息

必需

data

object

可选

message

string

提示信息

必需

上传成功，并发起申报！isDirectDeclare是true时

aggOrgId

string

企业id

必需

taskId

string

申报任务id

必需

isDirectDeclare是true时，申报任务id，可以通过查询任务状态接口来查询任务执行的情况

isDeclared

boolean

是否申报

必需

是否上传后直接申报标志

checkMessage

string

参数校验失败信息

必需

示例

企业不存在不支持示例参数或业务校验失败上传并发起申报

{
    "reqId": "662dd4a0e01d41daac21ef5c7da69402",
    "code": "PARAMETER_ERROR",
    "success": true,
    "message": "没有找到对应的企业！",
    "data": null
}

修改于 2024-09-07 08:29:45

简介

上传各税种申报表EXCEL数据

上传各税种申报表数据

接口描述#

错误码#

请求参数

示例代码

返回响应

接口描述

错误码