发起勾选数据同步

POST

openapi.nmy.cn/api/v1/open/checked-deduction/create-task

接口描述

该接口用于发起企业电子发票服务平台勾选抵扣数据同步。

系统将创建异步任务，从税局拉取最新勾选状态数据。

调用流程

调用「发起勾选数据同步」接口，调用成功后获取任务 ID（taskId）

调用「勾选数据同步状态查询」接口，通过 taskId 轮询执行状态；当 status=1（成功）时同步完成，可继续调用「勾选数据同步结果查询」接口获取完整勾选抵扣数据列表；当状态为「等待用户操作」时，需引导用户完成相应操作后继续等待

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "skssqStart": "202401",
    "skssqEnd": "202412",
    "needInvoiceItemVO": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'openapi.nmy.cn/api/v1/open/checked-deduction/create-task' \
--header 'Authorization: {{authorization}}' \
--header 'accountId: {{accountId}}' \
--header 'Content-Type: application/json' \
--data '{
    "uscc": "{{uscc}}",
    "areaCode": "{{areaCode}}",
    "personalAccount": "{{personalAccount}}",
    "skssqStart": "202401",
    "skssqEnd": "202412",
    "needInvoiceItemVO": 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

发票数据同步结果查询

勾选数据同步状态查询