连接管理 · 900002
业务接口都要求企业税号已有可用连接（ljzt=1）。 连接分两条并列路径：扫码（只需税号，当前唯一经过真实场景验证的路径）与短信（需要账号密码，已实现但暂无真机验证记录）。
发起扫码连接
已上线POST /api/v2/tax/900002/FQSMLJ
返回值是二维码图片地址，不是二维码文本——二维码文本等同一次性登录凭证，服务端只在内存渲染成 PNG，不下发明文。
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
| nsrsbh | 是 | 企业纳税人识别号 |
响应字段
| 字段 | 说明 |
|---|---|
| lsh | 会话流水号，供后续 CXLJZT 查询 |
| ewmdz | 二维码图片地址（相对路径，需拼接平台域名） |
| yxq | 有效期，格式 YYYYMMDDHHmmss |
查询连接状态
已上线POST /api/v2/tax/900002/CXLJZT
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
| lsh | 是 | 发起连接时返回的会话流水号 |
响应字段
| 字段 | 说明 |
|---|---|
| ljzt | 1=已连接 0=未连接 |
| yxq | 有效期，格式 YYYYMMDDHHmmss |
按税号查连接状态
已上线本平台扩展 · 9 号段POST /api/v2/tax/900002/CXNSRLJZT
CXLJZT 只能按 lsh 查询， 而 lsh 只在发起连接那一次返回，ERP 进程重启会丢失。本接口按企业税号直接查询， 并把 lsh 一并带回。
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
| nsrsbh | 是 | 企业纳税人识别号 |
响应字段
| 字段 | 说明 |
|---|---|
| ljzt | 1=已连接 0=未连接 |
| lsh | 会话流水号，可用于后续 CXLJZT/TJDXYZM |
| yxq | 有效期，格式 YYYYMMDDHHmmss |
发起短信连接
联调中POST /api/v2/tax/900002/FQDXLJ
已实现，但目前没有真机验证记录，请优先使用扫码连接。account/password 为可选：正常情况密码应先通过 PZZHMM 配置好， ERP 不接触税局密码明文；这两个字段只用于密码尚未入库的首次接入。
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
| nsrsbh | 是 | 企业纳税人识别号 |
| account | 否 | 税局账号（密码已配置时可省略） |
| password | 否 | 税局密码（密码已配置时可省略） |
| identityType | 否 | 本平台扩展：办税人员登录身份类型 |
响应字段
| 字段 | 说明 |
|---|---|
| lsh | 会话流水号 |
| sjh | 接收验证码的手机号（已脱敏，如 138****5678） |
提交短信验证码
联调中POST /api/v2/tax/900002/TJDXYZM
同步返回最终连接结果，不需要轮询。验证码错误返回 returncode=01（可直接用同一个 lsh 重新提交），不是 03（无需重新建连）。
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
| lsh | 是 | 发起短信连接返回的会话流水号 |
| smsCode | 是 | 短信验证码 |
响应字段
| 字段 | 说明 |
|---|---|
| ljzt | 1=已连接 0=未连接 |
配置税局账号密码
已上线本平台扩展 · 9 号段POST /api/v2/tax/900002/PZZHMM
幂等接口：重复调用会覆盖原密码，不拒绝。响应中绝不包含密码或其密文，只回执"是否配置成功"。
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
| nsrsbh | 是 | 企业纳税人识别号 |
| account | 是 | 税局账号 |
| password | 是 | 税局密码（传输已加密，平台不落明文） |
| dqbh | 否 | 地区编号，仅账号首次新建时使用 |
响应字段
| 字段 | 说明 |
|---|---|
| zh | 实际写入密码的账号 |
| mmzt | 密码状态：1=已配置 |
| sffg | 是否覆盖了原有密码：1=是 0=否（首次配置） |