---
title: "Consultar estado DGI de factura"
method: POST
path: "/tools/invoice_getDGIStatus"
tags: ["Invoices"]
---

# Consultar estado DGI de factura

`POST /tools/invoice_getDGIStatus`

## Request

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

Herramienta MCP: `invoice_getDGIStatus`.

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

Consulta el estado de facturación electrónica ante la DGI de UNA factura por su ID de Alegra. El campo `emissionStatus` puede ser:

- `PENDING`: no enviada todavía.
- `STAMPED_AND_WAITING_RESPONSE`: enviada, la DGI aún no responde.
- `STAMPED_AND_ACCEPTED`: autorizada.
- `STAMPED_AND_REJECTED`: rechazada.
- `CANCELLED_AND_WAITING_RESPONSE`: cancelación solicitada, sin confirmar.
- `STAMPED_AND_CANCELLED`: cancelada ante la DGI.

Devuelve además una descripción en lenguaje claro (`emissionStatusDescription`), el `cufe` (`null` si nunca se autorizó), la numeración, el cliente, los importes y un bloque `stamp` ligero (`legalStatus`, `cufe`, `date`, `authorizationNumber`, `authorizationDate`, `observations`). El bloque `entityResponse` incluye el motivo del rechazo de la DGI solo cuando Alegra lo guardó, lo cual no siempre ocurre.

`emissionStatus` es la fuente de verdad. Una factura RECHAZADA puede conservar un `cufe`, un `authorizationNumber` o una observación de un envío anterior, así que nunca deduzcas que fue autorizada a partir de esos campos. Las facturas de impresora fiscal no se envían a la DGI: solo tienen `stamp.fiscalNumber`.

Úsalo cuando el usuario pregunte si una factura específica fue autorizada o rechazada, o pida su CUFE. Si el usuario no nombra una factura, usa `invoice_listRejectedDGI`. Si necesita la factura completa (ítems, impuestos, pagos), usa `invoice_getInvoiceById`.

## Request body

- object
  - `id` string, required: ID interno de la factura en Alegra (por ejemplo, "1234"). Es el campo id que devuelve invoice_getInvoices, no el número de factura ni el CUFE. Si solo tienes el número, resuelve primero el ID con invoice_getInvoiceByNumber.

## Response `200`

Estado de facturación electrónica DGI de la factura

## 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)