Pruebas de Certificacion con el MH
Antes de poder emitir documentos fiscales en produccion, el Ministerio de Hacienda requiere que complete un proceso de certificacion. Fiscalizame incluye un panel automatizado que genera, firma y transmite DTEs de prueba al MH, permitiendole completar este proceso de forma rapida y eficiente.
Requisitos Previos
- Haber completado la incorporacion al ambiente de pruebas
- Haber completado la acreditacion como Emisor y generacion del certificado digital
- Haber configurado su organizacion en Fiscalizame 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 Como Agregar Productos)
- Tener registrados los diferentes tipos de clientes necesarios segun las pruebas que ejecutara (ver Como Agregar Clientes, detalle abajo)
- Para pruebas de Contingencia: el usuario que ejecute la prueba debe tener un documento de identificacion (DUI o NIT) configurado en su perfil. Esta informacion se envia al MH como responsable del evento
Importante
Clientes necesarios para las pruebas
Cada tipo de DTE requiere un tipo de cliente especifico. Antes de iniciar las pruebas, asegurese de tener registrados al menos:
| Tipo de Prueba | Tipo de Cliente | Campos Requeridos |
|---|---|---|
| Factura Consumidor Final (01) | Cliente general | Nombre (no requiere NIT) |
| Credito Fiscal (03) | Cliente corporativo (contribuyente) | NIT, NRC, actividad economica, direccion, municipio, departamento |
| Factura de Exportacion (11) | Cliente extranjero | Nombre, pais, complemento de direccion |
| Factura Sujeto Excluido (14) | Cliente excluido de IVA | Nombre, DUI o NIT, direccion, marcado como excluido de IVA |
Nota
Que son las Pruebas de Certificacion
El Ministerio de Hacienda otorga un periodo de pruebas (generalmente 2 meses para sistemas de transmision) durante el cual debe demostrar que su sistema puede generar y transmitir correctamente los diferentes tipos de documentos tributarios electronicos (DTEs).
Los tipos de DTE que puede necesitar certificar son:
| Codigo | Tipo de Documento | Uso Principal |
|---|---|---|
| 01 | Factura Consumidor Final | Ventas a consumidor final |
| 03 | Comprobante de Credito Fiscal | Ventas entre contribuyentes |
| 04 | Nota de Remision | Traslado de mercaderia |
| 05 | Nota de Credito | Devoluciones o descuentos |
| 06 | Nota de Debito | Cargos adicionales |
| 11 | Factura de Exportacion | Ventas al exterior |
| 14 | Factura de Sujeto Excluido | Compras a no contribuyentes |
Adicionalmente, se deben probar los eventos especiales:
- Anulacion — invalidacion de un DTE previamente transmitido
- Contingencia — transmision en modo de contingencia cuando el MH no esta disponible
Paso 1: Acceder al Panel de Pruebas
Navegue al panel de Pruebas de Certificacion
Desde el panel de administracion de Fiscalizame, acceda a "Pruebas de Certificacion MH".
Vera el panel de pruebas con las siguientes secciones:
- Tipo de Prueba — botones para seleccionar que tipo de prueba ejecutar
- Configuracion — parametros de la prueba (cliente, establecimiento, punto de venta, cantidad)
- Productos — seleccion de productos para incluir en los DTEs de prueba
- Resultados — progreso y detalle de cada iteracion
Nota
Paso 2: Tipos de Prueba Disponibles
Fiscalizame agrupa las pruebas de certificacion en los siguientes tipos:
Seleccione el tipo de prueba
En la parte superior del panel encontrara los botones para seleccionar el tipo de prueba. El boton activo se resalta en color morado.
Transmision Directa (01/03/14)
Genera y transmite Facturas de Consumidor Final, Comprobantes de Credito Fiscal o Facturas de Sujeto Excluido directamente al MH. El tipo de DTE se selecciona automaticamente segun el cliente elegido:
- Cliente sin NIT → genera Factura Consumidor Final (01)
- Cliente con NIT y NRC → genera Comprobante de Credito Fiscal (03)
- Cliente excluido de IVA → genera Factura de Sujeto Excluido (14)
Consejo
Factura de Exportacion (11)
Genera y transmite facturas de exportacion. Requiere un cliente extranjero con pais y direccion internacional configurados.
Nota de Remision (04)
Genera y transmite notas de remision para traslado de bienes entre establecimientos.
Nota de Credito (05)
Esta prueba consta de dos pasos automaticos: primero transmite un CCF base y luego genera y transmite una Nota de Credito referenciando ese CCF. Requiere un cliente con NIT y NRC.
Nota de Debito (06)
Similar a la Nota de Credito: transmite un CCF base y luego genera una Nota de Debito contra ese documento.
Evento de Anulacion
Transmite un DTE y luego genera el evento de anulacion correspondiente.
Evento de Contingencia
Simula el ciclo completo de contingencia: crea una orden real, genera el DTE, simula que el MH no esta disponible, crea el evento de contingencia, lo transmite al MH y luego transmite el DTE pendiente por lote.
Importante
Importante
Paso 3: Configurar y Ejecutar las Pruebas
Configure los parametros de la prueba
Para cada tipo de prueba, debe configurar:
| Parametro | Descripcion |
|---|---|
| Cliente | El cliente para los DTEs. El tipo de DTE se determina automaticamente segun el cliente |
| Cantidad de Iteraciones | Cuantos DTEs generar y transmitir. El panel sugiere una cantidad segun el tipo de prueba |
| Establecimiento | La sucursal desde la que se emitiran los DTEs |
| Punto de Venta | El POS asociado al establecimiento. Define el codigo de POS en el numero de control |
| Productos | Los productos que se incluiran aleatoriamente en cada DTE de prueba |
Adicionalmente, en la seccion de Productos seleccione los productos que desea incluir en los DTEs de prueba, y en Seleccion Aleatoria configure cuantos items y en que cantidades se incluiran en cada DTE generado.
Ejecute las pruebas
En la barra de controles encontrara tres opciones para ejecutar las pruebas:
- Ejecutar Siguiente — ejecuta una sola iteracion a la vez, permitiendo verificar cada resultado antes de continuar
- Auto-Pilot — ejecuta todas las iteraciones restantes de forma automatica y secuencial. Puede detenerlo en cualquier momento
- Reiniciar — limpia los resultados y permite comenzar de nuevo
Durante la ejecucion, el panel muestra el progreso en tiempo real:
- Barra de progreso — muestra el avance general (ej: 45/100)
- Indicadores — contadores de exitos y fallos (Total, Aceptados, Rechazados, Errores)
- Tabla de resultados — detalle de cada iteracion con el numero de control, sello de recepcion del MH, estado y tiempo de respuesta
Nota
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 Credito Fiscal (03) — use un cliente corporativo con NIT, NRC, actividad economica y direccion completa
- Factura de Sujeto Excluido (14) — use un cliente marcado como excluido de IVA, con DUI o NIT y direccion
- Factura de Exportacion (11) — use un cliente extranjero con pais y direccion internacional
Grupo 2: Documentos Complementarios
- Nota de Remision (04) — pruebe con cualquier cliente
- Nota de Credito (05) — use un cliente con NIT y NRC
- Nota de Debito (06) — use un cliente con NIT y NRC
Grupo 3: Eventos Especiales
- Anulacion — pruebe con cualquier cliente
- Contingencia — pruebe con cualquier cliente (requiere documento de identificacion en su perfil)
Consejo
Paso 5: Verificar los Resultados
Confirme que todas las pruebas fueron exitosas
Al finalizar cada grupo de pruebas, verifique en la tabla de resultados que:
- Todas las iteraciones muestran estado exitoso
- Cada DTE tiene un sello de recepcion del MH (esto confirma que fue recibido correctamente)
- Los tiempos de respuesta son razonables
Si alguna iteracion falla, revise el mensaje de error. Los motivos mas comunes son:
- Error de autenticacion — verifique las credenciales del certificado y API en la configuracion de entornos
- Error de validacion — el MH rechazo el formato del DTE. Contacte al soporte de Fiscalizame
- Timeout — el servicio del MH no respondio a tiempo. Puede reintentar la prueba
Despues de las Pruebas: Paso a Produccion
Importante
No realice el cambio a produccion hasta que el MH se lo autorice.
El Ministerio de Hacienda revisara los resultados de sus pruebas y le notificara cuando este autorizado para emitir DTEs reales.
Una vez que el Ministerio de Hacienda apruebe su certificacion y le autorice para operar en produccion:
- Repita el proceso de acreditacion en el portal del MH, pero esta vez para el ambiente de Produccion. Esto generara un nuevo certificado digital y nuevas credenciales API especificas para produccion
- Configure el certificado de produccion en Fiscalizame — vaya a Configuracion de Entornos, expanda la tarjeta de "Produccion" y cargue el nuevo certificado con sus credenciales (ver guia de configuracion)
- Cambie el ambiente activo a Produccion en la seccion de Ambiente MH Activo
- Verifique la conexion renovando el token MH para confirmar que las credenciales de produccion funcionan correctamente
Advertencia