Download openapi.yaml from Modulo-6/api: direct link, hf CLI and curl.
- Browser
- Download file 132 kB
-
https://huggingface.co/spaces/Modulo-6/api/resolve/dd287e4dedfe13fcebf6599b82d517d13aa1ac3d/openapi.yaml
- Command line
-
hf download hf://spaces/Modulo-6/api@dd287e4dedfe13fcebf6599b82d517d13aa1ac3d/openapi.yaml
-
curl -L -o openapi.yaml https://huggingface.co/spaces/Modulo-6/api/resolve/dd287e4dedfe13fcebf6599b82d517d13aa1ac3d/openapi.yaml
132 kB
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: []
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 |