Catálogos de Productos

Descripción general

La pantalla Catálogos permite gestionar los catálogos que agrupan productos y servicios en el módulo de Sistema de Logística Hospitalaria. Cada catálogo se identifica por un código, nombre, tipo (Producto o Servicio) y opcionalmente un rango de fechas de vigencia (caducidad).

---

Acceso

Navegue a: Logística → Módulos → Catálogos de Productos

Breadcrumb: Logistica > Catalogo

---

Vista principal — Tabla de catálogos

Al ingresar se muestra el título "Catalogos" con el subtítulo "Muestra el listado y las herramientas para gestionar el catalogo", seguido de una tabla de datos (p-table) con carga diferida (lazy loading) y paginación del lado del servidor.

Columnas de la tabla

Columna	Campo	Ancho	Ordenable	Descripción
codigo	codigo	150px	Sí	Código del catálogo.
nombre	nombre	auto	Sí	Nombre del catálogo.
Tipo	tipo	auto	Sí	Tipo de catálogo: PRODUCTO o SERVICIO.
Fecha Inicio	fecha_inicio	auto	Sí	Fecha de inicio de vigencia en formato DD/MM/YYYY. Vacío si no tiene caducidad.
Fecha Fin	fecha_fin	auto	Sí	Fecha de fin de vigencia en formato DD/MM/YYYY. Vacío si no tiene caducidad.
Acciones	—	80px	No	Ícono de puntos suspensivos (pi pi-ellipsis-h) para abrir el menú contextual.

Paginación

La tabla carga 50 registros por página desde el servidor. Controles de navegación:

Botón	Ícono	Acción
Primera página	pi pi-angle-double-left	Ir a la primera página.
Página anterior	pi pi-angle-left	Retroceder una página.
Selector de página	Desplegable (p-dropdown)	Seleccionar página específica ("X de Y").
Página siguiente	pi pi-angle-right	Avanzar una página.
Última página	pi pi-angle-double-right	Ir a la última página.

---

Barra de menú

Opción	Submenú	Ícono	Descripción
Nuevo	Catalogo	pi pi-plus	Abre el formulario para crear un nuevo catálogo.
Actualizar	—	pi pi-refresh	Recarga la lista de catálogos desde el servidor.

---

Menú contextual

Al hacer clic derecho sobre una fila o en el ícono de puntos suspensivos:

Opción	Ícono	Descripción
Detalle	pi pi-folder	Navega a la pantalla de detalles según el tipo del catálogo. Si es PRODUCTO, navega a Productos Principal. Si es SERVICIO, navega a Servicios Detalles.
Editar	pi pi-pencil	Abre el formulario de edición con los datos del catálogo seleccionado.
Eliminar	pi pi-times	Abre el diálogo de confirmación para eliminar el catálogo.

---

Formulario de creación / edición

Al seleccionar Nuevo > Catalogo desde la barra de menú, o Editar desde el menú contextual, se abre un diálogo a pantalla completa (p-dialog) con el formulario.

Encabezado del diálogo

• Título del diálogo: "Catalogo de producto"
• Breadcrumb: Inicio > Logistica > Catalogos
• Título del formulario: "Nuevo catalogo"
• Subtítulo: "Aqui puede editar la lista de catalogos"
• Diálogo a pantalla completa, no arrastrable ni redimensionable.

Sección — Detalles de catálogo

Nota del formulario: "Se tiene que rellenar los campos que contengan (*) obligatoriamente que se requiere para el registro."

Campo	Tipo	Obligatorio	Ancho	Tooltip	Mensaje de error	Descripción
Tipo	Botones de radio (p-radioButton)	Sí	12/12 columnas	—	—	Selecciona el tipo de catálogo. Opciones: PRODUCTO (seleccionado por defecto) y SERVICIO.
Codigo	Texto (pInputText)	Sí	4/12 columnas	"Ingrese el codigo de registro"	"* Ingrese codigo valido"	Código identificador del catálogo.
Nombre	Texto (pInputText)	Sí	8/12 columnas	"Ingrese el nombre"	"* Obligatorio"	Nombre del catálogo.
Configurar caducidad?	Interruptor (p-inputSwitch)	No	12/12 columnas	—	—	Activa o desactiva los campos de fecha de vigencia. Por defecto: desactivado.
Fecha Inicio	Calendario (p-calendar)	Condicional	6/12 columnas	"Seleccione una fecha de inicio que no pase al final"	"* Obligatorio"	Fecha de inicio de vigencia. Solo visible y obligatorio cuando el interruptor de caducidad está activado. Formato: dd/mm/yyyy.
Fecha Fin	Calendario (p-calendar)	Condicional	6/12 columnas	"Seleccione una fecha final que no sea menor a la fecha de inicio"	"* Obligatorio"	Fecha de fin de vigencia. Solo visible y obligatorio cuando el interruptor de caducidad está activado. Formato: dd/mm/yyyy.

