Appearance
当期申报表下载 S009
申报完成之后,获取税局下载的报表,如需获取往期申报表需要使用“申报结果查询、报表下载”接口,该接口仅可以下载当月申报的申报表。
请求参数
appKey | 客户唯一标识 | 用户申请,后台自动分配 | string(32) | 必填 | 无 |
jsonData | 请求参数 | 参数请求体 | json | 必填 | 无 |
serviceId | 服务ID | 选择对应的接口服务,参考接口列表 | string | 必填 | 无 |
nsrsbh | 纳税人识别号 | 请求参数,位置在jsonData里面 | string | 必填 | 无 |
sbzlbh | 申报种类编码 | 请求参数,位置在jsonData里面,具体值参考码表 | string | 必填 | 无 |
nsqxdm | 纳税期限代码 | 请求参数,位置在jsonData里面,01:按次、02:月度、03:季度、04:年度、05:半年度 | string | 必填 | 无 |
skssqq | 所属期起 | 请求参数,位置在jsonData里面,格式yyyy-MM-dd | string | 必填 | 无 |
skssqz | 所属期止 | 请求参数,位置在jsonData里面,格式yyyy-MM-dd | string | 必填 | 无 |
wybh | 唯一编号 | 请求参数,位置在jsonData里面,按次以及部分税种需要,存在校验 | string | 必填 | 无 |
kqybs | 跨区域办税 | 当该条任务是需要进行跨区域办税时,传该节点及节点下如下字段: ①"kqybslx":"跨区域办税类型",//1-根据报验项目选择;2-根据税源登记选择;其他值-无需跨区域办税 ②"zgswjg":"",//主管税务机关(必填) ③"scjydz":"",//生产经营地址(跨区域办税-税源登记选择时,必填) ④"byglbh":""//跨区域涉税事项报验管理编号(跨区域办税-报验项目选择时,必填) | string | 条件必填 | 无 |
kqybslx | 跨区域办税类型 | 进行跨区域办税时必填:1-根据报验项目选择;2-根据税源登记选择;其他值-无需跨区域办税 | string | 条件必填 | 无 |
zgswjg | 主管税务机关 | 主管税务机关:该字段用于房产税、城镇土地使用税分不同主管税务机关申报的情况时填写,维护后申报时系统将切换维护的主管税务机关进行申报。 | string | 条件必填 | 无 |
scjydz | 生产经营地址 | 进行跨区域办税-税源登记选择时,必填 | string | 条件必填 | 无 |
byglbh | 跨区域涉税事项报验管理编号 | 选择跨区域办税-报验项目选择时,该字段必填 | string | 条件必填 | 无 |
tdztbs | 特定主体办税 | 当该条任务是需要进行特定主体办税办税时,传该节点及节点下如下字段: ①"tdztlx":"特定主体类型",//特定主体登录时必填(1:跨区域报验户,2:跨区税源登记纳税人,3:社保非税专用户,传空:非特定主体办税) ②"tdztdq":"特定主体地区"(必传), ③"tdztzh":"特定主体账号"(必传), ④"tdztmm":"特定主体密码"(必传) | string | 条件必填 | 无 |
tdztlx | 特定主体类型 | 特定主体登录时必填(1:跨区域报验户,2:跨区税源登记纳税人,3:社保非税专用户,传空:非特定主体办税) | string | 条件必填 | 无 |
tdztdq | 特定主体地区 | 进行特定主体登录申报时,必传,参考【地区编码】码表 | string | 条件必填 | 无 |
tdztzh | 特定主体登录账号 | 选择特定主体登录时必传,用于登录 | string | 条件必填 | 无 |
tdztmm | 特定主体登录密码 | 进行特定主体登录的密码,进行特定主体登录申报时必填 | string | 条件必填 |
响应参数
status | 状态编码:200表示正常 | 无 | string | 必定返回 | |
---|---|---|---|---|---|
code | 业务编码:T0000表示成功,其他编码均为异常编码 | 无 | string | 必定返回 | |
msg | 消息描述 | 无 | string | 必定返回 | |
stackTrace | 错误堆栈信息 | 无 | string | 必定返回 | |
data | 返回对象 | 无 | string | 必定返回 |
请求示例
{
"appKey": "16e7c0b041054649a0526107c701451c",
"serviceId": "S009",
"jsonData": {
"nsqxdm": "02",
"nsrsbh": "税号",
"sbzlbh": "申报种类编码,如10101",
"skssqq": "所属期起,2019-10-01",
"skssqz": "所属期止,2019-10-31",
"wybh": "部分税种需要",
"kqybs": {
"kqybslx": "2",
"zgswjg": "国家税务总局上海市普陀区税务局第十五税务所",
"scjydz": "上海市普陀区河西路026号",
"byglbh": "582196247841"
},
"tdztbs": {
"tdztlx": "跨区域办税类型,如:2",
"tdztdq": "特定主体地区,如:31",
"tdztzh": "特定主体登录账号,如:18865500145",
"tdztmm": "特定主体登录密码,如:admin123"
}
}
}
响应示例
{
"status": 200,
"code": "T0000",
"msg": null,
"stackTrace": null,
"data": {}
}
注意事项
响应编码T0000表示成功,此时记录变更为报表下载获取中,使用查询接口S004获取后续的结果状态; "statusCode": "T0"(处理中);"T1"(处理成功);"T2"(处理失败)。 下面是当报表下载获取成功时候,使用S004接口获取结果的样例: { "status": 200, "code": "T0000", "msg": null, "stackTrace": null, "data": { "statusMsg": "报表下载获取成功", "statusCode": "T1", "bbxzFileName":"当状态为【报表下载获取成功】时才会返回的字段,文件名称", "bbxzFileType":"当状态为【报表下载获取成功】时才会返回的字段,文件类型", "bbxzContent":"当状态为【报表下载获取成功】时才会返回的字段,对应文件的内容,Base64字符串" } }