智能登录

业务简介

企业需要频繁登录电子税局代为办理纳税申报等涉税业务，以及办税员同时代理多家中小企业纳税申报，需要频繁切换多税务主体。智能登录解决自动登录电子税局，可以通过身份切换功能在多家税务主体之间快捷切换，完成企业纳税申报、进销项发票归集、增值税发票勾选认证等涉税业务的办理，极大的提高了办理效率，降低了企业运营成本。

该接口用于36个地区登录电子税务局网站、电子税局发票云平台；并可以通过身份切换功能在多家税务主体之间快捷切换。

业务说明

通过身份切换完成多家绑定的企业主体的切换办税工作，具体如下：

一个自然人（办税员）名下的企业可以直接切换，包括本地区切换和异地漫游切换；

「税务数字证书+办税员」模式可以去掉对短信验证码的依赖。

税务数字证书登录方案

方案一: [软证书托管] 使用账号密码+数字证书托管，无需手机号验证码，自动登录；软证书托管主要指在客户授权的前提下，由云南百望云帮助客户统一集中代办税务数字证书，办理周期一般需要 30 个工作日左右，办理完成统一罐装至云南百望云云服务器端。申请流程请参考证书申请指引；

方案二: [软证书自持] 使用账号密码+数字证书托管，无需手机号验证码，自动登录；该方案由客户自行或通过三方在总局申请税务数字证书，申请完成将调用税务数字证书的方法提交至云南百望云（通常提供获取token信息相关接口），保证云南百望云可通过接口取得进电子发票服务平台的token信息。

支持地区

云南百望云已支持(28)：重庆、浙江、新疆、四川、上海、陕西、山东、青岛、江西、江苏、湖北、河南、海南、广西、广东、福建、北京、安徽、贵州、河北、内蒙、黑龙江、山西、宁夏、青海、湖南、宁波、吉林

税局不支持(8)：厦门、天津、深圳、大连、辽宁、甘肃、云南、西藏

 注：区域最后更新时间2023-11-10

对接流程

智能登录需先创建企业，创建企业接口登录方式请选择：orgTaxLogin.gdsdlfs=11 创建企业请参考通用账户创建。

