DavixDavix ERPX
Configuracion

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.

Descripción general

El módulo Procedimientos de Laboratorio permite gestionar los procedimientos médicos de laboratorio organizados en catálogos. El sistema se estructura en varios niveles:

  1. Catálogos de procedimientos: Contenedores principales de tipo LABORATORIOS con fechas de vigencia opcionales.
  2. Procedimientos de laboratorio: Los procedimientos individuales dentro de cada catálogo, con códigos CPT, precios y analitos asociados.
  3. Grupos: Carpetas jerárquicas para organizar los procedimientos dentro de un catálogo.
  4. Analitos: Parámetros medibles dentro de cada procedimiento de laboratorio, con valores de referencia y valores críticos.

Dos formas de acceso

Existen dos vías para acceder a los procedimientos de laboratorio:

  • Vista principal: Acceso directo desde el menú, utiliza un catálogo configurado globalmente mediante el parámetro CATALOGO-PROCEDIMIENTO-LABORATORIO-PRINCIPAL.
  • Vista por catálogo: Acceso desde el listado de catálogos → clic en "Detalle" de un catálogo específico.

Listado de catálogos de procedimientos

Acceso

Ruta de navegación: Logística → Catálogo

Encabezado

La pantalla muestra el título "Catálogos Procedimientos Laboratorios" con la descripción: "Muestra el listado y las herramientas para gestionar el catálogo".

Barra de herramientas (Toolbar)

AcciónIconoTipoComportamiento
Nuevopi pi-cogMenú desplegableSub-opción: Catálogo — abre el diálogo de creación
Actualizarpi pi-refreshBotónRecarga la lista de catálogos desde el servidor

Columnas de la tabla

#ColumnaCampoOrdenableDescripción
1CódigocodigoCódigo identificador del catálogo. Ancho fijo: 150px
2NombrenombreNombre del catálogo de procedimientos
3Fecha Iniciofecha_inicioFecha de inicio de vigencia (formato DD/MM/YYYY)
4Fecha Finfecha_finFecha de fin de vigencia (formato DD/MM/YYYY)
5AccionesNoBotón de menú contextual. Ancho fijo: 80px

Filtro automático

La lista solo muestra catálogos de tipo LABORATORIOS. El filtro se aplica automáticamente: search=** AND tipo:LABORATORIOS.

Menú contextual

OpciónIconoAcción
Detallepi pi-folderNavega a la vista de procedimientos del catálogo seleccionado
Editarpi pi-pencilAbre el diálogo de edición con datos precargados
Eliminarpi pi-timesSolicita confirmación y elimina el catálogo

Crear / Editar catálogo de procedimientos

Se abre un diálogo a pantalla completa con el título "Nuevo catálogo de procedimientos de laboratorio".

Campos del formulario

#CampoComponenteObligatorioTooltipMensaje de errorDescripción
1Códigoinput text"Ingrese el código de registro""* Ingrese código válido"Código identificador del catálogo
2Nombreinput text"Ingrese el nombre""* Obligatorio"Nombre descriptivo del catálogo
3¿Configurar caducidad?p-inputSwitchNoHabilita/deshabilita campos de fecha
4Fecha Iniciop-calendarCondicional"Seleccione una fecha de inicio que no pase al final""* Obligatorio"Formato: dd/mm/yyyy. Solo obligatorio con switch activado
5Fecha Finp-calendarCondicional"Seleccione una fecha final que no sea menor a la fecha de inicio""* Obligatorio"Formato: dd/mm/yyyy. Solo obligatorio con switch activado

El campo tipo se establece automáticamente como "LABORATORIOS" y no es visible para el usuario.

Validación de fechas

Si las fechas están configuradas, el sistema valida que la Fecha Fin no sea menor a la Fecha Inicio. Mensaje de error: "La fecha fin no puede ser menor a la fecha inicio." (warning, 5s).

