Laboratorios Estudios

Que es el modulo Laboratorios Estudios

El modulo Laboratorios Estudios permite gestionar el ciclo completo de estudios de laboratorio clinico en Davix ERPX: desde la creacion de estudios a partir de ventas pendientes, pasando por la asignacion de laboratorios y responsables, el ingreso y validacion de resultados por analito, la generacion o subida de informes PDF, hasta la publicacion final de resultados con integracion a historias clinicas y al servidor DICOM externo.

Ruta de navegacion: Inicio > Pacs > Estudios

---

Estados de un estudio

Cada estudio tiene un estado representado con un badge de color:

Estado	Valor	Color del badge	Descripcion
Nuevo	0	Azul (info)	Estado inicial al crear el estudio. No tiene resultados ingresados ni informes.
Proceso	1	Amarillo (warning)	El estudio tiene resultados parciales, informes registrados o se cancelo una publicacion.
Publicado	2	Verde (success)	Todos los resultados fueron validados y todos los informes publicados. Se registro en historias clinicas y se envio al servidor DICOM.
De baja	3	Rojo (danger)	El estudio fue dado de baja manualmente.
Baja de venta	4	Rojo (danger)	El estudio se marco automaticamente como baja porque la venta asociada fue anulada (venta con estado 4).

---

Estados de un informe

Estado	Valor	Etiqueta visual	Descripcion
Pendiente	0	Tag amarillo "Pendiente"	El informe fue creado pero aun no ha sido publicado.
Publicado	2	Tag verde "Publicado"	El informe fue publicado exitosamente.

---

Tipos de paciente

Tipo	Valor
Privado	PRIVADO
Particular	PARTICULAR
Soat	SOAT
Convenio	CONVENIO

---

Pantalla principal: lista de estudios

Descripcion general

La pantalla muestra el titulo "Lista de laboratorios estudios" con la descripcion "Muestra el listado y las herramientas para gestionar los estudios".

La ruta de navegacion (breadcrumb) muestra: Inicio > Pacs > Estudios. Los dos primeros son enlaces navegables; "Estudios" es la pagina actual.

Barra de herramientas

Boton	Icono	Estilo	Descripcion
Exportar	pi pi-file-excel	Boton con borde	Abre el dialogo para exportar a Excel.
Actualizar	pi pi-refresh	Boton secundario con borde	Recarga los datos de la tabla.
Agregar estudios pendientes	pi pi-plus	Boton primario elevado	Abre el dialogo para agregar estudios desde ventas pendientes.

Columnas de la tabla principal

La tabla usa p-table con columnas redimensionables, scroll horizontal, seleccion simple y menu contextual por clic derecho. Paginacion personalizada de 50 registros por pagina con controles manuales. Las columnas son:

#	Columna	Ancho	Descripcion
1	Fecha	100px	Fecha del estudio. Formato: DD/MM/YYYY hh:mm:ss A.
2	Numero	60px	Numero correlativo del estudio.
3	Venta	150px	Serie y numero de las ventas asociadas, separadas por coma. Formato: serie-numero.
4	Paciente	150px	Nombre completo del paciente: nombres apellido_paterno apellido_materno.
5	Datos de estudio	Flexible	Badges de procedimientos con codigos de color (ver detalle abajo).
6	Medico referente	150px	Medico referente asignado con edicion inline (ver detalle abajo).
7	Informe	200px	Lista de informes con acciones y boton "Anadir" (ver detalle abajo).
8	Estado	80px	Badge de estado del estudio.
9	Acciones	80px	Icono de tres puntos (pi pi-ellipsis-h) que abre el menu contextual.

Cuando no hay registros: "No se encontraron datos" (con icono pi pi-exclamation-triangle).

Columna Datos de estudio (detalle)

Cada procedimiento del estudio se muestra como un p-badge con el nombre del procedimiento. El color del badge depende de dos condiciones: si el procedimiento tiene resultado validado (resultado_validacion_validado) y si tiene fecha de muestra (fecha_muestra):

Condicion	Color del badge
Sin fecha de muestra	Gris (default)
Con fecha de muestra, sin validar	Amarillo (warning)
Con fecha de muestra, validado	Verde (success)
Estudio con baja de venta (estado 4)	Estilo deshabilitado (opacidad reducida)

Tooltip de cada badge: Al pasar el cursor sobre un badge de procedimiento se muestra la informacion: grupo_nombre | nombre | laboratorio_nombre | responsable_proceso_nombre | fecha_muestra

Columna Medico referente (edicion inline)

