ALalegra
Gastos

Listar facturas de compra

Herramienta MCP: expenses_list-bills.

Lista facturas de compra (gastos) con filtros opcionales de estado, rango de fechas, proveedor, moneda, centro de costos y más. Soporta paginación con start y limit (hasta 200 por página).

Por defecto devuelve una versión ligera de cada documento; usa fields para incluir campos adicionales (por ejemplo totalTaxes, retentions, payments) y simple: true para objetos aún más reducidos.

Úsala para descubrir los id numéricos que necesita expenses_get-bill, auditar gastos por proveedor o período, o revisar documentos pendientes de pago. Para ver el detalle completo de un documento, usa expenses_get-bill.

Notas por país: en México las facturas de compra son CFDI; en República Dominicana usan NCF/ECF. En Colombia el tipo por defecto es bill (también acepta supportDocument); en Panamá, Perú, España y Venezuela type acepta all para ambas clases de documento. El filtro currency usa el código de la moneda local de cada país (por ejemplo MXN, DOP, COP).

Solo lectura.

post/tools/expenses_list-bills

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/expenses_list-bills
  • Auth
    HTTP bearer

Request body

billNumber_equalsstring

Coincidencia exacta del número de la factura de compra.

client_idinteger

ID numérico local del proveedor. Filtra los documentos de ese proveedor.

costCenter_idstring

ID del centro de costos. Usa "null", "none" o "0" para filtrar documentos sin centro de costos.

createdAt_earlierThanOrEqualTostring

Filtro: fecha de creación <= valor (ISO 8601).

createdAt_laterThanOrEqualTostring

Filtro: fecha de creación >= valor (ISO 8601).

createdBystring

Filtra por identificador del usuario que creó el documento.

currencystring

Filtra por código de moneda (por ejemplo USD).

datestring

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

date_afterOrNowstring

Filtro: fecha de emisión >= valor (YYYY-MM-DD).

date_beforeOrNowstring

Filtro: fecha de emisión <= valor (YYYY-MM-DD).

decimalMode'calculation' | 'display'

Modo de redondeo de los totales: 'calculation' usa la escala de la empresa, 'display' usa la precisión de visualización.

dueDatestring

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

dueDate_betweenstring

Rango de vencimiento: "YYYY-MM-DD,YYYY-MM-DD".

dueDate_earlierThanOrEqualTostring

Filtro: fecha de vencimiento <= valor (YYYY-MM-DD).

dueDate_laterThanOrEqualTostring

Filtro: fecha de vencimiento >= valor (YYYY-MM-DD).

emissionStatusstring

Filtro de estado de emisión electrónica, separado por comas.

excludePaidBillsboolean

Excluye de los resultados las facturas totalmente pagadas.

fieldsstring

Campos adicionales separados por comas: editable, deletable, comments, journal, url, purchaseOrders, totalTaxes, subTotal, advances, retentions, createdAt, updatedAt, idGlobal, uid, stamp, etc.

fullNumberstring

Coincidencia parcial del número completo del documento.

idsstring

Lista separada por comas de IDs locales a recuperar, por ejemplo '1,2,3' (máximo 30).

item_idinteger

Filtra documentos que contengan un ítem con este ID local.

limitinteger

Registros por página (0–200). Por defecto 30.

order_direction'ASC' | 'DESC'

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

order_field'billNumber' | 'name' | 'date' | 'dueDate' | 'id'

Campo por el que se ordenan los resultados.

provider_namestring

Filtra por nombre del proveedor (coincidencia parcial).

purchaseOrder_idinteger

Filtra facturas asociadas a un ID de orden de compra.

simpleboolean

Devuelve objetos simplificados con menos campos.

startinteger

Desplazamiento inicial de la paginación (0 para la primera página).

statusstring

Filtro de estado separado por comas, por ejemplo 'open,draft'. Valores: draft, open, paid, void.

type'bill' | 'supportDocument' | 'all'

Filtro por tipo de documento: 'bill' para facturas estándar, 'supportDocument' para documentos soporte de compra. En Colombia el valor por defecto es 'bill'; en Panamá, Perú, España y Venezuela 'all' incluye ambas clases.

uuidstring

Busca un único documento por su UUID.

uuidsstring

Lista separada por comas de UUIDs a recuperar.

warehouse_idinteger

Filtra por ID local de la bodega.

Response

Lista de facturas de compra

Changes

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