Catálogos de Imágenes

Descripción general

El módulo Catálogos de Imágenes permite gestionar los procedimientos de imagen diagnóstica que pertenecen a un catálogo específico de tipo IMAGENES. Los procedimientos se organizan opcionalmente dentro de grupos (familias) jerárquicos, y se muestran en una tabla plana (p-table) con paginación del lado del servidor.

Se accede a esta vista al hacer clic en Detalle sobre un catálogo de tipo IMAGENES en la pantalla de Catálogos. El sistema navega a la ruta /salud/catalogos-procedimientos-imagenes-detalles/\{id\}, donde \{id\} corresponde al identificador del catálogo seleccionado.

---

Acceso al módulo

Ruta de navegación: Salud → Catálogos procedimiento imagen detalles

La pantalla muestra una barra de navegación (breadcrumb) en la parte superior:

Nivel	Texto	Acción al hacer clic
1	Salud	Redirige a /salud
2	Catalogos procedimiento imagen detalles	Sin acción (página actual)

Título y descripción

• Título: Catalogos procedimientos imagen detalle
• Descripción: "Muestra el listado y las herramientas para gestionar los catalogos procedimientos imagen detalle"

---

Barra de herramientas

La parte superior derecha de la cabecera incluye tres botones de acción:

Botón	Icono	Estilo	Descripción
Actualizar	pi pi-refresh	Outlined	Recarga la tabla con los datos más recientes del servidor
Grupos	—	Primary	Abre el diálogo de gestión de grupos del catálogo
Nuevo Proc. Img.	pi pi-plus	Primary	Abre el diálogo para crear un nuevo procedimiento de imagen

---

Barra de búsqueda y filtros

Debajo de la barra de herramientas se encuentra un componente de búsqueda avanzada (app-search-list) que permite filtrar los procedimientos mostrados en la tabla.

Elementos de la barra de búsqueda

Elemento	Componente	Descripción
Campo de búsqueda	input text con ícono pi pi-search	Permite buscar por texto libre. La búsqueda se aplica al presionar el botón Buscar
Chips de filtros	p-chip	Muestra los filtros activos como etiquetas removibles. Cada chip puede eliminarse haciendo clic en la × o editarse haciendo clic sobre el texto
Agregar filtro	Botón pi pi-filter	Abre un panel superpuesto (p-overlayPanel) para configurar un nuevo filtro
Quitar filtros	Botón pi pi-filter-slash	Elimina todos los filtros activos y limpia el campo de búsqueda
Buscar	Botón pi pi-search	Ejecuta la búsqueda con el texto y los filtros configurados

Panel de filtro (OverlayPanel)

Al hacer clic en Agregar filtro, se despliega un panel con ancho de 350px y los siguientes campos:

#	Campo	Componente	Obligatorio	Descripción
1	Filtro	p-dropdown	Sí	Tipo de filtro a aplicar. Opciones disponibles: GRUPO
2	Grupo	p-treeSelect	Condicional	Selector de árbol jerárquico de grupos. Solo visible cuando el filtro seleccionado es GRUPO. Obligatorio en ese caso

Botón del panel

Botón	Acción
Guardar	Aplica el filtro y cierra el panel. El filtro aparece como chip en la barra de búsqueda. Si ya existe un filtro del mismo tipo, se reemplaza

---

Vista principal — Tabla de procedimientos

La vista principal presenta un p-table con carga diferida (lazy loading) que muestra los procedimientos de imagen del catálogo seleccionado.

Indicador de registros

Sobre la tabla se muestra un texto informativo con el formato:

Mostrando página {N} con {X} registros de {Y} entradas

Columnas de la tabla

#	Columna	Campo de datos	Ancho	Descripción
1	GRUPO	grupo	125px (fijo)	Muestra la jerarquía de grupos del procedimiento, concatenando los nombres de padres con el separador /. Ejemplo: Radiología / Tórax
2	CÓDIGO	codigo	125px (fijo)	Código identificador del procedimiento de imagen
3	NOMBRE	nombre	Auto	Nombre descriptivo del procedimiento
4	DESCRIPCIÓN	descripcion	Auto	Descripción detallada del procedimiento
5	CPT	codigo_cpt	100px (fijo)	Código CPT (Current Procedural Terminology) asociado al procedimiento
6	SEGUS	codigo_segus	100px (fijo)	Código SEGUS asociado al procedimiento
7	Acciones	—	60px (fijo)	Botón de menú contextual (pi pi-ellipsis-h)

