---
title: "Listar facturas rechazadas por DGI"
method: POST
path: "/tools/invoice_listRejectedDGI"
tags: ["Invoices"]
---

# Listar facturas rechazadas por DGI

`POST /tools/invoice_listRejectedDGI`

## Request

- Base URL: `https://mcp.alegra.com`
- URL: `https://mcp.alegra.com/tools/invoice_listRejectedDGI`
- Auth: HTTP bearer

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`.

## Request body

- object
  - `start` integer: Desplazamiento inicial (0 para la primera página, 30 para la segunda).
  - `limit` integer: 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.
  - `metadata` boolean: Si es true, devuelve { data: Invoice[], metadata: { total } } en lugar de un arreglo.
  - `status` string: Estado de la factura: 'open', 'closed', 'draft' o 'void'. Admite varios valores separados por comas.
  - `client_id` string: ID del cliente.
  - `client_name` string: Nombre del cliente.
  - `numberTemplate_fullNumber` string: Número completo exacto de la factura.
  - `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_before` string: Fecha de creación estrictamente anterior a esta fecha (YYYY-MM-DD).

## Response `200`

Facturas rechazadas por la DGI y metadatos de paginación

## Other responses

- `401`: No autorizado

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)