MhEmitirComprobante

Descripción

Emite un Comprobante de Crédito Fiscal (tipo 03), una Nota de Crédito (tipo 05) o una Nota de Débito (tipo 06) a El Salvador ante el Ministerio de Hacienda. A diferencia de la factura al consumidor final, en este documento el IVA se discrimina como tributo aparte en vez de ir incluido en el precio.

Las notas de crédito y débito referencian el documento tributario de origen mediante documentoRelacionado. El nodo arma el DTE en JSON, lo firma con JWS (RS512) y hace la recepción contra Hacienda.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial mh (clave, NIT y API de Hacienda)
comprobante	json	No	Comprobante en JSON: tipo (03 CCF, 05 NC, 06 ND), receptor (nit, nrc, nombre), items (precioUnitario sin IVA). Para notas: documentoRelacionado con codigoGeneración y fecha

El emisor se completa automáticamente desde la credencial cuando no viene en comprobante.

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 documento con JWS (RS512)
• Entorno: pruebas u producción según el ambiente configurado en Hacienda

Salida

{
  "success": true,
  "codigoGeneracion": "B2C3D4E5-F6A7-1234-5678-9ABCDEF01234",
  "numeroControl": "DTE-03-00000001-000000000000001",
  "selloRecibido": "2026080598765432109876543210987654",
  "estado": "PROCESADO",
  "fhProcesamiento": "05/08/2026 11:02:10"
}

Ejemplo de Uso

Comprobante de Crédito Fiscal

{
  "credentials_id": "cred-mh-prod",
  "comprobante": {
    "tipo": "03",
    "receptor": {
      "nit": "06141804941035",
      "nrc": "123456",
      "nombre": "Distribuidora SA de CV"
    },
    "items": [
      {
        "descripcion": "Mercadería varia",
        "cantidad": 10,
        "precioUnitario": 100
      }
    ]
  }
}

Nota de Crédito referenciando un CCF

{
  "credentials_id": "cred-mh-prod",
  "comprobante": {
    "tipo": "05",
    "receptor": {
      "nit": "06141804941035",
      "nrc": "123456",
      "nombre": "Distribuidora SA de CV"
    },
    "documentoRelacionado": {
      "codigoGeneracion": "B2C3D4E5-F6A7-1234-5678-9ABCDEF01234",
      "fecha": "2026-08-05"
    },
    "items": [
      {
        "descripcion": "Devolución de mercadería",
        "cantidad": 2,
        "precioUnitario": 100
      }
    ]
  }
}

Notas

• El precioUnitario de los ítems va sin IVA incluido; el tributo se calcula y se discrimina aparte al 13%.
• Las Notas de Crédito y Débito requieren documentoRelacionado con el codigoGeneracion y la fecha del comprobante que están corrigiendo.
• El tipo de documento (03, 05 o 06) determina la estructura y validaciones que Hacienda aplica al DTE.
• Igual que la factura, el comprobante solo queda válido cuando Hacienda responde PROCESADO con el Sello de Recepción.

Nodos Relacionados

• MhEmitirFactura - Emitir factura electrónica al consumidor final
• MhAnular - Anular un DTE ya emitido