La columna muestra el nombre del medico referente asignado. Al hacer clic en el icono de edicion (lapiz), se activa el modo de edicion inline:

Mensaje de exito: "Medico referente actualziado" (severity: success, duracion: 5000ms)

Columna Informe (detalle)

Cada informe del estudio se muestra en una fila con los siguientes elementos:

Elemento	Descripcion
Tag de estado	Tag amarillo "Pendiente" (estado 0) o tag verde "Publicado" (estado 2).
Ver PDF (icono pi pi-file-pdf, rojo)	Abre el visor de informe PDF. Disponible para todos los informes.
Editar (icono pi pi-pencil, azul)	Abre el formulario de edicion del informe. Solo visible cuando el estado del informe es 0 (Pendiente).
Eliminar (icono pi pi-trash, rojo)	Elimina el informe. Solo visible cuando el estado del estudio no es 2 (Publicado) y el estado del informe es 0 (Pendiente).
Anadir (boton con icono pi pi-plus)	Abre un menu popup con dos opciones.

Opciones del boton "Anadir":

Opcion	Descripcion
Generar informe del resultados	Genera un informe PDF a partir de los resultados validados.
Subir informe	Permite subir un archivo PDF como informe.

---

Filtros de busqueda

El panel de filtros permite buscar por texto libre y agregar filtros combinables con operador AND. Hay una barra de busqueda a la izquierda y los filtros se muestran como chips removibles. Al hacer clic en un chip existente se abre el overlay para editarlo.

Botones de filtro

Boton	Icono	Descripcion
Agregar filtro	pi pi-filter	Abre el panel overlay para configurar un nuevo filtro.
Quitar filtros	pi pi-filter-slash	Elimina todos los filtros activos y limpia la busqueda.
Buscar	pi pi-search	Ejecuta la busqueda con los filtros actuales.

Tipos de filtro disponibles

#	Filtro	Tipo de control	Descripcion
1	Fecha	Dos campos input[type=date] (inicio y fin)	Filtra por rango de fecha del estudio (fecha).
2	Fecha de venta	Dos campos input[type=date] (inicio y fin)	Filtra por rango de fecha de la venta asociada (venta_fecha).
3	Pacientes	p-dropdown con busqueda	Busca y selecciona un paciente especifico. Muestra: numero_documento - apellido_paterno apellido_materno nombres.
4	Estado	p-multiSelect con chips	Permite seleccionar multiples estados.
5	Medico referente	p-dropdown con busqueda	Busca y selecciona un medico referente. Muestra: numero_documento - apellido_paterno apellido_materno nombres.

Mensaje de error para campos obligatorios en el overlay: " Obligatorio"*.

Formato de consulta (query) por filtro

Filtro	Query generado	Texto del chip
Fecha	fecha:[YYYY-MM-DD TO YYYY-MM-DD]	"Fecha desde DD/MM/YYYY hasta DD/MM/YYYY"
Fecha de venta	venta_fecha:[YYYY-MM-DD TO YYYY-MM-DD]	"Fecha de venta desde DD/MM/YYYY hasta DD/MM/YYYY"
Pacientes	paciente_id:\{id\}	"Pacientes == {nombre_completo}"
Estado	estado:\{valores\}	"Estado == {nombres_estados}"
Medico referente	medico_referente_id:\{id\}	"Medico referente == {nombre_completo}"

Estados disponibles para filtro

Estado	Valor
NUEVO	0
PENDIENTE	1
PUBLICADO	2
BAJA	3

Si ya existe un filtro del mismo tipo, se reemplaza automaticamente.

---

Menu contextual

El menu contextual se activa por clic derecho sobre una fila o por clic en el icono de tres puntos de la columna Acciones. El contenido del menu cambia segun el estado del estudio.

Estado Nuevo (0) o Proceso (1)

#	Opcion	Icono	Descripcion
1	Validar resultados	pi pi-check-square	Abre el dialogo de validacion de resultados por analito.
2	Generar informe del resultados	pi pi-file	Genera informe PDF a partir de resultados validados.
3	Publicar resultados	pi pi-send	Abre el dialogo de confirmacion para publicar.
4	Cancelar publicacion	pi pi-times	Abre el dialogo para cancelar la publicacion.
5	Compartir estudio	pi pi-share-alt	Abre el dialogo para copiar enlace de resultados.
6	Datos de estudio	pi pi-book	Abre el formulario de datos de estudio (editable).
7	Subir informe	pi pi-file-pdf	Abre el formulario para subir un informe PDF.

Estado Publicado (2)

