创建发票附件下载任务

POST

openapi.nmy.cn/api/v1/open/attachment-download/create-task

接口描述

该接口用于创建企业电子发票服务平台发票附件（PDF/OFD 等）的异步下载任务。

调用流程

调用「创建发票附件下载任务」接口，调用成功后获取任务 ID（taskId）

调用「发票附件下载任务状态查询」接口，通过 taskId 轮询任务状态；当 status=1（成功）时任务完成，可继续调用「发票附件下载结果查询」接口获取附件文件列表；当状态为「等待用户操作」时，需引导用户完成相应操作后继续等待

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "invoiceStartDate": "2024-01-01",
    "invoiceEndDate": "2024-12-31"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'openapi.nmy.cn/api/v1/open/attachment-download/create-task' \
--header 'Authorization: {{authorization}}' \
--header 'accountId: {{accountId}}' \
--header 'Content-Type: application/json' \
--data '{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "invoiceStartDate": "2024-01-01",
    "invoiceEndDate": "2024-12-31"
}'

返回响应

🟢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

勾选数据同步结果查询

发票附件下载任务状态查询