数电登记
接口描述
数电登记（数电登录）。登录为异步流程：本接口实时返回状态码，根据状态码决定后续操作——返回 SMS 调用验证码提交，返回 QRCODE 展示二维码并调用扫码状态查询轮询扫码结果。
登录方式（loginType）：
| loginType | 登录方式 | 说明 |
|---|---|---|
| 1 | 账密(短信验证码)登录 | 需要手机验证码的省份使用；不需要验证码的省份（广东、浙江、湖北）登录成功直接返回 S000 |
| 2 | 扫码登录 | 需要手机验证码或二次扫码的省份，返回二维码供税务 APP 扫码 |
请求地址
Header 参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
Timestamp | String | 必选 | 公共参数。 |
SecretId | String | 必选 | 公共参数。 |
Signature | String | 必选 | 公共参数。 |
Algorithm | String | 可选 | 公共参数。 |
Content-Type | String | 必选 | 取值：application/json |
Body 请求参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
taxpayerNumber | String | 必选 | 纳税人识别号 |
taxpayerArea | String | 必选 | 纳税人地区;省份全拼(小写),如 guangdong、shaanxi,参见地区编号 |
loginType | String | 必选 | 登录类型;1:账密(短信验证码)登录,2:扫码登录,默认1 |
traceNo | String | 必选 | 流水号,必填;单次登录提交短信、查询扫码状态接口需和本接口保持一致,多次登录必须区分 |
naturalPersonLogin | String | 必选 | 自然人登录标志;true:自然人登录,false:企业登录,默认false |
loginIdentity | String | 必选 | 登录身份(1:财务负责人,2:法定代表人,3:办税员,7:开票员),参见附录-登录身份字典 |
loginIdentityPassword | String | 必选 | 登录身份密码 |
taxOfficerPhoneNumber | String | 可选 | 手机号码;接收短信验证码的手机号 |
loginUserId | String | 必选 | 登录账号(用户名/身份证号/接收短信的手机号) |
loginUserPassword | String | 必选 | 登录密码 |
taxOfficerIDCard | String | 可选 | 身份证件号码 |
返回参数
公共返回结构
| 参数名称 | 类型 | 说明 |
|---|---|---|
code | Integer | 200 表示请求成功 |
message | String | 错误提示信息 |
startTime | long | 开始时间 |
endTime | long | 结束时间 |
callId | long | 调用记录标识 |
data | | 返回数据 |
data 内容说明
| 参数名称 | 类型 | 说明 |
|---|---|---|
statusCode | String | 响应状态码;详见附录-响应状态码 |
authorizeMsg | String | 授权返回信息;statusCode 为 QRCODE 时返回二维码图片 Base64 |
traceNo | String | 流水号;与本接口请求参数一致，后续接口沿用 |
流程与约束
- 短信验证码有效期 4 分钟、扫码有效期 2 分钟，超时后需重新调用本接口发起登录。
- 短信验证码提交错误可重复提交，累计不超过 5 次。
- 账密直登省份（广东、浙江、湖北）登录成功直接返回
S000，无需后续操作。 traceNo在单次登录全流程中必须保持唯一且一致。
附录
响应状态码
| 状态码 | 说明 |
|---|---|
| S000 | 登录成功，返回授权信息 |
| F000 | 登录失败，authorizeMsg 返回具体失败原因 |
| R000 | 业务性异常，可重试 1-3 次 |
| SMS | 需要短信验证码，调用验证码提交 |
| QRCODE | 需要扫码登录，authorizeMsg 返回二维码图片 Base64，调用扫码状态查询轮询 |
登录身份字典
| 编码 | 名称 |
|---|---|
| 1 | 财务负责人 |
| 2 | 法定代表人 |
| 3 | 办税员 |
| 7 | 开票员 |