Contexto: Listas reutilizables (bibliotecas de datos predefinidos) que se conectan en múltiples partes de la plataforma. Una vez creado un catálogo, se usa como respuesta en formularios (opción múltiple, casillas, lista desplegable, campo de búsqueda) y como filtro en la guía de trámites. Soporta carga manual o masiva por CSV.

Audiencia: funcionarios con rol superadministrador, administrador o editor (los que crean y gestionan catálogos).

Cuándo aplicar: al armar listas de datos que se van a usar en múltiples trámites (dependencias, rubros económicos, barrios, etc.) o como filtros de búsqueda. El catálogo puede crearse desde cero o editarse sobre uno ya cargado.

Catálogos

Introducción

Los catálogos son una funcionalidad esencial dentro de la plataforma diseñada para organizar, agrupar y estandarizar la información. Son bibliotecas de datos predefinidos (listas) que pueden ser reutilizados en múltiples partes del sistema.

En lugar de escribir manualmente las mismas opciones una y otra vez para diferentes trámites (por ejemplo, una lista de barrios o dependencias), creas un catálogo una sola vez y lo conectas donde lo necesites.

Beneficios principales

Beneficio	Qué resuelve
Estandarización	Evita errores de escritura por parte de los ciudadanos al llenar formularios.
Eficiencia	Permite agrupar información del mismo tipo que responde a una misma pregunta en varios trámites.
Experiencia del ciudadano	Facilita la búsqueda a través de filtros en la guía de trámites. Ver Filtros.

Roles involucrados

Superadministrador, administrador y editor: crean, editan y gestionan la carga manual o masiva de datos en los catálogos.
Ciudadano: consume los catálogos al seleccionar opciones en un formulario o al filtrar trámites en la página de inicio o en la guía de trámites.

Configuraciones disponibles

Al crear un catálogo, puedes activar tres casillas de configuración (UI literal):

Casilla	Para qué
Jerárquico	Permite crear múltiples niveles de subcatálogos.
Catálogo Multinivel con Búsqueda	Conecta catálogos y subcatálogos para búsquedas complejas en el formulario.
Catálogo con ids personalizados	Asigna un código de identificación específico a cada ítem (útil para integraciones con otros sistemas).

Crear, vincular y usar un catálogo

Para implementar un catálogo sigues cuatro fases ordenadas: creación, carga de datos, vinculación e implementación.

1. Crear el catálogo

🎬 Video: Crear un catálogo Ver video

Ve a la barra lateral izquierda y haz clic en “Catálogos”.
La vista principal “Catálogos” muestra una tabla con tres columnas: Catálogos (nombre del catálogo), Fecha de creación y Acciones (con dos íconos: ícono de ojo (Ver detalle) y ícono de papelera (Eliminar)). Haz clic en el botón “Agregar nuevo registro” en la esquina superior derecha.

Se abre la pantalla “Detalle” con la sección GENERAL. Completa los campos:

Campo	Qué configura
Nombre	Nombre del catálogo (ej. “Dependencias”, “Rubros económicos”, “Cursos”).
Ruta dinámica	Slug del catálogo. Se autogenera a partir del nombre (ej. nombre “Cursos” → ruta `cursos`). Puede editarse.

Marca las casillas de configuración según la necesidad:
- Jerárquico — para crear múltiples niveles de subcatálogos.
- Catálogo Multinivel con Búsqueda — para búsquedas complejas conectando niveles.
- Catálogo con ids personalizados — para asignar códigos personalizados a cada ítem.
Haz clic en “Guardar”. El catálogo aparece en la tabla principal con su fecha de creación.

2. Cargar datos

Una vez creado el catálogo, está vacío. Hay que llenarlo accediendo a la vista de subcatálogos:

Desde la tabla principal de “Catálogos”, haz clic en el ícono de ojo (Ver detalle) de la columna “Acciones” del catálogo. Se abre la pantalla “Detalle [nombre del catálogo]” con la configuración general.
En la esquina superior derecha de esa pantalla, haz clic en el botón “Ver Listado”. Se abre la vista “Subcatálogos” con una tabla con cuatro columnas: Nombre, Slug, Id y Acciones (íconos de ojo, papelera y copiar).
Haz clic en el botón “Cargar nuevos datos” en la esquina inferior derecha. Se abre la ventana “Subir datos del catálogo” con dos pestañas: “AGREGAR UN TÉRMINO” y “SUBIR LISTA DE TÉRMINOS”.

Método	Cuándo usarlo	Pestaña
Carga manual	Listas cortas (ej. modalidad: presencial, online, híbrido).	AGREGAR UN TÉRMINO
Carga masiva CSV	Grandes volúmenes (ej. calles de un municipio, códigos postales).	SUBIR LISTA DE TÉRMINOS

Carga manual — pestaña “AGREGAR UN TÉRMINO”

La pestaña por defecto. Completa los campos:

Campo	Qué configura
Valor de la opción *	Texto que ve el ciudadano (ej. “Seguridad - Ojos en Alerta”).
Ruta dinámica de la opción *	Slug del término. Se usa internamente para identificar la opción (ej. `seguridadOjosEnAlerta`).
Icono	Código del ícono asociado al término (ej. `mdi-eye`). El campo muestra `mdi-account` como texto guía. Hay un ícono de vista previa al lado del campo y un link “Lista de iconos” debajo para consultar los códigos disponibles.

Confirma con “Guardar” o sale con “Cancelar”.

Pestaña Agregar un término con campos del formulario

Carga masiva CSV — pestaña “SUBIR LISTA DE TÉRMINOS”

🎬 Video: Carga de catálogos Ver video

La pestaña muestra una sección “Instrucciones” con tres reglas para el archivo:

El archivo debe ser de tipo csv.
El archivo puede tener 3 columnas, sin ningún espacio y con el siguiente orden: Nombre, Icono, Id Personalizado.
El campo Nombre es obligatorio y se debe completar toda la columna. Los campos Icono e Id Personalizado no son obligatorios.

Columna	Obligatoria	Detalle
Nombre	Sí	Tiene que estar completo en todas las filas.
Icono	No	Código del ícono (formato `mdi-*`).
Id Personalizado	No	Código del ítem para integraciones externas.

Prepara el archivo CSV cumpliendo las reglas anteriores.
En la pestaña “SUBIR LISTA DE TÉRMINOS”, en el campo obligatorio “Subir archivo” *, adjunta el archivo desde el ícono de clip.
Confirma con “Guardar” o sale con “Cancelar”.

Pestaña Subir lista de términos con instrucciones y campo Subir archivo

ℹ️ Detalle de un término ya cargado: desde la tabla de Subcatálogos, hacer clic en el ícono de ojo (Ver detalle) abre la pantalla “Detalle” con los campos Valor de la opción, Ruta dinámica de la opción, Id (con ícono de copiar al lado), Icono (con vista previa + link “Lista de iconos”) y la casilla “Jerárquico”. Permite editar y volver a guardar.

⚠️ Después de cargar datos (manual o CSV), vas a ver un aviso indicando que tienes que sincronizar. Vuelve a la página inicial de catálogos y haz clic en el botón “Sincronizar” para que los cambios se reflejen.

Aviso de sincronización pendiente

Botón Sincronizar en la página principal

3. Vincular al módulo de trámites

🎬 Video: Vinculación de catálogos al módulo de trámites Ver video

Crear el catálogo no lo hace visible automáticamente en los trámites. Tienes que conectarlo.

Ve a la barra lateral, selecciona “Ventanilla Digital” y luego “Configuración”.
Ve a la pestaña “Catálogos”.
Vas a ver una lista de catálogos ya vinculados. Para añadir uno nuevo, haz clic en “Agregar catálogo”.
Selecciona el catálogo creado de la lista desplegable y haz clic en “Agregar”.

4. Implementar el catálogo

Ya creado y vinculado, puedes usarlo de dos formas.

