发起确认单列表数据同步

POST

openapi.nmy.cn/api/v1/open/red-invoice/confirmation/list/create-task

接口描述

该接口用于发起企业电子发票服务平台红字确认单列表数据同步。

系统将创建异步任务，从税局拉取最新红字发票确认单列表数据。

调用流程

调用「发起确认单列表数据同步」接口，调用成功后获取任务 ID（taskId）

调用「确认单列表数据同步状态查询」接口，通过 taskId 轮询执行状态；当 status=1（成功）时同步完成，可继续调用「已同步确认单列表查询」接口查询最新数据

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'openapi.nmy.cn/api/v1/open/red-invoice/confirmation/list/create-task' \
--header 'Authorization: {{authorization}}' \
--header 'accountId: {{accountId}}' \
--header 'Content-Type: application/json' \
--data '{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}"
}'

返回响应

🟢200

application/json

Success

Bodyapplication/json

示例

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

🟠400

🟠401

🔴500

修改于 2026-10-12 01:58:56

确认单确认任务状态查询

确认单列表数据同步状态查询