{ "dlfs": "string", "aggOrgId": "string", "gryhm": "string", "gryhmm": "string", "sjhm": "string", "cutNsrsbh": "string", "cutSflx": "string", "isBrowser": "string", "isDppt": "string" }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "code": "2000",
    "data": {
        "tpass": {
            "cookie": [
                {
                    "sourceScheme": "Secure",
                    "path": "/",
                    "expires": -1,
                    "sourcePort": 443,
                    "sameParty": false,
                    "session": false,
                    "domain": ".chinatax.gov.cn",
                    "name": "DTL_SESSION_ID",
                    "secure": false,
                    "priority": "Medium",
                    "value": "376e0331-2a91-4300-8a30-0c105e295ad6"
                },
                {
                    "sourceScheme": "Secure",
                    "path": "/",
                    "expires": -1,
                    "sourcePort": 443,
                    "sameParty": false,
                    "session": false,
                    "domain": ".chinatax.gov.cn",
                    "name": "token",
                    "secure": false,
                    "priority": "Medium",
                    "value": "eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6ImM1ZGQzMTRiYzNiZDQ4MGJhNTk1YTQ2YzdkNzg0ZjFjIn0.aNqiA45pyVXHul2Uv4cPDBGF_6pZIVnKXZOuLftLtY56nHRZcMT_P591kctrmlTrB-OWOjObvYb-8jI-4A1GEA"
                }
            ],
            "localStorage": {
                "naturepublicKey": "04BF90B63FA86C4FD7EEA94E635F02FBF1888134B214D871B4D6FE6805CB7D36EAF99DA34D12C23E12646E05FA423E20C4499B047616E4808FD959F1078F2E73EB",
                "clientId": "xdf6a5cd4cx74bfca46x3bbfcxa4c4xf",
                "code": "F73B014CC9C54B74A0FE063F9FF4C2EB",
                "areaPrefix": "3300",
                "new_key16": "zwi5K6RQGwdK^R4q",
                "natureuuid": "3096425af5504c2ea0b18f5d13558425",
                "userinfo": "JTdCJTIyY2xpZW50X2lkJTIyJTNBJTIwJTIydGVmZTU1ZDYzYjVrNDg3MzlldDNlZTRkYjUzOTkyZjMlMjIlMkMlMjAlMjJjbGllbnRfdHlwZSUyMiUzQSUyMCUyMjAzJTIyJTJDJTIwJTIydXNlcl90eXBlJTIyJTNBJTIwJTIyMiUyMiUyQyUyMCUyMnVzZXJfbmFtZSUyMiUzQSUyMCUyMjMzMDgyNTE5OTgwNDEwNDUyNSUyMiUyQyUyMCUyMmZ1bGxfbmFtZSUyMiUzQSUyMCUyMiU1Q3U0ZjU5JTVDdTY4YTYlNUN1NWUwNiUyMiUyQyUyMCUyMnRydXN0ZWRfbGV2ZWwlMjIlM0ElMjAlMjIlNUN1NTZkYiU1Q3U3ZWE3JTIyJTJDJTIwJTIybmV3RXRheEZsYWclMjIlM0ElMjAlMjIwJTIyJTJDJTIwJTIyb3ZlcnNlYXMlMjIlM0ElMjAlMjIwJTIyJTJDJTIwJTIycmVnaXN0cmF0aW9uVHlwZU9mTGV2eVN1YmplY3QlMjIlM0ElMjAlMjIxMTEwJTIyJTJDJTIwJTIyZnVuY3Rpb25NZW51ZSUyMiUzQSUyMCU1QiU1RCUyQyUyMCUyMmFncmVlbWVudE51bWJlciUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmV4cGlyZXNfaW4lMjIlM0ElMjAzNjAwJTJDJTIwJTIybG9naW5fbGV2ZWwlMjIlM0ElMjAlMjIlNUN1NGUwMCU1Q3U3ZWE3JTIyJTJDJTIwJTIybGFzdF90cnVzdGVkX2RhdGElMjIlM0ElMjAlMjIyMDIzLTA5LTAxJTIwMTMlM0E0MSUzQTI5JTIyJTJDJTIwJTIybGFzdF90cnVzdGVkX2RhdGUlMjIlM0ElMjAlMjIyMDIzLTA5LTAxJTIwMTMlM0E0MSUzQTI5JTIyJTJDJTIwJTIydXNlcl9pZCUyMiUzQSUyMCUyMjEwMDA3Zjk4OTY5NzA5MjY0YTQxYmI4NDc1OTQ0N2U2MjcyMiUyMiUyQyUyMCUyMmVudGVycHJpc2VfaWQlMjIlM0ElMjAlMjIzMzAwMDFlNTM5MTkyNTU0NGI3NGIyOGJiYThkMDJiYTNkODUlMjIlMkMlMjAlMjJhZ2VuY3lfZW50ZXJwcmlzZV9pZCUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMnRheF9hdXRob3JpdHlfY29kZSUyMiUzQSUyMCUyMjEzMzAxMDgzMTAwJTIyJTJDJTIwJTIydGF4X2F1dGhvcml0eV9sZXZlbCUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMnRheF9hdXRob3JpdHlfbmFtZSUyMiUzQSUyMCUyMiU1Q3U1NmZkJTVDdTViYjYlNUN1N2EwZSU1Q3U1MmExJTVDdTYwM2IlNUN1NWM0MCU1Q3U2NzZkJTVDdTVkZGUlNUN1NWUwMiU1Q3U2ZWU4JTVDdTZjNWYlNUN1NTMzYSU1Q3U3YTBlJTVDdTUyYTElNUN1NWM0MCU1Q3U3YTBlJTVDdTZlOTAlNUN1N2JhMSU1Q3U3NDA2JTVDdTRlOGMlNUN1NzlkMSUyMiUyQyUyMCUyMnRheHBheWVyX2lkJTIyJTNBJTIwJTIyOTEzMzAxMDhNQUJYTFhHUjRDJTIyJTJDJTIwJTIyY29tcGFueV9uYW1lJTIyJTNBJTIwJTIyJTVDdTY3NmQlNUN1NWRkZSU1Q3U2MjdmJTVDdTRmNTElNUN1NzUzNSU1Q3U1YjUwJTVDdTU1NDYlNUN1NTJhMSU1Q3U2NzA5JTVDdTk2NTAlNUN1NTE2YyU1Q3U1M2Y4JTIyJTJDJTIwJTIybGFzdF9mYWNlX3ZlcmlmeV9kYXRlJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIyaWRfY2FyZCUyMiUzQSUyMCUyMjMzMDgyNTE5OTgwNDEwNDUyNSUyMiUyQyUyMCUyMmNhcmRfdHlwZSUyMiUzQSUyMCUyMjIwMSUyMiUyQyUyMCUyMnJlZ19udW1iZXIlMjIlM0ElMjAlMjIxMDIxMzMwMTAwMDAwMTExMTYyNSUyMiUyQyUyMCUyMnRydXN0X2NvZGUlMjIlM0ElMjAlMjI5MTMzMDEwOE1BQlhMWEdSNEMlMjIlMkMlMjAlMjJwaG9uZSUyMiUzQSUyMCUyMjEzMjgyNDIxOTE3JTIyJTJDJTIwJTIybW9iaWxlJTIyJTNBJTIwJTIyMTMyODI0MjE5MTclMjIlMkMlMjAlMjJ0YXhfZmlsZV9ubyUyMiUzQSUyMCUyMjEwMjEzMzAxMDAwMDAwNjQ5MDUyJTIyJTJDJTIwJTIycG9zaXRpb24lMjIlM0ElMjAlMjIwMyUyMiUyQyUyMCUyMmxvZ2luX3R5cGUlMjIlM0ElMjAlMjIxJTIyJTJDJTIwJTIycmVsYXRlZFR5cGUlMjIlM0ElMjAlMjIwMyUyMiUyQyUyMCUyMmNyZWRpdENvZGUlMjIlM0ElMjAlMjI5MTMzMDEwOE1BQlhMWEdSNEMlMjIlMkMlMjAlMjJzcHJvbGVfbGlzdCUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMnRheGVyX2NvZGUlMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJ0YXhlcl9uYW1lJTIyJTNBJTIwJTIyJTVDdTRmNTklNUN1NjhhNiU1Q3U1ZTA2JTIyJTJDJTIwJTIydGF4X2lkJTIyJTNBJTIwJTIyMTAwMDdmOTg5Njk3MDkyNjRhNDFiYjg0NzU5NDQ3ZTYyNzIyJTIyJTJDJTIwJTIydGF4ZXJfc3RhdHVzX2NvZGUlMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJ0YXhlcl9zdGF0dXNfbmFtZSUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmFnZW5jeUNyZWRpdENvZGUlMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJhZ2VuY3lOYW1lJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIyYWdlbmN5UmVnX251bWJlciUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmFyZWFQcmVmaXglMjIlM0ElMjAlMjIzMzAwJTIyJTJDJTIwJTIyYXJlYVByZU5hbWUlMjIlM0ElMjAlMjIlNUN1NmQ1OSU1Q3U2YzVmJTVDdTc3MDElMjIlMkMlMjAlMjJlbnRlcnByaXNlX3R5cGUlMjIlM0ElMjAlMjIwJTIyJTJDJTIwJTIyaW5pdGlhbF9lbnRlcnByaXNlX3R5cGUlMjIlM0ElMjAlMjIwJTIyJTJDJTIwJTIyY3Jvc3NJbnNwZWN0aW9uTnVtYmVyJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIycHJvamVjdE5hbWUlMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJjcm9zc1JlZ2lvbmFsUHJvcGVydHlUYXhTdWJqZWN0UmVnaXN0cmF0aW9uTWFyayUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmdlbmRlciUyMiUzQSUyMCUyMjAlMjIlMkMlMjAlMjJuYXRpb25hbGl0eSUyMiUzQSUyMCUyMjE1NiUyMiUyQyUyMCUyMnN0YXJ0RGF0ZSUyMiUzQSUyMCUyMjIwMTYwNzI3JTIyJTJDJTIwJTIyZW5kRGF0ZSUyMiUzQSUyMCUyMjIwMjYwNzI3JTIyJTJDJTIwJTIyYmlydGhkYXRlJTIyJTNBJTIwJTIyMjAyMjA1MDUlMjIlMkMlMjAlMjJhZGRyZXNzJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIyZW1haWwlMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJlbnRlcnByaXNlU3RhdHVzJTIyJTNBJTIwJTIyMDElMjIlMkMlMjAlMjJhZ2VuY3lUYXhwYXllcl9pZCUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmFnZW5jeVRheHBheWVyU3RhdHVzQ29kZSUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMnRheHBheWVyU3RhdHVzQ29kZSUyMiUzQSUyMCUyMjAzJTIyJTJDJTIwJTIycmVnaXN0ZXJfdGltZSUyMiUzQSUyMCUyMjIwMjItMDUtMTUlMjAwMCUzQTM2JTNBNTAlMjIlMkMlMjAlMjJhZ2VuY3lUeXBlJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIyaXNIYXZlUHN3JTIyJTNBJTIwJTIyMSUyMiUyQyUyMCUyMmNvbXBldGVudF90YXhfYnVyZWF1X2NvZGUlMjIlM0ElMjAlMjIxMzMwMTA4MDAwMCUyMiUyQyUyMCUyMmNvbXBldGVudF90YXhfYnVyZWF1X25hbWUlMjIlM0ElMjAlMjIlNUN1NTZmZCU1Q3U1YmI2JTVDdTdhMGUlNUN1NTJhMSU1Q3U2MDNiJTVDdTVjNDAlNUN1Njc2ZCU1Q3U1ZGRlJTVDdTVlMDIlNUN1NmVlOCU1Q3U2YzVmJTVDdTUzM2ElNUN1N2EwZSU1Q3U1MmExJTVDdTVjNDAlMjIlMkMlMjAlMjJtYWluSWRlbnRpdHklMjIlM0ElMjAlMjIxJTIyJTJDJTIwJTIyb3V0Z29pbmdCdXNpbmVzc0NlcnRpZmljYXRlVVVJRCUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMnRheF9hdXRob3JpdHlfYWJicmV2aWF0aW9uJTIyJTNBJTIwJTIyJTVDdTU2ZmQlNUN1NWJiNiU1Q3U3YTBlJTVDdTUyYTElNUN1NjAzYiU1Q3U1YzQwJTVDdTY3NmQlNUN1NWRkZSU1Q3U1ZTAyJTVDdTZlZTglNUN1NmM1ZiU1Q3U1MzNhJTVDdTdhMGUlNUN1NTJhMSU1Q3U1YzQwJTVDdTdhMGUlNUN1NmU5MCU1Q3U3YmExJTVDdTc0MDYlNUN1NGU4YyU1Q3U3OWQxJTIyJTJDJTIwJTIyY29tcGV0ZW50X3RheF9idXJlYXVfYWJicmV2aWF0aW9uJTIyJTNBJTIwJTIyJTVDdTU2ZmQlNUN1NWJiNiU1Q3U3YTBlJTVDdTUyYTElNUN1NjAzYiU1Q3U1YzQwJTVDdTY3NmQlNUN1NWRkZSU1Q3U1ZTAyJTVDdTZlZTglNUN1NmM1ZiU1Q3U1MzNhJTVDdTdhMGUlNUN1NTJhMSU1Q3U1YzQwJTIyJTJDJTIwJTIybGFuZyUyMiUzQSUyMCUyMm51bGwlMjIlMkMlMjAlMjJyYXJlbHklMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJhcmVhTmFtZSUyMiUzQSUyMCUyMiU1Q3U2ZDU5JTVDdTZjNWYlMjIlN0Q=",
                "timestamp": "20230901134122",
                "token": "eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6ImM1ZGQzMTRiYzNiZDQ4MGJhNTk1YTQ2YzdkNzg0ZjFjIn0.aNqiA45pyVXHul2Uv4cPDBGF_6pZIVnKXZOuLftLtY56nHRZcMT_P591kctrmlTrB-OWOjObvYb-8jI-4A1GEA"
            }
        },
        "etax": {
            "access_token": "eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6ImM1ZGQzMTRiYzNiZDQ4MGJhNTk1YTQ2YzdkNzg0ZjFjIn0.aNqiA45pyVXHul2Uv4cPDBGF_6pZIVnKXZOuLftLtY56nHRZcMT_P591kctrmlTrB-OWOjObvYb-8jI-4A1GEA",
            "cookie": [
                {
                    "sourceScheme": "Secure",
                    "path": "/",
                    "expires": -1,
                    "sourcePort": 443,
                    "sameParty": false,
                    "session": false,
                    "domain": ".chinatax.gov.cn",
                    "name": "DTL_SESSION_ID",
                    "httpOnly": true,
                    "secure": false,
                    "priority": "Medium",
                    "value": "376e0331-2a91-4300-8a30-0c105e295ad6"
                }
            ],
            "localStorage": ""
        },
        "dppt": {
            "cookie": [
                {
                    "sourceScheme": "Secure",
                    "path": "/",
                    "expires": -1,
                    "sourcePort": 443,
                    "sameParty": false,
                    "session": false,
                    "domain": ".chinatax.gov.cn",
                    "name": "DTL_SESSION_ID",
                    "secure": false,
                    "priority": "Medium",
                    "value": "376e0331-2a91-4300-8a30-0c105e295ad6"
                },
                {
                    "sourceScheme": "Secure",
                    "path": "/",
                    "expires": -1,
                    "sourcePort": 443,
                    "sameParty": false,
                    "session": false,
                    "domain": ".chinatax.gov.cn",
                    "name": "oauth2_referer",
                    "secure": false,
                    "priority": "Medium",
                    "value": "etax.zhejiang.chinatax.gov.cn"
                },
                {
                    "sourceScheme": "Secure",
                    "path": "/",
                    "expires": -1,
                    "sourcePort": 443,
                    "sameParty": false,
                    "session": false,
                    "domain": ".chinatax.gov.cn",
                    "name": "x_host_key",
                    "secure": false,
                    "priority": "Medium",
                    "value": "18a4f42d4be-13929d003d5aa2219b66cd1b18e7f9c6cde04f0a"
                },
                {
                    "sourceScheme": "Secure",
                    "path": "/",
                    "expires": -1,
                    "sourcePort": 443,
                    "sameParty": false,
                    "session": false,
                    "domain": ".chinatax.gov.cn",
                    "name": "SSO_SECURITY_CHECK_TOKEN",
                    "secure": false,
                    "priority": "Medium",
                    "value": "984a19ba0aae42718431def2ff6e1ab4"
                },
                {
                    "sourceScheme": "Secure",
                    "path": "/",
                    "expires": -1,
                    "sourcePort": 443,
                    "sameParty": false,
                    "session": false,
                    "domain": ".chinatax.gov.cn",
                    "name": "dzfp-ssotoken",
                    "secure": false,
                    "priority": "Medium",
                    "value": "e344be7c23e24e759126083a70ea7c7d"
                }
            ]
        }
    },
    "success": true,
    "message": "税务数字账户登录成功",
    "reqId": "dc33cfee4cb74523b46d44e34b4ba488"
}

业务简介#

业务说明#

税务数字证书登录方案#

支持地区#

对接流程#