Proceso de guardado

  • Creación: POST /v2.0.1/erpx/salud/catalogos-procedimientos"Registro exitoso."
  • Edición: PUT /v2.0.1/erpx/salud/catalogos-procedimientos/\{id\}"Actualización exitosa."

Vista de procedimientos de laboratorio

Esta vista muestra los procedimientos individuales dentro de un catálogo específico.

Encabezado

  • Título: "Catalogos procedimientos laboratorio detalle"
  • Breadcrumb: Salud → Catálogos procedimiento laboratorio detalles

Barra de herramientas

AcciónIconoEstiloComportamiento
Actualizarpi pi-refreshOutlinedRecarga la lista de procedimientos
GruposPrimarioAbre el diálogo de gestión de grupos
Nuevo Proc. Lab.pi pi-plusPrimarioAbre el diálogo de creación de nuevo procedimiento

Barra de búsqueda y filtros

Debajo de la barra de herramientas se muestra un componente de búsqueda con:

  • Campo de búsqueda: Input de texto libre con icono de búsqueda.
  • Chips de filtros activos: Cada filtro se muestra como chip removible.
  • Agregar filtro: Abre panel overlay con filtro por GRUPO (p-treeSelect).
  • Quitar filtros: Elimina todos los filtros y limpia la búsqueda.
  • Buscar: Ejecuta la búsqueda con filtros actuales.

Columnas de la tabla

#ColumnaCampoAnchoDescripción
1GRUPOgrupo125px fijoMuestra la jerarquía del grupo padre separada por /
2CÓDIGOcodigo125px fijoCódigo identificador del procedimiento
3NOMBREnombreAutoNombre del procedimiento de laboratorio
4CPTcodigo_cpt100px fijoCódigo CPT (Current Procedural Terminology)
5PRECIOsalud_relaciones[0].lista_precio_servicio.precio_unitario100px fijoPrecio unitario del procedimiento obtenido desde la relación con la lista de precios de servicios. Si no tiene relaciones, muestra 0
6Acciones60px fijoBotón de menú contextual

Columna PRECIO

La columna PRECIO es exclusiva de la vista de laboratorios (no existe en la vista de imágenes). Muestra el precio unitario del primer registro en salud_relaciones que tenga un lista_precio_servicio asociado. Si no hay relaciones, se muestra 0.

Menú contextual

OpciónIconoAcción
Editarpi pi-pencilAbre el diálogo de edición del procedimiento
Analitospi pi-eyeAbre el diálogo de gestión de analitos del procedimiento
Eliminarpi pi-timesSolicita confirmación y elimina el procedimiento

Paginación

  • Tamaño de página: 50 registros por defecto.
  • Indicador: "Mostrando página X con Y registros de Z entradas".
  • Navegación: Botones Primera, Anterior, Siguiente, Última con selector de página filtrable.

Crear / Editar procedimiento de laboratorio

Se abre un diálogo a pantalla completa con el título "Nuevo analito" (nota: el título del diálogo dice "analito" pero se refiere al procedimiento de laboratorio).

Subtítulo: "Datos generales del analito""Se tiene que rellenar los campos que contengan () obligatoriamente que se requiere para el registro."*

Campos del formulario

#CampoComponenteObligatorioTooltipMensaje de errorDescripción
1Analitop-treeSelectNo"Si desea agregar a un analito seleccione""* Obligatorio"Selector de árbol para vincular a un analito padre
2Grupo / Familiap-treeSelectNo"Si desea agregar a un grupo/familia seleccione""* Obligatorio"Selector de árbol jerárquico de grupos del catálogo
3Nombreinput text"Ingrese el nombre""* Obligatorio"Nombre del procedimiento
4Descripcióninput textNo"Ingrese la descripción"Descripción del procedimiento
5Unidadp-dropdown"Ingrese el unidad""* Obligatorio"Unidad de medida del procedimiento, cargada desde el grupo de unidades configurado
6Tipo dato resultadop-dropdown"* Obligatorio"Tipo de dato para los resultados del analito
7Lista Valoresinput textCondicional"Ingrese valores separados por ',' si elegiste tipo de dato resultado lista""* Obligatorio"Solo habilitado cuando Tipo dato resultado = LISTA. Valores separados por coma
8Agregar valor defectop-checkboxNo"Marcar si es que tiene la lista un valor por defecto"Solo habilitado cuando Tipo dato resultado = LISTA