#	Opcion	Icono	Descripcion
1	Cancelar publicacion	pi pi-times	Abre el dialogo para cancelar la publicacion.
2	Datos de estudio	pi pi-book	Abre el formulario en modo solo lectura.

Estado Baja de venta (4)

#	Opcion	Icono	Descripcion
1	Datos de estudio	pi pi-book	Abre el formulario en modo solo lectura.

---

Agregar estudios pendientes

Acceso

Se accede al hacer clic en el boton "Agregar estudios pendientes" de la barra de herramientas.

Dialogo

Se abre en pantalla completa (100% ancho y alto) con titulo "Agregar estudios".

Descripcion

Este dialogo muestra las ventas de salud que tienen procedimientos de tipo LABORATORIO pero que aun no tienen un estudio de laboratorio asignado. Permite seleccionar una o mas ventas para crear automaticamente los estudios correspondientes.

Filtros

El dialogo incluye un componente de filtro con barra de busqueda y los siguientes filtros:

#	Filtro	Tipo de control	Descripcion
1	Fecha	Dos campos input[type=date] (inicio y fin)	Filtra por rango de fecha de la venta.
2	Serie	input text	Filtra por serie de la nota de venta.
3	Numero	input text	Filtra por numero de la nota de venta.
4	Paciente	input text	Filtra por nombre del paciente.

Mensaje de error para campos obligatorios: " Obligatorio"*.

Columnas de la tabla

Columna	Descripcion
Checkbox	Checkbox de seleccion por fila. Tambien hay checkbox de seleccion global en el encabezado.
FECHA	Fecha de la venta. Formato: DD/MM/YYYY.
NUM. VENTA	Serie y numero de la venta. Formato: serie-numero.
DNI & RUC	Numero de documento del paciente.
PACIENTE	Nombre completo del paciente: nombres apellido_paterno apellido_materno.
CANT. PROC.	Cantidad de procedimientos de laboratorio en la venta.

Condiciones de consulta

Solo se muestran ventas que cumplan todas estas condiciones:

• No tienen estudio de laboratorio asignado (estudio_laboratorio_codigo_grupo_is_null:0)
• Estado de la venta es 0 (activa)
• Tienen al menos 1 procedimiento de laboratorio (cantidad_procedimientos_laboratorios:[1 TO 1000])

Flujo al guardar

Validaciones

Validacion	Mensaje
No se selecciono ninguna venta	"Seleccione como minimo una venta." (severity: warn)

Botones

Boton	Accion
Cancelar	Cierra el dialogo sin guardar.
Guardar	Crea los estudios para las ventas seleccionadas. Muestra spinner de carga mientras procesa.

---

Datos de estudio (Procedimientos)

Acceso

Se accede desde la opcion "Datos de estudio" del menu contextual (cuando el estudio tiene estado 0 o 1).

Dialogo

Se abre en pantalla completa (100% ancho y alto) con titulo "Detalle de estudio LAB".

Seccion: Detalles de estudios

Campo	Tipo	Requerido	Descripcion
Paciente	p-autoComplete con busqueda y boton "Agregar nuevo +"	Si	Busca y selecciona un paciente. Al escribir se filtran los pacientes por texto. El resultado muestra: nombres apellido_paterno apellido_materno / tipo_documento: numero_documento. El boton "Agregar nuevo +" abre el formulario de nuevo paciente.
F. Nac. Paciente	p-calendar (dd/mm/yyyy)	Si	Fecha de nacimiento del paciente. Se establece automaticamente al seleccionar un paciente. Campo deshabilitado para edicion directa. Tooltip: "Registre la fecha de nacimiento del paciente".
Edad	input text (deshabilitado)	Si	Edad calculada automaticamente a partir de la fecha de nacimiento. Formato: X anio(s) Y mes(es) Z dia(s).
Sexo	p-radioButton (Masculino / Femenino)	Si	Valores: M (Masculino), F (Femenino). Campo deshabilitado; se establece al seleccionar un paciente.
Medico referente	p-autoComplete con busqueda y boton "Agregar nuevo +"	Si	Busca y selecciona un medico referente. El boton "Agregar nuevo +" abre el formulario de nuevo colaborador con rol MD. Tambien incluye un boton de edicion (lapiz) para modificar el colaborador seleccionado.

Seccion: Estudios (tabla de procedimientos)

La tabla muestra los procedimientos de laboratorio asignados al estudio, con una fila de valores por defecto en el encabezado y una fila por cada procedimiento.

Fila de encabezado (valores por defecto):

