Médicos Referentes

Gestión de médicos referentes (externos) en el módulo de Salud de Davix ERPX.

Descripción general

La pantalla Lista de médicos referentes permite registrar y administrar médicos referentes externos al establecimiento de salud. A diferencia de los médicos internos, los médicos referentes tienen un formulario simplificado que solo requiere datos básicos de identificación (nombres, apellidos, CMP, RNE) e información de contacto (teléfonos y correos).

Ruta de navegación: Inicio → Salud → Medicos referentes

Vista principal (listado de médicos referentes)

Encabezado

Elemento	Descripción
Título	"Lista de médicos referentes"
Subtítulo	"Muestra el listado y las herramientas para gestionar los médicos"
Botón "Actualizar"	Icono `pi pi-refresh`. Recarga la tabla.
Botón "Nuevo médico"	Icono `pi pi-plus`. Abre el diálogo de creación.

Barra de búsqueda y filtros

Idéntica en estructura a la pantalla de Médicos.

Elemento	Tipo	Descripción
Campo de búsqueda	`pInputText` con icono `pi pi-search`	Búsqueda por texto libre. Se ejecuta al presionar Enter o al hacer clic en "Buscar".
Chips de filtros activos	`p-chip`	Filtros aplicados como chips removibles.
Botón "Agregar filtro"	Icono `pi pi-filter`	Abre el panel overlay de filtros.
Botón "Quitar filtros"	Icono `pi pi-filter-slash`	Elimina todos los filtros.
Botón "Buscar"	Icono `pi pi-search`	Ejecuta la búsqueda.

Panel de filtros (overlay)

Filtro	Valor	Campos adicionales
Fecha	1	Fecha inicio* (`input[type=date]`), Fecha fin* (`input[type=date]`)
Tipo documento	2	Tipo documento* (`p-dropdown`): DNI, Pasaporte
Numero documento	3	Numero documento* (`pInputText`)
Medico	4	Médico* (`p-autoComplete`): busca en el endpoint de médicos referentes, muestra nombres y número de documento

Indicador de paginación

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

Columnas de la tabla

Columna	Ancho	Ordenable	Descripción
Nombre	Flexible	Sí	Nombres del médico referente.
A. paterno	Flexible	Sí	Apellido paterno.
A. Materno	Flexible	Sí	Apellido materno.
Dirección	250px fijo	Sí	Dirección del médico referente.
Telefonos	100px fijo	Sí	Lista de números de teléfono separados por coma.
Correos	100px fijo	Sí	Lista de correos electrónicos separados por coma.
Acciones	80px fijo	No	Icono de tres puntos (`pi pi-ellipsis-h`) para el menú contextual.

A diferencia de la pantalla de Médicos internos, la tabla de médicos referentes no muestra las columnas de Tipo Documento, Número Documento ni Especialidades.

Cuando no hay registros: "No se encontraron datos".

Menú contextual

Opción	Icono	Descripción
Detalles	`pi pi-eye`	Muestra los detalles del médico referente (funcionalidad pendiente de implementación).
Editar	`pi pi-pencil`	Abre el diálogo de edición con los datos precargados.
Eliminar	`pi pi-trash`	Abre el diálogo de confirmación para eliminar.

Paginación

Mismos controles que la pantalla de Médicos: primera página, anterior, selector de página (dropdown), siguiente, última página. Tamaño de página: 50 registros.

Crear / editar médico referente

Al hacer clic en "Nuevo médico" o "Editar", se abre un diálogo a pantalla completa (DynamicDialog).

Título al crear: "Nuevo médico"
Título al editar: "Actualizar datos de {nombres} {apellido_paterno} {apellido_materno}"

Al editar, el sistema obtiene los datos actualizados del médico referente desde el servidor antes de mostrar el formulario.

Sección: Datos generales

Subtítulo: "Se tiene que rellenar los campos mínimos para identificar al médico."

Campo	Tipo	Obligatorio	Ancho	Tooltip	Mensaje de error
Nombres	`pInputText`	Sí	4/12 col	"Ingrese los nombres"	"* Ingrese los nombres"
Apellido paterno	`pInputText`	Sí	4/12 col	"Ingrese el apellido paterno"	"* Ingrese el apellido paterno"
Apellido materno	`pInputText`	No	4/12 col	"Ingrese el apellido materno"	"* Ingrese el apellido materno"
CMP	`pInputText`	No	4/12 col	"Ingrese el apellido materno"	"* Ingrese el CMP"
RNE	`pInputText`	No	4/12 col	"Ingrese el RNE"	"* Ingrese el apellido materno"