Tipos de dato resultado

ValorEtiquetaDescripción
1ENTEROResultado es un número entero
2DECIMALResultado es un número decimal
3TEXTOResultado es texto libre
4LISTAResultado se selecciona de una lista predefinida (habilita campo "Lista Valores")
5TEXTO MULTIPLEResultado es texto multilínea

Valores de referencia

Debajo de los campos principales, se muestra una tabla dinámica para gestionar los valores de referencia del analito.

#ColumnaComponenteDescripción
1SEXOp-dropdownOpciones: MASCULINO (M), FEMENINO (F). Con botón de limpiar
2EDADGrupo de p-inputNumberDos campos: inicio y fin (rango de edad)
3INDICADORinput textTexto libre para el indicador
4RANGO/VALORESinput textTexto que describe el rango o valores de referencia
5p-button (trash)Elimina la fila del valor de referencia

Debajo de la tabla, el botón "Agregar un valor de referencia" (pi pi-plus) permite añadir nuevas filas.

Valores críticos

Similar a los valores de referencia, se muestra otra tabla dinámica para valores críticos.

#ColumnaComponenteDescripción
1SEXOp-dropdownOpciones: MASCULINO (M), FEMENINO (F)
2EDADGrupo de p-inputNumberRango de edad: inicio y fin
3INDICADORinput textTexto libre para el indicador
4INICIOp-inputNumberValor numérico de inicio del rango crítico
5FINp-inputNumberValor numérico de fin del rango crítico
6p-button (trash)Elimina la fila del valor crítico

Debajo de la tabla, el botón "Agregar un valor crítico" permite añadir nuevas filas.

Campo calculado y fórmula

CampoComponenteDescripción
Campo calculadop-checkboxSi se activa, habilita el campo de fórmula
Fórmula(editor de fórmula)Permite definir una fórmula de cálculo basada en otros analitos

Proceso de guardado

Validar formulario

Verifica que Nombre, Unidad y Tipo dato resultado estén completados. Si tipo = LISTA, también valida Lista Valores.

Validar fórmula (si aplica)

Si el campo calculado está activado, valida que la fórmula sea correcta.

Enviar datos al servidor

  • Creación: POST /v2.0.1/erpx/salud/catalogos-procedimientos-laboratorios-analitos
  • Edición: PUT /v2.0.1/erpx/salud/catalogos-procedimientos-laboratorios-analitos/\{id\}

Se envían: grupo_id, parent_id, catalogo_procedimiento_id, nombre, descripcion, unidad_id, tipo_dato_resultado, list_valores, agregar_valor_defecto, campo_calculado, formula, valores_referencias[], valores_criticos[].

Confirmación

  • Creación: "Registro exitoso." (success, 5s).
  • Edición: "Actualización exitoso." (success, 5s).

Gestión de analitos

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

Diálogo de analitos

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

Subtítulo: "Aquí puede editar la lista de analitos"

Barra de herramientas

BotónIconoAcción
Nuevo Grupospi pi-plusCrea un nuevo grupo de analitos
Nuevo analitopi pi-plusCrea un nuevo analito

TreeTable de analitos

Los analitos se muestran en un TreeTable expandido por defecto con las siguientes columnas:

#ColumnaCampoAnchoDescripción
1NOMBREnombre400pxNombre del analito o grupo (con toggle de expansión)
2TIPOtype100pxTipo del elemento: GRUPO o ITEM
3UNIDADunidad.codigo100pxCódigo de la unidad de medida (solo para ITEM)
4T. DE DATOtipo_dato_resultadoAutoTipo de dato del resultado (ENTERO, DECIMAL, TEXTO, LISTA, TEXTO MULTIPLE). Si es LISTA, muestra los valores entre paréntesis
5V. REFERENCIAvalores_referenciasAutoValores de referencia formateados. Muestra sexo + valor_texto por línea
6V. CRITICOAutoValores críticos (columna reservada)

Carga de datos

Al abrir el diálogo de analitos, el sistema carga dos listas en paralelo (forkJoin):

  1. Grupos de analitos: GET /v2.0.1/erpx/salud/catalogos-procedimientos-analitos-grupos
  2. Analitos individuales: GET /v2.0.1/erpx/salud/catalogos-procedimientos-laboratorios-analitos

Los datos se combinan en una estructura de árbol donde los analitos sin grupo se muestran al nivel raíz, y los analitos con grupo_id se insertan como hijos del grupo correspondiente. Todo se ordena por el campo orden.

Menú contextual de analitos

El menú contextual varía según el tipo de elemento seleccionado.

Para elementos tipo ITEM (analito)

OpciónIconoAcción
Editarpi pi-pencilAbre el diálogo de edición del analito
Eliminarpi pi-timesElimina el analito
Separador
Agregar analitopi pi-plusCrea un nuevo analito como hijo del analito actual
Separador
Mover analito arribapi pi-arrow-upMueve el analito una posición hacia arriba
Mover abajo abajopi pi-arrow-downMueve el analito una posición hacia abajo

Para elementos tipo GRUPO

OpciónIconoAcción
Editarpi pi-pencilAbre el diálogo de edición del grupo
Eliminarpi pi-timesElimina el grupo
Separador
Agregar grupopi pi-plusCrea un sub-grupo dentro del grupo actual
Agregar analitopi pi-plusCrea un analito dentro del grupo actual
Separador
Mover grupo arribapi pi-arrow-upMueve el grupo una posición hacia arriba
Mover grupo abajopi pi-arrow-downMueve el grupo una posición hacia abajo

Reordenamiento de analitos y grupos

Al mover un elemento (arriba o abajo), el sistema:

  1. Intercambia las posiciones del elemento con su vecino.
  2. Envía una actualización masiva al servidor con los nuevos valores de orden para todos los elementos del mismo nivel.
  3. Para grupos: POST /v2.0.1/erpx/salud/catalogos-procedimientos-analitos-grupos/bulk (PATCH masivo).
  4. Para analitos: POST /v2.0.1/erpx/salud/catalogos-procedimientos-laboratorios-analitos/bulk (PATCH masivo).

Crear / Editar grupo de analitos

Diálogo

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

Campos del formulario

#CampoComponenteObligatorioTooltipMensaje de errorDescripción
1Grupop-treeSelectNo"Seleccione el grupo si desea asignarlo""* Obligatorio"Selector jerárquico para grupo padre. Se deshabilita si se crea desde menú contextual de un grupo
2Nombreinput text"Ingrese el nombre del grupo""* Obligatorio"Nombre del grupo de analitos
3Descripcióninput textNo"Ingrese la descripción del grupo"Descripción del grupo

Proceso de guardado

  • Creación: POST /v2.0.1/erpx/salud/catalogos-procedimientos-analitos-grupos"Registro exitoso."
  • Edición: PUT /v2.0.1/erpx/salud/catalogos-procedimientos-analitos-grupos/\{id\}"Actualización exitoso."

Se envía: codigo, nombre, descripcion, catalogo_procedimiento_id, parent_id, nivel, path, orden.


Gestión de grupos de procedimientos

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

Diálogo de grupos

Diálogo a pantalla completa con un TreeTable que muestra la jerarquía de grupos del catálogo. Funcionalidad idéntica al módulo de Procedimientos de Imagen.

Crear / Editar grupo de procedimientos

