电子税局切换登录企业API
API说明:通过此接口,实现切换登陆企业功能,必须在登陆完成之后才能使用本接口。(仅支持部分场景,是否需要调用可事先联系市场或运维人员)。
调用方式:HTTP协议
API编码:jx.taxdigital.tpass.change
调用方法:POST
数据格式:json
请求报文规范
{
"step_name":"方法名称",
"nsrsbh":"纳税人识别号",
"changensrsbh":"变更纳税人识别号",
"pageNo":"页码",
"pageSize":"每页数量",
"zrrlx":"责任人类型",
"dqbm":"地区编码",
"username":"用户名"
}
字段说明
| 数据项 |
数据项名称 |
类型 |
长度 |
必填 |
说明 |
| step_name |
方法名称 |
varchar |
20 |
是 |
详见“方法名称与接口后续流程对应关系表”,及参数使用说明。 |
| nsrsbh |
纳税人识别号 |
varchar |
20 |
是 |
9-20位大写字母或数字 |
| changensrsbh |
变更纳税人识别号 |
varchar |
20 |
否 |
9-20位大写字母或数字 |
| pageNo |
页码 |
varchar |
10 |
否 |
|
| pageSize |
每页数量 |
varchar |
10 |
否 |
|
| zrrlx |
责任人 |
varchar |
2 |
否 |
详见“责任人身份类型对照表”,及参数使用说明。 |
| dqbm |
地区编码 |
varchar |
4 |
否 |
详见“电子税局企业账号登录-地区编码清单” |
| username |
用户名 |
varchar |
50 |
否 |
指定切换企业使用的用户,不传默认使用当前税号最后一次登录成功的用户 |
【地区编码清单】说明:
| 地区 |
编码 |
| 北京 |
1100 |
| 天津 |
1200 |
| 河北 |
1300 |
| 山西 |
1400 |
| 内蒙古 |
1500 |
| 辽宁 |
2100 |
| 大连 |
2102 |
| 吉林 |
2200 |
| 黑龙江 |
2300 |
| 上海 |
3100 |
| 江苏 |
3200 |
| 浙江 |
3300 |
| 宁波 |
3302 |
| 安徽 |
3400 |
| 福建 |
3500 |
| 厦门 |
3502 |
| 江西 |
3600 |
| 山东 |
3700 |
| 青岛 |
3702 |
| 河南 |
4100 |
| 湖北 |
4200 |
| 湖南 |
4300 |
| 广东 |
4400 |
| 深圳 |
4403 |
| 广西 |
4500 |
| 海南 |
4600 |
| 重庆 |
5000 |
| 四川 |
5100 |
| 贵州 |
5200 |
| 云南 |
5300 |
| 西藏 |
5400 |
| 陕西 |
6100 |
| 甘肃 |
6200 |
| 青海 |
6300 |
| 宁夏 |
6400 |
| 新疆 |
6500 |
方法名称与接口后续流程对应关系表
参数使用说明:
1、“step_name”为“get_company”,纳税人识别号、页码、每页数量、地区编码必传,获取返回参数,根据返回参数判断是否有可以切换的企业;
2、 在“get_company”接口返回有其他企业时,可以调用“step_name”为“get_zrrlx”,纳税人识别号、变更纳税人识别号、地区编码必传,获取返回参数,根据返回参数判断可以切换的责任人类型;
3、 在“get_zrrlx”接口返回责任人类型后,可以调用“step_name”为“change_user”,纳税人识别号、变更纳税人识别号、责任人类型、地区编码必传,当“step_code”为“0”时即为登录成功;
参数说明:
| 请求参数step_name |
接口后续流程 |
| get_company |
获取公司名称 |
| get_zrrlx |
获取责任类型 |
| change_user |
选择责任人 |
责任人身份类型对照表
参数说明:
| 身份类型 |
责任人 |
| 法定代表人 |
01 |
| 财务负责人 |
02 |
| 办税员 |
03 |
| 管理员 |
05 |
| 领票员 |
07 |
| 社保经办人 |
08 |
| 开票员 |
09 |
| 销售人员 |
10 |
返回报文规范
get_company 返回:
{
"data": {
"companyList": [
{
"reg_number": "",
"nsrsbh": "",//可以切换的税号
"nsrmc": ""
}
]
}
}
get_zrrlx 返回:
{
"data": {
"companyList": [
{
"nsrsbh": "",
"zrrlx": "03"
}
]
}
}
change_user 返回:
{
"step_code": 0
}
字段说明