企业账户登录

开发中

POST

https://skynjweb.com:7443/hx/api/fp/h5.js.electronicTaxBureau.authentication

请求参数

Header 参数

nsrsbh

string

接口调用方税号

可选

access_token

string

可选

通过“获取access_token”接口获取，除“获取access_token”接口外，其余接口访问均需携带此参数

Body 参数application/json

step_name

string

方法名称

必需

<= 20 字符

nsrsbh

string

纳税人识别号

必需

9-20 位大写字母或数字

<= 20 字符

username

string

用户名

必需

用户名

<= 200 字符

password

string

密码

可选

<= 50 字符

zrrlx

string

责任人

可选

<= 2 字符

smsCode

string

短信验证码

可选

<= 20 字符

dqbm

string

地区编码

可选

<= 4 字符

auto_sms_login_flag

string

短信精灵登录开关

可选

0 不启用1启用注：1）启用时，传入的用户名必需为手机号2）zrrlx 可以选择传入或者不传入，a. 传入时，如果账户拥有此责任人，短信精灵登录时会自动使用，若无此责任人，会自动按照省份和责任人优先顺序自动筛选b. 不传入责任人，后台会自动筛选3) 短信精灵登录启用后，在 25 秒内用户可每 2-5 秒轮询调用查询短信精灵登录结果的步骤，获取短信精灵登录成功或失败的结果

<= 1 字符

get_jump_url

string

是否获取跳转地址

可选

true 获取跳转地址和可信登录授权码，false 或者不填表示走正常登录流程不获取跳转地址

<= 10 字符

jump_url_type

string

获取跳转地址类型

可选

0或不填为获取跳转电子税务局的 url1 为获取跳转开票服务的Url2为获取跳转税务数字账户的 Url

<= 1 字符

app_flags

string

获取二维码标识

可选

"1"表示获取个税 APP 的二维码 "2"或者不填表示各地方税务 APP 的二维码；需要在获取二维码和验证二维码传参。

<= 1 字符

qrcode_id

string

二维码 ID

可选

获取二维码返回的二维码ID，在获取二维码扫码结果时使用

<= 100 字符

dyfs

string

调用方式

可选

调用方式，填 1 为调快捷登录。不填或者填其它值默认为企业账户登录

<= 1 字符

dxbz

string

短信标志

可选

调用方式为 1 快捷登录时才需考虑填该参数；短信标志：0或空为自动发短信，1不自动发短信15 sms_code_id 短信验证码 ID varchar 50 否调用方式为 1 快捷登录时才需考虑填该参数；短信验证码 id16 reloginflag强制重新登录标志varchar 50 否开票接口返回 3203 特定报错时需要传该字段为 true

<= 1 字符

sms_code_id

string

sms_code_id

可选

reloginflag

string

reloginflag

可选

示例

{
    "step_name": "string",
    "nsrsbh": "string",
    "username": "string",
    "password": "string",
    "zrrlx": "st",
    "smsCode": "string",
    "dqbm": "stri",
    "auto_sms_login_flag": "s",
    "get_jump_url": "string",
    "jump_url_type": "s",
    "app_flags": "s",
    "qrcode_id": "string",
    "dyfs": "s",
    "dxbz": "s",
    "sms_code_id": "string",
    "reloginflag": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://skynjweb.com:7443/hx/api/fp/h5.js.electronicTaxBureau.authentication' \
--header 'nsrsbh;' \
--header 'access_token;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "step_name": "string",
    "nsrsbh": "string",
    "username": "string",
    "password": "string",
    "zrrlx": "st",
    "smsCode": "string",
    "dqbm": "stri",
    "auto_sms_login_flag": "s",
    "get_jump_url": "string",
    "jump_url_type": "s",
    "app_flags": "s",
    "qrcode_id": "string",
    "dyfs": "s",
    "dxbz": "s",
    "sms_code_id": "string",
    "reloginflag": "string"
}'

返回响应

🟢200成功

application/json

Body

data

array[string]

可选

step_code

string

接口后续流程

可选

详见“方法名称与接口后续流程对应关系表”，及使用说明。

<= 20 字符

sms_waittime

string

轮询等待时间

可选

该值为查询短信精灵结果超时时间，每次登录只会第一次触发有值，在触发短信精灵后，在该时间内可每 2 秒轮询一次获取短信精灵登录的结果

<= 2 字符

jump_url

string

跳转税局的

可选

Varchar 300 否跳转税局的 URL（get_jump_url为 true时才会返回）

login_code

string

可信登录授权码

可选

可信登录授权码（get_jump_url为 true时才会返回）

<= 150 字符

qrcode_id

string

二维码 ID

可选

获取二维码返回的二维码 ID

<= 100 字符

qrcode

string

二维码

可选

获取二维码返回的二维码，Base64 字符串

