ALalegra
Invoices

Listar facturas rechazadas por SAT

Herramienta MCP: invoice_listRejectedSAT.

Solo lectura. Exclusiva de México: solo está disponible cuando la empresa de Alegra es mexicana.

Lista las facturas cuyo timbrado SAT fue rechazado (emissionStatus = STAMPED_AND_REJECTED). Se enviaron para timbrar, pero el PAC o el SAT no las aceptó, así que no son CFDI válidos hasta corregir la causa en Alegra y volver a timbrarlas. Las facturas de tiquetes de venta se excluyen siempre: se emiten mediante una factura global.

El motivo del rechazo no forma parte de este resultado. Cada registro es una vista SAT (estado y descripción, UUID, numeración, cliente, importes y bloque stamp), no la factura completa.

Úsalo para preguntas como "¿qué facturas rechazó el SAT?" o "¿cuáles fallaron al timbrar?". Para una sola factura, usa invoice_getSATStatus.

Los resultados se paginan sobre las facturas revisadas (máximo 30 por página con limit, desplazamiento con start). Lee returnedByApi, discardedByClientFilter, serverSideFilterHonored y note en la respuesta. Si serverSideFilterHonored es false, sigue paginando con start, porque una página puede contener menos coincidencias que limit.

post/tools/invoice_listRejectedSAT

Request

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

Request body

startinteger

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

limitinteger

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

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.

metadataboolean

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

statusstring

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

client_idstring

ID del cliente.

client_namestring

Nombre del cliente.

numberTemplate_fullNumberstring

Número completo exacto de la factura (folio fiscal).

datestring

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

date_afterstring

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

date_beforestring

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

Response

Facturas con timbrado SAT rechazado y metadatos de paginación

Changes

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