---
title: "Descargar Invoices por vencer cobrables"
method: GET
path: "/download/chargeable_due_invoices"
tags: ["Downloads"]
---

# Descargar Invoices por vencer cobrables

`GET /download/chargeable_due_invoices`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/download/chargeable_due_invoices`
- Auth: API key in header `x-api-key`

Genera un Excel con las Invoices por vencer que están listas para cobrarse y devuelve su URL.

Permite revisar en una planilla qué Invoices entrarían en el próximo cobro antes de ejecutarlo. El archivo se sube a almacenamiento y la respuesta trae la URL firmada de descarga junto con la cantidad de Invoices incluidas.

Los parámetros `included_invoices` y `excluded_invoices` ajustan la selección a mano sobre el resultado de los filtros: el primero fuerza la inclusión de Invoices puntuales y el segundo las deja fuera.

## Query parameters

- `id_account` string: Identificador público de la Account cuyas Invoices se quieren incluir.
- `due_date` string: Fecha de vencimiento por la que se filtran las Invoices, en formato `YYYY-MM-DD`.
- `included_invoices` string: Identificadores públicos de Invoices que se incluyen aunque no cumplan el resto de los filtros, en un arreglo JSON (por ejemplo `["in_bQ7nWzX4TgKpLmR8vY2aJdH5sC3fN6uE"]`).
- `excluded_invoices` string: Identificadores públicos de Invoices que se excluyen del archivo, en un arreglo JSON (por ejemplo `["in_bQ7nWzX4TgKpLmR8vY2aJdH5sC3fN6uE"]`).

## Response `200`

Successful Response

- ChargeableDueInvoicesExcelResponse: Resultado de la generación del Excel de Invoices por vencer cobrables.
  - `total` integer, required: Cantidad de Invoices incluidas en el archivo.
  - `url` string, required: URL firmada de descarga del archivo Excel, con vigencia limitada.

## Other responses

- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: El recurso solicitado no existe.
- `422`: El cuerpo de la petición no pasó la validación.
- `429`: Se superó el límite de peticiones permitidas.

## Changes

- **2026-11-03** `a6ef070075b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/download/chargeable_due_invoices/get.md)

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)
