上传各税种申报表EXCEL数据
接口描述
上传各税种整表的 EXCEL 数据（每次只能上传一个税种），需要整表数据。
目前支持以下 EXCEL 上传：
| 模板代码（yzpzzlDm） | 申报表类型 |
|---|---|
| BDA0610606 | 增值税及附加税(适用于一般纳税人) |
| BDA0610611 | 增值税及附加税(适用于小规模纳税人) |
| BDA0000000 | 财产行为税合并纳税申报（房土） |
| BDA0610005 | 车船税 |
| BDA0610036 | 资源税 |
| BDA0610100 | 通用申报 |
| BDA0610334 | 文化事业建设费 |
| BDA0610334HB | 文化使用建设费合并申报 |
| BDA0610794 | 印花税 |
| BDA0610980 | 环境保护税纳税申报表 |
| BDA0610987 | 水资源税 |
| BDA0611054 | 非税收入通用申报表 |
| BDA0611111 | 消费税及附加税费申报表 |
| BDA0611159 | 企业所得税A类 |
| BDA0610790SYCJ | 城镇土地使用税税源采集 |
| BDA0610791SYCJ | 房产税税源采集 |
| CWBBSB | 财务报表申报（月季报）：小企业、企业会计准则未执行/已执行、企业会计制度、金融类企业会计准则已执行 |
| CWBBNDSB | 财务报表年度申报（年报）：小企业、企业会计准则未执行/已执行、企业会计制度、金融类企业会计准则已执行 |
| BDA0610865 | 增值税预缴 |
| BDA0610857 | 残保金 |
| ZDSY | 重点税源 |
| BDA0610791 | 房产税 |
| BDA0610790 | 城镇土地使用税 |
请求地址
Header 参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
Timestamp | String | 必选 | 公共参数。 |
SecretId | String | 必选 | 公共参数。 |
Signature | String | 必选 | 公共参数。 |
Algorithm | String | 可选 | 公共参数。 |
Content-Type | String | 必选 | 取值：application/json |
Body 请求参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
aggOrgId | String | 必选 | 企业Id |
accountId | String | 可选 | 账号ID，多账号场景使用 |
tdztswjgmc | String | 可选 | 特定主体税务机关名称 |
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不兼容。默认不兼容 |
zdsysfsh | String | 可选 | 重点税源是否审核，1=审核，不传或者传空则是申报 |
usePresetDialog | Boolean | 必选 | 使用预置弹窗信息，true=使用，false=不使用（以当期上传弹窗为准，未上传则认定为未预置）默认true |
bsswjg | String | 可选 | 税务机关名称跨区域上传省市区(只针对房产税，城镇土地使用税，环保税)，上传格式 省|市|区 如"湖南省|湘潭市|岳塘区" |
kqyswjgmc | String | 可选 | 跨区域税局机关名称(只针对房产税，城镇土地使用税，环保税)，上传格式如"国家税务总局鞍山高新技术产业开发区税务局税源管理一股"，正确上传值可以以企业信息-跨区域信息节点返回进行参考 |
sfxzyhssm | Boolean | 可选 | 是否新增印花税税目，按期申报税局未认定或者一个税目需要申报多条税源明细需要操作新增税目 (true新增/false不新增) |
disableDeclareCache | String | 可选 | 禁用申报缓存，Y/N 非必传参数，默认为空。Y=不缓存，空/N或者不传这个参数=缓存 |
sfjxbdjy | String | 可选 | 是否进行表单校验，财报专用，Y=是/N=否。非必传字段，请求Y则会对请求的表单节点与税局报表列表进行比对是否一致，税局要求申报的表单未请求则失败返回。默认传空，或者传N则是维持现状只校验必填表单（资产、利润），其他表单不上传默认以税种申报 |
zsxmDm | String | 必选 | 征收项目代码，工会经费=39900/水利建设专项收入=30221，合并申报则可以为空 |
zsxmList | [] | 必选 | 征收项目列表 |
optionCodeList | [] | 可选 | 多条弹窗设置明细 |
征收项目列表 zsxmList
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
yzpzzlDm | String | 必选 | 应征凭证种类代码，取值参见接口描述中支持的申报表列表 |
ssqQ | String | 必选 | 所属期起，格式yyyy-MM-dd |
ssqZ | String | 必选 | 所属期止，格式yyyy-MM-dd |
zspmDm | String | 可选 | 征收品目代码，文化事业建设费时必传字段，用来区分文化业还是娱乐业，302170100娱乐业文化事业建设费、302170200广告业文化事业建设费。（税报） |
zlbsxlDm | String | 可选 | 资料报送小类代码，财报必须传。ZL1001001:一般企业会计准则、ZL1001002:企业会计制度、ZL1001003:小企业会计准则、ZL1001050:企业会计准则金融企业 |
templateCode | String | 可选 | 资料报送子类代码 【一般企业会计准则】类型时必填，1:适用未执行新金融准则、新收入准则和新租赁准则的一般企业、2:适用已执行新金融准则、新收入准则和新租赁准则的一般企业 【企业会计准则金融企业】类型是必填，1:适用已执行新金融工具准则的金融企业（目前仅支持金融类型的这个子类） 其他准则传0 |
attachEncode | String | 必选 | 税表excel base64加密后的串，必传 |
attachName | String | 必选 | 税表excel文件名称，必传 |
isDirectDeclare | Boolean | 必选 | 是否上传后直接申报，默认传true， 目前接口无暂存能力，只支持上传后直接申报 |
gzDeclare | Integer | 必选 | 财报覆盖申报，1表示覆盖申报；0表示不覆盖。默认及空为0；当isDirectDeclare为true时生效 |
多条弹窗设置明细 optionCodeList
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
optionCode | String | 可选 | 选项code |
memoJson | String | 可选 | 备注信息 |
fileCode | String | 必选 | 文件编码，base64加密后的串，非必传。只有optionCode为强制申报使用 |
fileName | String | 必选 | 文件名称 |
返回参数
公共返回结构
data 内容说明
| 参数名称 | 类型 | 说明 |
|---|---|---|
message | String | 提示信息，上传成功，并发起申报！isDirectDeclare是true时返回 |
aggOrgId | String | 企业Id |
taskId | String | 申报任务id，isDirectDeclare是true时返回，可以通过查询任务状态接口来查询任务执行的情况 |
isDeclared | Boolean | 是否申报，是否上传后直接申报标志 |
checkMessage | String/[] | 参数校验失败信息，校验失败时逐项返回失败原因，如：$.fjssbb: 必传不能为空 |
错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
- code：错误码。
- message：错误描述信息，帮助理解和解决发生的错误。
| 错误码 | 描述 |
|---|---|
| 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 |
| PARAMETERCheck | 参数校验失败，请检查。data.checkMessage 返回具体校验失败信息 |