CMP = Código del Médico en el Colegio Médico del Perú. RNE = Registro Nacional de Especialista. Ambos campos son opcionales pero recomendados para la identificación del médico referente.

Sección: Teléfonos

Subtítulo: "Registre la cantidad de correos que tenga el colaborador."

Formulario dinámico (FormArray) para agregar múltiples teléfonos.

Campo	Tipo	Descripción
Número	`pInputText`	Número de teléfono.
Tipo	`p-dropdown`	Opciones: Casa (CASA), Trabajo (TRABAJO), Personal (PERSONAL). Valor por defecto: Personal.

Se inicia con una fila vacía.
Botón "Agregar" (pi pi-plus): agrega una nueva fila.
Icono eliminar (pi pi-times): aparece a partir de la segunda fila.

Sección: Correos

Subtítulo: "Registre la cantidad de telefonos que tenga el colaborador."

Campo	Tipo	Descripción
Correo	`pInputText`	Dirección de correo electrónico.
Tipo	`p-dropdown`	Opciones: Casa (CASA), Trabajo (TRABAJO), Personal (PERSONAL). Valor por defecto: Personal.

Se inicia con una fila vacía.
Botón "Agregar" (pi pi-plus): agrega una nueva fila.
Icono eliminar (pi pi-times): aparece a partir de la segunda fila.

Botones del diálogo

Ubicados en la parte inferior fija del diálogo.

Botón	Icono	Descripción
Cancelar	`pi pi-times`	Cierra el diálogo sin guardar.
Guardar	`pi pi-check` (cambia a spinner durante el proceso)	Valida el formulario y guarda. Se deshabilita durante el guardado.

Validaciones al guardar

Campos obligatorios:

Nombres
Apellido paterno

Si hay errores: "Revise bien, hay formularios por validar." (severidad: error, duración: 5s, posición: bottom-left).

Datos enviados al servidor

El formulario envía:

id (solo en edición)
fecha: fecha actual en formato YYYY-MM-DD
nombres, apellido_paterno, apellido_materno
cmp, rne
telefonos: array de objetos \{numero, tipo\}
correos: array de objetos \{correo, tipo\}
creator_id: ID del colaborador autenticado
user_id: ID del usuario autenticado

Notificaciones al guardar

Resultado	Severidad	Mensaje	Duración
Creación exitosa	success	"Registrado con éxito"	5 segundos
Actualización exitosa	success	"Se ha actualizado con éxito"	5 segundos
Error	error	Mensaje de error del servidor	5 segundos

Eliminar médico referente

Al seleccionar "Eliminar" del menú contextual, se abre un diálogo de confirmación (DynamicDialog) con título "Confirmación" y ancho de 50vw.

Elemento	Descripción
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 sin eliminar.
Botón "Si"	Icono `pi pi-check` (cambia a spinner). Ejecuta la eliminación.

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

Endpoints

Método	Endpoint	Descripción
`GET`	`/v2.0.4/erpx/salud/medicos-referentes/`	Lista todos los médicos referentes con paginación y búsqueda.
`GET`	`/v2.0.4/erpx/salud/medicos-referentes/\{id\}`	Obtiene un médico referente por su ID (para edición).
`POST`	`/v2.0.4/erpx/salud/medicos-referentes/`	Crea un nuevo médico referente.
`PUT`	`/v2.0.4/erpx/salud/medicos-referentes/\{id\}`	Actualiza un médico referente existente.
`DELETE`	`/v2.0.4/erpx/salud/medicos-referentes/\{id\}`	Elimina un médico referente.
`GET`	`/v2.0.1/erpx/global/params/`	Obtiene los parámetros de configuración.
`GET`	`/v2.0.1/erpx/rrhh/roles/`	Lista los roles de RRHH (para filtrar por roles médicos).

Problemas comunes

Problema	Causa	Solución
"Revise bien, hay formularios por validar"	Los campos Nombres y/o Apellido paterno están vacíos.	Complete los campos obligatorios marcados con (*).
La tabla de médicos referentes está vacía	No hay médicos referentes registrados o los filtros aplicados no coinciden con ningún registro.	Quite los filtros y verifique que existan registros.
Error al guardar	Datos inválidos o problemas de conexión con el servidor.	Verifique los datos ingresados y la conexión al servidor.

Páginas relacionadas

Médicos — Gestión de médicos internos del establecimiento de salud.
Catálogos — Gestión general de catálogos de salud.