Contexto: Permite hacer pruebas controladas en producción sin afectar al ciudadano: un grupo selecto de testers puede iniciar trámites de prueba mientras el trámite permanece oculto al público. Las solicitudes de prueba se identifican con folio “PRUEBA” y no afectan estadísticas.

Audiencia: funcionarios con rol editor, administrador o superadministrador (configuran la whitelist y agregan testers).

Cuándo aplicar: al validar un trámite nuevo o cambios significativos antes del lanzamiento público. La whitelist se activa sobre un trámite ya creado (no es un trámite aparte): se enciende el modo de prueba desde el panel derecho del trámite.

Whitelist

🎬 Video: Whitelist (2) Ver video

Introducción

La WhiteList (o Lista Blanca) es una funcionalidad avanzada del módulo de trámites que permite realizar pruebas controladas en un entorno de producción (el sistema real) sin afectar la operación pública.

A diferencia de un entorno de pruebas aislado (sandbox), la WhiteList permite validar procesos, formularios y flujos de trabajo en condiciones 100% reales antes de lanzarlos masivamente al público.

Su principal valor es la seguridad operativa: permite que un grupo selecto de usuarios (funcionarios o testers) envíen solicitudes de prueba mientras el trámite permanece oculto o inactivo para el resto de la ciudadanía.

Roles involucrados

Tester

El usuario agregado a la WhiteList debe iniciar sesión con su cuenta normal.
Al buscar el trámite, podrá verlo e iniciar la solicitud como si fuera un trámite real.
Los usuarios que no estén en la lista blanca no verán el trámite disponible, ya que la opción “Aceptar solicitudes ciudadanas” está apagada.

Operador

El operador recibe la solicitud en su Bandeja de Entrada.
Diferenciación: el número de folio estará precedido por la etiqueta “PRUEBA” (ej. PRUEBA / TEMPORAL - 001), lo que alerta al funcionario que no es un expediente real.

Características principales

Antes de configurar, conviene entender las reglas de la herramienta:

Característica	Comportamiento
Exclusividad de modo	No se pueden aceptar solicitudes ciudadanas (reales) y solicitudes de prueba al mismo tiempo. Se debe elegir una u otra.
Roles permitidos	Solo usuarios con rol editor, administrador o superadministrador pueden configurar esta opción.
Aislamiento de datos	Las solicitudes de prueba no se reflejan en el Dashboard. Citas, inspecciones o verificaciones generadas en modo prueba no interfieren con los reportes operativos.
Identificación visual	Los trámites generados tendrán un folio distintivo que incluye la palabra “PRUEBA” para que los operadores los reconozcan fácilmente.
Carácter efímero	Si se desactiva la WhiteList, toda la información (solicitudes, citas, inspecciones) generada bajo este modo se elimina automáticamente.

Configuración

Preparación del trámite

Ve al listado de trámites y ubica el proceso que quieres probar.
En la columna de acciones, haz clic en el ícono de lápiz (Editar).
Asegúrate de estar en la pantalla inicial del trámite.

Activación de los interruptores

En el panel derecho de la pantalla del trámite aparecen los tres interruptores que controlan la disponibilidad pública: Publicar trámite, Aceptar solicitudes ciudadanas y Aceptar solicitudes de prueba. Para activar las pruebas, sigue esta secuencia:

Apaga el interruptor “Aceptar solicitudes ciudadanas”.

⚠️ Importante: si este interruptor está encendido, el sistema no te permitirá activar las pruebas. Los dos modos son excluyentes.
Enciende el interruptor “Aceptar solicitudes de prueba”. El texto debajo del interruptor dice: “El funcionario podrá realizar pruebas del trámite.”
Inmediatamente debajo del interruptor activo aparece un botón nuevo: “Agregar usuarios de prueba”.

Panel de configuración con los interruptores de solicitudes ciudadanas y de prueba

Agregar usuarios a la lista blanca