Columna	Control	Descripcion
Ingresar resultado?	Checkbox global	Marca/desmarca todos los procedimientos para ingreso de resultado.
Laboratorio	p-dropdown + boton copiar	Selecciona laboratorio por defecto. El boton copiar (icono pi pi-copy) aplica el valor a todos los procedimientos. Valor por defecto: laboratorio con nombre "YABAJA".
Responsable del proceso	p-dropdown + boton copiar	Selecciona responsable por defecto. El boton copiar aplica el valor a todos. Valor por defecto: usuario actual.
Fecha de muestra	p-calendar + boton copiar	Selecciona fecha por defecto. El boton copiar aplica el valor a todos. Valor por defecto: fecha y hora actual.

Fila por cada procedimiento:

Columna	Control	Descripcion
Ingresar resultado?	Checkbox individual	Marca si el procedimiento debe tener ingreso de resultado.
Nombre	Texto (deshabilitado)	Nombre del procedimiento.
Laboratorio	p-dropdown	Laboratorio asignado a este procedimiento.
Responsable del proceso	p-dropdown	Responsable asignado a este procedimiento.
Fecha de muestra	p-calendar	Fecha y hora de toma de muestra.

Seccion: Resumen clinico

Campo	Tipo	Requerido	Descripcion
Resumen clinico	p-editor (editor de texto enriquecido)	Si	Permite formato basico: negrita, cursiva, subrayado. Toolbar: [['bold', 'italic', 'underline']].

Mensajes de error de validacion

Campo	Mensaje de error
Fecha de nacimiento	" Ingrese la fecha de nacimiento del paciente"*
Sexo	" Seleccione el sexo"*
Medico referente	" Seleccione el medico referente"*
Resumen clinico	" Ingrese el resumen clinico"*
Formulario general	"Revise bien, hay formularios por validar." (toast, severity: warn)

Botones

Boton	Accion
Cancelar	Cierra el dialogo sin guardar.
Guardar	Guarda los cambios del estudio y sus procedimientos.

Mensajes de exito

• Al actualizar: "Datos actualizados con exito" (severity: success, duracion: 5000ms)
• Al crear: "Se ha registrado con exito" (severity: success, duracion: 5000ms)

---

Datos de estudio (solo lectura)

Acceso

Se accede desde la opcion "Datos de estudio" del menu contextual cuando el estudio tiene estado Publicado (2) o Baja de venta (4).

Descripcion

Muestra exactamente la misma informacion que el formulario editable de Datos de estudio, pero todos los campos estan deshabilitados y no se muestra el boton "Guardar". Solo se muestra el boton "Cancelar" para cerrar el dialogo.

---

Validar resultados

Acceso

Se accede desde la opcion "Validar resultados" del menu contextual o desde la barra de herramientas del estudio.

Dialogo

Se abre en pantalla completa (100% ancho y alto) con titulo "Detalle de estudio LAB".

Estructura general

El formulario muestra los resultados organizados en un p-accordion donde cada tab corresponde a un grupo de procedimientos. Los procedimientos se organizan en una estructura de arbol:

Grupo de Procedimiento
  └── Procedimiento
        └── Analito Grupo (opcional)
              └── Analito
                    └── Perfil (formula calculada)

Encabezado de cada tab del accordion

Elemento	Descripcion
Nombre del grupo	Nombre del grupo de procedimientos.
Checkbox de validacion	p-checkbox que marca el grupo como validado (resultado_validacion_validado). Al marcar, se establece la validacion como verdadera; al desmarcar, como falsa.

Columnas de la tabla de analitos

Columna	Ancho	Descripcion
ANALISIS	30%	Nombre del analito. Se muestra indentado segun el nivel en la estructura de arbol. Los tipos Procedimiento y AnalitoGrupo se muestran como separadores de seccion.
RESULTADO	15%	Campo editable para ingresar el resultado del analisis. Para analitos con opciones predefinidas: p-dropdown. Para analitos numericos: input text.
VALIDACION	15%	Campo de validacion del resultado. Se puede copiar el resultado a la validacion. Incluye boton de copiar en el encabezado que replica todos los resultados a validaciones.
UND	20px	Unidad de medida del analito (ej: mg/dL, U/L).
VALOR REFERENTE	10%	Rango de valores de referencia normales para el analito.
VALOR CRITICO	10%	Rango de valores criticos que requieren atencion inmediata.

Tipos de items en el arbol

Tipo	Comportamiento visual
Procedimiento	Fila separadora con nombre del procedimiento. No tiene campos editables.
AnalitoGrupo	Fila separadora con nombre del grupo. No tiene campos editables.
Analito	Fila con campos de resultado y validacion editables.
Perfil	Fila con resultado calculado automaticamente mediante formula (no editable). Usa BigNumber para precision aritmetica.