#CampoComponenteObligatorioDescripción
1Grupop-treeSelectNoSelector jerárquico para grupo padre
2Códigoinput textCódigo del grupo
3Nombreinput textNombre del grupo
4Descripcióninput textNoDescripción del grupo
  • Creación: POST /v2.0.1/erpx/salud/catalogos-procedimientos-grupos
  • Edición: PUT /v2.0.1/erpx/salud/catalogos-procedimientos-grupos/\{id\}

Eliminar elementos

Eliminar procedimiento de laboratorio

DELETE /v2.0.1/erpx/salud/catalogos-procedimientos-laboratorios-analitos/\{id\} para tipo ANALITOS.

DELETE /v2.0.1/erpx/salud/catalogos-procedimientos-laboratorios/\{id\} para tipo SERVICIO.

Eliminar grupo de procedimientos

DELETE /v2.0.1/erpx/salud/catalogos-procedimientos-grupos/\{id\} para tipo GRUPO.

Eliminar grupo de analitos

DELETE /v2.0.1/erpx/salud/catalogos-procedimientos-analitos-grupos/\{id\} para tipo ANALITOS-GRUPO.

Eliminar analito

DELETE /v2.0.1/erpx/salud/catalogos-procedimientos-laboratorios-analitos/\{id\} para tipo ANALITOS.

Eliminación diferenciada

El componente de eliminación verifica el campo type del elemento para determinar qué endpoint de eliminación utilizar. Los tipos son: SERVICIO (procedimiento), GRUPO (grupo de procedimientos), ANALITOS (analito individual) y ANALITOS-GRUPO (grupo de analitos).


Parámetros globales de configuración

La vista principal de procedimientos de laboratorio utiliza múltiples parámetros de configuración:

DominioCódigoDescripción
CONFIG-ERPX-SALUD-CATALOGO-PROCEDIMIENTO-LABORATORIOCATALOGO-PROCEDIMIENTO-LABORATORIO-PRINCIPALID del catálogo de procedimientos principal
CONFIG-ERPX-SALUD-CATALOGO-PROCEDIMIENTO-LABORATORIOGRUPO-UNIDAD-DEFECTOID del grupo de unidades por defecto
CONFIG-ERPX-SALUD-CATALOGO-PROCEDIMIENTO-LABORATORIOCATALOGO-SERVICIO-LABORATORIO-DEFECTOID del catálogo de servicios de laboratorio por defecto
CONFIG-ERPX-SALUD-CATALOGO-PROCEDIMIENTO-LABORATORIOCATALOGO-PRODUCTO-LABORATORIO-DEFECTOID del catálogo de productos de laboratorio por defecto
CONFIG-ERPX-SALUD-CATALOGO-PROCEDIMIENTO-LABORATORIOLISTA-PRECIO-SERVICIO-PRINCIPALID de la lista de precios de servicios principal

Consulta: GET /v2.0.1/erpx/global/params/?search=domain:CONFIG-ERPX-SALUD-CATALOGO-PROCEDIMIENTO-LABORATORIO&size=10


Endpoints del módulo

