Pruebas de Certificación con el MH

Cómo ejecutar las pruebas de certificación requeridas por el Ministerio de Hacienda.

Antes de poder emitir documentos fiscales en producción, el Ministerio de Hacienda requiere que complete un proceso de certificación. Fiscalízame incluye un panel automatizado que genera, firma y transmite DTEs de prueba al MH, permitiéndole completar este proceso de forma rápida y eficiente.

Requisitos Previos

• Haber completado la incorporación al ambiente de pruebas
• Haber completado la acreditación como Emisor y generación del certificado digital
• Haber configurado su organización en Fiscalízame con el certificado y las credenciales del MH
• Tener al menos un establecimiento y un punto de venta configurados
• Tener al menos un producto activo registrado (ver Cómo Agregar Productos)
• Tener registrados los diferentes tipos de clientes necesarios según las pruebas que ejecutará (ver Cómo Agregar Clientes, detalle abajo)
• Para pruebas de Contingencia: el usuario que ejecute la prueba debe tener un documento de identificación (DUI o NIT) configurado en su perfil. Esta información se envía al MH como responsable del evento

¿Qué son las Pruebas de Certificación?

El Ministerio de Hacienda otorga un período de pruebas (generalmente 2 meses para sistemas de transmisión) durante el cual debe demostrar que su sistema puede generar y transmitir correctamente los diferentes tipos de documentos tributarios electrónicos (DTEs).

Los tipos de DTE que puede necesitar certificar son:

Adicionalmente, se deben probar los eventos especiales:

• Anulación — invalidación de un DTE previamente transmitido
• Contingencia — transmisión en modo de contingencia cuando el MH no está disponible
• Operaciones Especiales (17) — ventas respaldadas con facturas simplificadas o comprobantes de control interno (versión 2 de la API)
• Retorno (18) — devolución de productos vendidos con una factura ya sellada (versión 2 de la API)

Paso 1: Abrir «Certificación MH»

Navegue al panel de certificación

En el menú, dentro de Documentos Tributarios, abra «Certificación MH». El encabezado confirma la organización que se está certificando y que los documentos van al ambiente de pruebas del MH.

El panel tiene tres partes:

• Plan de certificación (a la izquierda) — la lista de pruebas que pide el MH, agrupadas en documentos de venta, notas y eventos. Cada una muestra cuántos documentos aceptados lleva de su meta y un ícono con su estado: pendiente, en curso, completa o con fallos
• La prueba elegida — el cliente que recibe los documentos, la meta de aceptados, la Emisión (plegada) y los botones para ejecutar
• Resultados — el avance hacia la meta y cada documento enviado, el más reciente primero

Paso 2: Las pruebas del plan

El plan tiene una prueba por cada documento que el MH cuenta por separado:

Los comprobantes, el Documento Contable de Liquidación, el Evento de Operaciones Especiales y el Evento de Retorno aparecen solo si la organización emite con la versión 2 de la API de Hacienda.

Al elegir una prueba, el campo Cliente ofrece primero los clientes que sirven para ella; los demás aparecen deshabilitados con el motivo (por ejemplo, «Necesita NIT y NRC»). Si ninguno sirve, el panel dice qué cliente hace falta y ofrece un enlace para crearlo.

• Nota de Crédito y Nota de Débito — cada documento transmite primero un Crédito Fiscal de base y luego la nota contra él
• Evento de Anulación — cada evento transmite primero una Factura y luego la anula
• Evento de Retorno — cada evento transmite primero una Factura y, cuando el MH la sella, devuelve una unidad de su primera línea
• Evento de Contingencia — cada evento recorre el ciclo completo: crea la orden, genera la Factura, la marca en contingencia, transmite el evento al MH y luego la Factura por lote

Paso 3: Configurar y ejecutar una prueba

Elija el cliente y la meta

Revise la Emisión (una sola vez)

La sección Emisión se usa en todas las pruebas y está plegada: su encabezado resume lo que tiene (por ejemplo, «Casa Matriz (M001) · Caja Principal (P001) · 5 productos · 1–3 ítems × 1–5 unidades»). Se abre sola cuando falta algo. Al abrirla puede cambiar:

• Establecimiento y Punto de venta — desde dónde se emiten los documentos; definen los códigos del número de control
• Productos — los que se incluyen al azar en cada documento («Todos», «5 al azar» o «Ninguno»)
• Ítems por documento y Unidades por ítem — los rangos de la selección al azar

El panel recuerda la Emisión en este navegador.

Ejecute

• Ejecutar N documentos — envía documentos uno tras otro hasta alcanzar la meta de aceptados. Si el MH rechaza o falla 3 documentos seguidos, se detiene para no consumir más números de control y le pide revisar la respuesta del MH
• Detener — aparece durante la ejecución; se detiene al terminar el documento en curso
• Ejecutar uno — envía un solo documento, para revisar el resultado antes de continuar