Haz clic en el botón “Agregar usuarios de prueba”. Se abre la ventana “Añadir usuarios a la lista blanca” con el texto “Solo es posible añadir usuarios registrados como ciudadanos.”
La ventana incluye un buscador “Buscar por correo electrónico” con ícono de lupa y un botón “Agregar” a su derecha. Ingresa el correo del tester en el buscador y haz clic en “Agregar” para sumarlo al lote.
La sección “Usuarios añadidos a la lista blanca” muestra la tabla de testers ya cargados, con las columnas Nombre, Correo y Acciones (ícono de papelera roja para eliminar). Cuando no hay testers, dice “No hay datos disponibles”. Tiene paginación al pie (“Filas por página: 10”).
Confirma con “Guardar” o sale con “Cancelar”.

⚠️ Importante: los testers deben estar registrados como ciudadanos en el portal antes de agregarlos. Si no tienen cuenta, el sistema no los encuentra al buscar por correo.

Configuración del folio de prueba

Este paso suele olvidarse, pero es vital para generar el número de expediente correctamente.

En la columna izquierda, busca el ítem “Configuración general” (debajo de “Documento de salida”). Puede aparecer marcado con una cruz roja, indicando que falta configuración.
Ingresa y busca el campo llamado “Pruebas”.
Selecciona el campo de donde se tomará el valor para generar el folio de pruebas.
Haz clic en “Guardar cambios”.

Tips y recomendaciones

Antes de activar

Verifica los usuarios: ten a mano los correos electrónicos de tu equipo de pruebas y asegúrate de que se hayan registrado en el portal ciudadano con antelación.
Completa la ficha: revisa que la “Ficha del trámite” tenga todos los campos llenos, ya que la configuración de folios depende de ello. Ver Configuración ficha del trámite.

Durante las pruebas

Simulación real: instruye a tus testers para que suban documentos reales (o simulados pero con formato correcto) para validar pesos y extensiones de archivos.
Monitoreo: recuerda que aunque estés probando, las notificaciones por correo pueden llegar a los usuarios.

Después de las pruebas

Borrado automático: al desactivar la WhiteList para volver a operar con ciudadanos reales, todo lo creado en la fase de prueba se elimina. No uses la WhiteList para guardar expedientes que quieras conservar como histórico.
Secuencia de salida para volver a producción normal:
1. Desactiva “Aceptar solicitudes de prueba”.
2. Activa “Aceptar solicitudes ciudadanas”.
3. No es necesario borrar manualmente la configuración general; el sistema se ajusta.

Errores comunes y cómo solucionarlos

Error	Causa probable	Solución
No puedo encender el botón de “Solicitudes de prueba”.	El interruptor “Aceptar solicitudes ciudadanas” sigue encendido.	Apaga primero las solicitudes ciudadanas; el sistema no permite ambos modos activos a la vez.
No encuentro al usuario para agregarlo a la lista.	El usuario no está registrado en la plataforma.	Pídele a tu tester que se cree una cuenta en el portal ciudadano antes de intentar agregarlo.
La Configuración general tiene una cruz roja (X).	No seleccionaste el campo para el folio de pruebas.	Ve a Configuración general > Pruebas y selecciona un campo de la lista desplegable.
No aparecen opciones en el campo “Pruebas”.	La ficha del trámite está vacía.	Ve a la edición de la ficha del trámite y completa la información básica.

Glosario técnico

Ficha del trámite: sección informativa del trámite (título, descripción, requisitos) que ve el ciudadano antes de iniciar la solicitud. Es la fuente de datos para el folio de prueba. Ver Configuración ficha del trámite.
Folio: código alfanumérico único que identifica un expediente dentro de la plataforma.
Entorno de producción: el ambiente “real” donde operan los trámites verdaderos. La WhiteList permite probar acá sin “ensuciar” los datos.
Dashboard: panel de control con estadísticas y métricas de uso. Los datos generados por WhiteList no aparecen acá.

Ver también

Antes de probar:

Configuración ficha del trámite — la ficha tiene que estar completa.
Formulario — el formulario tiene que estar armado.
Etapas — el flujo operativo tiene que estar definido.
Documento de salida — el documento final tiene que estar configurado.

Relacionados:

Validación — el flujo que verán los testers operadores.
Borradores — alternativa cuando quieres probar cambios sobre un trámite ya publicado.