Configuración de la Organización
Cómo configurar el certificado digital y las credenciales del MH en Fiscalízame.
Una vez completada la acreditación como Emisor DTE en el portal del Ministerio de Hacienda, debe configurar su organización en Fiscalízame con el certificado digital y las credenciales necesarias para firmar y transmitir documentos electrónicos.
Requisitos Previos
- Haber completado la incorporación al ambiente de pruebas (ver Manual de Incorporación)
- Haber completado la acreditación como Emisor y generación del certificado digital (ver Manual de Acreditación)
- Tener a mano el archivo del certificado digital descargado desde el portal del MH (formato
.crt) - Conocer la contraseña de la clave privada del certificado (definida durante la acreditación)
- Conocer la contraseña de acceso API del Ministerio de Hacienda (definida durante la acreditación)
- Tener una cuenta de administrador en Fiscalízame
Las contraseñas mencionadas son las que usted definió durante el proceso de acreditación en el portal del Ministerio de Hacienda. Si no las recuerda, deberá regenerar su certificado digital desde el portal del MH.
Qué necesita configurar
Para que Fiscalízame pueda firmar y transmitir DTEs, se necesitan tres elementos clave por cada ambiente (Pruebas y Producción):
ElementoDescripciónOrigenCertificado digitalArchivo .crt que contiene la firma electrónicaDescargado del portal MHContraseña del certificadoClave privada que protege el certificadoDefinida durante la acreditaciónContraseña API MHCredencial para autenticarse con los servicios del MHDefinida durante la acreditación
Paso 1: Acceder a la Configuración de Entornos
Navegue a Mi Organización
Desde el panel de administración de Fiscalízame:
- Haga clic en "Mi Organización" en el menú lateral
- Verá un resumen de su organización con su información fiscal, el estado de configuración para DTE y el ambiente activo
Si la configuración para DTE está incompleta, verá una barra de progreso indicando cuántos requisitos faltan por completar. Los requisitos de "Firma y Transmisión DTE" son los que configuraremos en esta guía.
Ingrese a Configuración de Entornos
En la sección "Configuración de Entornos MH", haga clic en el botón "Configurar Entornos".
Esto le llevará a la página donde puede gestionar los certificados y credenciales para cada ambiente del Ministerio de Hacienda.
Paso 2: Verificar el Ambiente Activo
Confirme que el ambiente de Pruebas está seleccionado
En la parte superior de la página verá la sección "Ambiente MH Activo" con dos opciones:
- Pruebas — para el ambiente de pruebas del MH
- Producción — para el ambiente real (solo usar después de la certificación)
Para la configuración inicial, asegúrese de que "Pruebas" esté seleccionado. Si no lo está, selecciónelo y haga clic en "Guardar".
No cambie al ambiente de Producción hasta que haya completado todas las pruebas de certificación con el Ministerio de Hacienda. El ambiente determina contra qué servicios del MH se autentica su organización.
Paso 3: Cargar el Certificado Digital
Ubique la sección de Certificados de Firma
Debajo de la sección de ambiente y conexión MH, encontrará la sección "Certificados de Firma". Verá dos tarjetas desplegables:
- Pruebas — con la etiqueta Ambiente actual
- Producción — para configurar más adelante
Cada tarjeta muestra un indicador de estado:
- Configurado — el certificado ya fue cargado
- Pendiente — falta cargar el certificado
Haga clic en la tarjeta de "Pruebas" para expandirla.
Cargue el archivo del certificado
En el formulario expandido, complete los siguientes campos:
CertificadoHaga clic en "Elegir archivo" y seleccione el archivo .crt del certificado digital que descargó del portal del MH.
El NIT y NRC registrados en la información fiscal de su organización en Fiscalízame deben coincidir exactamente con los datos contenidos en el certificado digital (.crt). El certificado se genera con el NIT y NRC que el Ministerio de Hacienda tiene registrados para su empresa. Si hay una discrepancia, la firma de los DTEs fallará y no podrá transmitir documentos electrónicos.
Paso 4: Ingresar las Contraseñas
Configure la contraseña del certificado
En el campo "Contraseña del certificado", ingrese la contraseña de la clave privada que definió durante el proceso de acreditación en el portal del MH.
Esta contraseña protege el certificado digital y es necesaria para que Fiscalízame pueda firmar los documentos electrónicos.
Configure la contraseña API MH
En el campo "Contraseña API MH", ingrese la contraseña de acceso API que definió en el último paso de la acreditación (Paso 6 del manual de acreditación, sección "Credenciales de Acceso API").
Esta contraseña permite a Fiscalízame autenticarse con los servicios del Ministerio de Hacienda para transmitir los DTEs.
El usuario para la autenticación API es el NIT de su organización. Este se configura automáticamente a partir de la información fiscal de su organización — no necesita ingresarlo manualmente aquí.
Recuerde que el NIT utilizado para la autenticación API y el NRC de su organización deben ser los mismos con los que se generó el certificado digital. Si actualizó sus datos fiscales en el Ministerio de Hacienda (por ejemplo, cambio de NRC), deberá generar un nuevo certificado y cargarlo en Fiscalízame.
Paso 5: Email de Prueba (Opcional)
Configure un email de prueba
El campo "Email de prueba" es opcional y solo aparece para el ambiente de Pruebas.
Si lo configura, los DTEs generados en el ambiente de pruebas enviarán las notificaciones a este correo electrónico en lugar del correo del cliente. Esto es útil para verificar que los correos de DTE se envían correctamente sin afectar a sus clientes reales.
Paso 6: Guardar la Configuración
Guarde los cambios
Una vez completados todos los campos, haga clic en el botón "Cargar certificado" (o "Guardar cambios" si ya existía un certificado previo).
Si la carga es exitosa, verá que:
- La tarjeta de Pruebas cambia su estado a Configurado
- Aparece una barra de información con el nombre del archivo, su tamaño, la fecha de carga y el usuario que lo subió
- Los campos de contraseña muestran un icono verde ✓ indicando que están configurados
Puede actualizar las contraseñas en cualquier momento sin necesidad de volver a cargar el archivo del certificado. Simplemente ingrese la nueva contraseña y haga clic en "Guardar cambios".
Paso 7: Verificar la Conexión con el MH
Revise el estado de la conexión
En la sección "Conexión MH", puede verificar el estado del token de autenticación:
- Token Activo — la conexión está funcionando correctamente
- Por Expirar — el token está próximo a vencer
- Token Expirado — necesita renovar el token
- Desconocido — aún no se ha intentado autenticar
Use el botón "Renovar" para obtener un nuevo token de autenticación. Esto se hace automáticamente cuando Fiscalízame necesita transmitir un DTE, pero puede hacerlo manualmente para verificar que la configuración es correcta.
Si al renovar el token obtiene un error, verifique que las credenciales (contraseña del certificado y contraseña API) sean correctas. Si las cambió en el portal del MH, deberá actualizarlas también en Fiscalízame.
Configuración para Producción
Esta sección aplica únicamente después de completar la certificación con el MH.No configure el ambiente de Producción hasta que haya realizado todas las pruebas requeridas por el Ministerio de Hacienda y recibido la autorización para operar en producción.
- Genere un nuevo certificado de producción desde el portal del MH (el proceso de acreditación se repite para el ambiente de producción)
- Acceda a Configuración de Entornos en Fiscalízame
- Expanda la tarjeta de "Producción" en la sección de Certificados de Firma
- Cargue el certificado de producción y configure las contraseñas correspondientes al ambiente de producción
- Cambie el ambiente activo a "Producción" en la sección de Ambiente MH Activo
Al cambiar a Producción, todos los DTEs emitidos desde Fiscalízame se transmitirán al ambiente real del Ministerio de Hacienda y tendrán validez fiscal. Asegúrese de que toda su configuración (establecimiento, punto de venta, datos fiscales) esté correcta antes de hacer el cambio.
Resumen
ConfiguraciónCampo en FiscalízameOrigenCertificado digitalCertificado (carga de archivo)Archivo .crt descargado del portal MHClave del certificadoContraseña del certificadoClave privada definida en la acreditaciónClave APIContraseña API MHContraseña API definida en la acreditaciónEmail de pruebaEmail de prueba (opcional)Correo para recibir DTEs de prueba
Con la configuración de pruebas completa, el siguiente paso es ejecutar las Pruebas de Certificación con el MH para completar el proceso de certificación requerido por el Ministerio de Hacienda.