Download e-invoices

Returns a ZIP archive holding one document per requested invoice. Pass up to 50 ids, taken from /invoices/invoices/e-invoices/{format}. An archive is returned even for a single id. Ids that cannot be rendered or are not available to this account are left out of the archive and listed in SKIPPED-INVOICES.txt and SKIPPED-INVOICES.json inside it. A 200 is NOT always an archive: when none of the ids could be rendered the body is a JSON object carrying success: false and the reason for each. Check success before treating the body as a ZIP.

Responses

🟢200OK

application/json

A ZIP archive (application/zip, downloaded as e-invoices-YYYY-MM-DD.zip), or a JSON failure body with HTTP 200. Check the Content-Type header. The JSON body is an ErrorBusinessRule (status_code 410) when no id was given, more than 50 were given, or none could be rendered (each reason in errors), or an ErrorUnauthorized (status_code 401 or 403).

Body

Example

{
    "success": false,
    "status_code": 410,
    "errors": {
        "0": "Invoice #1025: This invoice is not available for this account.",
        "error_message": "Invoice #1025: This invoice is not available for this account."
    },
    "data": []
}

🟠404Record Not Found

Request

Responses