Menú contextual

Al hacer clic en el botón de acciones (pi pi-ellipsis-h) o hacer clic derecho sobre una fila, se despliega un menú contextual con las siguientes opciones:

Opción	Icono	Acción
Editar	pi pi-pencil	Abre el diálogo de edición del procedimiento con los datos precargados
Eliminar	pi pi-times	Abre el diálogo de confirmación de eliminación

Paginación

La tabla incluye paginación personalizada en la parte inferior con los siguientes controles:

Control	Icono	Descripción
Primera página	pi pi-angle-double-left	Va a la primera página. No hace nada si ya está en la primera
Página anterior	pi pi-angle-left	Retrocede una página. No hace nada si ya está en la primera
Selector de página	p-dropdown	Muestra la página actual en formato \{número\} de \{total\}. Permite seleccionar cualquier página directamente. Incluye búsqueda habilitada ([filter]="true")
Página siguiente	pi pi-angle-right	Avanza una página. No hace nada si ya está en la última
Última página	pi pi-angle-double-right	Va a la última página. No hace nada si ya está en la última

El tamaño de página por defecto es de 50 registros.

---

Crear procedimiento de imagen

Se accede desde el botón Nuevo Proc. Img. en la barra de herramientas.

Diálogo

Se abre un diálogo a pantalla completa con las siguientes propiedades:

Propiedad	Valor
Título	Producto
Tamaño	Pantalla completa (width: 100%, height: 100%, top: 0, bottom: 0, maxHeight: 100%)
Arrastrable	No ([draggable]="false")
Redimensionable	No ([resizable]="false")
Modal	No ([modal]="false")
Breakpoints	653px: 100vw, 960px: 100vw

Encabezado del diálogo

• Breadcrumb: Salud > Catalogos procedimiento imagen detalles > Nuevo
• Título: Nuevo Procedimiento imagen
• Descripción: "Aqui puede editar la lista de catalogos de procedimiento imagen detalle"

Indicador de carga

Mientras se cargan los datos (solo en modo edición), el diálogo muestra:

• Texto: "Cargando sus datos"
• Ícono: Spinner animado (pi pi-spin pi-spinner)

Sección de formulario

El formulario tiene el subtítulo:

• Título de sección: Datos generales de imagen
• Descripción: "Se tiene que rellenar los campos que contengan () obligatoriamente que se requiere para el registro."*

Campos del formulario

#	Campo	Componente	Obligatorio	Tooltip	Mensaje de error	Ancho	Descripción
1	Grupo / Familia	p-treeSelect	No	"Si dese a gregar a un grupo/familia seleccione"	" Obligatorio"*	col-12	Selector de árbol jerárquico que muestra los grupos disponibles del catálogo. Permite seleccionar el grupo padre al que pertenecerá el procedimiento. Incluye búsqueda habilitada y opción de limpiar selección
2	Codigo	input text	Sí	"Ingrese el código"	" Obligatorio"*	col-4	Código identificador único del procedimiento de imagen
3	Nombre	input text	Sí	"Ingrese el nombre"	" Obligatorio"*	col-8	Nombre descriptivo del procedimiento de imagen
4	Descripción	input text	No	"Ingrese la descripción"	—	col-12	Descripción detallada del procedimiento
5	Código CPT	input text	No	"Ingrese código CPT"	—	col-4	Código CPT (Current Procedural Terminology) asociado al procedimiento
6	Código Segus	input text	No	"Ingrese código SEGUS"	—	col-8	Código SEGUS asociado al procedimiento

Botones de acción

Botón	Icono	Estilo	Acción
Cancelar	pi pi-times	p-button-text text-default	Cierra el diálogo sin guardar cambios
Guardar	pi pi-check (o spinner mientras procesa)	Primary	Valida el formulario y guarda el nuevo procedimiento. Se deshabilita durante el envío

Proceso de guardado

---

Editar procedimiento de imagen

Se accede desde el menú contextual de un procedimiento → Editar.

Diálogo

Se abre el mismo diálogo a pantalla completa con el título "Producto". Los campos se precargan con los datos actuales del procedimiento seleccionado:

