Davix ERPXProcedimientos Perfiles
Gestión de perfiles de procedimientos de laboratorio en el módulo de Salud de Davix ERPX.
Descripción general
La pantalla Catálogos procedimientos perfiles permite crear y administrar perfiles que agrupan varios procedimientos de laboratorio bajo un solo código y nombre. Cada perfil tiene un precio calculado automáticamente como la suma de los precios unitarios de los procedimientos que lo componen. Esta funcionalidad es útil para definir paquetes de exámenes de laboratorio que se solicitan frecuentemente de forma conjunta.
Ruta de navegación: Inicio → Salud → Catálogos procedimientos perfiles
Vista principal (listado de perfiles)
Al ingresar a la pantalla se muestra una tabla paginada con todos los perfiles registrados.
Encabezado
| Elemento | Descripción |
|---|---|
| Título | "Catalogos procedimientos perfiles" |
| Subtítulo | "Muestra el listado y las herramientas para gestionar los catalogos procedimientos perfiles" |
| Botón "Actualizar" | Icono pi pi-refresh. Recarga la tabla con los datos más recientes del servidor. |
| Botón "Nuevo perfil" | Icono pi pi-plus. Abre el diálogo de creación de un nuevo perfil. |
Indicador de paginación
Se muestra el texto: "Mostrando página {N} con {X} registros de {T} entradas", donde N es la página actual, X es la cantidad de registros visibles y T es el total de registros.
Columnas de la tabla
| Columna | Ancho | Descripción |
|---|---|---|
| CÓDIGO | 125px fijo | Código identificador del perfil. |
| NOMBRE | Flexible | Nombre descriptivo del perfil. |
| PRECIO | Flexible | Precio unitario del perfil (precio_unitario). Muestra 0 si no tiene precio asignado. |
| Acciones | 60px fijo | Icono de tres puntos (pi pi-ellipsis-h) que abre el menú contextual. |
Menú contextual
Se activa haciendo clic derecho sobre una fila o haciendo clic en el icono de tres puntos en la columna Acciones.
| Opción | Icono | Descripción |
|---|---|---|
| Editar | pi pi-pencil | Abre el diálogo de edición del perfil seleccionado con sus datos precargados. |
| Eliminar | pi pi-trash | Abre el diálogo de confirmación para eliminar el perfil seleccionado. |
Paginación
La paginación se controla mediante botones de navegación y un selector de página:
| Control | Icono | Descripción |
|---|---|---|
| Primera página | pi pi-angle-double-left | Navega a la primera página. Se deshabilita si ya está en la primera página. |
| Página anterior | pi pi-angle-left | Retrocede una página. Se deshabilita si ya está en la primera página. |
| Selector de página | Dropdown | Muestra la página actual en formato "N de T". Permite seleccionar cualquier página directamente. Incluye filtro por número. |
| Página siguiente | pi pi-angle-right | Avanza una página. Se deshabilita si ya está en la última página. |
| Última página | pi pi-angle-double-right | Navega a la última página. Se deshabilita si ya está en la última página. |
El tamaño de página es de 50 registros por defecto.
Crear / editar perfil
Al hacer clic en "Nuevo perfil" o en la opción "Editar" del menú contextual, se abre un diálogo a pantalla completa con el título "Perfil".
Al abrir el diálogo, el sistema carga los parámetros de configuración necesarios y muestra un indicador de carga ("Cargando sus datos" con un spinner) hasta que todos los datos estén listos.
Sección: Detalles del perfil
Se muestra el encabezado "Detalles del perfil" con la indicación: "Se tienen que rellenar los campos que contengan () obligatoriamente que se requiere para el registro"*.
| Campo | Tipo | Obligatorio | Mensaje de error | Descripción |
|---|---|---|---|---|
| Código | pInputText | Sí | "* Obligatorio" | Código único del perfil. Ocupa 3/12 columnas. |
| Nombre | pInputText | Sí | "* Obligatorio" | Nombre descriptivo del perfil. Ocupa 3/12 columnas. |
Botón "Agregar Procedimientos"
Debajo de los campos del perfil se encuentra el botón "Agregar Procedimientos" (icono pi pi-plus, ancho fijo de 300px). Al hacer clic, abre el diálogo de selección de procedimientos.
Tabla de procedimientos seleccionados
Muestra los procedimientos que han sido agregados al perfil actual.
| Columna | Descripción |
|---|---|
| Codigo | Código del procedimiento de laboratorio. |
| Nombre | Nombre del procedimiento. |
| Precio | Precio unitario del procedimiento. Muestra 0 si no tiene precio. |
| Acciones | Botón circular con icono pi pi-trash (estilo p-button-warning) para quitar el procedimiento de la lista. |
Solo se agregan procedimientos que tienen un precio unitario mayor a 0. Los procedimientos sin precio son ignorados al agregar.
Al quitar un procedimiento de la lista (botón eliminar), el precio total se recalcula automáticamente.
Sección: Precio
| Campo | Tipo | Obligatorio | Mensaje de error | Descripción |
|---|---|---|---|---|
| Precio | p-inputNumber con p-checkbox | Sí (cuando está habilitado) | "* Obligatorio" | Precio unitario del perfil. Formato decimal con 2 decimales mínimos, locale es-PE. El checkbox a la izquierda habilita/deshabilita la edición del precio. |
Comportamiento del precio:
- Cuando se agregan procedimientos mediante el diálogo de selección, el precio se calcula automáticamente como la suma de los precios unitarios de todos los procedimientos seleccionados.
- El checkbox se marca automáticamente y se deshabilita (no se puede desmarcar) cuando hay procedimientos con precio.
- El campo de precio se deshabilita cuando el checkbox no está marcado.
Botones del diálogo
| Botón | Descripción |
|---|---|
| Cancelar | Icono pi pi-times. Cierra el diálogo sin guardar cambios. |
| Guardar | Icono pi pi-check. Valida el formulario y guarda el perfil. Muestra un spinner de carga durante el proceso. |
Validaciones al guardar
Si el formulario es inválido, se muestra una notificación de error:
- Severidad: error
- Título: "Alerta"
- Mensaje: "Revise bien, hay formularios por validar."
- Duración: 5 segundos
Flujo de guardado
Crear/actualizar el perfil
El sistema envía los datos del perfil (código, nombre, lista de catalogo_procedimiento_item_id) al endpoint de perfiles.
- Creación:
POSTal endpoint de perfiles. - Actualización:
PUTal endpoint de perfiles con el ID existente.
Crear/actualizar el catálogo de servicio asociado
Al crear un nuevo perfil, el sistema crea automáticamente un registro en catálogos de servicios con:
tipo: "SERVICIO"codigoynombre: en mayúsculas, tomados del formulariocatalogo_id: ID del catálogo de servicios de laboratorio por defecto (parámetro de configuración)unidades: la unidad de servicio por defectosalud_relaciones: relación de tipo "PERFIL" con el ID del perfil creado y la lista de precios principal
Al editar, se actualiza el catálogo de servicio existente (vía PATCH) con los datos actualizados del formulario.
Crear/actualizar el precio del servicio (solo si el checkbox de precio está habilitado)
Si el precio unitario está habilitado, el sistema:
- Calcula el valor unitario =
precio_unitario / 1.18(redondeado a 2 decimales). - Calcula el impuesto =
precio_unitario - valor_unitario(redondeado a 2 decimales). - Busca si ya existe un registro en listas de precios de servicios para el catálogo de servicio.
- Si existe, lo actualiza (
PUT); si no existe, lo crea (POST).
Notificaciones al guardar
| Resultado | Severidad | Título | Mensaje | Duración |
|---|---|---|---|---|
| Éxito (crear) | success | "Alerta" | "Registro exitoso." | 5 segundos |
| Éxito (editar) | success | "Alerta" | "Actualización exitoso." | 5 segundos |
| Error | error | "Error {código}" | Mensaje de error del servidor | 5 segundos |
Prerrequisitos de configuración
Si alguno de los siguientes parámetros no está configurado, el sistema mostrará un mensaje de error y no permitirá continuar:
- UNIDAD-SERVICIO no configurada → "CONFIGURE LA UNIDAD"
- IMPUESTO-DEFECTO no configurado → "CONFIGURE EL IMPUESTO"
Diálogo de selección de procedimientos
Se abre al hacer clic en "Agregar Procedimientos" dentro del diálogo de creación/edición de perfil. Tiene el título "Procedimientos" y un ancho mínimo de 50rem.
Barra de búsqueda y filtros
La barra de búsqueda permite filtrar los procedimientos disponibles.
| Elemento | Tipo | Descripción |
|---|---|---|
| Campo de búsqueda | pInputText con icono pi pi-search | Permite buscar por texto libre. Ocupa 4/12 columnas. |
| Chips de filtros activos | p-chip | Muestra los filtros aplicados. Cada chip tiene un botón de eliminar (removable). Al hacer clic en un chip se abre el panel de edición del filtro. |
| Botón "Agregar filtro" | Botón con icono pi pi-filter | Abre el panel overlay para agregar un nuevo filtro. |
| Botón "Quitar filtros" | Botón con icono pi pi-filter-slash | Elimina todos los filtros activos y limpia el campo de búsqueda. |
| Botón "Buscar" | Botón con icono pi pi-search | Ejecuta la búsqueda con los filtros y texto actuales. |
Panel de filtro (overlay)
Al hacer clic en "Agregar filtro", se abre un p-overlayPanel de 350px de ancho con un botón de cierre.
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Filtro | p-dropdown | Sí | Selector del tipo de filtro. Opciones disponibles: GRUPO (valor: 1). Incluye búsqueda por texto. |
| Grupo | p-treeSelect | Sí (cuando Filtro = GRUPO) | Selector de árbol jerárquico con los grupos de procedimientos del catálogo. Se muestra solo cuando el filtro seleccionado es GRUPO. Incluye búsqueda con autofoco. |
| Botón | Descripción |
|---|---|
| Guardar | Aplica el filtro seleccionado. Si ya existe un filtro del mismo tipo, lo reemplaza. Muestra un spinner durante el proceso. |
Tabla de procedimientos disponibles
| Columna | Ancho | Descripción |
|---|---|---|
| (checkbox) | 50px fijo | Casilla de selección individual (p-tableCheckbox). Permite seleccionar múltiples procedimientos. |
| GRUPO | 125px fijo | Nombre del grupo jerárquico al que pertenece el procedimiento, mostrando la ruta completa separada por " / " (ej: "Grupo padre / Subgrupo"). |
| CÓDIGO | 125px fijo | Código del procedimiento de laboratorio. |
| NOMBRE | Flexible | Nombre del procedimiento. |
| PRECIO | 100px fijo | Precio unitario del procedimiento. |
La tabla tiene paginación propia con los mismos controles que la vista principal (50 registros por página).
Botones del diálogo
| Botón | Descripción |
|---|---|
| Cancelar | Icono pi pi-times. Cierra el diálogo sin agregar procedimientos. |
| Agregar | Agrega los procedimientos seleccionados (con checkbox marcado) a la lista del perfil. Solo se agregan los que tienen precio_unitario > 0. Los procedimientos que ya están en la lista son ignorados (sin duplicados). El precio del perfil se recalcula automáticamente. |
Eliminar perfil
Al seleccionar "Eliminar" del menú contextual, se abre un diálogo de confirmación.
Diálogo de confirmación
| Elemento | Descripción |
|---|---|
| Título | "Confirmación" |
| Ancho | 50vw |
| Icono | pi pi-exclamation-triangle (tamaño 2rem) |
| Mensaje | "Estas seguro de proceder con la eliminación?" |
| Botón "No" | Icono pi pi-times. Cierra el diálogo sin eliminar. |
| Botón "Si" | Icono pi pi-check (cambia a spinner durante el proceso). Ejecuta la eliminación del perfil. |
Notificaciones
| Resultado | Severidad | Título | Mensaje | Duración |
|---|---|---|---|---|
| Éxito | success | "Alerta" | "Eliminado." | 5 segundos |
| Error | error | "Error {código}" | Mensaje de error del servidor | 5 segundos |
Parámetros de configuración
El módulo requiere los siguientes parámetros globales del dominio CONFIG-ERPX-SALUD-CATALOGO-PROCEDIMIENTO-LABORATORIO:
Parámetro (code) | Descripción |
|---|---|
CATALOGO-PROCEDIMIENTO-LABORATORIO-PRINCIPAL | ID del catálogo principal de procedimientos de laboratorio. Se usa para filtrar los procedimientos disponibles al agregar al perfil. |
GRUPO-UNIDAD-DEFECTO | ID del grupo de unidades por defecto. Se usa para cargar las unidades disponibles. |
CATALOGO-SERVICIO-LABORATORIO-DEFECTO | ID del catálogo de servicios de laboratorio. Se asigna como catalogo_id al crear el servicio asociado al perfil. |
CATALOGO-PRODUCTO-LABORATORIO-DEFECTO | ID del catálogo de productos de laboratorio por defecto. |
LISTA-PRECIO-SERVICIO-PRINCIPAL | ID de la lista de precios de servicios principal. Se usa para registrar el precio del servicio asociado al perfil. |
Adicionalmente, se requieren los parámetros del dominio PARAMS-ERPX-LOGISTICA-CATALOGOS y PARAMS-ERPX-COMERCIAL-LISTA:
Parámetro (code) | Descripción |
|---|---|
UNIDAD-SERVICIO | ID de la unidad de medida para servicios. Requerido para la creación del catálogo de servicio. |
IMPUESTO-DEFECTO | ID del impuesto por defecto (generalmente IGV). Requerido para el cálculo del precio con impuestos. |
Endpoints
| Método | Endpoint | Descripción |
|---|---|---|
GET | /v2.0.1/erpx/salud/catalogos-procedimientos-perfiles/ | Lista todos los perfiles con paginación y búsqueda. |
GET | /v2.0.1/erpx/salud/catalogos-procedimientos-perfiles/\{id\} | Obtiene un perfil por su ID (usado al editar). |
POST | /v2.0.1/erpx/salud/catalogos-procedimientos-perfiles/ | Crea un nuevo perfil. |
PUT | /v2.0.1/erpx/salud/catalogos-procedimientos-perfiles/\{id\} | Actualiza un perfil existente. |
DELETE | /v2.0.1/erpx/salud/catalogos-procedimientos-perfiles/\{id\} | Elimina un perfil. |
GET | /v2.0.1/erpx/salud/gateway-catalogos-procedimientos-laboratorios/ | Lista procedimientos de laboratorio con datos del gateway (incluye precio y grupos). Usado en el diálogo de selección de procedimientos. |
GET | /v2.0.1/erpx/salud/catalogos-procedimientos-grupos/ | Obtiene los grupos de procedimientos para el filtro por grupo. |
GET | /v2.0.1/erpx/global/params/ | Obtiene los parámetros de configuración globales. |
GET | /v2.0.1/erpx/logistica/unidades/ | Lista las unidades de medida (filtradas por grupo de unidad por defecto). |
GET | /v2.0.1/erpx/logistica/unidades/\{id\} | Obtiene la unidad de servicio por defecto. |
GET | /v2.0.1/erpx/contabilidad/impuestos/ | Lista los impuestos disponibles. |
POST | /v2.0.4/erpx/logistica/catalogos-servicios/ | Crea un catálogo de servicio asociado al perfil. |
PATCH | /v2.0.4/erpx/logistica/catalogos-servicios/\{id\} | Actualiza un catálogo de servicio existente. |
GET | /v2.0.1/erpx/comercial/listas-precios-servicios/ | Busca si existe un precio de servicio para el catálogo. |
POST | /v2.0.1/erpx/comercial/listas-precios-servicios/ | Crea un nuevo precio de servicio. |
PUT | /v2.0.1/erpx/comercial/listas-precios-servicios/\{id\} | Actualiza un precio de servicio existente. |
Problemas comunes
| Problema | Causa | Solución |
|---|---|---|
| Mensaje "CONFIGURE LA UNIDAD" al abrir el formulario | El parámetro UNIDAD-SERVICIO no está configurado en los parámetros globales. | Configure el parámetro UNIDAD-SERVICIO en el dominio PARAMS-ERPX-LOGISTICA-CATALOGOS con el ID de la unidad de servicio. |
| Mensaje "CONFIGURE EL IMPUESTO" al abrir el formulario | El parámetro IMPUESTO-DEFECTO no está configurado en los parámetros globales. | Configure el parámetro IMPUESTO-DEFECTO en el dominio PARAMS-ERPX-COMERCIAL-LISTA con el ID del impuesto por defecto. |
| Los procedimientos no aparecen en el diálogo de selección | El parámetro CATALOGO-PROCEDIMIENTO-LABORATORIO-PRINCIPAL no está configurado o no tiene procedimientos registrados. | Verifique que el parámetro esté configurado y que existan procedimientos de laboratorio en el catálogo correspondiente. |
| El precio del perfil es 0 | Ninguno de los procedimientos seleccionados tiene precio unitario asignado, o no se seleccionaron procedimientos. | Asegúrese de que los procedimientos tengan un precio unitario mayor a 0 en la lista de precios. |
| Un procedimiento no se agrega al perfil | El procedimiento ya está en la lista (duplicado) o su precio unitario es 0. | Verifique que el procedimiento no esté ya agregado y que tenga un precio mayor a 0. |
| "Revise bien, hay formularios por validar" al guardar | Los campos obligatorios (Código y/o Nombre) están vacíos. | Complete todos los campos marcados como obligatorios. |
| Redirección a página de login | El token de autenticación ha expirado o es inválido (error de seguridad código 29000-29999). | Inicie sesión nuevamente en el sistema. |
Páginas relacionadas
- Procedimientos Laboratorios — Gestión de procedimientos de laboratorio (origen de los procedimientos que se agregan a los perfiles).
- Catálogos Laboratorios — Gestión de catálogos de laboratorio.
- Catálogos — Gestión general de catálogos de salud.
Procedimientos de Laboratorio
Gestión completa de catálogos de procedimientos de laboratorio, incluyendo procedimientos, grupos jerárquicos, analitos con valores de referencia y críticos, y filtros de búsqueda.
Médicos
Gestión del registro de médicos y personal de salud en el módulo de Salud de Davix ERPX.