电子税局企业手机登录API

API说明：通过此接口，实现企业使用手机号登录来跳过短信验证码的步骤（仅支持部分场景，是否需要调用可事先联系市场或运维人员）。
调用方式：HTTP协议
API编码：jx.taxdigital.phone.login
调用方法：POST
数据格式：json

请求报文规范

{
    "step_name":"方法名称",
    "nsrsbh":"纳税人识别号",
    "username":"用户名", 
    "password":"密码",
    "dqbm":"地区编码",
    "zrrlx":"责任人",
    "smsCode":"短信验证码"
}

字段说明

【地区编码清单】说明:

方法名称与接口后续流程对应关系表

参数使用说明：
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”为用户收到的短信验证码。

参数说明：

责任人身份类型对照表

参数使用说明：
接口返回参数“data”中“01”等字段表示的为当前账号可选择的“身份类型”，编码以“,”间隔，调用方获取 并解析后展示给用户，供用户选择后继续调用登录接口。

参数说明：

返回报文规范

{
    "data": "{数据}",
    "step_code": "接口后续流程",
    "sms_waittime": "轮询等待时间"
}

字段说明