虚拟手机号登录 - 用票管理

请求参数

Header 参数

nsrsbh

string

密钥所有方税号

可选

access_token

string

可选

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

fplx

string

可选

必传固定值“jxfp”

默认值:

jxfp

Body 参数application/json

step_name

string

步骤名称

必需

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

<= 20 字符

nsrsbh

string

纳税人识别号

可选

15/17/18/20是

username

string

用户名

必需

必需为手机号

<= 200 字符

password

string

密码

可选

<= 50 字符

zrrlx

string

责任人类型

可选

zrrlx可以选择传入或者不传入，a. 传入时，如果账户拥有此责任人，短信精灵登录时会自动使用，若无此责任人，会自动按照省份和责任人优先顺序自动筛选b. 不传入责任人，后台会自动筛选详见“责任人身份类型对照表”，及参数使用说明。

<= 2 字符

smsCode

string

短信验证码

可选

<= 20 字符

dqbm

string

地区编码

可选

详见“企业账号登录-地区编码对照表”，及参数使用说明。

<= 4 字符

示例

{
    "step_name": "string",
    "nsrsbh": "string",
    "username": "string",
    "password": "string",
    "zrrlx": "st",
    "smsCode": "string",
    "dqbm": "stri"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://skynjweb.com:7443/hx/api/fp/51ys.jx.taxdigital.tpass.loginPhone' \
--header 'nsrsbh;' \
--header 'access_token;' \
--header 'fplx: jxfp' \
--header 'Content-Type: application/json' \
--data-raw '{
    "step_name": "string",
    "nsrsbh": "string",
    "username": "string",
    "password": "string",
    "zrrlx": "st",
    "smsCode": "string",
    "dqbm": "stri"
}'

返回响应

🟢200成功

application/json

Body

data

object

可选

step_code

可选

sms_waittime

string

轮询等待时间

可选

用户可轮询此时间，获取短信精灵登录的结果方法名称与接口后续流程对应关系表返回参数 step_code 请求参数 step_name 接口后续流程0 登录成功1 send_sms 获取验证码2 select_zrrlx 选择责任人3 sms_login 短信登录5 query_auto_login_res查询短信精灵自动登录结果6 短信精灵登录失败参数使用说明：1、第一次登录时，“step_name”为“login”，用户密码必传，获取返回参数，根据返回参数判断是否需要再次调用登录接口进行后续交互流程；2、接口返回参数“step_code”为 0 时，即登录成功。无需再次调用本接口，可进行其他业务逻辑；3、接口返回参数“step_code”为 1 时，即告知登录需要校验短信验证，需调用登录接口发送验证码。再次调用本接口，调用参数中“step_name”为“send_sms”；4、接口返回参数“step_code”为 2 时，即告知登录需要选择责任人，返回参数“data”中“personList”字段为选择责任人列表，解析后用户可选择任意一个责任人。再次调用本接口，调用参数中“step_name”为“select_zrrlx”，“zrrlx”字段为用户选择责任人编号；5、接口返回参数“step_code”为 3 时，即告知登录需要校验短信验证，且验证码已发送，需提交验证码。再次调用本接口，调用参数中“step_name”为“sms_login”，“smsCode”为用户收到的短信验证码。6、接口返回参数“step_code”为 5 时，即告知登录已触发短信精灵登录。再次调用本接口，调用参数中“step_name”为“query_auto_login_res”。责任人身份类型对照表身份类型责任人法定代表人 01财务负责人 02办税员 03管理员 05领票人 07社保经办人 08开票员 09销售人员 10

<= 2 字符

示例

{
    "data": {},
    "step_code": 0,
    "sms_waittime": ""
}