Herramienta MCP: invoices__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 invoices__listRejectedDGI. Si necesita la factura completa (ítems, impuestos, pagos), usa invoices__getInvoiceById.