MhAnular

Descripción

Invalida (anula) un DTE ya emitido en El Salvador ante el Ministerio de Hacienda, identificándolo por su Código de Generación. El nodo arma el evento de invalidación correspondiente, lo firma con JWS y lo envía a Hacienda.

Los demás datos del documento a anular (tipo, emisor, receptor) se recuperan automáticamente de la base a partir del Código de Generación; solo hace falta indicar el motivo de la anulación.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial mh (clave, NIT y API de Hacienda)
codigo_generacion	text	Sí	Código de Generación del DTE a anular
motivo	textarea	Sí	Motivo de la anulación

Credenciales

Este módulo requiere una credencial de tipo mh con los siguientes campos:

• NIT / NRC del emisor: identificación tributaria del contribuyente
• Usuario y clave API de Hacienda: credenciales para obtener el token de autenticación
• Certificado de firma: material usado para firmar el evento de invalidación con JWS (RS512)
• Entorno: pruebas u producción según el ambiente configurado en Hacienda

Salida

{
  "success": true,
  "codigoGeneracion": "A1B2C3D4-E5F6-1234-5678-9ABCDEF01234",
  "codigoGeneracionEvento": "F9E8D7C6-B5A4-1234-5678-9ABCDEF98765",
  "estado": "PROCESADO",
  "fhProcesamiento": "05/08/2026 12:40:05"
}

Ejemplo de Uso

{
  "credentials_id": "cred-mh-prod",
  "codigo_generacion": "A1B2C3D4-E5F6-1234-5678-9ABCDEF01234",
  "motivo": "Error en los datos del receptor, se emite un nuevo documento"
}

Notas

• El codigo_generacion debe corresponder a un DTE que haya quedado PROCESADO previamente; no se puede anular un documento rechazado o inexistente.
• El evento de invalidación se firma con el mismo esquema JWS (RS512) que el DTE original.
• El motivo es obligatorio: Hacienda exige una justificación textual de la anulación.
• Hacienda impone plazos y condiciones para invalidar un DTE (por ejemplo, según el tiempo transcurrido desde la emisión); si el documento ya no es anulable, el nodo devuelve el error de Hacienda correspondiente.

Nodos Relacionados

• MhEmitirFactura - Emitir la factura que luego se podría anular
• MhEmitirComprobante - Emitir el Comprobante de Crédito Fiscal o Nota que luego se podría anular