Comportamiento del interruptor "Configurar caducidad?"

• Desactivado (por defecto): Los campos Fecha Inicio y Fecha Fin están deshabilitados y vacíos. No son obligatorios.
• Activado: Los campos Fecha Inicio y Fecha Fin se habilitan y se vuelven obligatorios. Debe ingresar ambas fechas.

Botones del formulario

Botón	Ícono	Acción
Cancelar	pi pi-times	Cierra el diálogo sin guardar cambios.
Guardar	pi pi-check (o pi pi-spin pi-spinner mientras guarda)	Valida el formulario y guarda el catálogo. Se deshabilita durante el proceso de guardado.

---

Flujo de creación

---

Flujo de edición

---

Eliminación de catálogos

Al seleccionar Eliminar desde el menú contextual, se abre un diálogo de confirmación.

Diálogo de confirmación

• Título: "Confirmacion"
• Ancho: 50% de la pantalla
• Ícono: pi pi-exclamation-triangle (tamaño 2rem)
• Mensaje: "Estas seguro de proceder con la eliminacion?"
• Modal: Sí (fondo oscurecido)

Botón	Ícono	Acción
No	pi pi-times	Cierra el diálogo sin eliminar.
Si	pi pi-check (o pi pi-spin pi-spinner mientras elimina)	Ejecuta la eliminación enviando DELETE al endpoint.

Tras confirmar, se muestra la notificación "Eliminado." (tipo éxito, duración 5 segundos).

---

Validaciones del formulario

Escenario	Mensaje	Tipo	Duración
Formulario inválido al guardar	"Revise bien, hay formularios por validar."	Error	5 segundos
Fecha fin anterior a fecha inicio	"La fecha fin no puede ser menor a la fecha inicio."	Advertencia	5 segundos
Catálogo creado exitosamente	"Registro exitoso."	Éxito	5 segundos
Catálogo actualizado exitosamente	"Actualizacion exitosa."	Éxito	5 segundos
Catálogo eliminado exitosamente	"Eliminado."	Éxito	5 segundos

---

Errores de servidor

Código HTTP	Mensaje mostrado
400	"Error de estructura de envio de datos. ERROR 400"
401 / 402 / 403	Muestra el mensaje de error devuelto por el servidor.
404	"No se encontro el servidor de respuestas, consulte con el Administrador. ERROR 404"
500	"Error interno del servidor. ERROR 500"
Otro	"Error 404 consulte con su admin."

Todos los errores se muestran como notificación de tipo error con duración de 5 segundos.

---

Endpoints de la API

Método	Endpoint	Descripción
GET	/v2.0.1/erpx/logistica/catalogos/?search=&from=\{desde\}&size=\{tamaño\}	Obtiene la lista de catálogos con paginación.
GET	/v2.0.1/erpx/logistica/catalogos/\{id\}	Obtiene un catálogo por su ID.
POST	/v2.0.1/erpx/logistica/catalogos/	Crea un nuevo catálogo.
PUT	/v2.0.1/erpx/logistica/catalogos/\{id\}	Actualiza un catálogo existente.
DELETE	/v2.0.1/erpx/logistica/catalogos/\{id\}	Elimina un catálogo.

---

Problemas comunes

Problema	Causa	Solución
No se muestran catálogos en la tabla	No hay catálogos registrados o error de conexión	Verifique la conexión de red. Use Actualizar en la barra de menú.
Error "La fecha fin no puede ser menor a la fecha inicio."	La fecha de fin de vigencia es anterior a la fecha de inicio	Corrija las fechas para que la fecha fin sea posterior a la fecha inicio.
Los campos de fecha están deshabilitados	El interruptor "Configurar caducidad?" está desactivado	Active el interruptor para habilitar los campos de fecha.
La opción "Detalle" no abre nada	Error de navegación o el módulo de destino no está cargado	Verifique que tiene acceso al módulo correspondiente (productos o servicios).

---

Páginas relacionadas

• Productos Principal — Detalle de productos dentro de un catálogo.
• Servicios — Catálogo de servicios.
• Servicios Detalles — Detalle de servicios dentro de un catálogo.
• Categorías — Categorías de productos y servicios.