Obtener facturas

post

https://mcp.alegra.com/tools/invoice_getInvoices

Herramienta MCP: invoice_getInvoices.

Lista facturas de venta con filtros opcionales y paginación (start y limit, máximo 30 por página).

Por defecto devuelve una versión ligera de cada factura (ids, fechas, estado, numeración, cliente e importes). Usa detail: true solo cuando el usuario pida explícitamente ítems, impuestos o pagos.

Para más de unos 120 registros o un rango de fechas completo, usa invoice_createInvoicesExportable en lugar de paginar.

Algunos filtros existen solo en ciertos países. Si un parámetro no está disponible en el país de la empresa, omítelo. Solo lectura.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

client_id

string

ID del cliente. Filtra las facturas de ese cliente.

client_identification

string

Identificación del cliente (RUC, cédula o NIT según el país). Disponible solo en: AR, CO, CR, DO, ES, PA, VE

client_name

string

Nombre del cliente.

date

string

Fecha exacta de creación (YYYY-MM-DD).

date_after

string

Fecha de creación estrictamente posterior a esta fecha (YYYY-MM-DD).

date_afterOrNow

string

Fecha de creación igual o posterior a esta fecha (YYYY-MM-DD). Disponible solo en: AR, CO, CR, DO, ES, VE

date_before

string

Fecha de creación estrictamente anterior a esta fecha (YYYY-MM-DD).

date_beforeOrNow

string

Fecha de creación igual o anterior a esta fecha (YYYY-MM-DD). Disponible solo en: AR, CO, CR, DO, ES, VE

detail

boolean

Defaults to false

Si es false (por defecto), devuelve una versión ligera. Si es true, incluye el contenido completo (ítems, impuestos, etc.); úsalo solo si el usuario lo pide.

dueDate

string

Fecha de vencimiento exacta (YYYY-MM-DD).

dueDate_after

string

Fecha de vencimiento estrictamente posterior a esta fecha (YYYY-MM-DD). Disponible solo en: CO

dueDate_afterOrNow

string

Fecha de vencimiento igual o posterior a esta fecha (YYYY-MM-DD). Disponible solo en: CO

dueDate_before

string

Fecha de vencimiento estrictamente anterior a esta fecha (YYYY-MM-DD). Disponible solo en: CO

dueDate_beforeOrNow

string

Fecha de vencimiento igual o anterior a esta fecha (YYYY-MM-DD). Disponible solo en: CO

string

Lista separada por comas de IDs de facturas. Si se indica, los demás filtros se ignoran.

item_id

string

Filtra facturas que contengan este ID de ítem. Disponible solo en: AR, CO, CR, DO, ES, VE

limit

integer

1 to 30

Número de facturas por petición (máximo 30).

metadata

boolean

Si es true, devuelve { data: Invoice[], metadata: { total } } en lugar de un arreglo.

numberTemplate_fullNumber

string

Número completo exacto de la factura (por ejemplo, el NCF).

order_direction

string

enum

Dirección del orden: ASC (ascendente) o DESC (descendente).

Allowed:

order_field

string

enum

Campo por el que se ordenan los resultados.

Allowed:

start

integer

≥ 0

Desplazamiento inicial (0 para la primera página, 30 para la segunda).

status

string

Estado de la factura: 'open', 'closed', 'draft' o 'void'. Admite varios valores separados por comas.

Responses

401

No autorizado

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Lista de facturas de venta