Untitled static subpage: Thursday, 25 June 2026, 19:44
Date: 2026-06-25 00:02 Title: Portal Admin y Monitor DTE — Guía de Usuario Type: page Description: Cómo usar el portal de acceso y el monitor de DTEs en tiempo real
Portal Admin y Monitor DTE — Guía de Usuario
Acceso
Desde cualquier navegador, ingresa a:
https://host.kontroles.com/portal
No requiere usuario ni contraseña — el acceso es por URL directa.
Portal de Administración
Al ingresar verás el Portal Kontroles, que es el punto de entrada central para todas las herramientas del sistema.
Estado de servidores
En la parte superior aparecen dos chips de estado:
| Chip | Significa |
|---|---|
● INROCAR OK (verde) |
El servidor INROCAR responde correctamente |
● JAASA OK (verde) |
El servidor JAASA responde correctamente |
● INROCAR ERROR (rojo) |
Hay DTEs en error o el servidor no responde |
Barra de alertas DTE
Si hay facturas electrónicas con error en algún servidor, aparece una barra roja en la parte superior con el texto "Hay DTEs en estado ERROR". Haz clic en ella para ir directamente al Monitor y ver el detalle.
Accesos rápidos
El portal muestra botones para las herramientas disponibles:
| Botón | Accede a |
|---|---|
| Monitor DTE | Monitoreo en tiempo real de DTEs y dispositivos |
| ERP INROCAR | ADempiere (sistema contable/ERP) de INROCAR |
| IA Gerencial INROCAR | Análisis de ventas con inteligencia artificial |
Monitor DTE
Accede desde el Portal → Monitor DTE, o directamente:
https://host.kontroles.com/monitor
El monitor consulta ambos servidores simultáneamente y se actualiza automáticamente cada 30 segundos. Hay un contador regresivo visible.
Tarjeta de servidor
Cada servidor tiene su propia tarjeta. En la parte superior:
| Indicador | Qué muestra |
|---|---|
DB ✓ |
Base de datos conectada |
ERP ✓ |
Aplicación ADempiere corriendo |
| Schema | Nombre del esquema de base de datos activo |
Si alguno aparece en rojo, el servicio correspondiente no está disponible.
Contadores DTE
Muestra cuántos documentos hay en cada estado:
| Estado | Descripción |
|---|---|
| SENT | Documentos enviados y aceptados por el MH |
| PENDING | En espera de ser procesados |
| PROCESSING | El worker los está enviando ahora |
| ERROR | Rechazados o con falla — requieren atención |
Si el contador ERROR es mayor que cero, la tarjeta del servidor se resalta en rojo.
Tabla de errores recientes
Cuando hay errores, aparece una tabla con:
- Documento — número de factura o documento DTE
- Código — código de error del Ministerio de Hacienda
- Mensaje — descripción del error
- Fecha — cuándo ocurrió
Los errores más comunes y su significado:
| Código MH | Causa habitual |
|---|---|
023 |
NIT o NRC del cliente no encontrado en registros MH |
099 |
Error interno MH — reintentar luego |
027 |
Secuencia de DTE duplicada |
Estado del Worker
El worker es el proceso que envía los DTEs al Ministerio de Hacienda.
| Estado | Descripción |
|---|---|
● Activo (verde) |
Procesó DTEs recientemente |
● Inactivo (amarillo) |
Sin actividad en más de 60 minutos |
● Sin actividad (gris) |
Nunca ha procesado DTEs (nuevo) |
Si aparece Inactivo con documentos pendientes, es posible que el worker necesite ser reiniciado (contactar soporte técnico).
Dispositivos autorizados
Cada tarjeta de servidor muestra los dispositivos registrados:
| Columna | Descripción |
|---|---|
| Nombre | Nombre del dispositivo (ej. "Laptop Gerencia") |
| Estado | Activo / Revocado |
| Última actividad | Hace cuántas horas se conectó por última vez |
Administrar dispositivos
Los dispositivos son las computadoras o tablets autorizadas para acceder al ERP desde el navegador.
Crear un nuevo dispositivo
- En el Monitor, busca la sección Dispositivos de la tarjeta del servidor deseado
- Haz clic en + Nuevo
- Ingresa el nombre del dispositivo (ej. "PC Contabilidad") y una nota opcional
- Haz clic en Crear
- Aparecerá un código de activación de 8 caracteres, por ejemplo:
BQNUJYWD
El código se muestra una sola vez. Anótalo o compártelo con el usuario
que activará el dispositivo. El usuario debe ingresar ese código en la
pantalla de activación del ERP (/erp-gate).
Revocar un dispositivo
- Localiza el dispositivo en la lista
- Haz clic en Revocar
- Confirma la acción
El dispositivo revocado pierde acceso inmediatamente. Si el usuario intenta entrar al ERP, será redirigido a la pantalla de activación.
Preguntas frecuentes
¿Cada cuánto se actualiza el monitor?
Automáticamente cada 30 segundos. También puedes hacer clic en
Actualizar ahora en cualquier momento.
¿Qué hago si un DTE aparece en ERROR?
Revisa el código y mensaje de error en la tabla. Si el error es del MH
(código de 3 dígitos), generalmente se debe a datos incorrectos del cliente
en el ERP (NIT, NRC, dirección). Corrige los datos y el worker reintentará
automáticamente.
¿Qué significa "DTEs atascados"?
Son documentos que llevan más de 10 minutos en estado PROCESSING sin avanzar.
Indica que el worker puede haber tenido un problema. Contacta soporte técnico.
¿Por qué el servidor JAASA aparece como "Sin conexión"?
Puede ser un problema de red o que el contenedor esté detenido. Contacta
al administrador del servidor JAASA.
¿El portal funciona desde fuera de la oficina?
Sí, desde cualquier conexión a internet ingresando a https://host.kontroles.com/portal.