diff --git "a/openapi.yaml" "b/openapi.yaml" new file mode 100644--- /dev/null +++ "b/openapi.yaml" @@ -0,0 +1,4214 @@ +openapi: 3.0.1 +info: + title: 'Módulo 6 - Internación y Gestión de Camas' + description: > + API REST del módulo de Internación y Gestión de Camas para la red + hospitalaria Health Grid. + + + ## Modelo de Dominio + + + Un **EPISODIO DE INTERNACIÓN** comienza cuando se aprueba una solicitud de + cama y termina + + cuando el Módulo 1 (HCE) notifica el alta médica. + + + El flujo principal es: + + + 1. Un médico solicita una cama desde HCE (M1) + + 2. La solicitud llega a este módulo como webhook entrante + + 3. Un administrativo la aprueba (con la cama pedida u otra), o la rechaza + + 4. Al aprobar → se asigna la cama al paciente (estado `OCUPADA`) + + 5. Los traslados también llegan como solicitudes desde HCE (M1) o se + realizan directamente + + 6. El alta médica llega como webhook desde HCE (M1) + + + ### Solicitudes + + + Las solicitudes de internación y traslado llegan desde HCE (M1) y quedan en + estado + + `PENDIENTE` hasta que un administrativo las resuelve. + + + | Resolución | Efecto | + + |------------|--------| + + | `APROBAR` | Se ejecuta la acción (ingreso o traslado) con la cama + solicitada | + + | `APROBAR_CON_CAMBIO` | Se ejecuta la acción con una cama distinta a la + solicitada | + + | `RECHAZAR` | No se ejecuta ninguna acción. Se notifica a HCE | + + + ## Leyenda de Endpoints + + + - **Sin prefijo:** Endpoints PROPIOS de este módulo (implementados por + nosotros) + + - **Tag [EXT]:** Endpoints de otros módulos, documentados como referencia. + Mockeados localmente en la 2da entrega + + + ## Webhooks Salientes (HTTP POST que este módulo dispara) + + + | Evento | Receptor | Cuándo | + + |--------|----------|--------| + + | `SOLICITUD_RESUELTA` | Módulo 1 - HCE | Al aprobar o rechazar una + solicitud | + + | `ALTA_MONITOREO` | Módulo 9 - Monitoreo | Al asignar una cama a un + paciente (ingreso o traslado destino) | + + | `BAJA_MONITOREO` | Módulo 9 - Monitoreo | Al dar el alta médica o al + trasladar un paciente (cama origen) | + + | `CAMA_LISTA` | Módulo 7 - Facturación | Al completar limpieza post-alta + (cama pasa de EN_LIMPIEZA a DISPONIBLE) | + + + ## Webhooks Entrantes (HTTP POST que recibimos de otros módulos) + + + | Evento | Emisor | Cuándo | + + |--------|--------|--------| + + | Solicitud de internación | Módulo 1 - HCE | Un médico solicita cama para + internar un paciente | + + | Solicitud de traslado | Módulo 1 - HCE | Un médico solicita trasladar un + paciente internado | + + | Alta médica | Módulo 1 - HCE | Un médico da el alta al paciente | + + | Alerta de emergencia | Módulo 9 - Monitoreo | Se detecta un código rojo en + un paciente | + + + ## APIs Externas Consumidas + + + | Módulo | Endpoint | Cuándo se usa | + + |--------|----------|---------------| + + | Core (M10) | `GET /usuarios/{pacienteId}` | Al aprobar una solicitud de + internación | + + | Core (M10) | `POST /auth/validate-token` | En cada request (middleware + JWT) | + + | HCE (M1) | `GET /pacientes/{pacienteId}/contraindicaciones` | Al aprobar + una solicitud de internación | + + | HCE (M1) | `POST /hce/solicitudes/{solicitudHceId}/resultado` | Al + resolver una solicitud | + + | HCE (M1) | `GET /hce/pacientes/{pacienteId}` | Al mostrar el detalle del + paciente internado en una cama | + + | HCE (M1) | `POST /hce/movimientos` | Al asignar una cama o trasladar un + paciente | + + | Turnos (M2) | `GET /turnos/{turnoId}` | Al aprobar solicitud con + origen=CIRUGIA_PROGRAMADA | + + | Facturación (M7) | `POST /webhooks/internacion/cama-lista` | Al completar + limpieza post-alta | + + | Monitoreo (M9) | `POST /webhooks/internacion/baja-monitoreo` | Al dar alta + médica o trasladar (cama origen) | + + | Monitoreo (M9) | `POST /webhooks/internacion/alta-monitoreo` | Al asignar + cama a un paciente (ingreso o traslado destino) | + + | HCE (M1) | `POST /hce/episodios/{episodioId}/eventos` | Al recibir alerta + de emergencia de M9 | + version: 4.0.0 + contact: + name: Grupo Módulo 6 - UADE + license: + name: Uso académico +tags: + - name: Camas + - name: Solicitudes + - name: Webhooks Entrantes + - name: '[EXT] HCE - Módulo 1' + - name: '[EXT] Turnos - Módulo 2' + - name: '[EXT] Facturación - Módulo 7' + - name: '[EXT] Monitoreo - Módulo 9' + - name: '[EXT] Core - Módulo 10' +paths: + /camas: + get: + summary: Obtener mapa completo de camas + deprecated: false + description: > + Retorna el estado actual de todas las camas del hospital con + estadísticas agregadas. + + Permite filtrar por piso, sector, estado y hospital. + + + > **Nota:** Las camas con estado `BAJA_PERMANENTE` **no** se incluyen + por defecto. + + + ## Comportamiento por rol + + + | Rol | Comportamiento | + + |-----|----------------| + + | `ADMINISTRATIVO`, `MEDICO` | Ve todas las camas con todos los filtros + | + + | `LIMPIEZA` | Solo ve camas con estado `EN_LIMPIEZA`. Los demás filtros + de estado se ignoran. | + + + ## Roles permitidos + + + `MEDICO`, `ADMINISTRATIVO` y `LIMPIEZA`. + operationId: getCamas + tags: + - Camas + parameters: + - name: piso + in: query + description: '' + required: false + schema: + type: integer + - name: sector + in: query + description: '' + required: false + schema: + type: string + - name: estado + in: query + description: '' + required: false + schema: + type: string + - name: hospital_id + in: query + description: '' + required: false + schema: + type: string + responses: + '200': + description: Mapa de camas con estadísticas + content: + application/json: + schema: + $ref: '#/components/schemas/CamaMapaResponse' + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + headers: {} + '403': + $ref: '#/components/responses/NoAutorizado' + description: El rol del usuario no tiene permisos para esta acción + headers: {} + security: + - BearerAuth: [] + post: + summary: Crear una nueva cama + deprecated: false + description: > + Permite a un administrador dar de alta una nueva cama en el inventario + hospitalario. + + + ## Consideraciones + + + - El `id` de la cama es un entero generado automáticamente por el + sistema. + + - La cama se crea en estado `DISPONIBLE` por defecto. + + + ## Roles permitidos + + + Solo usuarios con rol `ADMINISTRATIVO` pueden ejecutar esta operación. + operationId: crearCama + tags: + - Camas + parameters: [] + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CamaCreateRequest' + examples: + cama_uti: + value: + numero: '210' + piso: 2 + sector: UTI + tipo: CRITICA + hospital_id: HOSP-001 + contraindicaciones_incompatibles: + - ALERGIA_LATEX + summary: Nueva cama de UTI + cama_sala: + value: + numero: '315' + piso: 3 + sector: SALA_COMUN + tipo: ESTANDAR + hospital_id: HOSP-001 + contraindicaciones_incompatibles: [] + summary: Nueva cama de sala común + cama_quirofano: + value: + numero: Q01 + piso: 5 + sector: QUIROFANO + tipo: CIRUGIA + hospital_id: HOSP-001 + specialty_id: 43 + contraindicaciones_incompatibles: [] + summary: Nuevo quirófano (CIRUGIA) con specialty_id + required: true + responses: + '201': + description: Cama creada exitosamente + content: + application/json: + schema: + $ref: '#/components/schemas/Cama' + example: + id: 210 + numero: '210' + piso: 2 + sector: UTI + tipo: CRITICA + estado: DISPONIBLE + paciente_id: null + hospital_id: HOSP-001 + contraindicaciones_incompatibles: + - ALERGIA_LATEX + ultima_actualizacion: '2025-06-01T09:00:00Z' + specialty_id: null + headers: {} + '400': + $ref: '#/components/responses/ErrorValidacion' + description: Error de validación en el body de la request + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '403': + $ref: '#/components/responses/NoAutorizado' + description: El rol del usuario no tiene permisos para esta acción + security: + - BearerAuth: [] + /camas/{camaId}: + get: + summary: Obtener detalle de una cama + deprecated: false + description: | + ## Roles permitidos + + `MEDICO` y `ADMINISTRATIVO`. + operationId: getCamaById + tags: + - Camas + parameters: + - name: camaId + in: path + description: Identificador único de la cama (entero autogenerado) + required: true + example: 0 + schema: + type: integer + example: 204 + responses: + '200': + description: Detalle de la cama + content: + application/json: + schema: + $ref: '#/components/schemas/Cama' + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '403': + $ref: '#/components/responses/NoAutorizado' + description: El rol del usuario no tiene permisos para esta acción + '404': + $ref: '#/components/responses/CamaNoEncontrada' + description: Cama no encontrada + security: + - BearerAuth: [] + patch: + summary: Actualizar estado o contraindicaciones incompatibles de una cama + deprecated: false + description: > + Permite cambiar el estado de una cama manualmente o actualizar la lista + + de `contraindicaciones_incompatibles`. + + + **Restricciones:** + + - El estado `OCUPADA` solo se asigna automáticamente al aprobar + solicitudes o al asignar. + + - El estado `CODIGO_ROJO` solo lo setea el webhook de alerta de + emergencia de M9. + + + ## Roles permitidos + + + `ADMINISTRATIVO` y `LIMPIEZA`. + + + ## Restricciones por rol + + + | Rol | Transiciones permitidas | + + |-----|------------------------| + + | `ADMINISTRATIVO` | Cualquier transición manual válida | + + | `LIMPIEZA` | Solo `EN_LIMPIEZA` → `DISPONIBLE` | + + + ## Comportamiento especial: limpieza completada (post-alta) + + + Cuando una cama pasa de `EN_LIMPIEZA` a `DISPONIBLE` y el último + + movimiento del paciente fue un **alta médica**: + + + 1. Se dispara el webhook `CAMA_LISTA` al Módulo 7 (Facturación) + con los datos del episodio para la liquidación de prestaciones. + 2. Se emite evento `CAMA_ACTUALIZADA` por WebSocket. + + + Si la cama estaba `EN_LIMPIEZA` por un **traslado** (no por alta), + + **no** se dispara el webhook a facturación. + + + > **Nota:** En versiones anteriores, `CAMA_LISTA` se disparaba al + + > recibir el alta médica. Ahora se dispara al completar la limpieza. + operationId: updateCamaEstado + tags: + - Camas + parameters: + - name: camaId + in: path + description: '' + required: true + example: 0 + schema: + type: integer + example: 0 + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CamaUpdateRequest' + required: true + responses: + '200': + description: Estado actualizado exitosamente + content: + application/json: + schema: + $ref: '#/components/schemas/Cama' + headers: {} + '400': + $ref: '#/components/responses/ErrorValidacion' + description: Error de validación en el body de la request + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + headers: {} + '403': + $ref: '#/components/responses/NoAutorizado' + description: El rol del usuario no tiene permisos para esta acción + headers: {} + '404': + $ref: '#/components/responses/CamaNoEncontrada' + description: Cama no encontrada + headers: {} + '409': + description: Conflicto con el estado actual de la cama + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + headers: {} + security: + - BearerAuth: [] + delete: + summary: Dar de baja permanente una cama + deprecated: false + description: > + Realiza una **baja lógica** (soft delete) de la cama: la marca con + estado + + `BAJA_PERMANENTE` y la excluye del inventario operativo. + + + No se elimina el registro físico de la base de datos para preservar la + trazabilidad + + histórica (episodios pasados que referenciaron esta cama siguen siendo + válidos). + + + ## Restricciones + + + - Solo se puede dar de baja una cama que esté en estado `DISPONIBLE` o + `FUERA_DE_SERVICIO`. + + - Si la cama está `OCUPADA` o `EN_LIMPIEZA` (lo que implica que estuvo + ocupada + recientemente), la operación es rechazada con `409 Conflict`. + - Una cama con estado `BAJA_PERMANENTE` **no puede** ser reactivada a + través de esta API + (requiere intervención manual en base de datos o un proceso administrativo separado). + + ## Roles permitidos + + + Solo usuarios con rol `ADMINISTRATIVO` pueden ejecutar esta operación. + operationId: darDeBajaCama + tags: + - Camas + parameters: + - name: camaId + in: path + description: Identificador único de la cama (entero autogenerado) + required: true + example: 0 + schema: + type: integer + example: 204 + responses: + '200': + description: Cama dada de baja permanente exitosamente + content: + application/json: + schema: + $ref: '#/components/schemas/Cama' + example: + id: 210 + numero: '210' + piso: 2 + sector: UTI + tipo: CRITICA + estado: BAJA_PERMANENTE + paciente_id: null + hospital_id: HOSP-001 + contraindicaciones_incompatibles: [] + ultima_actualizacion: '2025-06-15T14:00:00Z' + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '403': + $ref: '#/components/responses/NoAutorizado' + description: El rol del usuario no tiene permisos para esta acción + '404': + $ref: '#/components/responses/CamaNoEncontrada' + description: Cama no encontrada + '409': + description: La cama no puede darse de baja en su estado actual + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: CAMA_EN_USO + mensaje: No se puede dar de baja una cama en uso + detalle: >- + La cama 204 está OCUPADA por el paciente 123. Dé de alta al + paciente antes de proceder. + headers: {} + security: + - BearerAuth: [] + /camas/{camaId}/asignar: + post: + summary: Asignar o trasladar un paciente a una cama + deprecated: false + description: > + Permite asignar directamente un paciente a una cama (ingreso) o + trasladarlo + + desde su cama actual a esta cama (traslado), sin requerir una solicitud + previa. + + + Antes de asignar, el sistema verifica que ninguna contraindicación del + paciente + + esté en la lista `contraindicaciones_incompatibles` de la cama destino. + Si + + alguna coincide, devuelve `HTTP 422 CONTRAINDICACION_DETECTADA`. + + + ## Tipos de movimiento + + + | Tipo | Descripción | + + |------|-------------| + + | `INGRESO` | Asigna el paciente a la cama. La cama pasa a estado + `OCUPADA`. | + + | `TRASLADO` | Mueve al paciente desde su cama actual (`cama_origen_id`) + a esta. La cama origen pasa a `EN_LIMPIEZA`, la destino a `OCUPADA`. | + + + ## Efectos colaterales + + + - **[EXT]** Notifica el movimiento a HCE (M1) vía `POST + /hce/movimientos` + + - **[EXT]** Si `tipo=INGRESO`: emite `ALTA_MONITOREO` a M9 (el paciente + entra en monitoreo) + + - Si `tipo=TRASLADO`: **no** se emiten eventos de monitoreo (el + monitoreo sigue al paciente, no a la cama) + + + ## Roles permitidos + + + Solo usuarios con rol `ADMINISTRATIVO`. + operationId: asignarCama + tags: + - Camas + parameters: + - name: camaId + in: path + description: Identificador único de la cama (entero autogenerado) + required: true + example: 0 + schema: + type: integer + example: 204 + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AsignacionCamaRequest' + examples: + ingreso: + value: + tipo: INGRESO + paciente_id: 123 + summary: Asignación de cama (ingreso) + traslado: + value: + tipo: TRASLADO + paciente_id: 123 + cama_origen_id: 204 + summary: Traslado a esta cama + required: true + responses: + '200': + description: Cama asignada o traslado realizado exitosamente + content: + application/json: + schema: + $ref: '#/components/schemas/AsignacionCamaResponse' + example: + mensaje: Paciente 123 asignado a la cama 315 + cama_id: 315 + paciente_id: 123 + tipo: INGRESO + cama_origen_id: null + timestamp: '2025-01-15T10:30:00Z' + headers: {} + '400': + $ref: '#/components/responses/ErrorValidacion' + description: Error de validación en el body de la request + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '403': + $ref: '#/components/responses/NoAutorizado' + description: El rol del usuario no tiene permisos para esta acción + '404': + $ref: '#/components/responses/CamaNoEncontrada' + description: Cama no encontrada + '409': + description: Conflicto con el estado de la cama o del paciente + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: CAMA_NO_DISPONIBLE + mensaje: La cama destino no está disponible + detalle: La cama 315 está actualmente en estado OCUPADA + headers: {} + '422': + description: Contraindicación del paciente incompatible con la cama destino + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: CONTRAINDICACION_DETECTADA + mensaje: >- + El paciente tiene contraindicaciones incompatibles con la cama + destino + detalle: La cama 204 es incompatible con ALERGIA_LATEX del paciente 123 + headers: {} + '502': + description: Error al notificar movimiento a HCE (M1) + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: SERVICIO_EXTERNO_NO_DISPONIBLE + mensaje: No se pudo notificar el movimiento a HCE + detalle: >- + El módulo HCE (M1) no respondió en el tiempo esperado. La + asignación de cama fue completada. + headers: {} + security: + - BearerAuth: [] + /camas/{camaId}/reservas: + get: + summary: Listar reservas de un quirófano + deprecated: false + description: > + Retorna las reservas de un quirófano con filtros opcionales. + + Por defecto devuelve reservas con estado `RESERVADA` y `EN_CURSO`. + + + Solo aplica a camas con **sector=QUIROFANO y tipo=CIRUGIA**. + + Si la cama no cumple esta condición, responde `409 + CAMA_NO_ES_QUIROFANO`. + + + ## Roles permitidos + + + `MEDICO` y `ADMINISTRATIVO`. + operationId: getReservasQuirofano + tags: + - Camas + parameters: + - name: camaId + in: path + description: '' + required: true + example: 0 + schema: + type: integer + example: 0 + - name: estado + in: query + description: '' + required: false + schema: + type: string + - name: prioridad + in: query + description: >- + Filtra las reservas por prioridad clínica. Acepta un único valor del + enum `PrioridadQuirofanoEnum`. + required: false + schema: + $ref: '#/components/schemas/PrioridadQuirofanoEnum' + - name: fecha_desde + in: query + description: '' + required: false + schema: + type: string + format: date + - name: fecha_hasta + in: query + description: '' + required: false + schema: + type: string + format: date + responses: + '200': + description: Lista de reservas del quirófano + content: + application/json: + schema: + type: object + properties: + total: + type: integer + example: 2 + reservas: + type: array + items: + $ref: '#/components/schemas/ReservaQuirofanoResponse' + headers: {} + '401': + description: No autenticado + headers: {} + '404': + description: Cama no encontrada + headers: {} + '409': + description: La cama no es un quirófano (sector!=QUIROFANO o tipo!=CIRUGIA) + headers: {} + security: + - BearerAuth: [] + post: + summary: Crear reserva de quirófano programada + deprecated: false + description: > + Crea una reserva de quirófano para una cirugía programada. **Este + endpoint lo invoca exclusivamente M2 (Turnos)** cuando confirma un turno + quirúrgico. No existe una UI en M6 para crear reservas: todo el flujo de + reservas nace fuera de este módulo. + + + ## Flujos de reserva en M6 + + + M6 maneja reservas de quirófano sólo a través de estos cuatro caminos + automáticos. Ninguno requiere intervención manual de un administrativo + de M6: + + + | Escenario | Entrada a M6 | Resultado | + + |-----------|--------------|-----------| + + | Cirugía programada | `POST /camas/{camaId}/reservas` ← M2 | Reserva + `PROGRAMADA` con prioridad elegida por M2 | + + | Urgencia sin conflicto | `POST /webhooks/hce/cirugia-urgente` ← M1 | + Reserva `EMERGENCIA` en un quirófano libre | + + | Urgencia con conflicto | `POST /webhooks/hce/cirugia-urgente` ← M1 | + Reserva `EMERGENCIA` + desplazamiento de la programada de menor + prioridad + aviso a M2 | + + | Cancelación de turno | `POST /turnos/{turnoId}/cancelacion-quirofano` + ← M2 | Reserva pasa a `CANCELADA` | + + + ## Semántica + + + - `turno_id` es obligatorio. El `origen` resultante es siempre + `PROGRAMADA`. + + - La respuesta HTTP es el resultado definitivo: + - `201 Created`: la reserva quedó confirmada. + - `409 Conflict`: no se pudo reservar (superposición, cama no + disponible o cama que no corresponde a quirófano). + + `GET /camas/disponibilidad` puede usarse previamente desde M2 para + mostrar opciones, pero no reemplaza esta validación. El check de + superposición y la inserción de la reserva se ejecutan en una única + transacción para evitar race conditions. + + + ## Validaciones + + + - La cama debe tener **sector=QUIROFANO y tipo=CIRUGIA**. + + - La cama no debe estar en `FUERA_DE_SERVICIO` ni `BAJA_PERMANENTE`. + + - `fecha_hora_inicio` debe ser anterior a `fecha_hora_fin_estimada`. + + - No debe existir otra reserva activa superpuesta para la misma cama. + + - `turno_id` es obligatorio y no debe existir otra reserva activa para + ese turno (idempotencia: reintentos con el mismo `turno_id` devuelven la + reserva existente con `200 OK` en vez de duplicarla). + + - `prioridad` es obligatoria. El valor `URGENTE` está reservado para el + flujo automático de `/webhooks/hce/cirugia-urgente` y no se acepta por + este endpoint (devuelve `HTTP 422 PRIORIDAD_URGENTE_NO_PERMITIDA`). + + + ## Autorización + + + Sólo M2 (Turnos). No hay rol humano con permiso para invocar este + endpoint directamente. + operationId: crearReservaQuirofano + tags: + - Camas + parameters: + - name: camaId + in: path + description: '' + required: true + example: 0 + schema: + type: integer + example: 0 + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ReservaQuirofanoCreateRequest' + example: + turno_id: 89 + paciente_id: 123 + medico_cirujano_id: 45 + fecha_hora_inicio: '2025-01-18T09:00:00Z' + fecha_hora_fin_estimada: '2025-01-18T11:00:00Z' + prioridad: MEDIA + observaciones: Colecistectomía laparoscópica programada + required: true + responses: + '200': + description: >- + La reserva ya existía con ese `turno_id` (idempotencia). Devuelve la + reserva previamente registrada sin crear una nueva. + content: + application/json: + schema: + $ref: '#/components/schemas/ReservaQuirofanoResponse' + headers: {} + '201': + description: Reserva creada + content: + application/json: + schema: + $ref: '#/components/schemas/ReservaQuirofanoResponse' + example: + id: 15 + cama_id: 501 + turno_id: 89 + origen: PROGRAMADA + estado: RESERVADA + prioridad: MEDIA + paciente_id: 123 + medico_cirujano_id: 45 + fecha_hora_inicio: '2025-01-18T09:00:00Z' + fecha_hora_fin_estimada: '2025-01-18T11:00:00Z' + observaciones: Colecistectomía laparoscópica programada + desplazada_por_reserva_id: null + created_at: '2025-01-18T08:55:00Z' + headers: {} + '400': + description: Error de validación + headers: {} + '401': + description: No autenticado + headers: {} + '403': + description: No autorizado + headers: {} + '404': + description: Cama no encontrada + headers: {} + '409': + description: Conflicto de reserva + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: RESERVA_SUPERPUESTA + mensaje: No se pudo crear la reserva + detalle: >- + El quirófano 501 ya posee una reserva activa entre + 2025-01-18T09:30:00Z y 2025-01-18T10:30:00Z + headers: {} + '422': + description: Prioridad no permitida para este flujo + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: PRIORIDAD_URGENTE_NO_PERMITIDA + mensaje: La prioridad URGENTE no puede asignarse desde este endpoint + detalle: >- + URGENTE está reservada para el flujo automático de + `/webhooks/hce/cirugia-urgente` + headers: {} + security: + - BearerAuth: [] + /camas/{camaId}/reservas/{reservaId}: + get: + summary: Obtener detalle de una reserva + deprecated: false + description: | + Devuelve el detalle completo de una reserva de quirófano. + + ## Roles permitidos + + `MEDICO` y `ADMINISTRATIVO`. + operationId: getReservaById + tags: + - Camas + parameters: + - name: reservaId + in: path + description: '' + required: true + example: 0 + schema: + type: integer + example: 1 + - name: camaId + in: path + description: '' + required: true + example: 0 + schema: + type: integer + example: 501 + responses: + '200': + description: Detalle de la reserva + content: + application/json: + schema: + $ref: '#/components/schemas/ReservaQuirofanoResponse' + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '404': + description: Reserva o cama no encontrada + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: RECURSO_NO_ENCONTRADO + mensaje: Reserva no encontrada + detalle: No existe reserva con ID 999 en la cama 501 + headers: {} + security: + - BearerAuth: [] + patch: + summary: Actualizar estado de una reserva de quirófano + deprecated: false + description: > + Permite cambiar el estado de una reserva de quirófano desde este módulo. + + + ## Transiciones válidas + + + | De | A | Efecto en la cama | + + |----|---|-------------------| + + | `RESERVADA` | `EN_CURSO` | Cama pasa a `OCUPADA` | + + | `RESERVADA` | `CANCELADA` | Sin cambio en la cama | + + | `EN_CURSO` | `COMPLETADA` | Cama pasa a `EN_LIMPIEZA` | + + + ## Comportamiento + + + Este endpoint `PATCH` queda para acciones internas de M6, por ejemplo + iniciar la + + cirugía, completarla o cancelar una reserva + + + Se usa para cancelaciones cuando la cancelación no nace en M2, sino + dentro de Internación y Gestión de Camas. Por ejemplo: se requiere + liberar un quirófano reservado para una cirugía programada para poder + atender una cirugía de emergencia. + + + - Cambia la reserva a estado `CANCELADA` y libera el recurso para nuevas + reservas. + + - Si la reserva cancelada tiene `turno_id`, significa que estaba + asociada a una cirugía programada de M2. En ese caso M6 debe informar a + M2 por el mecanismo de integración acordado para que el turno quede + cancelado o pendiente de reprogramación. + + - No reemplaza a `POST /turnos/{turnoId}/cancelacion-quirofano`: ese + endpoint sigue siendo para cancelaciones iniciadas por M2. + + + ## Roles permitidos + + + `ADMINISTRATIVO`. + operationId: updateEstadoReserva + tags: + - Camas + parameters: + - name: camaId + in: path + description: '' + required: true + example: 0 + schema: + type: integer + example: 0 + - name: reservaId + in: path + description: '' + required: true + example: 0 + schema: + type: integer + example: 0 + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ReservaEstadoUpdateRequest' + required: true + responses: + '200': + description: Estado actualizado + headers: {} + '400': + description: Error de validación + headers: {} + '401': + description: No autenticado + headers: {} + '403': + description: No autorizado + headers: {} + '404': + description: Reserva o cama no encontrada + headers: {} + '409': + description: Transición de estado inválida + headers: {} + security: + - BearerAuth: [] + /camas/disponibilidad: + get: + summary: Consultar disponibilidad de quirófanos en un rango horario + deprecated: false + description: > + Retorna los quirófanos (camas con **sector=QUIROFANO y tipo=CIRUGIA**) + y, para cada uno, las reservas activas que caen total o parcialmente + dentro del rango horario indicado. Incluye sólo quirófanos cuyo estado + actual no es `FUERA_DE_SERVICIO` ni `BAJA_PERMANENTE`. + + + Se usa para visualizar huecos disponibles. No es un prerrequisito de la + reserva: la validación real de superposición se ejecuta de forma atómica + dentro del flujo de creación (`POST /camas/{camaId}/reservas` para M2, o + el motor de desplazamiento interno de `/webhooks/hce/cirugia-urgente` + para M1). La disponibilidad devuelta por este endpoint no garantiza que + el quirófano siga libre al momento de la creación. + + + ## Quién lo usa + + + - **M2 (Turnos):** consulta principal. Lo usa para mostrar opciones en + la UI de reserva de turnos quirúrgicos. + + - **M6 (este módulo):** sólo lectura. Personal de M6 (`ADMINISTRATIVO`, + `MEDICO`) puede visualizar la ocupación de quirófanos, pero no puede + crear ni modificar reservas desde acá. + operationId: getDisponibilidadQuirofanos + tags: + - Camas + parameters: + - name: desde + in: query + description: '' + required: true + schema: + type: string + format: date-time + - name: hasta + in: query + description: '' + required: true + schema: + type: string + format: date-time + - name: hospital_id + in: query + description: '' + required: false + schema: + type: string + - name: specialty_id + in: query + description: >- + Filtra quirófanos por especialidad quirúrgica (referencia al `id` de + M2). Útil para que M2 muestre solo los quirófanos compatibles con el + tipo de cirugía del turno. + required: false + schema: + type: integer + example: 43 + responses: + '200': + description: Quirófanos disponibles en el rango + content: + application/json: + schema: + type: object + properties: + desde: + type: string + format: date-time + example: '2025-01-18T08:00:00Z' + hasta: + type: string + format: date-time + example: '2025-01-18T18:00:00Z' + total_quirofanos: + type: integer + example: 3 + quirofanos: + type: array + items: + type: object + properties: + cama_id: + type: integer + example: 501 + numero: + type: string + example: '501' + piso: + type: integer + example: 5 + hospital_id: + type: string + example: HOSP-001 + estado: + $ref: '#/components/schemas/EstadoCamaEnum' + reservas_en_rango: + type: array + description: > + Reservas activas (RESERVADA o EN_CURSO) que caen + total o parcialmente dentro del rango solicitado. + Permite ver los huecos disponibles. + items: + $ref: '#/components/schemas/ReservaQuirofanoResponse' + specialty_id: + type: integer + description: >- + Especialidad quirúrgica del quirófano (ID de M2). + Permite a M2 filtrar por especialidad compatible. + nullable: true + example: 43 + headers: {} + '400': + $ref: '#/components/responses/ErrorValidacion' + description: Error de validación + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: No autenticado + headers: {} + '403': + $ref: '#/components/responses/NoAutorizado' + description: No autorizado + headers: {} + security: + - BearerAuth: [] + /solicitudes: + get: + summary: Listar solicitudes + deprecated: false + description: > + Retorna las solicitudes de internación y traslado recibidas desde HCE + (M1). + + Por defecto devuelve solo las solicitudes en estado `PENDIENTE`. + + + ## Roles permitidos + + + `MEDICO` (lectura) y `ADMINISTRATIVO`. + operationId: getSolicitudes + tags: + - Solicitudes + parameters: + - name: estado + in: query + description: Filtrar por estado. Si se omite, devuelve solo PENDIENTE. + required: false + schema: + $ref: '#/components/schemas/EstadoSolicitudEnum' + - name: tipo + in: query + description: Filtrar por tipo de solicitud + required: false + schema: + $ref: '#/components/schemas/TipoSolicitudEnum' + - name: hospital_id + in: query + description: '' + required: false + schema: + type: string + example: HOSP-001 + responses: + '200': + description: Lista de solicitudes + content: + application/json: + schema: + $ref: '#/components/schemas/SolicitudesListResponse' + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '403': + $ref: '#/components/responses/NoAutorizado' + description: El rol del usuario no tiene permisos para esta acción + security: + - BearerAuth: [] + /solicitudes/{solicitudId}: + get: + summary: Obtener detalle de una solicitud + deprecated: false + description: | + ## Roles permitidos + + `MEDICO` (lectura) y `ADMINISTRATIVO`. + operationId: getSolicitudById + tags: + - Solicitudes + parameters: + - name: solicitudId + in: path + description: Identificador único de la solicitud + required: true + example: '' + schema: + type: string + example: SOL-00123 + responses: + '200': + description: Detalle de la solicitud + content: + application/json: + schema: + $ref: '#/components/schemas/Solicitud' + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '404': + $ref: '#/components/responses/SolicitudNoEncontrada' + description: Solicitud no encontrada + security: + - BearerAuth: [] + patch: + summary: Resolver una solicitud (aprobar o rechazar) + deprecated: false + description: > + Permite al administrativo aprobar o rechazar una solicitud de + internación o traslado. + + + ## Acciones posibles + + + | Acción | Descripción | + + |--------|-------------| + + | `APROBAR` | Acepta la solicitud con la cama originalmente solicitada | + + | `APROBAR_CON_CAMBIO` | Acepta pero asigna una cama distinta (requiere + `cama_asignada_id` y `motivo`) | + + | `RECHAZAR` | Rechaza la solicitud (requiere `motivo`) | + + + ## Flujo al APROBAR solicitud de INTERNACION + + + 1. **[EXT]** Valida existencia del paciente con Core (M10) + + 2. Verifica que ninguna contraindicación del paciente coincida con + `contraindicaciones_incompatibles` de la cama destino; si coincide → `HTTP 422` + 3. Marca la cama como `OCUPADA` y asigna el paciente + + 4. **[EXT]** Notifica el movimiento y el resultado a HCE (M1) vía `POST + /hce/movimientos` + con `tipo_movimiento=INGRESO` (M1 registra el movimiento y notifica al médico a cargo) + 5. **[EXT]** Emite `ALTA_MONITOREO` a M9 vía `POST + /webhooks/internacion/alta-monitoreo` + + + ## Flujo al APROBAR solicitud de TRASLADO + + + 1. Valida que la cama destino esté `DISPONIBLE` y compatible con las + contraindicaciones del paciente + + 2. Cama origen → `EN_LIMPIEZA`, cama destino → `OCUPADA` + + 3. **[EXT]** Notifica el movimiento y el resultado a HCE (M1) vía `POST + /hce/movimientos` + con `tipo_movimiento=TRASLADO` + 4. El monitoreo continúa sobre el mismo paciente: **no** se emite + `ALTA_MONITOREO` ni `BAJA_MONITOREO` + + + ## Flujo al RECHAZAR + + + 1. Marca solicitud como `RECHAZADA` + + 2. **[EXT]** Notifica el rechazo a HCE (M1) vía `POST /hce/movimientos` + con `tipo_movimiento=RESOLUCION_SOLICITUD`, `resultado=RECHAZADA` y el `motivo` + + > **Nota sobre contraindicaciones:** la consulta a HCE (M1) de + contraindicaciones del paciente + + > es puramente informativa para la decisión del administrativo. La + validación automática sólo + + > se ejecuta contra `contraindicaciones_incompatibles` de la cama. + + + ## Roles permitidos + + + Solo usuarios con rol `ADMINISTRATIVO`. + operationId: resolverSolicitud + tags: + - Solicitudes + parameters: + - name: solicitudId + in: path + description: Identificador único de la solicitud + required: true + example: '' + schema: + type: string + example: SOL-00123 + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SolicitudResolucionRequest' + examples: + aprobar: + value: + accion: APROBAR + summary: Aprobar con la cama solicitada + aprobar_cambio: + value: + accion: APROBAR_CON_CAMBIO + cama_asignada_id: 312 + motivo: >- + La cama solicitada quedó fuera de servicio; asigno + alternativa del mismo sector + summary: Aprobar con cama alternativa + rechazar: + value: + accion: RECHAZAR + motivo: >- + No hay disponibilidad en el sector solicitado para las + próximas 24hs + summary: Rechazar la solicitud + required: true + responses: + '200': + description: Solicitud resuelta exitosamente + content: + application/json: + schema: + $ref: '#/components/schemas/Solicitud' + headers: {} + '400': + $ref: '#/components/responses/ErrorValidacion' + description: Error de validación en el body de la request + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '403': + $ref: '#/components/responses/NoAutorizado' + description: El rol del usuario no tiene permisos para esta acción + '404': + $ref: '#/components/responses/SolicitudNoEncontrada' + description: Solicitud no encontrada + '409': + description: Conflicto con el estado de la solicitud o la cama + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: SOLICITUD_YA_RESUELTA + mensaje: La solicitud ya fue resuelta + detalle: La solicitud SOL-00123 fue APROBADA el 2025-01-15T10:30:00Z + headers: {} + '422': + description: Contraindicación del paciente incompatible con la cama destino + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: CONTRAINDICACION_DETECTADA + mensaje: >- + El paciente tiene contraindicaciones incompatibles con la cama + destino + detalle: La cama 204 es incompatible con ALERGIA_LATEX del paciente 123 + headers: {} + '502': + description: Error al consultar servicio externo + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: SERVICIO_EXTERNO_NO_DISPONIBLE + mensaje: No se pudo completar la validación externa + detalle: El módulo Core (M10) no respondió en el tiempo esperado + headers: {} + security: + - BearerAuth: [] + /webhooks/hce/solicitud: + post: + summary: '[M1] Recibir solicitud (internación o traslado)' + deprecated: false + description: > + El Módulo 1 (HCE) llama a este endpoint cuando un médico solicita una + cama + + para internar a un paciente o para trasladarlo a otra cama. El campo + `tipo` + + discrimina entre ambos flujos. + + + ## Acciones que ejecuta este módulo + + + 1. Valida el payload según `tipo` (`INTERNACION` o `TRASLADO`). + + 2. Crea una solicitud en estado `PENDIENTE`. + + 3. Queda disponible para que un administrativo la resuelva vía `PATCH + /solicitudes/{id}`. + operationId: recibirSolicitudHce + tags: + - Webhooks Entrantes + parameters: [] + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SolicitudHceWebhook' + examples: + internacion: + value: + tipo: INTERNACION + solicitud_hce_id: HCE-SOL-00789 + paciente_id: 123 + medico_solicitante_id: 45 + cama_solicitada_id: 204 + origen: GUARDIA + diagnostico_ingreso: Insuficiencia respiratoria aguda + obra_social_id: OSDE-310 + numero_afiliado: '123456789' + prioridad: ALTA + observaciones: Paciente requiere monitoreo continuo + timestamp: '2025-01-15T08:00:00Z' + summary: Solicitud de internación + traslado: + value: + tipo: TRASLADO + solicitud_hce_id: HCE-SOL-00790 + paciente_id: 123 + medico_solicitante_id: 45 + cama_origen_id: 204 + cama_destino_solicitada_id: 108 + motivo_traslado: Mejoría clínica - pase a sala común + timestamp: '2025-01-17T10:00:00Z' + summary: Solicitud de traslado + required: true + responses: + '200': + description: Solicitud recibida y registrada como pendiente + content: + application/json: + schema: + type: object + properties: + mensaje: + type: string + example: Solicitud recibida y pendiente de aprobación + solicitud_id: + type: string + description: ID interno de la solicitud en nuestro módulo + example: SOL-00123 + estado: + type: string + example: PENDIENTE + headers: {} + '400': + $ref: '#/components/responses/ErrorValidacion' + description: Error de validación en el body de la request + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + security: + - BearerAuth: [] + /webhooks/hce/alta-medica: + post: + summary: '[M1] Recibir alta médica' + deprecated: false + description: > + El Módulo 1 (HCE) llama a este endpoint cuando un médico da el alta a un + + paciente internado. M1 es dueño del episodio: este módulo sólo reacciona + + sobre la cama y dispara los webhooks correspondientes. + + + La cama del paciente se resuelve internamente a partir del `paciente_id` + + (este módulo mantiene su propio registro de asignaciones activas). + + M1 **no necesita enviar** el `cama_id` en el payload. + + + ## Acciones que ejecuta este módulo + + + 1. Busca la cama actualmente asignada al `paciente_id` recibido. + + 2. La cama pasa a estado `EN_LIMPIEZA`. + + 3. **[WEBHOOK]** Emite `BAJA_MONITOREO` al Módulo 9 (Monitoreo). + + 4. Se emite evento `CAMA_ACTUALIZADA` por WebSocket. + + + > **Nota:** El webhook `CAMA_LISTA` a Facturación (M7) **NO** se dispara + aquí. + + > Se dispara cuando el personal de limpieza marca la cama como + `DISPONIBLE` + + > vía `PATCH /camas/{camaId}`. + operationId: recibirAltaMedica + tags: + - Webhooks Entrantes + parameters: [] + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AltaMedicaWebhook' + example: + paciente_id: 123 + medico_firmante_id: 45 + tipo_alta: ALTA_MEDICA + timestamp: '2025-01-20T11:00:00Z' + required: true + responses: + '200': + description: Alta procesada exitosamente + content: + application/json: + schema: + type: object + properties: + mensaje: + type: string + example: Alta médica procesada. Cama en limpieza. + cama_id: + type: integer + example: 204 + estado_cama: + type: string + example: EN_LIMPIEZA + headers: {} + '400': + $ref: '#/components/responses/ErrorValidacion' + description: Error de validación en el body de la request + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + headers: {} + '404': + description: Paciente no encontrado o sin cama asignada + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + headers: {} + security: + - BearerAuth: [] + /webhooks/hce/cirugia-urgente: + post: + summary: '[M1] Recibir solicitud de cirugía urgente' + deprecated: false + description: > + El Módulo 1 (HCE) llama a este endpoint cuando un médico decide que un + paciente necesita una cirugía de emergencia y requiere quirófano de + forma inmediata. + + + ## Diferencia con el flujo de reserva programada + + + Este endpoint es uno de los dos mecanismos automáticos por los que + entran reservas a M6. Se diferencia del flujo de reserva programada + (`POST /camas/{camaId}/reservas`, invocado por M2) en cuatro aspectos: + + + | Aspecto | Este webhook | `POST /camas/{camaId}/reservas` | + + |---------|--------------|----------------------------------| + + | Cama destino | M6 la elige automáticamente | La fija M2 en el path | + + | Prioridad | Siempre `URGENTE` | Cualquiera excepto `URGENTE` | + + | Desplazamiento de otras reservas | Sí, automático | No | + + | Quién lo invoca | M1 (HCE) exclusivamente | M2 (Turnos) exclusivamente + | + + + En otras palabras: **este webhook es el único camino por el que una + reserva URGENTE puede entrar al sistema**, y es el único flujo que puede + cancelar automáticamente a otras reservas ya confirmadas. + + + ## Acciones que ejecuta este módulo + + + 1. Busca quirófanos disponibles (sector=QUIROFANO, tipo=CIRUGIA, estado + distinto de FUERA_DE_SERVICIO y BAJA_PERMANENTE) en el rango + [`fecha_hora_inicio`, `fecha_hora_fin_estimada`]. + + 2. **Si hay algún quirófano libre (sin reservas superpuestas):** crea la + reserva con `origen=EMERGENCIA`, `prioridad=URGENTE` y `estado=RESERVADA`. + Responde `201`. + + 3. **Si todos los quirófanos del rango tienen reservas activas:** + selecciona la reserva candidata a desplazar según el siguiente + criterio: + 1. Menor prioridad (`MUY_BAJA` antes que `BAJA`, etc.). Sólo se + consideran reservas con prioridad menor a `URGENTE`. + 2. Dentro de las de menor prioridad, la que tiene `fecha_hora_inicio` + más cercana al momento actual. + 3. Si hay empate, la de menor `id`. + + 4. La reserva elegida pasa a `estado=CANCELADA` con + `desplazada_por_reserva_id` apuntando a la nueva reserva urgente. + + 5. **[EXT]** Si la reserva desplazada tiene `turno_id`, se notifica a M2 + vía `POST /turnos/{turnoId}/resultado-quirofano` con + `resultado=CANCELADA` y `motivo_cancelacion=DESPLAZADA_POR_URGENCIA`. + + 6. Se crea la nueva reserva urgente en el quirófano liberado con + `origen=EMERGENCIA`, `prioridad=URGENTE` y `estado=RESERVADA`. + Responde `201`. + + 7. **Si no existe ninguna reserva desplazable** (todas las reservas + activas son también `URGENTE`, o no hay quirófanos en el sistema), + responde `409 SIN_QUIROFANO_DISPONIBLE`. M1 es responsable de decidir + el siguiente paso (reprogramar, derivar a otro hospital, etc.). + + + ## Idempotencia + + + El payload debe incluir `solicitud_urgencia_hce_id`. Si ya existe una + reserva URGENTE creada con ese mismo `solicitud_urgencia_hce_id`, el + endpoint responde `200` con la reserva ya existente en vez de crear una + nueva. Esto protege frente a reintentos de M1. + operationId: recibirCirugiaUrgente + tags: + - Webhooks Entrantes + parameters: [] + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CirugiaUrgenteWebhook' + example: + solicitud_urgencia_hce_id: HCE-URG-00045 + paciente_id: 123 + medico_cirujano_id: 45 + medico_solicitante_id: 78 + fecha_hora_inicio: '2025-01-18T14:00:00Z' + fecha_hora_fin_estimada: '2025-01-18T16:00:00Z' + diagnostico: Apendicitis aguda con sospecha de perforación + hospital_id: HOSP-001 + timestamp: '2025-01-18T13:45:00Z' + required: true + responses: + '200': + description: La reserva ya existía (idempotencia por `solicitud_urgencia_hce_id`) + content: + application/json: + schema: + $ref: '#/components/schemas/CirugiaUrgenteResponse' + headers: {} + '201': + description: Reserva urgente creada (con o sin desplazamiento) + content: + application/json: + schema: + $ref: '#/components/schemas/CirugiaUrgenteResponse' + examples: + sin_desplazamiento: + summary: Había quirófano libre + value: + mensaje: Reserva urgente creada exitosamente + reserva: + id: 22 + cama_id: 502 + turno_id: null + origen: EMERGENCIA + estado: RESERVADA + prioridad: URGENTE + paciente_id: 123 + medico_cirujano_id: 45 + fecha_hora_inicio: '2025-01-18T14:00:00Z' + fecha_hora_fin_estimada: '2025-01-18T16:00:00Z' + observaciones: Cirugía urgente solicitada por HCE (HCE-URG-00045) + desplazada_por_reserva_id: null + created_at: '2025-01-18T13:46:00Z' + reserva_desplazada: null + con_desplazamiento: + summary: Se canceló una reserva de menor prioridad + value: + mensaje: >- + Reserva urgente creada. Se desplazó la reserva 15 + (prioridad BAJA) para liberar el quirófano 501. + reserva: + id: 23 + cama_id: 501 + turno_id: null + origen: EMERGENCIA + estado: RESERVADA + prioridad: URGENTE + paciente_id: 123 + medico_cirujano_id: 45 + fecha_hora_inicio: '2025-01-18T14:00:00Z' + fecha_hora_fin_estimada: '2025-01-18T16:00:00Z' + observaciones: >- + Cirugía urgente solicitada por HCE (HCE-URG-00045). + Desplazó reserva 15. + desplazada_por_reserva_id: null + created_at: '2025-01-18T13:46:00Z' + reserva_desplazada: + reserva_id: 15 + cama_id: 501 + turno_id: 89 + prioridad_original: BAJA + notificado_a_m2: true + headers: {} + '400': + $ref: '#/components/responses/ErrorValidacion' + description: Error de validación en el body de la request + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '409': + description: No se puede ubicar la cirugía urgente + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + examples: + sin_quirofanos: + summary: No hay quirófanos desplazables + value: + codigo: SIN_QUIROFANO_DISPONIBLE + mensaje: >- + No hay quirófanos disponibles y no existe reserva + desplazable de menor prioridad + detalle: >- + Todas las reservas activas en el rango solicitado tienen + prioridad URGENTE. M1 debe reprogramar o derivar el + paciente. + headers: {} + '502': + description: >- + No se pudo notificar el desplazamiento a M2. La reserva urgente se + creó igualmente; M2 quedará desincronizado hasta el próximo + reintento. + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: SERVICIO_EXTERNO_NO_DISPONIBLE + mensaje: No se pudo notificar a M2 la cancelación por desplazamiento + detalle: >- + La reserva urgente 23 fue creada correctamente; el turno 89 de + M2 quedará pendiente de actualización. + headers: {} + security: + - BearerAuth: [] + /turnos/{turnoId}: + get: + summary: Obtener detalle de un turno quirúrgico + deprecated: false + description: > + **Pertenece al Módulo 2 (Turnos).** + + + Se consume al aprobar una solicitud con `origen=CIRUGIA_PROGRAMADA` + para validar que el turno sigue vigente. + + + **Mock 2da entrega:** responde HTTP 200 con datos ficticios. + operationId: ext_getTurno + tags: + - '[EXT] Turnos - Módulo 2' + parameters: + - name: turnoId + in: path + description: Identificador del turno quirúrgico en M2 + required: true + example: 0 + schema: + type: integer + example: 89 + responses: + '200': + description: Turno encontrado + content: + application/json: + schema: + $ref: '#/components/schemas/Ext_Turno' + example: + id: 89 + estado: CONFIRMADO + paciente_id: 123 + medico_cirujano_id: 45 + fecha_hora_inicio: '2025-01-18T09:00:00Z' + fecha_hora_fin_estimada: '2025-01-18T11:00:00Z' + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '404': + description: Turno no encontrado en M2 + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + headers: {} + security: + - BearerAuth: [] + /turnos/{turnoId}/cancelacion-quirofano: + post: + summary: '[M2] Cancelar reserva de quirófano por turno' + deprecated: false + description: > + Endpoint implementado por M6 para que M2 informe la cancelación o + reprogramación + + de una cirugía programada. + + + M2 es dueño del turno quirúrgico. M6 no cancela el turno: únicamente + cancela la + + reserva física del quirófano asociada al `turnoId` y libera el recurso + si + + corresponde. + + + ## Comportamiento + + + - Busca una reserva activa con `turno_id = turnoId` y `origen = + PROGRAMADA`. + + - Si la reserva está `RESERVADA`, cambia su estado a `CANCELADA`. + + - Si la reserva ya está `EN_CURSO` o `COMPLETADA`, responde `409` porque + no se + puede cancelar por este flujo. + - La operación debe ser idempotente: si la reserva ya estaba + `CANCELADA`, puede + responder `200` con el estado actual. + + ## Autorización + + + Sólo M2 (Turnos). No hay rol humano con permiso para invocar este + endpoint directamente desde M6. + operationId: cancelarReservaQuirofanoPorTurno + tags: + - Webhooks Entrantes + parameters: + - name: turnoId + in: path + description: Identificador del turno quirúrgico en M2. + required: true + example: 0 + schema: + type: integer + example: 89 + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CancelacionQuirofanoRequest' + example: + motivo: Paciente canceló el turno quirúrgico + tipo_cancelacion: CANCELACION_TURNO + timestamp: '2025-01-19T14:00:00Z' + required: true + responses: + '200': + description: Reserva cancelada o ya se encontraba cancelada + content: + application/json: + schema: + $ref: '#/components/schemas/CancelacionQuirofanoResponse' + example: + mensaje: Reserva de quirófano cancelada correctamente + reserva_id: 15 + turno_id: 89 + cama_id: 501 + estado: CANCELADA + headers: {} + '400': + description: Error de validación + headers: {} + '401': + description: No autenticado + headers: {} + '403': + description: No autorizado + headers: {} + '404': + description: No existe una reserva programada asociada al turno + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: RESERVA_NO_ENCONTRADA + mensaje: No se encontró una reserva activa para el turno informado + detalle: No existe reserva de quirófano asociada al turno 89 + headers: {} + '409': + description: La reserva no puede cancelarse por este flujo + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: RESERVA_NO_CANCELABLE + mensaje: La reserva no puede cancelarse + detalle: La reserva está EN_CURSO o COMPLETADA + headers: {} + security: + - BearerAuth: [] + /webhooks/monitoreo/alerta-emergencia: + post: + summary: '[M9] Recibir alerta de emergencia' + deprecated: false + description: > + El Módulo 9 (Monitoreo) llama a este endpoint cuando detecta un código + rojo + + en un paciente internado. + + + La cama se resuelve internamente a partir del `paciente_id` (este módulo + + mantiene su propio registro de asignaciones activas). M9 **no necesita + enviar** + + el `cama_id` en el payload. + + + ## Acciones que ejecuta este módulo + + + 1. Busca la cama actualmente asignada al `paciente_id` recibido. + + 2. Setea `estado=CODIGO_ROJO` en esa cama. + + + > **Nota:** M9 es quien notifica al médico a cargo del paciente. Este + módulo + + > no registra eventos adicionales ni llama a otros módulos al recibir la + alerta. + operationId: recibirAlertaEmergencia + tags: + - Webhooks Entrantes + parameters: [] + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AlertaEmergenciaRequest' + example: + paciente_id: 123 + timestamp: '2025-01-15T14:22:33Z' + required: true + responses: + '200': + description: Alerta recibida; cama marcada en CODIGO_ROJO + content: + application/json: + schema: + $ref: '#/components/schemas/AlertaEmergenciaResponse' + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '404': + description: Paciente no encontrado o sin cama asignada actualmente + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: RECURSO_NO_ENCONTRADO + mensaje: Paciente no encontrado + detalle: No existe paciente con ID 999 en este módulo + headers: {} + security: + - BearerAuth: [] + /webhooks/monitoreo/alerta-resuelta: + post: + summary: '[M9] Recibir alerta resuelta' + deprecated: false + description: | + El Módulo 9 (Monitoreo) llama a este endpoint cuando una alerta + de emergencia (código rojo) se resuelve: los signos vitales del + paciente volvieron a parámetros normales. + + ## Acciones que ejecuta este módulo: + 1. La cama pasa de `CODIGO_ROJO` a `OCUPADA` + 2. Se registra la resolución en el historial de alertas + 3. Se emite evento `ALERTA_RESUELTA` por WebSocket + + Si la cama no está en estado `CODIGO_ROJO`, responde 409. + + **Mock 2da entrega:** Endpoint local que cambia el estado de la cama. + operationId: recibirAlertaResuelta + tags: + - Webhooks Entrantes + parameters: [] + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AlertaResueltaRequest' + example: + paciente_id: 123 + motivo_resolucion: Frecuencia cardíaca estabilizada en 78 bpm + timestamp: '2025-01-15T14:45:00Z' + required: true + responses: + '200': + description: Alerta resuelta, cama volvió a estado OCUPADA + content: + application/json: + schema: + $ref: '#/components/schemas/AlertaResueltaResponse' + example: + mensaje: Alerta resuelta. Cama 204 volvió a estado OCUPADA. + cama_id: 204 + estado_anterior: CODIGO_ROJO + estado_actual: OCUPADA + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + headers: {} + '404': + description: No se encontró cama en CODIGO_ROJO para el paciente + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: RECURSO_NO_ENCONTRADO + mensaje: Paciente no encontrado en código rojo + detalle: No existe cama en estado CODIGO_ROJO para el paciente 123 + headers: {} + '409': + description: La cama del paciente no está en CODIGO_ROJO + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + headers: {} + security: + - BearerAuth: [] + /hce/pacientes/{pacienteId}/contraindicaciones: + get: + summary: Consultar contraindicaciones de un paciente + deprecated: false + description: > + **Pertenece al Módulo 1 (HCE).** + + + Consulta informativa. El administrativo puede usarla para revisar las + + contraindicaciones del paciente antes de resolver una solicitud. La + validación + + automática se hace contra `contraindicaciones_incompatibles` de la cama. + operationId: ext_getContraindicaciones + tags: + - '[EXT] HCE - Módulo 1' + parameters: + - name: pacienteId + in: path + description: '' + required: true + example: 0 + schema: + type: integer + example: 123 + responses: + '200': + description: Resultado de la consulta + content: + application/json: + schema: + $ref: '#/components/schemas/Ext_Contraindicaciones' + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '404': + description: Paciente sin historia clínica + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + headers: {} + security: + - BearerAuth: [] + /hce/pacientes/{pacienteId}: + get: + summary: Obtener detalle del paciente internado + deprecated: false + description: > + **Pertenece al Módulo 1 (HCE).** + + + Se consume para mostrar la información clínica y demográfica de un + paciente + + que está actualmente internado en una cama. + + + Devuelve datos de contacto, obra social, diagnósticos activos y + medicación + + vigente, permitiéndole al personal ver el perfil completo del paciente + + sin salir del módulo de internación. + operationId: ext_getPacienteHCE + tags: + - '[EXT] HCE - Módulo 1' + parameters: + - name: pacienteId + in: path + description: '' + required: true + example: 0 + schema: + type: integer + example: 123 + responses: + '200': + description: Detalle del paciente + content: + application/json: + schema: + $ref: '#/components/schemas/Ext_PacienteHCE' + example: + id: 123 + nombre: Juan + apellido: Pérez + dni: '30123456' + fecha_nacimiento: '1985-03-15' + telefono: +54 11 1234-5678 + obra_social_id: OSDE-310 + numero_afiliado: '123456789' + grupo_sanguineo: A+ + diagnosticos_activos: + - codigo: J18.9 + descripcion: Neumonía, no especificada + fecha_inicio: '2025-01-10' + medicacion_vigente: + - nombre: Amoxicilina 500mg + dosis: 1 comprimido cada 8hs + via: oral + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '404': + description: Paciente no encontrado en HCE + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: RECURSO_NO_ENCONTRADO + mensaje: Paciente no encontrado + detalle: No existe historia clínica para el paciente 999 + headers: {} + security: + - BearerAuth: [] + /hce/movimientos: + post: + summary: Registrar movimiento de paciente en HCE (endpoint unificado) + deprecated: false + description: > + **Pertenece al Módulo 1 (HCE).** + + + Endpoint unificado para notificar a HCE todos los movimientos de + pacientes y + + resultados de solicitudes. M1 persiste el movimiento en la historia + clínica + + y notifica al médico a cargo cuando corresponde. + + + | `tipo_movimiento` | Cuándo se usa | + + |-------------------|---------------| + + | `INGRESO` | Al aprobar una internación o al ingresar directamente un + paciente | + + | `TRASLADO` | Al aprobar un traslado o al trasladar directamente | + + | `ALTA` | Al procesar el alta médica | + + | `RESOLUCION_SOLICITUD` | Al rechazar una solicitud (sin movimiento + físico) | + operationId: ext_registrarMovimiento + tags: + - '[EXT] HCE - Módulo 1' + parameters: [] + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/Ext_MovimientoRequest' + examples: + ingreso: + value: + tipo_movimiento: INGRESO + paciente_id: 123 + cama_id: 315 + solicitud_hce_id: HCE-SOL-00789 + resultado: APROBADA + medico_responsable_id: MED-0045 + timestamp: '2025-01-15T10:30:00Z' + summary: Notificar ingreso aprobado + traslado: + value: + tipo_movimiento: TRASLADO + paciente_id: 123 + cama_id: 315 + cama_origen_id: 204 + solicitud_hce_id: HCE-SOL-00790 + resultado: APROBADA + medico_responsable_id: MED-0045 + timestamp: '2025-01-17T10:00:00Z' + summary: Notificar traslado aprobado + alta: + value: + tipo_movimiento: ALTA + paciente_id: 123 + cama_id: 204 + timestamp: '2025-01-20T11:00:00Z' + summary: Notificar alta médica + rechazo: + value: + tipo_movimiento: RESOLUCION_SOLICITUD + paciente_id: 123 + solicitud_hce_id: HCE-SOL-00789 + resultado: RECHAZADA + motivo: No hay disponibilidad en el sector solicitado + timestamp: '2025-01-15T09:00:00Z' + summary: Notificar solicitud rechazada + required: true + responses: + '200': + description: Movimiento registrado en HCE + content: + application/json: + schema: + type: object + properties: + mensaje: + type: string + example: Movimiento registrado en historia clínica del paciente + movimiento_id: + type: string + example: MOV-HCE-00456 + headers: {} + '400': + $ref: '#/components/responses/ErrorValidacion' + description: Error de validación en el body de la request + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '404': + description: Paciente no encontrado en HCE + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: RECURSO_NO_ENCONTRADO + mensaje: Paciente no encontrado + detalle: No existe historia clínica para el paciente 999 + headers: {} + security: + - BearerAuth: [] + /hce/episodios/{episodioId}/eventos: + post: + summary: Registrar evento en episodio de internación (HCE) + deprecated: false + description: > + **Pertenece al Módulo 1 (HCE).** + + + Se consume para registrar eventos en el episodio de internación + (alertas, resoluciones, cambios clínicos). M1 persiste el evento + y notifica al equipo médico cuando corresponde. + + + **Mock 2da entrega:** responde HTTP 200. + operationId: ext_registrarEventoEpisodio + tags: + - '[EXT] HCE - Módulo 1' + parameters: + - name: episodioId + in: path + description: Identificador del episodio de internación en HCE + required: true + example: 0 + schema: + type: integer + example: 456 + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/Ext_EventoEpisodioRequest' + example: + tipo_evento: CODIGO_ROJO + descripcion: Alerta de emergencia detectada por Monitoreo (M9) + timestamp: '2025-01-15T14:22:33Z' + required: true + responses: + '200': + description: Evento registrado en HCE + content: + application/json: + schema: + type: object + properties: + mensaje: + type: string + example: Evento registrado en el episodio de internación + evento_id: + type: string + example: EVT-HCE-00789 + headers: {} + '400': + $ref: '#/components/responses/ErrorValidacion' + description: Error de validación en el body de la request + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '404': + description: Episodio no encontrado en HCE + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + headers: {} + security: + - BearerAuth: [] + /turnos/{turnoId}/resultado-quirofano: + post: + summary: Notificar cancelación por desplazamiento a Turnos + deprecated: false + description: > + **Pertenece al Módulo 2 (Turnos).** + + + M6 invoca este endpoint **únicamente cuando una cirugía urgente recibida + por `/webhooks/hce/cirugia-urgente` desplazó automáticamente a una + reserva programada de menor prioridad**. + + + No se usa para ningún otro escenario de cancelación: + + + - Si M2 cancela un turno, M2 ya lo sabe: no hace falta que M6 le + informe. + + - M6 no puede cancelar reservas por decisión propia (no existe ese + flujo). + + + M2 usa esta notificación para actualizar el estado del turno + correspondiente, avisar al paciente y decidir si reprograma. + + + **Mock 2da entrega:** Endpoint local que responde HTTP 200. + operationId: ext_notificarResultadoQuirofano + tags: + - '[EXT] Turnos - Módulo 2' + parameters: + - name: turnoId + in: path + description: '' + required: true + example: 0 + schema: + type: integer + example: 89 + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/WebhookResultadoQuirofano' + examples: + cancelacion_manual: + value: + resultado: CANCELADA + reserva_id: 15 + cama_id: 501 + motivo_cancelacion: DESPLAZADA_POR_URGENCIA + reserva_urgente_id: 23 + motivo: Apendicitis aguda con sospecha de perforación + timestamp: '2025-01-18T13:46:00Z' + summary: Cancelación manual desde M6 + desplazada_por_urgencia: + value: + resultado: CANCELADA + reserva_id: 15 + cama_id: 501 + motivo_cancelacion: DESPLAZADA_POR_URGENCIA + reserva_urgente_id: 23 + motivo: Apendicitis aguda con sospecha de perforación + timestamp: '2025-01-18T13:46:00Z' + summary: Cancelación automática por cirugía urgente + required: true + responses: + '200': + description: M2 confirmó la recepción + content: + application/json: + schema: + type: object + properties: + mensaje: + type: string + example: Resultado de quirófano recibido + headers: {} + '401': + description: No autenticado + headers: {} + '404': + description: Turno no encontrado en M2 + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + headers: {} + security: + - BearerAuth: [] + /webhooks/internacion/cama-lista: + post: + summary: Notificar cama lista (dispara liquidación) + deprecated: false + description: > + **Pertenece al Módulo 7 (Facturación).** + + + Se llama cuando el personal de limpieza marca la cama como `DISPONIBLE` + (transición `EN_LIMPIEZA` → `DISPONIBLE` post-alta médica) para iniciar + la liquidación de prestaciones. + + El payload incluye los datos del episodio necesarios para facturar: + + obra social, historial de camas con timestamps, diagnósticos, etc. + + + > **Nota:** se dispara al completar la limpieza, **no** al recibir el + alta médica. El alta pone la cama en `EN_LIMPIEZA`; el webhook a + > Facturación se dispara cuando limpieza la marca `DISPONIBLE`. + operationId: ext_notificarCamaLista + tags: + - '[EXT] Facturación - Módulo 7' + parameters: [] + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/WebhookCamaLista' + required: true + responses: + '200': + description: Facturación confirmó la recepción + content: + application/json: + schema: + type: object + properties: + mensaje: + type: string + example: Datos de episodio recibidos para liquidación + liquidacion_id: + type: string + description: ID de la liquidación creada (opcional) + example: LIQ-2025-00123 + headers: {} + '400': + $ref: '#/components/responses/ErrorValidacion' + description: Error de validación en el body de la request + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + security: + - BearerAuth: [] + /webhooks/internacion/baja-monitoreo: + post: + summary: Notificar baja de monitoreo de paciente + deprecated: false + description: | + **Pertenece al Módulo 9 (Monitoreo).** + + Se llama al procesar el alta médica para indicar al módulo de + monitoreo que deje de monitorear al paciente dado de alta. + operationId: ext_notificarBajaMonitoreo + tags: + - '[EXT] Monitoreo - Módulo 9' + parameters: [] + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/WebhookBajaMonitoreo' + required: true + responses: + '200': + description: Monitoreo confirmó la baja + content: + application/json: + schema: + type: object + properties: + mensaje: + type: string + example: Monitoreo del paciente 123 dado de baja + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '404': + description: Paciente no estaba siendo monitoreado + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: RECURSO_NO_ENCONTRADO + mensaje: Paciente no monitoreado + detalle: El paciente 123 no tiene monitoreo activo + headers: {} + security: + - BearerAuth: [] + /webhooks/internacion/alta-monitoreo: + post: + summary: Notificar inicio de monitoreo de paciente + deprecated: false + description: > + **Pertenece al Módulo 9 (Monitoreo).** + + + Se llama al ingresar un paciente (aprobación de internación o asignación + directa) + + para que M9 inicie el monitoreo. **No** se llama en traslados: el + monitoreo + + sigue al paciente, no a la cama. + operationId: ext_notificarAltaMonitoreo + tags: + - '[EXT] Monitoreo - Módulo 9' + parameters: [] + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/WebhookAltaMonitoreo' + example: + evento: ALTA_MONITOREO + paciente_id: 123 + timestamp: '2025-01-15T10:30:00Z' + required: true + responses: + '200': + description: Monitoreo confirmó el inicio de seguimiento + content: + application/json: + schema: + type: object + properties: + mensaje: + type: string + example: Monitoreo del paciente 123 iniciado + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '404': + description: Paciente no encontrado en el sistema de monitoreo + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: RECURSO_NO_ENCONTRADO + mensaje: Paciente no encontrado + detalle: No existe paciente con ID 999 en el sistema de monitoreo + headers: {} + security: + - BearerAuth: [] + /auth/token: + get: + summary: Obtener JWT a partir de credenciales + deprecated: false + description: | + **Pertenece al Módulo 10 (Core).** + + Devuelve un `access_token` (JWT) y un `refresh_token` a partir de las + credenciales del usuario. + operationId: ext_authToken + tags: + - '[EXT] Core - Módulo 10' + parameters: + - name: usuario + in: query + description: '' + required: true + schema: + type: string + example: admin01 + - name: password + in: query + description: '' + required: true + schema: + type: string + format: password + example: '********' + responses: + '200': + description: Credenciales válidas + content: + application/json: + schema: + $ref: '#/components/schemas/Ext_AuthTokenResponse' + headers: {} + '401': + description: Credenciales inválidas + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: NO_AUTENTICADO + mensaje: Credenciales inválidas + detalle: Usuario o contraseña incorrectos + headers: {} + security: [] + /auth/refresh: + get: + summary: Renovar JWT a partir de un refresh token + deprecated: false + description: | + **Pertenece al Módulo 10 (Core).** + + Emite un nuevo `access_token` a partir de un `refresh_token` válido. + operationId: ext_authRefresh + tags: + - '[EXT] Core - Módulo 10' + parameters: + - name: refresh_token + in: query + description: '' + required: true + schema: + type: string + example: rft_8f4c6a... + responses: + '200': + description: Token renovado + content: + application/json: + schema: + $ref: '#/components/schemas/Ext_AuthTokenResponse' + headers: {} + '401': + description: Refresh token inválido o expirado + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: NO_AUTENTICADO + mensaje: Refresh token inválido o expirado + headers: {} + security: [] + /auth/validate-token: + post: + summary: Validar y decodificar un JWT + deprecated: false + description: > + **Pertenece al Módulo 10 (Core).** + + + Valida la firma y expiración de un JWT y devuelve los claims del + usuario (id, rol, hospital_id). Usado como middleware de autenticación + en cada request entrante a M6. + + + **Mock 2da entrega:** responde HTTP 200 con claims ficticios. + operationId: ext_validateToken + tags: + - '[EXT] Core - Módulo 10' + parameters: [] + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/Ext_ValidateTokenRequest' + example: + token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... + required: true + responses: + '200': + description: Token válido. Devuelve los claims del usuario. + content: + application/json: + schema: + type: object + properties: + valid: + type: boolean + example: true + user_id: + type: integer + example: 10 + rol: + type: string + example: ADMINISTRATIVO + hospital_id: + type: string + example: HOSP-001 + headers: {} + '401': + description: Token inválido, expirado o malformado + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: NO_AUTENTICADO + mensaje: Token JWT inválido o expirado + headers: {} + security: [] + /usuarios/{pacienteId}: + get: + summary: Obtener datos básicos del usuario/paciente + deprecated: false + description: | + **Pertenece al Módulo 10 (Core).** Devuelve los datos básicos del + usuario/paciente identificado por `pacienteId`. + operationId: ext_getPaciente + tags: + - '[EXT] Core - Módulo 10' + parameters: + - name: pacienteId + in: path + description: '' + required: true + example: 0 + schema: + type: integer + example: 123 + responses: + '200': + description: Usuario encontrado + content: + application/json: + schema: + $ref: '#/components/schemas/Ext_Paciente' + headers: {} + '401': + $ref: '#/components/responses/NoAutenticado' + description: Token JWT ausente, expirado o malformado + '404': + description: Usuario no encontrado en el sistema + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + example: + codigo: RECURSO_NO_ENCONTRADO + mensaje: Usuario no encontrado + detalle: No existe usuario con ID 999 + headers: {} + security: + - BearerAuth: [] +components: + schemas: + EstadoSolicitudEnum: + type: string + enum: + - PENDIENTE + - APROBADA + - RECHAZADA + TipoSolicitudEnum: + type: string + enum: + - INTERNACION + - TRASLADO + AccionResolucionEnum: + type: string + enum: + - APROBAR + - APROBAR_CON_CAMBIO + - RECHAZAR + PrioridadSolicitudEnum: + type: string + enum: + - BAJA + - MEDIA + - ALTA + - URGENTE + Cama: + type: object + properties: + id: + type: integer + example: 204 + numero: + type: string + example: '204' + piso: + type: integer + example: 2 + sector: + $ref: '#/components/schemas/SectorEnum' + tipo: + $ref: '#/components/schemas/TipoCamaEnum' + specialty_id: + type: integer + description: >- + ID de la especialidad quirúrgica asociada a este quirófano + (referencia al `id` de M2). Solo aplica cuando `tipo=CIRUGIA`. Para + todos los demás tipos de cama este campo es `null`. + nullable: true + example: 43 + estado: + $ref: '#/components/schemas/EstadoCamaEnum' + paciente_id: + type: integer + nullable: true + example: 123 + hospital_id: + type: string + example: HOSP-001 + contraindicaciones_incompatibles: + type: array + items: + type: string + example: + - ALERGIA_LATEX + ultima_actualizacion: + type: string + format: date-time + example: '2025-01-15T10:30:00Z' + CamaUpdateRequest: + type: object + properties: + estado: + $ref: '#/components/schemas/EstadoCamaEnum' + contraindicaciones_incompatibles: + type: array + items: + type: string + CamaCreateRequest: + type: object + required: + - numero + - piso + - sector + - tipo + - hospital_id + properties: + numero: + type: string + example: '210' + piso: + type: integer + example: 2 + sector: + $ref: '#/components/schemas/SectorEnum' + tipo: + $ref: '#/components/schemas/TipoCamaEnum' + specialty_id: + type: integer + description: >- + Requerido si `tipo=CIRUGIA`. ID de la especialidad quirúrgica del + quirófano, obtenido de M2 (`GET /specialties?is_high_complexity=1`). + Ignorado si `tipo` no es `CIRUGIA`. + nullable: true + example: 43 + hospital_id: + type: string + example: HOSP-001 + contraindicaciones_incompatibles: + type: array + items: + type: string + example: + - ALERGIA_LATEX + Solicitud: + type: object + properties: + id: + type: string + example: SOL-00123 + solicitud_hce_id: + type: string + example: HCE-SOL-00789 + tipo: + $ref: '#/components/schemas/TipoSolicitudEnum' + estado: + $ref: '#/components/schemas/EstadoSolicitudEnum' + paciente_id: + type: integer + example: 123 + medico_solicitante_id: + type: integer + example: 45 + cama_solicitada_id: + type: integer + nullable: true + example: 204 + cama_asignada_id: + type: integer + nullable: true + example: 204 + origen: + $ref: '#/components/schemas/OrigenIngresoEnum' + turno_id: + type: integer + nullable: true + example: null + diagnostico_ingreso: + type: string + nullable: true + example: Insuficiencia respiratoria aguda + obra_social_id: + type: string + nullable: true + example: OSDE-310 + numero_afiliado: + type: string + nullable: true + example: '123456789' + prioridad: + $ref: '#/components/schemas/PrioridadSolicitudEnum' + cama_origen_id: + type: integer + nullable: true + example: null + cama_destino_solicitada_id: + type: integer + nullable: true + example: null + motivo_traslado: + type: string + nullable: true + example: null + accion: + allOf: + - $ref: '#/components/schemas/AccionResolucionEnum' + nullable: true + description: Acción tomada al resolver. Null mientras la solicitud esté PENDIENTE. + motivo: + type: string + nullable: true + example: null + resuelto_por: + type: integer + nullable: true + example: null + observaciones: + type: string + nullable: true + example: Paciente requiere monitoreo continuo + timestamp_solicitud: + type: string + format: date-time + timestamp_resolucion: + type: string + format: date-time + nullable: true + SolicitudesListResponse: + type: object + properties: + total: + type: integer + example: 5 + solicitudes: + type: array + items: + $ref: '#/components/schemas/Solicitud' + SolicitudResolucionRequest: + type: object + required: + - accion + properties: + accion: + $ref: '#/components/schemas/AccionResolucionEnum' + cama_asignada_id: + type: integer + description: Requerido si accion=APROBAR_CON_CAMBIO + example: 312 + motivo: + type: string + description: Requerido si accion=RECHAZAR o APROBAR_CON_CAMBIO + example: No hay disponibilidad en el sector solicitado + AltaMedicaWebhook: + type: object + required: + - paciente_id + - medico_firmante_id + - tipo_alta + - timestamp + properties: + paciente_id: + type: integer + medico_firmante_id: + type: integer + tipo_alta: + $ref: '#/components/schemas/TipoAltaEnum' + timestamp: + type: string + format: date-time + AsignacionCamaRequest: + type: object + required: + - tipo + - paciente_id + properties: + tipo: + type: string + enum: + - INGRESO + - TRASLADO + paciente_id: + type: integer + example: 123 + cama_origen_id: + type: integer + description: Requerido si tipo=TRASLADO + nullable: true + example: 204 + AsignacionCamaResponse: + type: object + properties: + mensaje: + type: string + example: Paciente 123 asignado a la cama 315 + cama_id: + type: integer + example: 315 + paciente_id: + type: integer + example: 123 + tipo: + type: string + example: INGRESO + cama_origen_id: + type: integer + nullable: true + example: null + timestamp: + type: string + format: date-time + AlertaEmergenciaRequest: + type: object + description: > + Payload mínimo que envía M9 al detectar un código rojo. M9 resuelve + internamente el detalle clínico (tipo de alerta, parámetros, valores) y + notifica al médico a cargo. M6 sólo necesita identificar al paciente + para poner su cama en `CODIGO_ROJO`. + required: + - paciente_id + - timestamp + properties: + paciente_id: + type: integer + example: 123 + observaciones: + type: string + description: Texto libre opcional con contexto clínico de la alerta. + nullable: true + timestamp: + type: string + format: date-time + example: '2025-01-15T14:22:33Z' + AlertaEmergenciaResponse: + type: object + properties: + mensaje: + type: string + example: Alerta registrada. Cama 204 en CODIGO_ROJO. Enfermería notificada. + cama_id: + type: integer + example: 204 + sector: + type: string + example: UTI + WebhookCamaLista: + type: object + description: | + Enviado a M7 (Facturación) cuando limpieza completa la cama post-alta. + properties: + evento: + type: string + example: CAMA_LISTA + cama_id: + type: integer + example: 204 + paciente_id: + type: integer + example: 123 + obra_social_id: + type: string + nullable: true + example: OSDE-310 + numero_afiliado: + type: string + nullable: true + example: '123456789' + tipo_alta: + $ref: '#/components/schemas/TipoAltaEnum' + fecha_ingreso: + type: string + format: date-time + fecha_alta: + type: string + format: date-time + fecha_limpieza_completada: + type: string + format: date-time + diagnostico_ingreso: + type: string + diagnostico_egreso: + type: string + camas_utilizadas: + type: array + items: + type: object + properties: + cama_id: + type: integer + sector: + type: string + desde: + type: string + format: date-time + hasta: + type: string + format: date-time + timestamp_evento: + type: string + format: date-time + WebhookBajaMonitoreo: + type: object + description: > + Enviado a M9 (Monitoreo) para que deje de monitorear a un paciente. Se + dispara al procesar el alta médica. No se envía `cama_id`: el monitoreo + está asociado al paciente, no a la cama. + required: + - evento + - paciente_id + - timestamp + properties: + evento: + type: string + enum: + - BAJA_MONITOREO + example: BAJA_MONITOREO + paciente_id: + type: integer + example: 123 + timestamp: + type: string + format: date-time + example: '2025-01-20T11:00:00Z' + WebhookAltaMonitoreo: + type: object + description: > + Enviado a M9 (Monitoreo) para iniciar el seguimiento de un paciente. Se + dispara al ingresar un paciente (aprobación de internación o asignación + directa). No se envía en traslados: el monitoreo sigue al paciente, no a + la cama. No se envía `cama_id` por el mismo motivo. + required: + - evento + - paciente_id + - timestamp + properties: + evento: + type: string + enum: + - ALTA_MONITOREO + example: ALTA_MONITOREO + paciente_id: + type: integer + example: 123 + timestamp: + type: string + format: date-time + example: '2025-01-15T10:30:00Z' + Ext_PacienteHCE: + type: object + description: '[EXT] Detalle del paciente en HCE (Módulo 1)' + properties: + id: + type: integer + example: 123 + nombre: + type: string + apellido: + type: string + contraindicaciones: + type: array + items: + type: string + Ext_MovimientoRequest: + type: object + description: '[EXT] Payload para registrar movimiento en HCE (M1)' + properties: + tipo_movimiento: + type: string + enum: + - INGRESO + - TRASLADO + - ALTA + - RESOLUCION_SOLICITUD + paciente_id: + type: integer + example: 123 + cama_id: + type: integer + nullable: true + example: 204 + cama_origen_id: + type: integer + nullable: true + solicitud_hce_id: + type: string + description: ID de la solicitud en HCE. Presente en INGRESO, TRASLADO y RESOLUCION_SOLICITUD. + nullable: true + example: HCE-SOL-00789 + resultado: + type: string + description: 'Para RESOLUCION_SOLICITUD: APROBADA o RECHAZADA' + nullable: true + medico_responsable_id: + type: integer + description: ID del médico responsable del movimiento. + nullable: true + example: 45 + motivo: + type: string + nullable: true + timestamp: + type: string + format: date-time + Ext_Paciente: + type: object + description: '[EXT] Respuesta del Módulo 10 (Core)' + properties: + id: + type: integer + example: 123 + nombre: + type: string + example: Juan + apellido: + type: string + example: Pérez + dni: + type: string + example: '30123456' + fecha_nacimiento: + type: string + format: date + example: '1985-03-15' + email: + type: string + example: juan.perez@email.com + telefono: + type: string + example: +54 11 1234-5678 + Ext_Contraindicaciones: + type: object + description: '[EXT] Respuesta del Módulo 1 (HCE)' + properties: + paciente_id: + type: integer + example: 123 + tiene_contraindicaciones: + type: boolean + example: false + detalle: + type: array + items: + type: object + properties: + tipo: + type: string + enum: + - ALERGIA + - MEDICAMENTO_CONTRAINDICADO + - CONDICION_PREVIA + descripcion: + type: string + example: Alergia severa a penicilina + severidad: + type: string + enum: + - LEVE + - MODERADA + - SEVERA + Error: + type: object + required: + - codigo + - mensaje + properties: + codigo: + type: string + example: NO_AUTENTICADO + mensaje: + type: string + example: No Autenticado + detalle: + type: string + nullable: true + SolicitudHceWebhook: + type: object + description: Payload unificado que envía HCE (M1) para solicitudes + required: + - tipo + - solicitud_hce_id + - paciente_id + - medico_solicitante_id + - timestamp + properties: + tipo: + $ref: '#/components/schemas/TipoSolicitudEnum' + solicitud_hce_id: + type: string + example: HCE-SOL-00789 + paciente_id: + type: integer + example: 123 + medico_solicitante_id: + type: integer + example: 45 + cama_solicitada_id: + type: integer + description: '[INTERNACION] Cama solicitada' + nullable: true + example: 204 + origen: + $ref: '#/components/schemas/OrigenIngresoEnum' + turno_id: + type: integer + nullable: true + example: null + diagnostico_ingreso: + type: string + nullable: true + example: Insuficiencia respiratoria aguda + obra_social_id: + type: string + nullable: true + example: OSDE-310 + numero_afiliado: + type: string + nullable: true + example: '123456789' + prioridad: + $ref: '#/components/schemas/PrioridadSolicitudEnum' + observaciones: + type: string + nullable: true + cama_origen_id: + type: integer + description: '[TRASLADO] Cama actual del paciente' + nullable: true + cama_destino_solicitada_id: + type: integer + description: '[TRASLADO] Cama destino solicitada' + nullable: true + motivo_traslado: + type: string + description: '[TRASLADO] Motivo' + nullable: true + timestamp: + type: string + format: date-time + Ext_AuthTokenResponse: + type: object + description: '[EXT] Respuesta de login/refresh del Módulo 10 (Core)' + properties: + access_token: + type: string + refresh_token: + type: string + token_type: + type: string + example: bearer + expires_in: + type: integer + example: 3600 + SectorEnum: + type: string + enum: + - UTI + - SALA_COMUN + - QUIROFANO + - GUARDIA + - NEONATOLOGIA + TipoCamaEnum: + type: string + enum: + - ESTANDAR + - PEDIATRICA + - AISLAMIENTO + - CRITICA + - CIRUGIA + description: | + Tipo de cama según equipamiento. + `CIRUGIA` solo aplica a camas con sector=QUIROFANO (mesas quirúrgicas). + EstadoCamaEnum: + type: string + enum: + - DISPONIBLE + - OCUPADA + - EN_LIMPIEZA + - FUERA_DE_SERVICIO + - BAJA_PERMANENTE + - CODIGO_ROJO + OrigenIngresoEnum: + type: string + enum: + - GUARDIA + - CIRUGIA_PROGRAMADA + TipoAltaEnum: + type: string + enum: + - ALTA_MEDICA + - ALTA_VOLUNTARIA + - TRASLADO_EXTERNO + - DEFUNCION + AlertaResueltaRequest: + type: object + required: + - paciente_id + - timestamp + properties: + paciente_id: + type: integer + example: 123 + motivo_resolucion: + type: string + nullable: true + example: Frecuencia cardíaca estabilizada en 78 bpm + timestamp: + type: string + format: date-time + AlertaResueltaResponse: + type: object + properties: + mensaje: + type: string + example: Alerta resuelta. Cama 204 volvió a estado OCUPADA. + cama_id: + type: integer + example: 204 + estado_anterior: + type: string + example: CODIGO_ROJO + estado_actual: + type: string + example: OCUPADA + WebhookResultadoQuirofano: + type: object + description: >- + Enviado a M2 (Turnos) cuando M6 cancela automáticamente una reserva + programada para liberar el quirófano ante una cirugía urgente recibida + por `/webhooks/hce/cirugia-urgente`. Es el único caso en que M6 avisa a + M2 sobre cancelaciones: cuando M2 cancela un turno, M2 ya lo sabe y no + necesita ser notificado por M6. + required: + - resultado + - motivo_cancelacion + - reserva_id + - cama_id + - reserva_urgente_id + - timestamp + properties: + resultado: + type: string + enum: + - CANCELADA + example: CANCELADA + reserva_id: + type: integer + description: ID de la reserva que fue cancelada. + example: 15 + cama_id: + type: integer + description: Quirófano donde estaba la reserva cancelada. + example: 501 + motivo_cancelacion: + type: string + description: > + Clasificación de la causa. Actualmente sólo existe el caso + `DESPLAZADA_POR_URGENCIA` porque ése es el único escenario en que M6 + inicia una cancelación. Se mantiene como enum para permitir + extensiones futuras sin romper contrato. + enum: + - DESPLAZADA_POR_URGENCIA + example: DESPLAZADA_POR_URGENCIA + reserva_urgente_id: + type: integer + description: > + ID de la reserva urgente creada por M6 que desplazó a esta. Permite + a M2 correlacionar ambos turnos si lo necesita. + example: 23 + motivo: + type: string + description: > + Texto libre complementario. Puede contener el diagnóstico de la + urgencia que motivó el desplazamiento. + nullable: true + example: Apendicitis aguda con sospecha de perforación + timestamp: + type: string + format: date-time + ReservaQuirofanoCreateRequest: + type: object + required: + - turno_id + - paciente_id + - medico_cirujano_id + - fecha_hora_inicio + - fecha_hora_fin_estimada + - prioridad + properties: + turno_id: + type: integer + description: >- + ID del turno quirúrgico en M2 (appointment_id). Obligatorio: este + endpoint sólo recibe reservas programadas provenientes de M2. Las + emergencias entran por `POST /webhooks/hce/cirugia-urgente`. + example: 89 + paciente_id: + type: integer + example: 123 + medico_cirujano_id: + type: integer + example: 45 + fecha_hora_inicio: + type: string + format: date-time + example: '2025-01-18T09:00:00Z' + fecha_hora_fin_estimada: + type: string + format: date-time + example: '2025-01-18T11:00:00Z' + prioridad: + allOf: + - $ref: '#/components/schemas/PrioridadQuirofanoEnum' + description: > + Prioridad clínica de la reserva, determinada por M2 al confirmar el + turno. Acepta cualquier valor de `PrioridadQuirofanoEnum` **excepto + `URGENTE`**: ese valor está reservado exclusivamente para el flujo + automático de `/webhooks/hce/cirugia-urgente` y permite al sistema + decidir si desplaza o no a otra reserva. + observaciones: + type: string + nullable: true + example: Colecistectomía laparoscópica programada + description: | + Datos necesarios para crear una reserva de quirófano programada. + + Todas las reservas creadas por este endpoint tienen `origen=PROGRAMADA` + y provienen de M2 (Turnos). No existe un flujo manual para crear + reservas desde M6. + ReservaEstadoUpdateRequest: + type: object + required: + - estado + properties: + estado: + type: string + enum: + - EN_CURSO + - COMPLETADA + - CANCELADA + observaciones: + type: string + nullable: true + ReservaQuirofanoResponse: + type: object + required: + - id + - cama_id + - origen + - estado + - prioridad + - paciente_id + - medico_cirujano_id + - fecha_hora_inicio + - fecha_hora_fin_estimada + - created_at + properties: + id: + type: integer + example: 15 + cama_id: + type: integer + example: 501 + turno_id: + type: integer + nullable: true + example: 89 + origen: + type: string + enum: + - PROGRAMADA + - EMERGENCIA + example: PROGRAMADA + estado: + type: string + enum: + - RESERVADA + - EN_CURSO + - COMPLETADA + - CANCELADA + example: RESERVADA + prioridad: + $ref: '#/components/schemas/PrioridadQuirofanoEnum' + paciente_id: + type: integer + example: 123 + medico_cirujano_id: + type: integer + example: 45 + fecha_hora_inicio: + type: string + format: date-time + example: '2025-01-18T09:00:00Z' + fecha_hora_fin_estimada: + type: string + format: date-time + example: '2025-01-18T11:00:00Z' + observaciones: + type: string + nullable: true + example: Colecistectomía laparoscópica programada + desplazada_por_reserva_id: + type: integer + description: > + Si la reserva fue cancelada automáticamente para liberar el + quirófano ante una cirugía urgente, este campo indica el ID de la + reserva urgente que la desplazó. Sólo se completa cuando + `estado=CANCELADA` y el motivo fue un desplazamiento automático. + nullable: true + example: null + created_at: + type: string + format: date-time + example: '2025-01-18T08:55:00Z' + CancelacionQuirofanoRequest: + type: object + required: + - motivo + - timestamp + properties: + motivo: + type: string + example: Paciente canceló el turno quirúrgico + tipo_cancelacion: + type: string + enum: + - CANCELACION_TURNO + - REPROGRAMACION_TURNO + - OTRO + nullable: true + example: CANCELACION_TURNO + timestamp: + type: string + format: date-time + example: '2025-01-19T14:00:00Z' + CancelacionQuirofanoResponse: + type: object + properties: + mensaje: + type: string + example: Reserva de quirófano cancelada correctamente + reserva_id: + type: integer + example: 15 + turno_id: + type: integer + example: 89 + cama_id: + type: integer + example: 501 + estado: + type: string + enum: + - CANCELADA + example: CANCELADA + PrioridadQuirofanoEnum: + type: string + description: > + Prioridad clínica de una reserva de quirófano. Ordenada de menor a mayor + importancia. + + + | Nivel | Uso típico | + + |-------|-----------| + + | `MUY_BAJA` | Procedimientos estéticos o diferibles sin impacto clínico + | + + | `BAJA` | Cirugías programadas de baja complejidad, pacientes estables + | + + | `MEDIA` | Cirugías programadas estándar | + + | `ALTA` | Cirugías programadas con riesgo clínico relevante si se + posponen | + + | `MUY_ALTA` | Cirugías programadas que no pueden postergarse más de + 24hs | + + | `URGENTE` | Cirugía de emergencia con riesgo vital | + + + **Quién la asigna:** + + + - M2 (Turnos) elige la prioridad al crear una reserva programada vía + `POST /camas/{camaId}/reservas`. Puede usar cualquier valor **excepto + `URGENTE`**. + + - `URGENTE` lo asigna M6 automáticamente cuando recibe una cirugía + urgente por `/webhooks/hce/cirugia-urgente`. Ningún rol humano ni + cliente HTTP puede asignar `URGENTE` desde otro endpoint. + + + **Regla de desplazamiento:** una reserva `URGENTE` entrante puede + desplazar automáticamente a otra reserva en estado `RESERVADA` de + prioridad estrictamente menor. El criterio de elección es "menor + prioridad y más cercana al horario requerido". Nunca se desplaza una + reserva en estado `EN_CURSO` o `COMPLETADA`. + enum: + - MUY_BAJA + - BAJA + - MEDIA + - ALTA + - MUY_ALTA + - URGENTE + CirugiaUrgenteWebhook: + type: object + description: > + Payload que envía HCE (M1) para solicitar un quirófano de forma urgente. + A diferencia de una reserva programada, no se especifica cama destino: + M6 decide qué quirófano utilizar y si desplaza o no una reserva de menor + prioridad. + required: + - solicitud_urgencia_hce_id + - paciente_id + - medico_cirujano_id + - medico_solicitante_id + - fecha_hora_inicio + - fecha_hora_fin_estimada + - diagnostico + - timestamp + properties: + solicitud_urgencia_hce_id: + type: string + description: > + Identificador único de la solicitud de urgencia en HCE. Usado para + idempotencia: si llega dos veces el mismo id, M6 devuelve la reserva + ya creada sin duplicar. + example: HCE-URG-00045 + paciente_id: + type: integer + example: 123 + medico_cirujano_id: + type: integer + description: Médico que ejecutará la cirugía. + example: 45 + medico_solicitante_id: + type: integer + description: > + Médico que solicita la cirugía desde HCE (puede ser distinto del + cirujano). + example: 78 + fecha_hora_inicio: + type: string + format: date-time + example: '2025-01-18T14:00:00Z' + fecha_hora_fin_estimada: + type: string + format: date-time + example: '2025-01-18T16:00:00Z' + diagnostico: + type: string + example: Apendicitis aguda con sospecha de perforación + hospital_id: + type: string + description: > + Hospital donde se requiere el quirófano. Si se omite, M6 evalúa + todos los hospitales del sistema. + nullable: true + example: HOSP-001 + observaciones: + type: string + nullable: true + timestamp: + type: string + format: date-time + description: Momento en que M1 disparó el webhook. + example: '2025-01-18T13:45:00Z' + CirugiaUrgenteResponse: + type: object + description: > + Respuesta al webhook de cirugía urgente. Informa si hubo desplazamiento + de una reserva existente y los datos de la nueva reserva creada. + required: + - mensaje + - reserva + properties: + mensaje: + type: string + example: Reserva urgente creada exitosamente + reserva: + $ref: '#/components/schemas/ReservaQuirofanoResponse' + reserva_desplazada: + type: object + description: > + Presente sólo si se canceló una reserva de menor prioridad para + ubicar la cirugía urgente. `null` si había quirófano libre. + properties: + reserva_id: + type: integer + example: 15 + cama_id: + type: integer + example: 501 + turno_id: + type: integer + description: >- + Si la reserva desplazada tenía turno asociado en M2, aparece acá + (es el appointment_id de M2). Indica que se disparó la + notificación a M2. + nullable: true + example: 89 + prioridad_original: + $ref: '#/components/schemas/PrioridadQuirofanoEnum' + notificado_a_m2: + type: boolean + description: > + `true` si la reserva desplazada tenía turno y se pudo notificar + a M2. `false` si no tenía turno o si la notificación falló + (igual así la reserva urgente se creó). + example: true + nullable: true + ErrorValidacion: + type: object + required: + - codigo + - mensaje + - errores + properties: + codigo: + type: string + example: ERROR_VALIDACION + mensaje: + type: string + example: Error de validación en los datos enviados + errores: + type: array + items: + type: object + required: + - campo + - mensaje + properties: + campo: + type: string + example: paciente_id + mensaje: + type: string + example: El campo es requerido + CamaMapaResponse: + type: object + description: Respuesta del mapa completo de camas con estadísticas agregadas + properties: + total: + type: integer + example: 50 + disponibles: + type: integer + example: 12 + ocupadas: + type: integer + example: 30 + en_limpieza: + type: integer + example: 5 + fuera_de_servicio: + type: integer + example: 2 + codigo_rojo: + type: integer + example: 1 + camas: + type: array + items: + $ref: '#/components/schemas/Cama' + Ext_Turno: + type: object + description: '[EXT] Detalle de un turno quirúrgico en M2 (Turnos)' + properties: + id: + type: integer + example: 89 + estado: + type: string + enum: + - CONFIRMADO + - PENDIENTE + - CANCELADO + - COMPLETADO + example: CONFIRMADO + paciente_id: + type: integer + example: 123 + medico_cirujano_id: + type: integer + example: 45 + fecha_hora_inicio: + type: string + format: date-time + example: '2025-01-18T09:00:00Z' + fecha_hora_fin_estimada: + type: string + format: date-time + example: '2025-01-18T11:00:00Z' + specialty_id: + type: integer + nullable: true + example: 43 + observaciones: + type: string + nullable: true + Ext_EventoEpisodioRequest: + type: object + description: '[EXT] Payload para registrar un evento en un episodio de internación (HCE M1)' + required: + - tipo_evento + - timestamp + properties: + tipo_evento: + type: string + description: Tipo de evento clínico a registrar + example: CODIGO_ROJO + descripcion: + type: string + description: Descripción libre del evento + nullable: true + example: Alerta de emergencia detectada por Monitoreo (M9) + timestamp: + type: string + format: date-time + example: '2025-01-15T14:22:33Z' + Ext_ValidateTokenRequest: + type: object + description: '[EXT] Payload para validar un JWT en el Módulo 10 (Core)' + required: + - token + properties: + token: + type: string + description: JWT a validar + example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... + responses: + NoAutenticado: + description: Token JWT ausente, expirado o malformado + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + examples: + Success: + summary: Success + value: + codigo: NO_AUTENTICADO + mensaje: No Autenticado + detalle: >- + No se proporcionó token de autenticación en el header + Authorization + NoAutorizado: + description: El rol del usuario no tiene permisos para esta acción + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + examples: + Success: + summary: Success + value: + codigo: NO_AUTORIZADO + mensaje: No Autorizado + detalle: >- + El usuario MED-0045 con rol MEDICO no tiene permiso para + ejecutar esta acción + CamaNoEncontrada: + description: Cama no encontrada + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + examples: + Success: + summary: Success + value: + codigo: RECURSO_NO_ENCONTRADO + mensaje: Cama no encontrada + detalle: No existe cama con ID 999 + SolicitudNoEncontrada: + description: Solicitud no encontrada + content: + application/json: + schema: + $ref: '#/components/schemas/Error' + examples: + Success: + summary: Success + value: + codigo: RECURSO_NO_ENCONTRADO + mensaje: Solicitud no encontrada + detalle: No existe solicitud con ID SOL-99999 + ErrorValidacion: + description: Error de validación en el body de la request + content: + application/json: + schema: + $ref: '#/components/schemas/ErrorValidacion' + examples: + Success: + summary: Success + value: + codigo: ERROR_VALIDACION + mensaje: Error de validación en los datos enviados + errores: + - campo: paciente_id + mensaje: El campo es requerido + securitySchemes: + BearerAuth: + type: http + scheme: bearer + bearerFormat: JWT +servers: [] +security: []