expires_in

string

有效时间

可选

有效时间，单位秒

<= 5 字符

qrcode_status

string

二维码状态

可选

"1" 尚未扫码验证（轮询 verify_qrcode，推荐时间间隔 4~5 秒）"2" 扫码完成，"3"二维码失效（刷新二维码，重新create_qrcode）

<= 1 字符

sms_code_id

string

短信验证码 ID

可选

调用方式为 1 新版登录时才需考虑填该参数；短信验证码 id方法名称与接口后续流程对应关系表返回参数 step_code 请求参数 step_name 接口后续流程0 登录成功1send_sms、create_qrcode获取短信验证码、获取二维码2 select_zrrlx 选择责任人3 sms_login 短信登录4 verify_qrcode 获取二维码验证结果5 query_auto_login_res查询短信精灵自动登录结果6 短信精灵登录失败参数使用说明：1、第一次登录时，“step_name”为“login”，用户密码必传，获取返回参数，根据返回参数判断是否需要再次调用登录接口进行后续交互流程；2、接口返回参数“step_code”为 0 时，即登录成功。无需再次调用本接口，可进行其他业务逻辑；3、接口返回参数“step_code”为 1 时，即告知登录需要进行二次验证，可选择短信验证或者扫码验证；若选择短信验证，需调用登录接口发送验证码。再次调用本接口，调用参数中“step_name”为“send_sms”；若选择二维码验证，需调用登录接口获取二维码。再次调用本接口，调用参数中“step_name”为“create_qrcode”；其中“app_flags”在获取二维码时如果不填或者填“2”为获取对应地区税局的二维码，填“1”为获取个税 APP 的二维码。4、接口返回参数“step_code”为 2时，即告知登录需要选择责任人，返回参数“data”中为选择责任人列表，用户可选择任意一个责任人。再次调用本接口，调用参数中“step_name”为“select_zrrlx”，“zrrlx”字段为用户选择责任人编号；5、接口返回参数“step_code”为 3 时，即告知登录需要校验短信验证，且验证码已发送，需提交验证码。再次调用本接口，调用参数中“step_name”为“sms_login”，“smsCode”为用户收到的短信验证码。6、接口返回参数“step_code”为 4 时，需要获取二维码的验证结果。再次调用本接口，调用参数中“step_name”为“verify_qrcode”，“qrcode_id”为获取二维码时返回的“qrcode_id”，“app_flags”与获取二维码时的值保持一致。该接口推荐 4~5 秒请求一次获取结果。7、接口返回参数“step_code”为 5 时，触发短信精灵自动登录，需每 2s 轮询调用登录接口查询短信精灵自动登录结果，调用参数中“step_name”为“query_auto_login_res”。责任人身份类型对照表身份类型责任人法定代表人 01财务负责人 02办税员 03管理员 05领票员 07社保经办人 08开票员 09销售人员 10参数使用说明：接口返回参数“data”中“01”等字段表示的为当前账号可选择的“身份类型”，编码以“,”间隔，调用方获取并解析后展示给用户，供用户选择后继续调用登录接口。接口入参 get_jump_url 为 true 时表示获取跳转税局的 url 链接，获取到的 url 链接只可访问一次。此参数为 true时不会进行正常的企业账户登录流程，若您不清楚该参数的作用请不要传 true，传空字符串或者不传即进行正常的企业账户登录流程。当调用参数中“jump_url_type”的值是 0 或不填表示获取跳转电子税务局的 url，值是 1 表示获取跳转开票服务的 Url，值是 2 表示获取跳转税务数字账户的 Url。企业账户登录兼容新版登录说明：1、第一次登录时，“step_name”为“login”，税号、用户名、密码必传，调用方式填 1，短信标志、短信验证码 ID根据实际需要传值，获取返回参数，根据返回参数判断是否需要再次调用登录接口进行后续交互流程；2、接口返回参数“step_code”为 0 时，即登录成功。无需再次调用本接口，可进行其他业务逻辑；3、接口返回参数“step_code”为 3 时，若未发送验证码，需要重新走 1 的步骤（短信标志改为自动发短信）获取验证码；若已发送了验证码，需要在 1的请求报文基础上加入 1返回报文中的短信 ID，短信验证码填用户收到的短信验证码；业务流程

<= 50 字符

示例

{
    "data": [
        "数据"
    ],
    "step_code": "接口后续流程",
    "sms_waittime": "轮询等待时间",
    "jump_url": "跳转税局的 URL",
    "login_code": "可信登录授权码",
    "qrcode_id": "二维码 ID",
    "qrcode": "二维码",
    "expires_in": "有效时间",
    "qrcode_status": "二维码状态",
    "sms_code_id": "短信 ID"
}

修改于 2025-06-12 12:32:32

获取access_token

获取风险预警级别接口