创建企业登录任务

POST

openapi.nmy.cn/api/v1/open/login/task

接口描述

该接口用于向电子税务局发起登录认证，创建登录任务并立即返回任务 ID（taskId），登录验证在后台异步进行。

⚠️ 请求头说明：本接口无需携带 accountId。此时用户尚未完成登录，accountId 将在登录成功后由服务端返回，登录成功后的后续业务接口再行携带。

调用流程

调用本接口，提交登录信息（纳税人识别号、地区编码、账号、密码、身份类型等），获取任务 ID（taskId）

通过「登录任务状态查询」接口，以 taskId 轮询任务状态；当返回状态为「成功」或「失败」时停止轮询

若状态为「等待短信验证码」，提示用户输入收到的验证码，并调用「提交短信验证码」接口完成验证

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "password": "******",
    "sflx": "BSY",
    "ywlx": "A",
    "relogin": true,
    "isDeviceLogin": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'openapi.nmy.cn/api/v1/open/login/task' \
--header 'Authorization: {{authorization}}' \
--header 'Content-Type: application/json' \
--data '{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "password": "******",
    "sflx": "BSY",
    "ywlx": "A",
    "relogin": true,
    "isDeviceLogin": true
}'

返回响应

🟢200

application/json

Success

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "taskID": 12345
    },
    "traceId": "xxxx-xxxx-xxxx-xxxx"
}

🟠400

🟠401

🔴500

修改于 2026-09-29 07:58:32

地区编码

创建代理企业登录任务