• Grupo / Familia: Se precarga con el grupo padre actual (si tiene). El sistema busca el grupo en la estructura de árbol para seleccionarlo correctamente en el p-treeSelect.
• Codigo: Se precarga con el código actual.
• Nombre: Se precarga con el nombre actual.
• Descripción: Se precarga con la descripción actual.
• Código CPT: Se precarga con el código CPT actual.
• Código Segus: Se precarga con el código SEGUS actual.

Proceso de actualización

---

Gestión de grupos

Los grupos permiten organizar los procedimientos de imagen en una estructura jerárquica de carpetas. Se gestionan desde dos pantallas: el listado de grupos y el formulario de creación/edición de grupo.

Listado de grupos

Se accede desde el botón Grupos en la barra de herramientas.

Diálogo

Se abre un diálogo a pantalla completa con las siguientes propiedades:

Propiedad	Valor
Título	Grupos
Tamaño	Pantalla completa
Arrastrable	No
Redimensionable	No
Modal	No

Encabezado del diálogo

• Breadcrumb: Inicio > Salud > Catalogos procedimientos imagen detalle
• Título: Grupos
• Descripción: "Aqui puede editar la lista de grupos"

Barra de herramientas del diálogo

Botón	Icono	Descripción
Nuevo Grupo	pi pi-plus	Abre el formulario de creación de un nuevo grupo

Tabla de grupos (TreeTable)

Los grupos se muestran en un componente p-treeTable que permite visualizar la jerarquía de grupos con expansión por niveles.

Columnas:

#	Columna	Descripción
1	Grupos	Nombre del grupo con icono de expansión (p-treeTableToggler) para navegar la jerarquía
2	Acciones	Dos botones de acción por fila (ancho fijo 60px)

Botones de acción por fila:

Botón	Icono	Estilo	Acción
Editar	pi pi-pencil	Primary	Abre el formulario de edición del grupo con datos precargados
Eliminar	pi pi-trash	Danger	Abre el diálogo de confirmación de eliminación del grupo

Botón de pie

Botón	Acción
Cancelar	Cierra el diálogo de grupos y notifica al componente padre para actualizar la lista de procedimientos

---

Crear grupo

Se accede desde:

• Diálogo de grupos → botón Nuevo Grupo

Diálogo

Se abre un diálogo a pantalla completa con el título "Nuevo Grupo".

Encabezado del diálogo

• Breadcrumb: Inicio > Logistica > Catalogos productos detalle
• Título: Nuevo grupo
• Descripción: "Aqui puede editar la lista de grupos"

Campos del formulario

#	Campo	Componente	Obligatorio	Tooltip	Mensaje de error	Ancho	Descripción
1	Grupo	p-treeSelect	No	"Seleccione el grupo si desea asignarlo"	" Obligatorio"*	col-12	Selector de árbol que muestra los grupos existentes. Permite seleccionar un grupo padre para crear un sub-grupo. Si se deja vacío, el grupo se crea en el nivel raíz
2	Codigo	input text	Sí	"Ingrese el código"	" Obligatorio"*	col-4	Código identificador único del grupo
3	Nombre	input text	Sí	"Ingrese el nombre del grupo"	" Obligatorio"*	col-8	Nombre descriptivo del grupo
4	Descripción	input text	No	"Ingrese la descripción del grupo"	—	col-12	Descripción detallada del grupo

Botones de acción

Botón	Icono	Estilo	Acción
Cancelar	pi pi-times	p-button-text text-default	Cierra el diálogo sin guardar cambios
Guardar	pi pi-check (o spinner mientras procesa)	Primary	Valida el formulario y guarda el nuevo grupo. Se deshabilita durante el envío

Proceso de guardado

---

Editar grupo

Se accede desde el botón de edición (pi pi-pencil) en la fila del grupo dentro del listado de grupos.

Diálogo

Se abre el mismo diálogo a pantalla completa con el título "Nuevo Grupo" (el título no cambia en modo edición). Los campos se precargan con los datos actuales del grupo seleccionado:

• Grupo: Se precarga con el grupo padre actual (si tiene). El sistema busca el grupo padre en la estructura de árbol para seleccionarlo correctamente.
• Codigo: Se precarga con el código actual.
• Nombre: Se precarga con el nombre actual.
• Descripción: Se precarga con la descripción actual.

Proceso de actualización

---

Eliminar elementos

Eliminar procedimiento de imagen

Se accede desde el menú contextual del procedimiento → Eliminar.

Eliminar grupo

Se accede desde el botón de eliminación (pi pi-trash) en la fila del grupo dentro del listado de grupos.

---

