异步登录税务数字账户【发送短信验证码】

接口描述

该接口用于36个地区税局的新版登录，如果税局登录需要短信验证码登录，则触发短信发送。注：广东、天津、浙江、湖北不需要短信验证码，该接口可直接登录
ps：相同的个人用户+不同身份类型在税局是互踢。建议的最优使用方案是不同个人用户+身份类型。
敏感信息支持加密，加密方案参见：加密说明

请求参数

Header 参数

access_token

string

必需

示例值:

req_date

string

必需

示例值:

req_sign

string

必需

待签名字符串 = HTTPMethod + "" + Content-Md5 + "" + req_date + "" + access_token + "" + AppSecret

示例值:

Body 参数application/json

nsrsbh

string

纳税人识别号

必需

该值必填

areaCode

string

地区编码

必需

四川传值5100，青岛为3702。该值必填

gryhm

string

用户名

必需

可为：居民身份证/手机号/用户名。该值必填

gryhmm

string

个人用户密码

必需

该值必填需要RSA加密

sflx

string

身份类型

必需

FDDBR法定代表人、CWFZR财务负责人、BSY办税员、LPY领票人、QTRY其他人员、FBSR附办税人、PTGLY普通管理员、GPY购票员、SMBS实名办税、FPLYR发票领用人、KPY开票员。该值必填

sjhm

string

手机号码

必需

除广东、天津、浙江、湖北外，该值必填

示例

{
    "nsrsbh": "string",
    "areaCode": "string",
    "gryhm": "string",
    "gryhmm": "string",
    "sflx": "string",
    "sjhm": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位

code

string | null

登录返回的code

必需

2000：登录成功；4xxx;登录信息有误;8xxx短信发送频繁；5xxx:系统错误

success

boolean

是否成功标记

必需

接口是否成功（是否发生业务异常）

message

string

错误信息

可选

data

object

业务数据

可选

当code为2000，从data获取任务id或者登录结果

dppt

object

登录数字账户信息

可选

taskId

string

发送短信成功的id，推送短信接口的传参

可选

accountId

string

账户唯一标识

可选

多账户业务需要要传入

individualId

string

自然人唯一标识

可选

示例

发送短信成功结果示例异常示例登录成功示例

{
    "req_id": "0f1fe24daa164e95b0191f80a2bf11fc",
    "success": true,
    "code": "2000",
    "data": {
        "individualId": "f7d90cd33fed9c9e0c5ad324e64dda52",
        "accountId": "836f8e89a726d14d4d1bd9e93b0fb946",
        "taskId": 1736647432086679600
    }
}

异步登录税务数字账户【发送短信验证码】

接口描述#

请求参数

示例代码

返回响应

接口描述