发起已勾选归集任务

POST

/app-api/v2/invoice/gj/collectCheckedInvoice

该接口用于发起已勾选归集任务，调用流程如下：

调用「发起已勾选归集任务」接口

调用接口成功后，获取到任务ID-taskId

调用「查询已勾选归集任务结果」接口

通过taskId调用接口，返回任务状态"status"=3则表示归集任务成功，此时有两种方式获取发票结构化数据：
1、通过此接口返参内返回的「jsonUrl」字段解析获得结构化数据（建议统一用这个方法）
2、通过taskId调用「查询已勾选归集数据」接口获取结构化数据（不建议用这个方法，若数据大小大于2M，只返回jsonUrl，不会返回结构化数据）

请求参数

Header 参数

Body 参数application/json

示例

{
    "nsrsbh": "9131******57LQY4Y",
    "kpyfq": "202211",
    "kpyfz": "202212",
    "tscjbz": "1,2",
    "dataType": "zip"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/app-api/v2/invoice/gj/collectCheckedInvoice' \
--header 'access-key;' \
--header 'secret-key;' \
--header 'Content-Type: application/json' \
--data '{
    "nsrsbh": "9131******57LQY4Y",
    "kpyfq": "202211",
    "kpyfz": "202212",
    "tscjbz": "1,2",
    "dataType": "zip"
}'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
    "reqId": "f650ac40f6914f328aa587116957899e",
    "code": "2000",
    "success": true,
    "message": null,
    "data": {
        "taskId": "1752226411192705000"
    }
}

修改于 2026-09-16 07:18:30

发起作废/红冲归集任务

查询已勾选归集任务结果