Endpoints del módulo

Procedimientos de imagen

Método	Endpoint	Descripción
GET	/v2.0.1/erpx/salud/catalogos-procedimientos-imagenes	Obtener lista paginada de procedimientos de imagen del catálogo
GET	/v2.0.1/erpx/salud/catalogos-procedimientos-imagenes/\{id\}	Obtener datos de un procedimiento por ID
POST	/v2.0.1/erpx/salud/catalogos-procedimientos-imagenes	Crear nuevo procedimiento de imagen
PUT	/v2.0.1/erpx/salud/catalogos-procedimientos-imagenes/\{id\}	Actualizar procedimiento de imagen existente
DELETE	/v2.0.1/erpx/salud/catalogos-procedimientos-imagenes/\{id\}	Eliminar procedimiento de imagen

Grupos

Método	Endpoint	Descripción
GET	/v2.0.1/erpx/salud/catalogos-procedimientos-grupos	Obtener grupos del catálogo
GET	/v2.0.1/erpx/salud/catalogos-procedimientos-grupos/\{id\}	Obtener datos de un grupo por ID
POST	/v2.0.1/erpx/salud/catalogos-procedimientos-grupos	Crear nuevo grupo
PUT	/v2.0.1/erpx/salud/catalogos-procedimientos-grupos/\{id\}	Actualizar grupo existente
DELETE	/v2.0.1/erpx/salud/catalogos-procedimientos-grupos/\{id\}	Eliminar grupo

Autenticación

Todas las peticiones incluyen las siguientes cabeceras HTTP:

Cabecera	Valor
accept	application/json
Authorization	Bearer \{token\}
enterprise-id	ID de la empresa del usuario autenticado

---

Manejo de errores

Código HTTP	Mensaje mostrado
400	"Error de estructura de envio de datos. ERROR 400"
401, 402, 403	Concatenación de los mensajes de error del servidor. Si el error es de seguridad (códigos 29000-29999), el sistema redirige automáticamente al servidor de autenticación
404	"No se encontró el servidor de respuestas, consulte con el Administrador. ERROR 404"
500	"Error interno del servidor. ERROR 500"
Otro	"Error 404 consulte con su admin."

Todas las notificaciones de error tienen una duración de 5 segundos.

---

Problemas comunes

Problema	Causa probable	Solución
No se muestran datos en la tabla	El catalogo_producto_id de la URL no corresponde a un catálogo válido o no tiene procedimientos de imagen asociados	Verificar que se accede desde un catálogo de tipo IMAGENES válido con procedimientos registrados
Al guardar aparece "Hay campos por validar revise"	Los campos obligatorios Codigo o Nombre están vacíos	Completar todos los campos marcados con asterisco (*)
El selector de Grupo/Familia no muestra opciones	No se han creado grupos en este catálogo	Crear al menos un grupo desde el botón Grupos antes de intentar asignar un procedimiento a un grupo
La columna GRUPO muestra valores vacíos	El procedimiento no tiene un grupo asignado	Editar el procedimiento y asignarle un grupo desde el campo Grupo / Familia
Al buscar no se encuentran resultados	El texto de búsqueda no coincide con ningún registro, o los filtros activos son demasiado restrictivos	Verificar el texto ingresado. Usar el botón Quitar filtros para limpiar todos los filtros y probar de nuevo
El filtro de grupo no muestra opciones en el TreeSelect	No hay grupos creados para este catálogo	Crear grupos primero desde el botón Grupos en la barra de herramientas
Error al eliminar un grupo	El grupo contiene sub-grupos o procedimientos hijos	Eliminar primero todos los elementos hijos del grupo antes de eliminar el grupo padre
El sistema redirige a la pantalla de login	La sesión ha expirado o el token de seguridad es inválido	Iniciar sesión nuevamente. El sistema redirige automáticamente de vuelta a la pantalla actual
El diálogo muestra "Cargando sus datos" indefinidamente	Error al consultar el procedimiento o grupo por ID durante la edición	Verificar la conexión al servidor y cerrar/reabrir el diálogo
La paginación no muestra el total correcto	Se aplicó un filtro que reduce los resultados	El indicador de registros muestra el total filtrado. Use Quitar filtros para ver todos los registros

---

Páginas relacionadas

• Catálogos — Gestión general de catálogos médicos (Imágenes y Laboratorios).
• Catálogos de Laboratorios — Gestión de catálogos de laboratorios.