ALalegra
Invoices

Obtener facturas

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.

post/tools/invoice_getInvoices

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/invoice_getInvoices
  • Auth
    HTTP bearer

Request body

client_idstring

ID del cliente. Filtra las facturas de ese cliente.

client_identificationstring

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_namestring

Nombre del cliente.

datestring

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

date_afterstring

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

date_afterOrNowstring

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

date_beforestring

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

date_beforeOrNowstring

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

detailboolean

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.

dueDatestring

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

dueDate_afterstring

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

dueDate_afterOrNowstring

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

dueDate_beforestring

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

dueDate_beforeOrNowstring

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

idstring

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

item_idstring

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

limitinteger

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

metadataboolean

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

numberTemplate_fullNumberstring

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

order_direction'ASC' | 'DESC'

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

order_field'id' | 'name' | 'date' | 'dueDate' | 'status'

Campo por el que se ordenan los resultados.

startinteger

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

statusstring

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

Response

Lista de facturas de venta

Changes

No recorded changes to this operation across all 1 revision of this API.