Junto a los botones, el panel recuerda que los documentos se transmiten al ambiente de pruebas del MH y consumen números de control reales, y si la prueba deja registros en la base de datos. Si falta algo para ejecutar (el cliente, un dato de la Emisión), lo dice en ese mismo lugar.

Lea los resultados

• Barra de avance — los aceptados frente a la meta
• Filtros — Todos, Aceptados, Rechazados y Errores, con su cantidad
• Tabla — por cada documento: estado, número de control y código de generación, sello de recepción o mensaje del MH, los pasos de las pruebas de varios pasos y el tiempo de respuesta
• CSV — descarga los resultados de la prueba elegida
• Reiniciar — borra el progreso guardado de la prueba elegida para empezarla de cero (lo transmitido al MH no cambia)

Paso 4: Plan de Pruebas Recomendado

Ejecute las pruebas en el orden sugerido

Se recomienda ejecutar las pruebas en el siguiente orden, preparando los clientes necesarios antes de cada grupo:

Grupo 1: Documentos de Venta

• Factura Consumidor Final (01) — use un cliente general (sin NIT)
• Comprobante de Crédito Fiscal (03) — use un cliente corporativo con NIT, NRC, actividad económica y dirección completa
• Factura de Sujeto Excluido (14) — use un cliente marcado como excluido de IVA, con DUI o NIT y dirección
• Factura de Exportación (11) — use un cliente extranjero con país y dirección internacional

Grupo 2: Comprobantes (solo con la versión 2 de la API)

Aparecen en el plan solo si su organización emite con la versión 2 de la API de Hacienda (Normativa DTE 2.0). Los documentos que detallan se declaran en papel, así que no hace falta emitir otros documentos antes.

• Comprobante de Retención (07) — use un cliente de El Salvador con NIT o DUI, actividad económica y dirección con distrito: hace las veces del proveedor al que se le retiene el 1 % de IVA
• Comprobante de Liquidación (08) — use un cliente como el anterior: hace las veces del mandante al que se le liquidan las ventas del mes
• Documento Contable de Liquidación (09) — use un cliente con NIT o DUI, actividad económica y correo electrónico: hace las veces del afiliado al que su organización, como agente perceptor, le liquida las operaciones del mes, menos el IVA percibido (2 %) y una comisión del 3 %
• Comprobante de Donación (15) — use un cliente de El Salvador con NIT o DUI: hace las veces del donante. Su organización necesita un teléfono registrado

Grupo 3: Documentos Complementarios

• Nota de Remisión (04) — pruebe con cualquier cliente
• Nota de Crédito (05) — use un cliente con NIT y NRC
• Nota de Débito (06) — use un cliente con NIT y NRC

Grupo 4: Eventos Especiales

• Anulación — pruebe con cualquier cliente
• Contingencia — pruebe con cualquier cliente (requiere documento de identificación en su perfil)
• Evento de Operaciones Especiales (17) — no lleva cliente: informa ventas del día respaldadas con facturas simplificadas. Solo con la versión 2 de la API
• Evento de Retorno (18) — pruebe con cualquier cliente. Las facturas que transmite quedan registradas, como las de la prueba de Anulación. Solo con la versión 2 de la API

Paso 5: Verificar los Resultados

Confirme que todas las pruebas fueron exitosas

Al finalizar cada grupo de pruebas, verifique en el plan que cada prueba está completa (ícono verde) y, en sus resultados, que:

• Los documentos muestran estado Aceptado
• Cada DTE tiene un sello de recepción del MH (esto confirma que fue recibido correctamente)
• Los tiempos de respuesta son razonables

Si algún documento falla, revise el mensaje de error. Los motivos más comunes son:

• Error de autenticación — verifique las credenciales del certificado y API en la configuración de entornos
• Error de validación — el MH rechazó el formato del DTE. Contacte al soporte de Fiscalízame
• Timeout — el servicio del MH no respondió a tiempo. Puede reintentar la prueba

Después de las Pruebas: Paso a Producción

• Repita el proceso de acreditación en el portal del MH, pero esta vez para el ambiente de Producción. Esto generará un nuevo certificado digital y nuevas credenciales API específicas para producción
• Configure el certificado de producción en Fiscalízame — vaya a Configuración de Entornos, expanda la tarjeta de "Producción" y cargue el nuevo certificado con sus credenciales (ver guía de configuración)
• Cambie el ambiente activo a Producción en la sección de Ambiente MH Activo
• Verifique la conexión renovando el token MH para confirmar que las credenciales de producción funcionan correctamente