FelAnular

Descripción

Anula un DTE (factura o nota) previamente certificado ante el SAT de Guatemala, identificándolo por su UUID (Número de Autorización). El nodo envía la solicitud de anulación al certificador habilitado configurado en la credencial y, si es aceptada, actualiza el estado del documento a cancelled en la base de datos de Floogos.

La anulación requiere obligatoriamente un motivo, que queda registrado tanto en el certificador como en el historial local del documento.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial FEL
uuid	text	Sí	UUID (Número de Autorización) del DTE a anular
motivo	textarea	Sí	Motivo de anulación

Credenciales

Este módulo requiere una credencial de tipo fel (certificador, usuario/clave o llave del certificador, NIT del emisor, ambiente).

Salida

{
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "estado": "cancelled",
  "motivo": "Error en el NIT del receptor",
  "fechaAnulacion": "2026-08-05T16:10:00-06:00"
}

Ejemplo de Uso

{
  "credentials_id": "cred-fel-prod",
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "motivo": "Error en el NIT del receptor"
}

Notas

• El motivo debe tener al menos 3 caracteres; si no se envía, el nodo corta la ejecución antes de contactar al certificador.
• No todos los adaptadores de certificador soportan anulación; si el proveedor configurado en la credencial no la implementa, el nodo devuelve error indicándolo.
• Una vez anulado, el DTE queda marcado como cancelled y ya no debería usarse como referencia para notas de crédito/débito.
• El SAT establece plazos para poder anular un DTE (normalmente dentro del mismo mes calendario de su emisión); pasado ese plazo el certificador rechazará la anulación.

Nodos Relacionados

• FelEmitirFactura - Emitir la factura a anular
• FelEmitirNota - Emitir una nota de crédito/débito
• FelRepresentación - Generar la representación impresa con QR