Appearance
接口名称:纳税人登录接口
- 请求方式:
POST
- 请求路径:
ip:port
/zzsq/login
请求参数示例(JSON 格式)
json
{
"nsrsbh": "123456789012345",
"loginType": "1",
"nsrdq": "shaanxi",
"traceno": "trace_001",
"qd": "true",
"nsrInfo": {
"dlsf": "admin",
"dlsfmm": "password123",
"zjh": "13800138000",
"gsnsmm": "password123",
"sfzjhm": "610101199001011234",
"gsnsyhm": "nsr_user",
"bsryxz": "张三"
}
}
请求参数说明
主结构字段
字段名 | 必填 | 类型 | 说明 |
---|---|---|---|
nsrsbh | 是 | string | 纳税人识别号 |
loginType | 是 | string | 登录类型:1 表示账密(短信验证码),4 表示账密(税务App扫码) |
nsrdq | 是 | string | 纳税人地区(省份全拼),例如:shaanxi (陕西) |
traceno | 是 | string | 流水号,用于请求追踪 |
qd | 否 | string | 是否全电登录,默认值为 true |
nsrInfo | 是 | object | 纳税人登录详细信息 |
nsrInfo 子结构字段
字段名 | 必填 | 类型 | 说明 |
---|---|---|---|
dlsf | 是 | string | 登录身份,参考身份字典 |
dlsfmm | 是 | string | 登录身份密码(与登录密码相同) |
zjh | 否 | string | 中间号或接收短信手机号(短信登录方式必填) |
gsnsmm | 是 | string | 登录密码 |
sfzjhm | 否 | string | 身份证件号码 |
gsnsyhm | 是 | string | 登录账号 |
bsryxz | 否 | string | 办税人员姓名 |
成功响应示例
json
{
"success": true,
"code": "SMS",
"msg": "验证码已发送,请输入验证码",
"trace": null,
"data": null
}
响应参数说明
参数名 | 类型 | 说明 |
---|---|---|
success | boolean | 接口调用状态,true 或 false |
code | string | 状态码,例如:SMS |
msg | string | 提示信息 |
trace | object | 调用链追踪(默认 null ) |
data | object | 返回数据(此接口中为 null ) |