电子税局切换登录企业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
}

字段说明

字段 名称 类型 长度 说明
data 数据 varchar 20 详见“责任人身份类型对照表”,及参数使用说明。
step_code 接口后续流程 varchar 20 详见“方法名称与接口后续流程对应关系表”,及使用说明。
Copyright © Shanghai Aisino Co.,Ltd 版权所有 侵权必究该文件修订时间: 2025-12-15 16:09:31

results matching ""

    No results matching ""