Observacion por grupo

Debajo de la tabla de cada grupo de procedimientos hay un campo:

Campo	Tipo	Descripcion
OBSERVACION	textarea	Texto libre para observaciones del grupo. Se guarda por separado.

Boton "Replicar resultado"

El boton "Replicar resultado" en el encabezado de la columna VALIDACION copia el valor de RESULTADO a VALIDACION para todos los analitos del grupo activo. Esto ahorra tiempo cuando el resultado y la validacion son identicos.

Boton "Ver informe"

En la parte superior del dialogo hay un boton que abre el componente ViewInformeBasic, mostrando una vista previa del informe PDF generado hasta el momento (si existe).

Botones

Boton	Accion
Cancelar	Cierra el dialogo sin guardar.
Guardar	Guarda los resultados y validaciones ingresados sin cambiar el estado de validacion.
Validar	Guarda los resultados, establece las validaciones de los medicos responsables y marca la validacion como completa.

Flujo al guardar

---

Generar informe de resultados

Acceso

Se accede desde:

• La opcion "Generar informe del resultados" del menu contextual
• La opcion "Generar informe del resultados" del boton "Anadir" en la columna Informe

Validacion previa

Antes de abrir el dialogo, el sistema valida:

• Debe existir al menos un procedimiento con resultado validado (resultado_validacion_validado = true)
• Si no se cumple, muestra: "Se requiere un procedimiento validado como minimo." (severity: error, duracion: 5000ms)

Dialogo

Se abre como dialogo con titulo "Generar informe de resultado" al 90% del ancho y 95% del alto.

Seleccion de procedimientos

Se muestra un arbol de procedimientos con checkboxes:

Tipo	Visual	Comportamiento
GRUPO	Texto en azul, sin checkbox, no seleccionable	Agrupador visual.
PROCEDIMIENTO	Texto en negro, con checkbox	Seleccionable individualmente.
PROCEDIMIENTO ya generado	Texto verde con tachado	El procedimiento ya tiene un informe generado previamente.
PROCEDIMIENTO no validado	Texto rojo con tachado	El procedimiento no ha sido validado aun y no se puede seleccionar.

"SELECCIONAR TODO": Checkbox que selecciona/deselecciona todos los procedimientos disponibles.

Campos del formulario

Campo	Tipo	Requerido	Descripcion
Fecha	p-calendar con selector de hora	Si	Fecha y hora del informe. Formato: DD/MM/YYYY HH:mm. Se establece automaticamente a la fecha y hora actual.
Descripcion	input text	Si	Descripcion del informe. Se auto-genera concatenando los nombres de los grupos de los procedimientos seleccionados, separados por guion.

Validaciones

Validacion	Mensaje
No se selecciono ningun procedimiento	"Seleccione un procedimiento como minimo." (severity: warn)
Descripcion vacia	"Ingrese la descripcion del informe" (severity: warn)

Flujo al guardar

Botones

Boton	Accion
Cancelar	Cierra el dialogo sin generar.
Guardar	Genera el informe PDF y lo registra. Muestra spinner de carga mientras procesa.

---

Subir informe

Acceso

Se accede desde:

• La opcion "Subir informe" del menu contextual
• La opcion "Subir informe" del boton "Anadir" en la columna Informe

Dialogo

Se abre como dialogo con titulo "Subir informe" al 90% del ancho y 95% del alto.

Seleccion de procedimientos

Se muestra el mismo arbol de procedimientos que en "Generar informe", pero solo se muestran los procedimientos donde registrar_resultado es false (procedimientos que no requieren ingreso de resultado por analito).

Campos del formulario

Campo	Tipo	Requerido	Descripcion
Fecha	p-calendar con selector de hora	Si	Fecha y hora del informe. Se establece a la fecha actual.
Descripcion	input text	Si	Descripcion del informe. Se auto-genera a partir de los nombres de los grupos de los procedimientos seleccionados.

Zona de carga de archivos

Se utiliza ngx-dropzone para la carga de archivos:

Propiedad	Valor
Extensiones aceptadas	Solo .pdf
Tamano maximo	1 MB
Cantidad maxima	1 archivo
Texto de la zona	"Suelta tus archivos aqui o haz clic en esta zona."

Archivo cargado: Se muestra como un p-chip con el nombre del archivo y un boton de eliminar (X). Tambien se muestra una barra de progreso durante la subida.

Mensajes de validacion de archivos