Como respuesta en un formulario

🎬 Video: Cómo seleccionar un catálogo como respuesta en el formulario Ver video

Permite que el ciudadano elija una opción de tu lista al llenar un trámite.

En el formulario, agrega una pregunta tipo Opción múltiple, Casilla de verificación o Lista desplegable. Ver Tipos de preguntas.
Activa la casilla “Usar catálogo”.
Selecciona el catálogo deseado de la lista (ej. “Unidad administrativa”).

Como filtro en la guía de trámites

🎬 Video: Cómo agregar un catálogo como filtro Ver video

Ayuda al ciudadano a encontrar trámites más rápido en la página de inicio.

Ve a “Filtros” en la barra lateral izquierda.
Haz clic en “Agregar filtro”.
Selecciona los catálogos que quieres usar como criterios de búsqueda (ej. “Rubros económicos”) y guarda. Ver Filtros.

Tips y recomendaciones

Antes de empezar

Planificación: evalúa si realmente necesitas un catálogo. ¿Esa información se va a usar en más de un trámite? Si es un dato único para un solo formulario, quizás no valga la pena crear un catálogo.
Limpieza de datos: si vas a usar un CSV, revisa que no tenga caracteres extraños y que la columna Nombre esté impecable antes de subirla.

Durante la configuración

Economía de recursos: vincula al módulo de trámites solo aquellos catálogos que sean necesarios.
Íconos: usa la lista de íconos provista en una pestaña aparte para copiar y pegar los códigos correctamente durante la carga manual.

Errores comunes y cómo evitarlos

Error	Causa probable	Solución
No veo mis opciones en el formulario.	Falta de sincronización.	Ve a la página principal de catálogos y presiona “Sincronizar”.
El catálogo no aparece para seleccionarlo en el formulario.	No está vinculado al módulo.	Asegúrate de haber ido a Ventanilla Digital > Configuración > Catálogos y haberlo agregado allí.
Error al subir el archivo CSV.	Formato de columnas incorrecto.	Verifica que el CSV tenga exactamente el orden: Nombre, Icono, Id Personalizado. La columna Nombre es obligatoria.
No puedo agregar subcatálogos.	Configuración inicial incorrecta o no guardada.	Verifica haber marcado Jerárquico al crear el catálogo. La opción de agregar subcatálogos aparece después de guardar por primera vez.

Glosario técnico

CSV: formato de archivo de texto simple donde los datos están separados por comas. Estándar para mover grandes cantidades de datos entre sistemas.
Slug / Ruta dinámica: versión amigable del nombre del catálogo o del término, sin espacios ni acentos, usada en URLs e integraciones. En el detalle del catálogo aparece como “Ruta dinámica”; en el detalle de cada término aparece como “Ruta dinámica de la opción”; en la tabla de subcatálogos aparece como columna “Slug”. Se autogenera del nombre y puede editarse.
Subcatálogo: elemento dentro de un catálogo. La vista “Subcatálogos” lista los términos cargados (con columnas Nombre / Slug / Id / Acciones).
Término: sinónimo de subcatálogo en el contexto de carga (la pestaña se llama “AGREGAR UN TÉRMINO” y los archivos CSV son “SUBIR LISTA DE TÉRMINOS”).
Id Personalizado: código opcional asignado a un término para integraciones con sistemas externos. Distinto del Id autogenerado por la plataforma.
Jerárquico: propiedad que permite que un dato tenga “hijos” o subcategorías (ej. deportes → fútbol, tenis).
Sincronización: proceso técnico de actualización de la base de datos para que los nuevos registros (o ediciones) sean visibles en el front-end.

Ver también

Antes de crear catálogos:

Configuración general — define los identificadores y reglas globales primero.

Después de crear catálogos:

Tipos de preguntas — usa los catálogos como respuestas en formularios.
Filtros — usa los catálogos como filtros en la guía de trámites.
Apariencia — usa los filtros (basados en catálogos) en la home pública.

Relacionados:

Registro de cambios — audita cambios en catálogos.