MétodoEndpointDescripción
GET/v2.0.1/erpx/salud/catalogos-procedimientosListar catálogos de procedimientos
POST/v2.0.1/erpx/salud/catalogos-procedimientosCrear catálogo
PUT/v2.0.1/erpx/salud/catalogos-procedimientos/\{id\}Actualizar catálogo
DELETE/v2.0.1/erpx/salud/catalogos-procedimientos/\{id\}Eliminar catálogo
GET/v2.0.1/erpx/salud/gateway-catalogos-procedimientos-laboratoriosListar procedimientos (vista gateway con relaciones)
GET/v2.0.1/erpx/salud/gateway-catalogos-procedimientos-laboratorios/\{id\}Obtener procedimiento por ID (gateway)
GET/v2.0.1/erpx/salud/catalogos-procedimientos-laboratoriosListar procedimientos de laboratorio
POST/v2.0.1/erpx/salud/catalogos-procedimientos-laboratoriosCrear procedimiento
PUT/v2.0.1/erpx/salud/catalogos-procedimientos-laboratorios/\{id\}Actualizar procedimiento
DELETE/v2.0.1/erpx/salud/catalogos-procedimientos-laboratorios/\{id\}Eliminar procedimiento
GET/v2.0.1/erpx/salud/catalogos-procedimientos-laboratorios-analitosListar analitos
GET/v2.0.1/erpx/salud/catalogos-procedimientos-laboratorios-analitos/\{id\}Obtener analito por ID
POST/v2.0.1/erpx/salud/catalogos-procedimientos-laboratorios-analitosCrear analito
PUT/v2.0.1/erpx/salud/catalogos-procedimientos-laboratorios-analitos/\{id\}Actualizar analito
POST/v2.0.1/erpx/salud/catalogos-procedimientos-laboratorios-analitos/bulkActualización masiva de orden
DELETE/v2.0.1/erpx/salud/catalogos-procedimientos-laboratorios-analitos/\{id\}Eliminar analito
GET/v2.0.1/erpx/salud/catalogos-procedimientos-analitos-gruposListar grupos de analitos
POST/v2.0.1/erpx/salud/catalogos-procedimientos-analitos-gruposCrear grupo de analitos
PUT/v2.0.1/erpx/salud/catalogos-procedimientos-analitos-grupos/\{id\}Actualizar grupo de analitos
POST/v2.0.1/erpx/salud/catalogos-procedimientos-analitos-grupos/bulkActualización masiva de orden
DELETE/v2.0.1/erpx/salud/catalogos-procedimientos-analitos-grupos/\{id\}Eliminar grupo de analitos
GET/v2.0.1/erpx/salud/catalogos-procedimientos-gruposListar grupos de procedimientos
POST/v2.0.1/erpx/salud/catalogos-procedimientos-gruposCrear grupo
PUT/v2.0.1/erpx/salud/catalogos-procedimientos-grupos/\{id\}Actualizar grupo
DELETE/v2.0.1/erpx/salud/catalogos-procedimientos-grupos/\{id\}Eliminar grupo
GET/v2.0.1/erpx/logistica/unidadesObtener unidades de medida
GET/v2.0.1/erpx/global/paramsObtener parámetros de configuración

Problemas comunes

ProblemaCausa probableSolución
No se muestran catálogos en la listaNo existen catálogos de tipo LABORATORIOSCrear un nuevo catálogo desde Nuevo → Catálogo
La vista de procedimientos no carga datosEl parámetro CATALOGO-PROCEDIMIENTO-LABORATORIO-PRINCIPAL no está configuradoContacte al administrador para configurar el parámetro global
La columna PRECIO muestra 0El procedimiento no tiene una relación de lista de precios de servicios asociadaVerificar que el procedimiento tenga un registro en salud_relaciones con lista_precio_servicio
No aparece la opción "Analitos" en el menú contextualEstá usando la vista de detalles en lugar de la vista principalLa gestión de analitos está disponible en la vista principal (Branch v2.0.7)
Error al mover analitosEl analito está en el borde (primero o último) de su nivelNo se puede mover más arriba si ya es el primero, ni más abajo si es el último
Los campos "Lista Valores" y "Agregar valor defecto" están deshabilitadosEl tipo de dato resultado no es LISTA (valor 4)Seleccione "LISTA" en el campo Tipo dato resultado para habilitar estos campos
No se muestran unidades en el dropdownEl parámetro GRUPO-UNIDAD-DEFECTO no está configuradoContacte al administrador para configurar el grupo de unidades por defecto
Error al guardar fórmulaLa fórmula contiene errores de sintaxis o referencias inválidasVerifique que la fórmula sea correcta y que los analitos referenciados existan

Páginas relacionadas