Condicion	Mensaje
Extension no permitida	"Solo se acepta extensiones (.pdf)" (severity: warn)
Archivo muy grande	"Solo se acepta archivos de peso (1MB)" (severity: warn)
Ya hay un archivo cargado	"Ya hay un archivo cargado. No se pueden cargar multiples archivos." (severity: warn)
Archivo excede limite (alternativo)	"El archivo es muy grande." (severity: warn)

Validaciones al guardar

Validacion	Mensaje
No se selecciono ningun procedimiento	"Seleccione un procedimiento como minimo." (severity: warn)
Descripcion vacia	"Ingrese la descripcion del informe." (severity: warn)
No se cargo ningun archivo	"Carge el informe para poder subir." (severity: warn)

Flujo al guardar

Botones

Boton	Accion
Cancelar	Cierra el dialogo sin guardar.
Guardar	Sube el archivo y crea el informe. Muestra spinner mientras procesa.

---

Ver informe (PDF)

Acceso

Se accede al hacer clic en el icono de PDF (icono pi pi-file-pdf, rojo) en la columna Informe de la tabla principal.

Dialogo

Se abre como dialogo con titulo "Ver informe" al 90% del ancho y 95% del alto.

Controles

Control	Descripcion
Zoom out (icono -)	Reduce el nivel de zoom del PDF.
Zoom in (icono +)	Aumenta el nivel de zoom del PDF.
Imprimir (icono impresora)	Abre el dialogo de impresion del navegador para el PDF.
Descargar (icono descarga)	Descarga el archivo PDF con el nombre: ndoc-\{apellido_paterno\}-\{descripcion\}-\{datetime\}.pdf.

El PDF se visualiza usando el componente pdf-viewer que renderiza el documento directamente en el navegador.

---

Eliminar informe

Acceso

Se accede al hacer clic en el icono de eliminar (icono pi pi-trash, rojo) en la columna Informe. Solo visible cuando el estado del estudio no es 2 (Publicado) y el estado del informe es 0 (Pendiente).

Dialogo de confirmacion

Elemento	Contenido
Mensaje principal	"Estas seguro de eliminar el informe?"
Mensaje secundario	"Recuerda que si elimina, no habra forma de recuperarla."

Botones

Boton	Accion
Cancelar	Cierra el dialogo sin eliminar.
Eliminar	Elimina el informe y recarga los datos del estudio.

Comportamiento especial

Para informes de tipo 1 (generados a partir de resultados), al eliminar el informe tambien se reinician las validaciones de resultado (resultado_validacion_validado) a false para los procedimientos asociados.

Mensaje de exito

"Informe eliminado con exito" (severity: success, duracion: 5000ms)

---

Publicar resultados

Acceso

Se accede desde la opcion "Publicar resultados" del menu contextual.

Validacion previa

Antes de abrir el dialogo, el sistema valida:

• El estudio debe tener al menos un informe registrado
• Si no tiene informes: "Requiere un informe registrado para realizar esta accion." (severity: warn, duracion: 5000ms)

Dialogo de confirmacion

Se abre como dialogo con titulo "Publicar resultados".

Mensaje: "Estas seguro de realizar la publicacion del estudio?"

Lista de informes

Se muestra una lista de los informes del estudio con checkboxes:

Elemento	Descripcion
Checkbox	Permite seleccionar que informes publicar. Los informes ya publicados (estado 2) se muestran deshabilitados con texto tachado en rojo.
Descripcion	Descripcion del informe.
Ver PDF (enlace)	Abre el visor PDF del informe.

Validaciones

Validacion	Mensaje
No se selecciono ningun informe	"Seleccione un estudios como minimo" (severity: warn)

Flujo al publicar

Datos enviados al servidor DICOM

Campo	Valor
paciente	Datos del paciente (documento, nombres, sexo, fecha nacimiento)
medicos	Lista de medicos responsables del estudio
atencion	Codigo de atencion generado
examen.tipo	"Laboratorio"
examen.descripcion	Descripcion del informe
examen.archivo	Referencia al archivo PDF del informe

Botones

Boton	Accion
Cancelar	Cierra el dialogo sin publicar.
Publicar	Publica los informes seleccionados y actualiza el estado del estudio.

---

Cancelar publicacion

Acceso

Se accede desde la opcion "Cancelar publicacion" del menu contextual.

Dialogo

Se abre como dialogo con titulo "Cancelar publicacion".

Lista de informes

Se muestra una lista similar a la de publicacion, pero con la logica invertida:

Elemento	Descripcion
Checkbox	Solo los informes con estado Publicado (2) son seleccionables. Los informes Pendientes (0) se muestran deshabilitados.
Descripcion	Descripcion del informe.
Ver PDF (enlace)	Abre el visor PDF del informe.

