Skip to main content

接口调用说明

概述​

数电登记采用异步流程：登录接口实时返回状态码，客户根据状态码调用对应后续接口，直到返回终态（S000 成功 / F000 失败）。

接口Action说明
数电登记EAuthorize.AuthorizeLogin发起登录，返回状态码
验证码提交EAuthorize.AuthorizeSmsCode登录返回 SMS 时提交短信验证码
扫码状态查询EAuthorize.AuthorizeQrCodeStatus登录返回 QRCODE 后轮询扫码结果

登录方式（loginType）：

loginType方式适用省份
1账密(短信验证码)登录默认方式；广东、浙江、湖北为账密直登（无需验证码，登录成功直接返回 S000），其他省份登录后返回 SMS 需提交短信验证码
2扫码登录需要手机验证码或二次扫码的省份；登录后返回 QRCODE，客户使用税务 APP 扫码

账密(短信验证码)登录流程（loginType=1）​

数电登记 ──► SMS  ──► 验证码提交 ──► S000 登录成功
    │                                  F000 登录失败(authorizeMsg 返回原因)
    ├──► S000 登录成功（广东、浙江、湖北账密直登）
    └──► F000 登录失败

扫码登录流程（loginType=2）​

数电登记 ──► QRCODE(authorizeMsg 为二维码图片 Base64)
    │
    ▼
展示二维码，客户使用税务 APP 扫码
    │
    ▼
轮询扫码状态查询 ──► S000 已扫码登录成功
                  F000 失败

轮询建议每 2~3 秒调用一次。

状态码说明​

状态码说明后续操作
S000登录成功，返回授权信息流程结束
F000登录失败authorizeMsg 返回具体失败原因
R000业务性异常可重试 1-3 次
SMS需要短信验证码调用验证码提交
QRCODE需要扫码登录展示二维码并轮询扫码状态查询

注意事项​

  1. 短信验证码有效期 4 分钟、二维码有效期 2 分钟，超时后需重新调用数电登记发起登录。
  2. 短信验证码提交错误可重复提交，累计不超过 5 次。
  3. traceNo 单次登录全流程（数电登记 → 验证码提交 / 扫码状态查询）必须保持一致且唯一；多次登录必须使用不同流水号区分。