ALalegra
Invoices

Listar facturas rechazadas por DGI

Herramienta MCP: invoice_listRejectedDGI.

Solo lectura. Exclusiva de Panamá: solo está disponible cuando la empresa de Alegra es panameña.

Lista las facturas que la DGI rechazó (emissionStatus = STAMPED_AND_REJECTED). No son facturas electrónicas válidas hasta corregir la causa y volver a enviarlas. Las facturas anuladas (status "void") también se incluyen; combina con status "open" para ver solo las que aún requieren acción. Una factura rechazada puede conservar un cufe o una observación de un envío anterior, como "0260 Autorizado el uso de la FE": emissionStatus es la referencia.

El motivo del rechazo de la DGI solo aparece (stamp.entityResponse) cuando Alegra lo guardó, lo cual no siempre ocurre. No inventes un motivo si falta. Los tiquetes de venta siempre se excluyen. Cada registro es una vista DGI (estado y descripción, CUFE, numeración, cliente, importes y bloque stamp), no la factura completa.

Úsalo para preguntas como "¿qué facturas rechazó la DGI?" o "¿cuáles fallaron al emitir?". Para una sola factura, usa invoice_getDGIStatus.

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_listRejectedDGI

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/invoice_listRejectedDGI
  • 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.

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 rechazadas por la DGI y metadatos de paginación

Changes

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