Flujo al cancelar publicacion

Botones

Boton	Accion
Cancelar	Cierra el dialogo sin cambios.
Cancelar publicacion	Revierte la publicacion de los informes seleccionados.

---

Compartir estudio

Acceso

Se accede desde la opcion "Compartir estudio" del menu contextual.

Dialogo

Se abre como dialogo con titulo "Compartir".

Contenido

Se muestra un textarea de solo lectura con un mensaje predefinido para compartir el estudio con el paciente:

Estimado(a) : {nombres del paciente} le enviamos su estudio de {tipo de estudio},
solo necesita acceder al siguiente link y podra visualizarlo y descargarlo.

VISOR DE IMAGENES
{enlace al visor}

Enlace del visor: https://hxviewer-paciente.yabaja.com/viewer?StudyInstanceUIDs=\{study_instance_uid\}

Mapeo de tipos de estudio:

Codigo	Nombre mostrado
DX	RAYOS X
CT	TOMOGRAFIA

Botones

Boton	Accion
Copiar	Copia el mensaje completo al portapapeles. Mensaje de exito: "Se ha copiado el mensaje con exito" (severity: success, duracion: 2000ms).

---

Dar de baja un estudio

Acceso

Funcionalidad de eliminacion/baja del estudio.

Dialogo de confirmacion

Elemento	Contenido
Mensaje	"Estas seguro de proceder con la baja?"

Botones

Boton	Accion
No	Cierra el dialogo sin cambios.
Si	Establece el estado del estudio a 3 (De baja) via patchEstudios.

Mensaje de exito

"Eliminado." (severity: success, duracion: 5000ms)

---

Exportar a Excel

Acceso

Se accede al hacer clic en el boton "Exportar" de la barra de herramientas principal.

Dialogo

Se abre como dialogo con titulo "Exportar excel".

Campos del formulario

Campo	Tipo	Descripcion
Customizar nombre de archivo	input text con boton refresh	Permite personalizar el nombre del archivo. El boton refresh (icono pi pi-refresh) restaura el nombre por defecto.
Tipo de exportacion	p-dropdown	Opciones: REPORTE (valor 1).

Columnas del archivo Excel generado

Columna	Descripcion
FECHA	Fecha del estudio.
HORA	Hora del estudio.
DOCTORES	Nombre del medico referente.
DNI	Numero de documento del paciente.
APELLIDO Y NOMBRES	Nombre completo del paciente.
EDAD	Edad del paciente.
SEXO	Sexo del paciente.
EXAMEN REALIZADO	Nombre del procedimiento.
NOTA DE VENTA	Serie y numero de la venta.
MONTO	Monto del procedimiento.
ATENDIDO	Nombre del responsable del proceso.
DERIVADO	"NO" si el laboratorio es "YABAJA", "SI" en caso contrario.
LABORATORIO	Nombre del laboratorio asignado.

Botones

Boton	Accion
Cancelar	Cierra el dialogo sin exportar.
Exportar	Genera y descarga el archivo Excel.

---

Lista de consulta detalle

Acceso

Pantalla alternativa de listado con titulo "Lista de consulta detalle" que permite ver informacion detallada de los estudios con columnas dinamicas.

Descripcion

Esta vista muestra un reporte detallado de los estudios de laboratorio con columnas configuradas dinamicamente desde el componente. Incluye su propio componente de filtros con opciones adicionales.

Filtros adicionales (vs. lista principal)

Ademas de los filtros de la lista principal (Fecha de estudio, Fecha de venta, Pacientes, Estado, Medico referente), la consulta detalle incluye:

#	Filtro	Tipo de control	Descripcion
6	Examen Realizado	p-dropdown con busqueda	Filtra por procedimiento de laboratorio especifico.
7	Responsable	p-dropdown con busqueda	Filtra por el responsable del proceso (colaborador).
8	Laboratorio	p-dropdown con busqueda	Filtra por laboratorio asignado.

Exportacion

Incluye un boton de exportacion que genera el archivo Excel con las mismas columnas mostradas en la tabla.

---

Nuevo paciente

Se accede desde el boton "Agregar nuevo +" en el campo Paciente del dialogo de Datos de estudio.

El formulario de nuevo paciente incluye campos completos para datos personales, ubicacion geografica (ubigeo), telefonos, correos y contactos. Para informacion detallada sobre este formulario, consulte la documentacion del modulo Pacientes.

---

Nuevo colaborador

