上传各税种申报表EXCEL数据

接口描述

上传各税种整表的EXCEL数据（每次只能上传一个税种），需要整表数据。目前只支持增值税一般人Excel。

错误码

错误代码	错误信息	解决方案
PARAMETER_ERROR	请求参数不能为空!
PARAMETER_ERROR	企业Id(aggOrgId)不能为空!
PARAMETER_ERROR	请求参数zsxmList不能为空！
PARAMETER_ERROR	请求参数year或period不能为空！
BUSINESS_ERROR	增值税主表错误，请检查数据！	确认主表sheet页存在且名称“主表”
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

aggOrgId

integer

企业Id

必需

year

integer

税款所属期年

必需

period

integer

税款所属期月

必需

自然月；例如：10月份申报增值税2021-09-01到2021-09-30，period传10

kkfs

integer

扣款方式

可选

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

yykkrq

string

预约扣款日期

可选

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

jrwc

string

是否兼容一分钱尾差

可选

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

usePresetDialog

boolean

使用预置弹窗信息

必需

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

bsswjg

string

税务机关名称

可选

(只针对房产税，城镇土地使用税)

zsxmList

array [object {10}]

征收项目列表

必需

yzpzzlDm

string

应征凭证种类代码

必需

参考申报附录：yzpzzlDm应征凭证种类代码

ssqQ

string

所属期起

必需

格式yyyy-MM-dd

ssqZ

string

所属期止

必需

格式yyyy-MM-dd

zspmDm

string

征收品目代码

可选

文化事业建设费时必传字段，用来区分文化业还是娱乐业，302170100娱乐业文化事业建设费、302170200广告业文化事业建设费。（税报）

zlbsxlDm

string

资料报送小类代码

可选

财报必须传,ZL1001001:一般企业会计准则、ZL1001003:小企业会计准则

templateCode

string

资料报送子类代码

可选

【一般企业会计准则】类型时必填，1:适用未执行新金融准则、新收入准则和新租赁准则的一般企业、2:适用已执行新金融准则、新收入准则和新租赁准则的一般企业；其他准则传0

attachEncode

string

税表excelbase64加密后的串，必传

必需

attachName

string

税表excel文件名称必传

必需

isDirectDeclare

boolean

是否上传后直接申报

必需

默认false

gzDeclare

integer

财报覆盖申报

必需

1表示覆盖申报；0表示不覆盖。默认及空为0；当isDirectDeclare为true 时生效。此参数针对税局财报已申报，是否继续覆盖申报，仅北京、广东地区支持，其余地区陆续上线中

optionCodeList

array [object {4}]

多条弹窗设置明细

可选

optionCode

string

选项code

可选

memoJson

string

备注信息

可选

fileCode

string

文件编码

必需

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

fileName

string

文件名称

必需

示例

{
  "aggOrgId": 276924188282944,
  "year": 2023,
  "period": 4,
  "kkfs": 2,
  "yykkrq": "2023-12-13",
  "zsxmList": [
    {
      "yzpzzlDm": "BDA0610606",
      "ssqQ": "2023-02-01",
      "ssqZ": "2023-02-28",
      "zspmDm": "",
      "zlbsxlDm": "",
      "templateCode": "",
      "attachEncode": "aa",
      "attachName": "增值税申报表.xlsx"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

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

code

string | null

错误码

必需

错误码

success

boolean

是否成功标记

必需

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

message

string | null

错误信息

必需

data

object

数据

可选

message

string

提示信息

必需

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

aggOrgId

integer

企业Id

必需

taskId

string

申报任务id

必需

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

isDeclared

boolean

是否申报

必需

是否上传后直接申报标志

checkMessage

string

参数校验失败信息

必需

示例

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

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

接口描述#

错误码#

请求参数

示例代码

返回响应

接口描述

错误码