Se accede desde el boton "Agregar nuevo +" en el campo Medico referente del dialogo de Datos de estudio. El dialogo se abre al 70% del ancho con titulo "Nuevo colaborador".

El colaborador creado se asigna automaticamente al campo de medico referente con rol MD (Medico).

---

Paginacion

La tabla usa paginacion personalizada de 50 registros por pagina. Se muestra la informacion:

"Mostrando pagina {N} con {registros_actuales} registros de {total} entradas"

Controles de paginacion

Control	Descripcion
Primera pagina	Icono doble flecha izquierda (pi pi-angle-double-left).
Pagina anterior	Icono flecha izquierda (pi pi-angle-left).
Selector de pagina	Dropdown con opciones "N de M" y filtro de busqueda. Mensaje vacio: "Sin paginas". Mensaje filtro vacio: "Sin resultados".
Pagina siguiente	Icono flecha derecha (pi pi-angle-right).
Ultima pagina	Icono doble flecha derecha (pi pi-angle-double-right).

---

Parametros de configuracion del modulo

El modulo utiliza parametros del sistema agrupados por dominio:

Dominio: CONFIG-ERPX-SALUD-CATALOGO-PROCEDIMIENTO-LABORATORIO

Parametros de configuracion de procedimientos de laboratorio.

Dominio: CONFIG-ERPX-SALUD-LABORATORIOS-ESTUDIOS-RESULTADOS

Parametro	Descripcion
PATH-INFORME-REPORT	Ruta de la plantilla para generar informes PDF de resultados.

Dominio: CONFIG-ERPX-SALUD-LABORATORIO-ESTUDIO

Parametros generales del modulo de laboratorios estudios.

Parametro	Descripcion
LABORATORIO-DEFECTO	ID del laboratorio asignado por defecto al crear estudios desde ventas pendientes.

---

Mensajes de error del sistema

Codigo HTTP	Mensaje mostrado
400	"Error de estructura de envio de datos. ERROR 400"
401 / 402 / 403	Mensajes especificos del servidor (concatenados si son multiples).
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."

---

Problemas comunes y soluciones

Problema	Solucion
No aparecen ventas en "Agregar estudios pendientes"	Verifique que las ventas tienen procedimientos de tipo LABORATORIO, estan en estado activo (0) y no tienen estudio de laboratorio asignado.
Error "Se requiere un procedimiento validado como minimo" al generar informe	Ingrese y valide los resultados de al menos un procedimiento antes de generar el informe. Use "Validar resultados" del menu contextual.
Error "Requiere un informe registrado" al publicar	Genere o suba al menos un informe antes de publicar. Use "Generar informe del resultados" o "Subir informe".
No puedo editar el medico referente	La edicion inline no esta disponible para estudios publicados (estado 2) o con baja de venta (estado 4). Cancele la publicacion primero.
Los badges de procedimientos aparecen en gris	El procedimiento no tiene fecha de muestra asignada. Abra "Datos de estudio" y asigne la fecha de muestra.
Error al subir informe: "Solo se acepta extensiones (.pdf)"	El archivo debe tener extension .pdf. Otros formatos no son aceptados.
Error al subir informe: "Solo se acepta archivos de peso (1MB)"	Reduzca el tamano del archivo PDF a 1 MB o menos.
No puedo eliminar un informe	Solo se pueden eliminar informes con estado Pendiente (0) en estudios que no esten publicados (estado 2).
El estudio muestra estado "Baja de venta" y no puedo editarlo	Este estado se asigna automaticamente cuando la venta asociada fue anulada. No se puede revertir desde el modulo de laboratorios; la venta debe reactivarse.
Los resultados no se guardan correctamente	Verifique que los campos de resultado y validacion estan completos. Use el boton "Replicar resultado" para copiar resultados a validaciones rapidamente.
El informe generado no incluye todos los procedimientos	Solo se incluyen en el informe los procedimientos seleccionados con checkbox. Los procedimientos no validados (texto rojo tachado) no se pueden seleccionar.
No aparece la opcion "Subir informe" en la seleccion de procedimientos	La opcion de subir informe solo muestra procedimientos donde registrar_resultado es false. Si todos los procedimientos requieren ingreso de resultado, use "Generar informe" en su lugar.

---

Paginas relacionadas

• Pacientes — registro y administracion de pacientes
• Medicos referentes — gestion de medicos referentes
• Procedimientos de laboratorios — configuracion de procedimientos y analitos
• Catalogos de laboratorios — catalogos de laboratorios
• Estudios (PACS/RIS) — estudios de imagen diagnostica
• Sistema de Gestión Comercial — ventas de servicios de salud