api / documentation /M6_openapi.json
juampisor's picture
SSO ticket saliente
15c2525
Raw History Blame
235 kB
{ "openapi": "3.0.1", "info": { "title": "Módulo predeterminado", "description": "API REST del módulo de Internación y Gestión de Camas para la red hospitalaria Health Grid.\n\n## Modelo de Dominio\n\nUn **EPISODIO DE INTERNACIÓN** comienza cuando se aprueba una solicitud de cama y termina\ncuando el Módulo 1 (HCE) notifica el alta médica.\n\nEl flujo principal es:\n\n1. Un médico solicita una cama desde HCE (M1)\n2. La solicitud llega a este módulo como webhook entrante\n3. Un administrativo la aprueba (con la cama pedida u otra), o la rechaza\n4. Al aprobar → se asigna la cama al paciente (estado `OCUPADA`)\n5. Los traslados también llegan como solicitudes desde HCE (M1) o se realizan directamente\n6. El alta médica llega como webhook desde HCE (M1)\n\n### Solicitudes\n\nLas solicitudes de internación y traslado llegan desde HCE (M1) y quedan en estado\n`PENDIENTE` hasta que un administrativo las resuelve.\n\n| Resolución | Efecto |\n|------------|--------|\n| `APROBAR` | Se ejecuta la acción (ingreso o traslado) con la cama solicitada |\n| `APROBAR_CON_CAMBIO` | Se ejecuta la acción con una cama distinta a la solicitada |\n| `RECHAZAR` | No se ejecuta ninguna acción. Se notifica a HCE |\n\n## Leyenda de Endpoints\n\n- **Sin prefijo:** Endpoints PROPIOS de este módulo (implementados por nosotros)\n- **Tag [EXT]:** Endpoints de otros módulos, documentados como referencia. Mockeados localmente en la 2da entrega\n\n## Webhooks Salientes (HTTP POST que este módulo dispara)\n\n| Evento | Receptor | Cuándo |\n|--------|----------|--------|\n| `SOLICITUD_RESUELTA` | Módulo 1 - HCE | Al aprobar o rechazar una solicitud |\n| `ALTA_MONITOREO` | Módulo 9 - Monitoreo | Al asignar una cama a un paciente (ingreso o traslado destino) |\n| `BAJA_MONITOREO` | Módulo 9 - Monitoreo | Al dar el alta médica o al trasladar un paciente (cama origen) |\n| `CAMA_LISTA` | Módulo 7 - Facturación | Al completar limpieza post-alta (cama pasa de EN_LIMPIEZA a DISPONIBLE) |\n\n## Webhooks Entrantes (HTTP POST que recibimos de otros módulos)\n\n| Evento | Emisor | Cuándo |\n|--------|--------|--------|\n| Solicitud de internación | Módulo 1 - HCE | Un médico solicita cama para internar un paciente |\n| Solicitud de traslado | Módulo 1 - HCE | Un médico solicita trasladar un paciente internado |\n| Alta médica | Módulo 1 - HCE | Un médico da el alta al paciente |\n| Alerta de emergencia | Módulo 9 - Monitoreo | Se detecta un código rojo en un paciente |\n\n## APIs Externas Consumidas\n\n| Módulo | Endpoint | Cuándo se usa |\n|--------|----------|---------------|\n| Core (M10) | `GET /usuarios/{pacienteId}` | Al aprobar una solicitud de internación |\n| Core (M10) | `POST /auth/validate-token` | En cada request (middleware JWT) |\n| HCE (M1) | `GET /pacientes/{pacienteId}/contraindicaciones` | Al aprobar una solicitud de internación |\n| HCE (M1) | `POST /hce/solicitudes/{solicitudHceId}/resultado` | Al resolver una solicitud |\n| HCE (M1) | `GET /hce/pacientes/{pacienteId}` | Al mostrar el detalle del paciente internado en una cama |\n| HCE (M1) | `POST /hce/movimientos` | Al asignar una cama o trasladar un paciente |\n| Turnos (M2) | `GET /turnos/{turnoId}` | Al aprobar solicitud con origen=CIRUGIA_PROGRAMADA |\n| Facturación (M7) | `POST /webhooks/internacion/cama-lista` | Al completar limpieza post-alta |\n| Monitoreo (M9) | `POST /webhooks/internacion/baja-monitoreo` | Al dar alta médica o trasladar (cama origen) |\n| Monitoreo (M9) | `POST /webhooks/internacion/alta-monitoreo` | Al asignar cama a un paciente (ingreso o traslado destino) |\n| HCE (M1) | `POST /hce/episodios/{episodioId}/eventos` | Al recibir alerta de emergencia de M9 |\n", "version": "4.0.0", "contact": { "name": "Grupo Módulo 6 - UADE" }, "license": { "name": "Uso académico" } }, "tags": [ { "name": "Auth" }, { "name": "Camas" }, { "name": "Quirófanos" }, { "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.\nPermite filtrar por piso, sector, estado y hospital.\n\n> **Nota:** Las camas con estado `BAJA_PERMANENTE` **no** se incluyen por defecto.\n\n> **Nota:** Los quirófanos (`tipo=CIRUGIA`) **no** se incluyen en este listado. Para gestionar quirófanos, usar `GET /quirofanos`.\n\n## Comportamiento por rol\n\n| Rol | Comportamiento |\n|-----|----------------|\n| `ADMINISTRATIVO`, `MEDICO` | Ve todas las camas con todos los filtros |\n| `LIMPIEZA` | Solo ve camas con estado `EN_LIMPIEZA`. Los demás filtros de estado se ignoran. |\n\n## Roles permitidos\n\n`MEDICO`, `ADMINISTRATIVO` y `LIMPIEZA`.\n", "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", "headers": {} }, "401": { "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" } } } } } }, "403": { "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" } } } } } } }, "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.\n\n## Consideraciones\n\n- El `id` de la cama es un entero generado automáticamente por el sistema.\n- La cama se crea en estado `DISPONIBLE` por defecto.\n\n## Roles permitidos\n\nSolo usuarios con rol `ADMINISTRATIVO` pueden ejecutar esta operación.\n\n> Si `tipo=CIRUGIA`, M6 responde `400 TIPO_NO_PERMITIDO`. Para dar de alta un quirófano usar `POST /quirofanos`.", "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" } } } }, "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": { "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" } ] } } } } } }, "401": { "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" } } } } } }, "403": { "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" } } } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/camas/{camaId}": { "get": { "summary": "Obtener detalle de una cama", "deprecated": false, "description": "## Roles permitidos\n\n`MEDICO` y `ADMINISTRATIVO`.\n", "operationId": "getCamaById", "tags": [ "Camas" ], "parameters": [ { "name": "quirofanoId", "in": "path", "description": "Identificador único de la cama (entero autogenerado)", "required": true, "example": 0, "schema": { "type": "integer", "example": 204 } }, { "name": "camaId", "in": "path", "description": "", "required": true, "example": "", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Detalle de la cama", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Cama" } } }, "headers": {} }, "401": { "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" } } } } } }, "404": { "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" } } } } } } }, "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\nde `contraindicaciones_incompatibles`.\n\n**Restricciones:**\n- El estado `OCUPADA` solo se asigna automáticamente al aprobar solicitudes o al asignar.\n- El estado `CODIGO_ROJO` solo lo setea el webhook de alerta de emergencia de M9. Para resolverlo, usar `POST /webhooks/monitoreo/alerta-resuelta`.\n\n## Actualización de contraindicaciones en cama OCUPADA\n\nSe permite actualizar `contraindicaciones_incompatibles` aunque la cama esté `OCUPADA`. El sistema **no bloquea** la operación aunque el paciente actual tenga alguna contraindicación que coincida con las recién agregadas. En ese caso:\n1. La actualización se aplica igualmente.\n2. Se registra en el log de auditoría con nivel `WARN`, indicando el `paciente_id`, la cama y las contraindicaciones en conflicto.\n3. No se emite ningún evento ni alerta automática: queda a criterio del administrativo notificar al médico a cargo.\n\n## Roles permitidos\n\n`ADMINISTRATIVO` y `LIMPIEZA`.\n\n## Restricciones por rol\n\n| Rol | Transiciones permitidas |\n|-----|------------------------|\n| `ADMINISTRATIVO` | Cualquier transición manual válida excepto `OCUPADA` (automático) y `CODIGO_ROJO` (solo M9) |\n| `LIMPIEZA` | Solo `EN_LIMPIEZA` → `DISPONIBLE` |\n\n> La transición `CODIGO_ROJO` → `OCUPADA` **no** se puede hacer manualmente desde este endpoint. Se ejecuta exclusivamente a través de `POST /webhooks/monitoreo/alerta-resuelta` (M9).\n\n## Comportamiento especial: limpieza completada (post-alta)\n\nCuando una cama pasa de `EN_LIMPIEZA` a `DISPONIBLE` y el último\nmovimiento del paciente fue un **alta médica**:\n\n1. Se dispara el webhook `CAMA_LISTA` al Módulo 7 (Facturación)\n con los datos del episodio para la liquidación de prestaciones.\n2. Se emite evento `CAMA_ACTUALIZADA` por WebSocket.\n\nSi la cama estaba `EN_LIMPIEZA` por un **traslado** (no por alta),\n**no** se dispara el webhook a facturación.\n\n> **Nota:** En versiones anteriores, `CAMA_LISTA` se disparaba al\n> recibir el alta médica. Ahora se dispara al completar la limpieza.\n", "operationId": "updateCamaEstado", "tags": [ "Camas" ], "parameters": [ { "name": "quirofanoId", "in": "path", "description": "", "required": true, "example": 0, "schema": { "type": "integer", "example": 0 } }, { "name": "camaId", "in": "path", "description": "", "required": true, "example": "", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CamaUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "Estado actualizado exitosamente", "headers": {} }, "400": { "description": "No autenticado", "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" } ] } } } } }, "headers": {} }, "401": { "description": "No autorizado", "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" } } } } }, "headers": {} }, "403": { "description": "Cama no encontrada", "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" } } } } }, "headers": {} }, "404": { "description": "Conflicto con el estado actual de la cama", "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" } } } } }, "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\n`BAJA_PERMANENTE` y la excluye del inventario operativo.\n\nNo se elimina el registro físico de la base de datos para preservar la trazabilidad\nhistórica (episodios pasados que referenciaron esta cama siguen siendo válidos).\n\n## Restricciones\n\n- Solo se puede dar de baja una cama que esté en estado `DISPONIBLE` o `FUERA_DE_SERVICIO`.\n- Si la cama está `OCUPADA` o `EN_LIMPIEZA` (lo que implica que estuvo ocupada\n recientemente), la operación es rechazada con `409 Conflict`.\n- Una cama con estado `BAJA_PERMANENTE` **no puede** ser reactivada a través de esta API\n (requiere intervención manual en base de datos o un proceso administrativo separado).\n\n## Roles permitidos\n\nSolo usuarios con rol `ADMINISTRATIVO` pueden ejecutar esta operación.\n", "operationId": "darDeBajaCama", "tags": [ "Camas" ], "parameters": [ { "name": "quirofanoId", "in": "path", "description": "Identificador único de la cama (entero autogenerado)", "required": true, "example": 0, "schema": { "type": "integer", "example": 204 } }, { "name": "camaId", "in": "path", "description": "", "required": true, "example": "", "schema": { "type": "string" } } ], "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": { "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" } } } } } }, "403": { "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" } } } } } }, "404": { "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" } } } } } }, "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\ndesde su cama actual a esta cama (traslado), sin requerir una solicitud previa.\n\nAntes de asignar, el sistema verifica que ninguna contraindicación del paciente\nesté en la lista `contraindicaciones_incompatibles` de la cama destino. Si\nalguna coincide, devuelve `HTTP 422 CONTRAINDICACION_DETECTADA`.\n\n## Tipos de movimiento\n\n| Tipo | Descripción |\n|------|-------------|\n| `INGRESO` | Asigna el paciente a la cama. La cama pasa a estado `OCUPADA`. |\n| `TRASLADO` | Mueve al paciente desde su cama actual (`cama_origen_id`) a esta. La cama origen pasa a `EN_LIMPIEZA`, la destino a `OCUPADA`. |\n\n## Efectos colaterales\n\n- **[EXT]** Notifica el movimiento a HCE (M1) vía `POST /hce/movimientos`\n- **[EXT]** Si `tipo=INGRESO`: emite `ALTA_MONITOREO` a M9 (el paciente entra en monitoreo)\n- Si `tipo=TRASLADO`: **no** se emiten eventos de monitoreo (el monitoreo sigue al paciente, no a la cama)\n\n## Roles permitidos\n\nSolo usuarios con rol `ADMINISTRATIVO`.\n", "operationId": "asignarCama", "tags": [ "Camas" ], "parameters": [ { "name": "camaId", "in": "path", "description": "Identificador único de la cama (entero autogenerado)", "required": true, "example": 204, "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": { "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" } ] } } } } } }, "401": { "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" } } } } } }, "403": { "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" } } } } } }, "404": { "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" } } } } } }, "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": [] } ] } }, "/quirofanos/{quirofanoId}": { "get": { "summary": "Obtener quirófano por ID", "deprecated": false, "description": "Retorna el detalle de un quirófano específico.\n\n## Roles permitidos\n\n`MEDICO` y `ADMINISTRATIVO`.", "operationId": "getQuirofanoById", "tags": [ "Quirófanos" ], "parameters": [ { "name": "quirofanoId", "in": "path", "description": "", "required": true, "example": 0, "schema": { "type": "integer", "example": 501 } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuirofanoResponse" }, "example": { "id": 501, "numero": "Q01", "piso": 5, "specialty_id": 43, "estado": "DISPONIBLE", "hospital_id": "HOSP-001", "contraindicaciones_incompatibles": [], "ultima_actualizacion": "2025-01-18T08:00:00Z" } } }, "headers": {} }, "401": { "description": "No autenticado", "headers": {} }, "404": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "codigo": "QUIROFANO_NO_ENCONTRADO", "mensaje": "No existe un quirófano con id 501", "detalle": null } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] }, "patch": { "summary": "Actualizar quirófano", "deprecated": false, "description": "Permite actualizar `specialty_id`, `contraindicaciones_incompatibles` y `estado` de un quirófano.\n\n`tipo` y `sector` no son modificables.\n\nSi se actualizan `contraindicaciones_incompatibles` con el quirófano `OCUPADA`, la operación se permite pero se registra en el log de auditoría con nivel `WARN`.\n\n## Roles permitidos\n\nSolo `ADMINISTRATIVO`.", "operationId": "updateQuirofano", "tags": [ "Quirófanos" ], "parameters": [ { "name": "quirofanoId", "in": "path", "description": "", "required": true, "example": 0, "schema": { "type": "integer", "example": 501 } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "specialty_id": { "type": "integer", "nullable": true, "example": 43 }, "contraindicaciones_incompatibles": { "type": "array", "items": { "type": "string" } }, "estado": { "$ref": "#/components/schemas/EstadoCamaEnum" } } }, "example": { "specialty_id": 43, "contraindicaciones_incompatibles": [ "ALERGIA_LATEX" ] } } }, "required": true }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuirofanoResponse" } } }, "headers": {} }, "400": { "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" } ] } } } } } }, "401": { "description": "No autenticado", "headers": {} }, "403": { "description": "Rol sin permiso", "headers": {} }, "404": { "description": "Quirófano no encontrado", "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/quirofanos": { "get": { "summary": "Listar quirófanos", "deprecated": false, "description": "Retorna el listado de todos los quirófanos del hospital (`tipo=CIRUGIA`, `sector=QUIROFANO`) con su estado actual.\n\nEs el equivalente de `GET /camas` pero exclusivo para quirófanos. Los quirófanos no aparecen en `GET /camas`.\n\n## Roles permitidos\n\n`MEDICO` y `ADMINISTRATIVO`.", "operationId": "listQuirofanos", "tags": [ "Quirófanos" ], "parameters": [ { "name": "hospital_id", "in": "query", "description": "Filtra por sede", "required": false, "schema": { "type": "string", "example": "HOSP-001" } }, { "name": "estado", "in": "query", "description": "Filtra por estado del quirófano", "required": false, "schema": { "$ref": "#/components/schemas/EstadoCamaEnum" } }, { "name": "specialty_id", "in": "query", "description": "Filtra por especialidad quirúrgica", "required": false, "schema": { "type": "integer", "example": 43 } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "integer", "example": 4 }, "quirofanos": { "type": "array", "items": { "$ref": "#/components/schemas/QuirofanoResponse" } } } }, "example": { "total": 2, "quirofanos": [ { "id": 501, "numero": "Q01", "piso": 5, "specialty_id": 43, "estado": "DISPONIBLE", "hospital_id": "HOSP-001", "contraindicaciones_incompatibles": [], "ultima_actualizacion": "2025-01-18T08:00:00Z" }, { "id": 502, "numero": "Q02", "piso": 5, "specialty_id": 12, "estado": "OCUPADA", "hospital_id": "HOSP-001", "contraindicaciones_incompatibles": [ "ALERGIA_LATEX" ], "ultima_actualizacion": "2025-01-18T09:00:00Z" } ] } } }, "headers": {} }, "401": { "description": "No autenticado", "headers": {} }, "403": { "description": "Rol sin permiso", "headers": {} } }, "security": [ { "BearerAuth": [] } ] }, "post": { "summary": "Dar de alta un quirófano", "deprecated": false, "description": "Permite a un administrador registrar un nuevo quirófano en el inventario.\n\n`tipo` y `sector` son fijos (`CIRUGIA` / `QUIROFANO`): M6 los asigna internamente, no se envían en el request.\n\nEl quirófano se crea en estado `DISPONIBLE` por defecto.\n\n## Roles permitidos\n\nSolo `ADMINISTRATIVO`.", "operationId": "createQuirofano", "tags": [ "Quirófanos" ], "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuirofanoCreateRequest" }, "example": { "numero": "Q01", "piso": 5, "specialty_id": 43, "hospital_id": "HOSP-001", "contraindicaciones_incompatibles": [] } } }, "required": true }, "responses": { "201": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuirofanoResponse" }, "example": { "id": 501, "numero": "Q01", "piso": 5, "specialty_id": 43, "estado": "DISPONIBLE", "hospital_id": "HOSP-001", "contraindicaciones_incompatibles": [], "ultima_actualizacion": "2025-01-18T08:00:00Z" } } }, "headers": {} }, "400": { "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" } ] } } } } } }, "401": { "description": "No autenticado", "headers": {} }, "403": { "description": "Rol sin permiso", "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/quirofanos/{quirofanoId}/reservas": { "get": { "summary": "Listar reservas de un quirófano", "deprecated": false, "description": "Retorna las reservas de un quirófano con filtros opcionales.\nPor defecto devuelve reservas con estado `RESERVADA` y `EN_CURSO`.\n\nSolo aplica a camas con **sector=QUIROFANO y tipo=CIRUGIA**.\nSi la cama no cumple esta condición, responde `409 CAMA_NO_ES_QUIROFANO`.\n\n## Roles permitidos\n\n`MEDICO` y `ADMINISTRATIVO`.\n", "operationId": "getReservasQuirofano", "tags": [ "Quirófanos" ], "parameters": [ { "name": "quirofanoId", "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": "Recibir solicitud de cirugía programada", "deprecated": false, "description": "Crea una reserva de quirófano para una cirugía programada. **Este endpoint lo invoca exclusivamente M1 (HCE)** cuando un médico programa una cirugía para un paciente.\n\n## Flujo completo de una cirugía programada\n\n1. El médico programa la cirugía en M1 (HCE).\n2. M1 consulta `GET /quirofanos/disponibilidad` para ver qué quirófanos están libres en el horario requerido.\n3. M1 llama a este endpoint con los datos de la cirugía.\n4. M6 valida disponibilidad del quirófano, crea la reserva en estado `RESERVADA` y responde `201`.\n5. M6 da de alta el turno en M2 llamando a `POST /api/v1/appointments` con los datos del médico, paciente y horario.\n6. M2 devuelve el `appointment_id`, que M6 almacena en la reserva como `turno_id`.\n\n## Validaciones\n\n- El recurso `{quirofanoId}` debe existir y ser un quirófano (`tipo=CIRUGIA`, `sector=QUIROFANO`). Si no: `409 CAMA_NO_ES_QUIROFANO`.\n- Si el quirófano ya tiene una reserva activa en ese rango horario: `409 RESERVA_SUPERPUESTA`.\n- Si ya existe una reserva activa para el mismo paciente en otro quirófano en el mismo horario: `409 RESERVA_DUPLICADA`.\n\n## Idempotencia\n\nSi M1 reintenta con los mismos datos (mismo paciente, médico y horario para la misma cama), M6 devuelve la reserva existente con `200 OK`.\n", "operationId": "crearReservaQuirofano", "tags": [ "Quirófanos" ], "parameters": [ { "name": "quirofanoId", "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" }, "examples": { "reserva_superpuesta": { "summary": "El quirófano tiene otra reserva en ese horario", "value": { "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" } }, "reserva_duplicada": { "summary": "El turno_id ya tiene una reserva en otro quirófano", "value": { "codigo": "RESERVA_DUPLICADA", "mensaje": "Ya existe una reserva activa para este turno en otro quirófano", "detalle": "El turno 89 ya tiene una reserva activa en el quirófano 502. Cancelá esa reserva antes de crear una nueva." } } } } }, "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": [] } ] } }, "/quirofanos/{quirofanoId}/reservas/{reservaId}": { "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.\n\n## Transiciones válidas\n\n| De | A | Efecto en la cama |\n|----|---|-------------------|\n| `RESERVADA` | `EN_CURSO` | Cama pasa a `OCUPADA` |\n| `RESERVADA` | `CANCELADA` | Sin cambio en la cama |\n| `EN_CURSO` | `COMPLETADA` | Cama pasa a `EN_LIMPIEZA` |\n\n## Comportamiento\n\nEste endpoint `PATCH` queda para acciones internas de M6, por ejemplo iniciar la\ncirugía, completarla o cancelar una reserva \n\nSe 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.\n\n- Cambia la reserva a estado `CANCELADA` y libera el recurso para nuevas reservas.\n- 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.\n- No reemplaza a `POST /turnos/{turnoId}/cancelacion-quirofano`: ese endpoint sigue siendo para cancelaciones iniciadas por M2.\n\n## Roles permitidos\n\n`ADMINISTRATIVO`.\n", "operationId": "updateEstadoReserva", "tags": [ "Quirófanos" ], "parameters": [ { "name": "quirofanoId", "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": [] } ] }, "get": { "summary": "Obtener detalle de una reserva", "deprecated": false, "description": "Devuelve el detalle completo de una reserva de quirófano.\n\n## Roles permitidos\n\n`MEDICO` y `ADMINISTRATIVO`.\n", "operationId": "getReservaById", "tags": [ "Quirófanos" ], "parameters": [ { "name": "reservaId", "in": "path", "description": "", "required": true, "example": 0, "schema": { "type": "integer", "example": 1 } }, { "name": "quirofanoId", "in": "path", "description": "", "required": true, "example": "", "schema": { "type": "string", "example": "" } } ], "responses": { "200": { "description": "Detalle de la reserva", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReservaQuirofanoResponse" } } }, "headers": {} }, "401": { "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" } } } } } }, "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": [] } ] } }, "/quirofanos/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`.\n\nSe 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 /quirofanos/{quirofanoId}/reservas` para M1, 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.\n\n## Quién lo usa\n\n- **M2 (Turnos):** consulta principal. Lo usa para mostrar opciones en la UI de reserva de turnos quirúrgicos.\n- **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á.\n\n## Filtros y comportamiento combinado\n\n- `desde` y `hasta` son obligatorios. Define el rango donde se buscan superposiciones.\n- `hospital_id` (opcional): filtra por sede. Si se omite, devuelve quirófanos de todos los hospitales.\n- `specialty_id` (opcional): filtra por especialidad quirúrgica. Devuelve **únicamente** los quirófanos cuyo campo `specialty_id` coincide con el valor enviado. Los quirófanos con `specialty_id=null` **no** se incluyen cuando este filtro está activo. Si se omite, devuelve todos los quirófanos independientemente de su especialidad.\n- Cuando se combinan `hospital_id` y `specialty_id`, ambos filtros se aplican como condición AND.\n", "operationId": "getDisponibilidadQuirofanos", "tags": [ "Quirófanos" ], "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": "integer", "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.\n", "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": { "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" } ] } } } } } }, "401": { "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" } } } } } }, "403": { "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" } } } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/solicitudes": { "get": { "summary": "Listar solicitudes", "deprecated": false, "description": "Retorna las solicitudes de internación y traslado recibidas desde HCE (M1).\nPor defecto devuelve solo las solicitudes en estado `PENDIENTE`.\n\n## Roles permitidos\n\n`MEDICO` (lectura) y `ADMINISTRATIVO`.\n", "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": { "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" } } } } } }, "403": { "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" } } } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/solicitudes/{solicitudId}": { "get": { "summary": "Obtener detalle de una solicitud", "deprecated": false, "description": "## Roles permitidos\n\n`MEDICO` (lectura) y `ADMINISTRATIVO`.\n", "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": { "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" } } } } } }, "404": { "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" } } } } } } }, "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.\n\n## Acciones posibles\n\n| Acción | Descripción |\n|--------|-------------|\n| `APROBAR` | Acepta la solicitud con la cama originalmente solicitada |\n| `APROBAR_CON_CAMBIO` | Acepta pero asigna una cama distinta (requiere `cama_asignada_id` y `motivo`) |\n| `RECHAZAR` | Rechaza la solicitud (requiere `motivo`) |\n\n## Flujo al APROBAR solicitud de INTERNACION\n\n1. **[EXT]** Valida existencia del paciente con Core (M10)\n2. Verifica que ninguna contraindicación del paciente coincida con\n `contraindicaciones_incompatibles` de la cama destino; si coincide → `HTTP 422`\n3. Marca la cama como `OCUPADA` y asigna el paciente\n4. **[EXT]** Notifica el movimiento y el resultado a HCE (M1) vía `POST /hce/movimientos`\n con `tipo_movimiento=INGRESO` (M1 registra el movimiento y notifica al médico a cargo)\n5. **[EXT]** Emite `ALTA_MONITOREO` a M9 vía `POST /webhooks/internacion/alta-monitoreo`\n\n## Flujo al APROBAR solicitud de TRASLADO\n\n1. Valida que la cama destino esté `DISPONIBLE` y compatible con las contraindicaciones del paciente\n2. Cama origen → `EN_LIMPIEZA`, cama destino → `OCUPADA`\n3. **[EXT]** Notifica el movimiento y el resultado a HCE (M1) vía `POST /hce/movimientos`\n con `tipo_movimiento=TRASLADO`\n4. El monitoreo continúa sobre el mismo paciente: **no** se emite `ALTA_MONITOREO` ni `BAJA_MONITOREO`\n\n## Flujo al RECHAZAR\n\n1. Marca solicitud como `RECHAZADA`\n2. **[EXT]** Notifica el rechazo a HCE (M1) vía `POST /hce/movimientos`\n con `tipo_movimiento=RESOLUCION_SOLICITUD`, `resultado=RECHAZADA` y el `motivo`\n\n> **Nota sobre contraindicaciones:** la consulta a HCE (M1) de contraindicaciones del paciente\n> es puramente informativa para la decisión del administrativo. La validación automática sólo\n> se ejecuta contra `contraindicaciones_incompatibles` de la cama.\n\n## Roles permitidos\n\nSolo usuarios con rol `ADMINISTRATIVO`.\n", "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": { "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" } ] } } } } } }, "401": { "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" } } } } } }, "403": { "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" } } } } } }, "404": { "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" } } } } } }, "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\npara internar a un paciente o para trasladarlo a otra cama. El campo `tipo`\ndiscrimina entre ambos flujos.\n\n## Acciones que ejecuta este módulo\n\n1. Valida el payload según `tipo` (`INTERNACION` o `TRASLADO`).\n2. Crea una solicitud en estado `PENDIENTE`.\n3. Queda disponible para que un administrativo la resuelva vía `PATCH /solicitudes/{id}`.\n", "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": "MED-0045", "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": "MED-0045", "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": { "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" } ] } } } } } }, "401": { "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" } } } } } } }, "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 lo antes posible.\n\n## Diferencia con el flujo de reserva programada\n\nEste 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/{quirofanoId}/reservas`, invocado por M1) en cuatro aspectos:\n\n| Aspecto | Este webhook | `POST /camas/{quirofanoId}/reservas` |\n|---------|--------------|----------------------------------|\n| Origen | M1 (HCE) vía webhook urgente | M1 (HCE) vía cirugía programada |\n| Cama destino | M6 la elige automáticamente | La fija M1 en el path |\n| Horario | M6 lo calcula (ASAP) | Lo fija M1 |\n| Prioridad | Siempre `URGENTE` | Cualquiera excepto `URGENTE` |\n| Desplazamiento de otras reservas | Sí, automático (reprograma, no cancela) | No |\n| Quién lo invoca | M1 (HCE) exclusivamente | M2 (Turnos) exclusivamente |\n\nEn 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 reprogramar automáticamente a otras reservas ya confirmadas.\n\n## Algoritmo ASAP (\"lo antes posible\")\n\n`fecha_hora_inicio` se interpreta como \"no antes de\" y `fecha_hora_fin_estimada - fecha_hora_inicio` como la duración de la cirugía — **no** es una ventana fija: M6 decide el horario real.\n\n1. Se consideran los quirófanos compatibles: mismo `hospital_id` (si se envió), excluidos los que están `FUERA_DE_SERVICIO`, `BAJA_PERMANENTE` o `EN_LIMPIEZA`. Si no queda ninguno, responde `409 SIN_QUIROFANO_COMPATIBLE`.\n\n2. Para cada quirófano candidato se calcula el **inicio más temprano factible**: arranca en \"no antes de\" y se empuja cada vez que choca con una reserva **bloqueante** — `EN_CURSO` (ya está pasando, no se puede tocar) o `RESERVADA` con prioridad `URGENTE` (nunca se desplaza entre urgencias) — hasta que ninguna bloqueante solapa más.\n\n3. Se elige el quirófano con menor inicio factible. Empate: preferencia por `specialty_id` si se envió, luego menor `id` de quirófano.\n\n4. Si en la ventana elegida caían reservas `PROGRAMADA` (no urgentes, no bloqueantes), se **reprograman** (nunca se cancelan): cada una se reubica en el próximo hueco libre y, si tiene `turno_id`, se notifica el nuevo horario a M2 vía `PATCH /appointments/{turno_id}/reschedule`. Puede haber más de una reserva reprogramada si varias caían dentro de la ventana.\n\n5. Se crea la reserva urgente (`origen=EMERGENCIA`, `prioridad=URGENTE`, `estado=RESERVADA`) con el horario finalmente calculado. Responde `201`.\n\n## Idempotencia\n\nEl 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.\n", "operationId": "recibirCirugiaUrgente", "tags": [ "Quirófanos" ], "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" }, "reservas_desplazadas": [] } }, "con_desplazamiento": { "summary": "Se reprogramó una reserva programada para liberar el quirófano", "value": { "mensaje": "Reserva urgente creada. Se reprogramaron las reservas 15", "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)", "desplazada_por_reserva_id": null, "created_at": "2025-01-18T13:46:00Z" }, "reservas_desplazadas": [ { "reserva_id": 15, "cama_id": 501, "turno_id": 89, "prioridad_original": "BAJA", "notificado_a_m2": true } ] } } } } }, "headers": {} }, "400": { "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" } ] } } } } } }, "401": { "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" } } } } } }, "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 compatibles/operables", "value": { "codigo": "SIN_QUIROFANO_COMPATIBLE", "mensaje": "No hay quirófanos operables para el hospital indicado", "detalle": "No existe ningún quirófano del hospital solicitado que no esté FUERA_DE_SERVICIO, BAJA_PERMANENTE o EN_LIMPIEZA. M1 debe derivar a otro hospital." } } } } }, "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": [] } ] } }, "/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\npaciente internado. M1 es dueño del episodio: este módulo sólo reacciona\nsobre la cama y dispara los webhooks correspondientes.\n\nLa cama del paciente se resuelve internamente a partir del `paciente_id`\n(este módulo mantiene su propio registro de asignaciones activas).\nM1 **no necesita enviar** el `cama_id` en el payload.\n\n## Acciones que ejecuta este módulo\n\n1. Busca la cama actualmente asignada al `paciente_id` recibido.\n2. La cama pasa a estado `EN_LIMPIEZA`.\n3. **[WEBHOOK]** Emite `BAJA_MONITOREO` al Módulo 9 (Monitoreo).\n4. Se emite evento `CAMA_ACTUALIZADA` por WebSocket.\n\n> **Nota:** El webhook `CAMA_LISTA` a Facturación (M7) **NO** se dispara aquí.\n> Se dispara cuando el personal de limpieza marca la cama como `DISPONIBLE`\n> vía `PATCH /camas/{quirofanoId}`.\n", "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": { "description": "No autenticado", "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" } ] } } } } }, "headers": {} }, "401": { "description": "Paciente no encontrado o sin cama asignada", "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" } } } } }, "headers": {} }, "404": { "description": "Paciente no encontrado o sin cama asignada", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": {} } }, "security": [ { "BearerAuth": [] } ] } }, "/turnos/{turnoId}/cancelacion": { "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\nde una cirugía programada.\n\nM2 es dueño del turno quirúrgico. M6 no cancela el turno: únicamente cancela la\nreserva física del quirófano asociada al `turnoId` y libera el recurso si\ncorresponde.\n\n## Comportamiento\n\n- Busca una reserva activa con `turno_id = turnoId` y `origen = PROGRAMADA`.\n- Si la reserva está `RESERVADA`, cambia su estado a `CANCELADA`.\n- Si la reserva ya está `EN_CURSO` o `COMPLETADA`, responde `409` porque no se\n puede cancelar por este flujo.\n- La operación debe ser idempotente: si la reserva ya estaba `CANCELADA`, puede\n responder `200` con el estado actual.\n\n## Autorización\n\nSólo M2 (Turnos). No hay rol humano con permiso para invocar este endpoint directamente desde M6.\n", "operationId": "cancelarReservaQuirofanoPorTurno", "tags": [ "Quirófanos" ], "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 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" } ] } } } } } }, "401": { "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" } } } } } }, "403": { "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" } } } } } }, "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\nen un paciente internado.\n\nLa cama se resuelve internamente a partir del `paciente_id` (este módulo\nmantiene su propio registro de asignaciones activas). M9 **no necesita enviar**\nel `cama_id` en el payload.\n\n## Acciones que ejecuta este módulo\n\n1. Busca la cama actualmente asignada al `paciente_id` recibido.\n2. Setea `estado=CODIGO_ROJO` en esa cama.\n\n> **Nota:** M9 es quien notifica al médico a cargo del paciente. Este módulo\n> no registra eventos adicionales ni llama a otros módulos al recibir la alerta.\n", "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": { "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" } } } } } }, "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\nde emergencia (código rojo) se resuelve: los signos vitales del\npaciente volvieron a parámetros normales.\n\n## Acciones que ejecuta este módulo:\n1. La cama pasa de `CODIGO_ROJO` a `OCUPADA`\n2. Se registra la resolución en el historial de alertas\n3. Se emite evento `ALERTA_RESUELTA` por WebSocket\n\nSi la cama no está en estado `CODIGO_ROJO`, responde 409.\n\n**Mock 2da entrega:** Endpoint local que cambia el estado de la cama.\n", "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": { "description": "La cama del paciente no está en CODIGO_ROJO", "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" } } } } }, "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).**\n\nConsulta informativa. El administrativo puede usarla para revisar las\ncontraindicaciones del paciente antes de resolver una solicitud. La validación\nautomática se hace contra `contraindicaciones_incompatibles` de la cama.\n", "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": { "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" } } } } } }, "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).**\n\nSe consume para mostrar la información clínica y demográfica de un paciente\nque está actualmente internado en una cama.\n\nDevuelve datos de contacto, obra social, diagnósticos activos y medicación\nvigente, permitiéndole al personal ver el perfil completo del paciente\nsin salir del módulo de internación.\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": { "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" } } } } } }, "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).**\n\nEndpoint unificado para notificar a HCE todos los movimientos de pacientes y\nresultados de solicitudes. M1 persiste el movimiento en la historia clínica\ny notifica al médico a cargo cuando corresponde.\n\n| `tipo_movimiento` | Cuándo se usa |\n|-------------------|---------------|\n| `INGRESO` | Al aprobar una internación o al ingresar directamente un paciente |\n| `TRASLADO` | Al aprobar un traslado o al trasladar directamente |\n| `ALTA` | Al procesar el alta médica |\n| `RESOLUCION_SOLICITUD` | Al rechazar una solicitud (sin movimiento físico) |\n", "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": { "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" } ] } } } } } }, "401": { "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" } } } } } }, "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": [] } ] } }, "/api/v1/appointments": { "post": { "summary": "/appointments", "deprecated": false, "description": "Permite reservar un turno en M2.\n\nM6 invoca este endpoint **inmediatamente después de crear una reserva de quirófano** (tanto para cirugías programadas como urgentes) para registrar el turno en el sistema de gestión de turnos. El `appointment_id` devuelto por M2 se almacena en M6 como `turno_id` de la reserva.\n\nEn el caso de una cirugía programada, este call es el paso 4 del flujo: M1 → M6 crea reserva → M6 llama a este endpoint → M2 devuelve `appointment_id`.\n\nEn el caso de una cirugía urgente que no desplazó ninguna reserva, M6 también llama aquí para registrar el nuevo turno urgente en M2.\n\n**Mock 2da entrega:** Endpoint local que responde HTTP 201 con `appointment_id` fijo.", "operationId": "ext_crearAppointmentM2", "tags": [ "[EXT] Turnos - Módulo 2" ], "parameters": [], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "medic": { "type": "object", "description": "Objeto con la información relacionada al médico", "properties": { "id": { "type": "integer", "description": "ID asociado al médico del turno" }, "fullname": { "type": "string", "description": "Nombre completo del médico" }, "email": { "type": "string", "description": "Email del médico" } }, "required": [ "id", "fullname", "email" ] }, "patient": { "type": "object", "description": "Objeto con la información relacionada al paciente", "properties": { "id": { "type": "integer", "description": "ID asociado al paciente del turno" }, "fullname": { "type": "string", "description": "Nombre completo del paciente" }, "email": { "type": "string", "description": "Email del paciente" } }, "required": [ "id", "fullname", "email" ] }, "appointment": { "type": "object", "description": "Objeto con la información asociada al turno", "properties": { "center_id": { "type": "integer", "description": "ID asociado al centro médico donde se llevará a cabo el turno" }, "speciality_id": { "type": "integer", "description": "ID asociado a la especialidad del médico que el paciente necesitaba" }, "starts_at": { "type": "string", "description": "Fecha y hora del inicio del turno, en formato YYYY-MM-DD HH:mm:ss" }, "ends_at": { "type": "string", "description": "Fecha y hora estipulada de fin del turno, en formato YYYY-MM-DD HH:mm:ss" } }, "required": [ "center_id", "speciality_id", "starts_at", "ends_at" ] } }, "required": [ "medic", "patient", "appointment" ] }, "example": { "appointment": { "center_id": 4, "speciality_id": 43, "starts_at": "2026-06-02 16:00:00", "ends_at": "2026-06-02 16:30:00" }, "medic": { "id": 1129, "fullname": "Dr. Marcelo Ferreyra (1129)", "email": "marcelo.ferreyra@mail.com" }, "patient": { "id": 123, "email": "maria.gonzalez@email.com", "fullname": "González María Elena" } } } }, "required": true }, "responses": { "201": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "appointment_id": { "type": "integer", "description": "ID del turno generado. M6 lo almacena como `turno_id` en la reserva de quirófano." } }, "required": [ "appointment_id" ] }, "example": { "appointment_id": 89 } } }, "headers": {} }, "400": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Tipo de error" }, "details": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string", "description": "Campo mal utilizado o faltante" }, "message": { "type": "string", "description": "Mensaje para guiar hacia la solución del error" } }, "required": [ "field", "message" ] }, "description": "Lista de objetos con los campos y sus errores asociados" } }, "required": [ "error", "details" ] }, "examples": { "2": { "summary": "Falta de campos", "value": { "error": "Validation error", "details": [ { "field": "medic_id", "message": "medic_id is required" }, { "field": "patient_id", "message": "patient_id is required" }, { "field": "center_id", "message": "center_id is required" }, { "field": "speciality_id", "message": "speciality_id is required" }, { "field": "starts_at", "message": "starts_at is required" }, { "field": "ends_at", "message": "ends_at is required" } ] } }, "3": { "summary": "Validación: starts_at NO es menor a la fecha actual", "value": { "error": "BadRequestError", "message": "Cannot create appointment in the past", "timestamp": "2026-04-10T03:45:23.938Z" } }, "4": { "summary": "Validación: los turnos NO se solapan", "value": { "error": "BadRequestError", "message": "The medic already has an overlapping appointment for the given time range", "timestamp": "2026-04-10T03:57:18.634Z" } } } } }, "headers": {} }, "500": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Tipo de error" }, "message": { "type": "string", "description": "Mensaje asociado al error, asignado por el desarrollador" }, "timestamp": { "type": "string", "description": "Fecha y hora de la petición, con estructura de ISO 8601" } }, "required": [ "error", "message", "timestamp" ] }, "example": { "error": "InternalServerError", "message": "Failed to create appointment", "timestamp": "2026-04-10T04:08:12.074Z" } } }, "headers": {} } }, "security": [] } }, "/webhooks/internacion/cama-lista": { "post": { "summary": "Notificar cama lista (dispara liquidación)", "deprecated": false, "description": "**Pertenece al Módulo 7 (Facturación).**\n\nSe llama al procesar el alta médica para iniciar la liquidación de prestaciones.\nEl payload incluye los datos del episodio necesarios para facturar:\nobra social, historial de camas con timestamps, diagnósticos, etc.\n\n> **Nota:** se dispara inmediatamente al recibir el alta, no cuando la cama\n> pasa a `DISPONIBLE`.\n", "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": { "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" } ] } } } } } }, "401": { "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" } } } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/webhooks/internacion/baja-monitoreo": { "post": { "summary": "Notificar baja de monitoreo de paciente", "deprecated": false, "description": "**Pertenece al Módulo 9 (Monitoreo).**\n\nSe llama al procesar el alta médica para indicar al módulo de\nmonitoreo que deje de monitorear al paciente dado de alta.\n", "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": { "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" } } } } } }, "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).**\n\nSe llama al ingresar un paciente (aprobación de internación o asignación directa)\npara que M9 inicie el monitoreo. **No** se llama en traslados: el monitoreo\nsigue al paciente, no a la cama.\n", "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": { "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" } } } } } }, "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).**\n\nDevuelve un `access_token` (JWT) y un `refresh_token` a partir de las\ncredenciales del usuario.\n", "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).**\n\nEmite un nuevo `access_token` a partir de un `refresh_token` válido.\n", "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": [] } }, "/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\nusuario/paciente identificado por `pacienteId`.\n", "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": { "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" } } } } } }, "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": [] } ] } }, "/api/v1/appointments/{appointmentId}": { "get": { "summary": "/appointments/<id>", "deprecated": false, "description": "Permite obtener la información asociada a un turno según su ID.\n\nM6 consume este endpoint al aprobar una solicitud de internación con `origen=CIRUGIA_PROGRAMADA`: antes de asignar la cama, consulta los datos del turno quirúrgico en M2 para validar que el turno existe, está confirmado (`status=CONFIRMED`) y corresponde al paciente correcto. Si el turno no existe o está cancelado, M6 rechaza la solicitud.\n\n> `turnoId` corresponde al `appointment_id` (entero) devuelto por M2 en `POST /api/v1/appointments`, y es el mismo valor que M2 envía como `turno_id` al crear una reserva de quirófano en M6.", "operationId": "ext_getTurnoM2", "tags": [ "[EXT] Turnos - Módulo 2" ], "parameters": [ { "name": "appointmentId", "in": "path", "description": "ID del turno en M2 (appointment_id devuelto por `POST /api/v1/appointments`)", "required": true, "example": 89, "schema": { "type": "integer", "example": 89 } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID asociado al turno" }, "medic_id": { "type": "integer", "description": "ID asociado al médico del turno" }, "patient_id": { "type": "integer", "description": "ID asociado al paciente del turno" }, "center_id": { "type": "integer", "description": "ID asociado al centro médico donde se llevará a cabo el turno" }, "speciality_id": { "type": "integer", "description": "ID asociado a la especialidad del médico que el paciente necesitaba" }, "status": { "type": "string", "enum": [ "PENDING_CONFIRMATION", "CONFIRMED", "CANCELLED", "CHECKED_IN", "COMPLETED", "ABSENT", "EXPIRED" ], "description": "Estado actual del turno" }, "starts_at": { "type": "string", "description": "Fecha y hora del inicio del turno, en formato YYYY-MM-DD HH:mm:ss" }, "ends_at": { "type": "string", "description": "Fecha y hora estipulada de fin del turno, en formato YYYY-MM-DD HH:mm:ss" }, "confirmed_at": { "type": "string", "description": "Fecha y hora de cuando el paciente confirmó su turno, en formato YYYY-MM-DD HH:mm:ss", "nullable": true, "format": "date-time" }, "checked_in_at": { "type": "string", "description": "Fecha y hora de cuando el paciente se recepcionó, en formato YYYY-MM-DD HH:mm:ss", "nullable": true, "format": "date-time" }, "cancelled_at": { "type": "string", "description": "Fecha y hora de cuando el paciente canceló su turno, en formato YYYY-MM-DD HH:mm:ss", "nullable": true, "format": "date-time" }, "completed_at": { "type": "string", "description": "Fecha y hora de cuando el médico marcó como finalizado el turno, en formato YYYY-MM-DD HH:mm:ss", "nullable": true, "format": "date-time" }, "created_at": { "type": "string", "description": "Fecha y hora de cuando el paciente solicitó el turno, en formato YYYY-MM-DD HH:mm:ss" } }, "required": [ "id", "medic_id", "patient_id", "center_id", "speciality_id", "status", "starts_at", "ends_at", "confirmed_at", "checked_in_at", "cancelled_at", "completed_at", "created_at" ] }, "example": { "id": 89, "medic_id": 45, "patient_id": 123, "center_id": 1, "speciality_id": 43, "status": "CONFIRMED", "starts_at": "2025-01-18 09:00:00", "ends_at": "2025-01-18 11:00:00", "confirmed_at": "2025-01-10 14:30:00", "checked_in_at": null, "cancelled_at": null, "completed_at": null, "created_at": "2025-01-08 10:00:00" } } }, "headers": {} }, "400": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Tipo de error" }, "details": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string", "description": "Campo mal utilizado o faltante" }, "message": { "type": "string", "description": "Mensaje para guiar hacia la solución del error" } }, "required": [ "field", "message" ] }, "description": "Lista de objetos con los campos y sus errores asociados" } }, "required": [ "error", "details" ] }, "example": { "error": "Validation error", "details": [ { "field": "id", "message": "id must be a number" } ] } } }, "headers": {} }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Tipo de error" }, "message": { "type": "string", "description": "Mensaje asociado al error, asignado por el desarrollador" }, "timestamp": { "type": "string", "description": "Fecha y hora de la petición, con estructura de ISO 8601" } }, "required": [ "error", "message", "timestamp" ] }, "examples": { "Validacion: el ID de turno NO existe": { "summary": "Validacion: el ID de turno NO existe", "value": { "error": "NotFoundError", "message": "Appointment id 89 not found", "timestamp": "2026-04-10T03:04:19.021Z" } } } } }, "headers": {} }, "500": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Tipo de error" }, "message": { "type": "string", "description": "Mensaje asociado al error, asignado por el desarrollador" }, "timestamp": { "type": "string", "description": "Fecha y hora de la petición, con estructura de ISO 8601" } }, "required": [ "error", "message", "timestamp" ] }, "example": { "error": "InternalServerError", "message": "Failed to find appointment id", "timestamp": "2026-04-10T04:08:12.074Z" } } }, "headers": {} } }, "security": [] } }, "/api/v1/appointments/{appointmentId}/cancel": { "post": { "summary": "/appointments/<id>/cancel", "deprecated": false, "description": "Permite cancelar un turno en M2 según su ID.\n\nM6 invoca este endpoint **únicamente cuando una cirugía urgente desplazó automáticamente una reserva de quirófano programada de menor prioridad** (flujo `POST /webhooks/hce/cirugia-urgente`). M2 usa esta notificación para marcar el turno como `CANCELLED`, avisar al paciente y decidir si reprograma.\n\n> `turnoId` en el path corresponde al `appointment_id` (entero) del turno en M2, equivalente al campo `turno_id` almacenado en la reserva de M6.\n\n**Mock 2da entrega:** Endpoint local que responde HTTP 200.", "operationId": "ext_cancelarTurnoM2", "tags": [ "[EXT] Turnos - Módulo 2" ], "parameters": [ { "name": "appointmentId", "in": "path", "description": "ID del turno en M2 (appointment_id devuelto por `POST /api/v1/appointments`)", "required": true, "example": 89, "schema": { "type": "integer", "example": 89 } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": {} }, "example": { "id": 89, "medic_id": 45, "patient_id": 123, "center_id": 1, "speciality_id": 43, "status": "CANCELLED", "starts_at": "2025-01-18 09:00:00", "ends_at": "2025-01-18 11:00:00", "confirmed_at": "2025-01-10 14:30:00", "checked_in_at": null, "cancelled_at": "2025-01-18 13:46:00", "completed_at": null, "created_at": "2025-01-08 10:00:00" } } }, "headers": {} }, "400": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Tipo de error" }, "details": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string", "description": "Campo mal utilizado o faltante" }, "message": { "type": "string", "description": "Mensaje para guiar hacia la solución del error" } }, "required": [ "field", "message" ] }, "description": "Lista de objetos con los campos y sus errores asociados" } }, "required": [ "error", "details" ] }, "example": { "error": "Validation error", "details": [ { "field": "id", "message": "id must be a number" } ] } } }, "headers": {} }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Tipo de error" }, "message": { "type": "string", "description": "Mensaje asociado al error, asignado por el desarrollador" }, "timestamp": { "type": "string", "description": "Fecha y hora de la petición, con estructura de ISO 8601" } }, "required": [ "error", "message", "timestamp" ] }, "examples": { "Validacion: el ID de turno NO existe": { "summary": "Validacion: el ID de turno NO existe", "value": { "error": "NotFoundError", "message": "Appointment id 89 not found", "timestamp": "2026-04-10T03:04:19.021Z" } } } } }, "headers": {} }, "500": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Tipo de error" }, "message": { "type": "string", "description": "Mensaje asociado al error, asignado por el desarrollador" }, "timestamp": { "type": "string", "description": "Fecha y hora de la petición, con estructura de ISO 8601" } }, "required": [ "error", "message", "timestamp" ] }, "examples": { "Error interno del servidor": { "summary": "Error interno del servidor", "value": { "error": "InternalServerError", "message": "Failed to cancel appointment", "timestamp": "2026-04-10T04:08:12.074Z" } } } } }, "headers": {} } }, "security": [] } }, "/api/v1/appointments/{appointmentId}/reschedule": { "patch": { "summary": "/appointments/<id>/reschedule", "deprecated": false, "description": "Permite reprogramar un turno en M2 según su ID.\n\nM6 invoca este endpoint cuando una cirugía urgente desplaza una reserva programada de menor prioridad. Una vez que M6 cancela la reserva física del quirófano y crea la reserva urgente, llama a este endpoint para actualizar el horario del turno en M2, de modo que M2 pueda notificar al paciente y al médico del cambio.\n\nEl ID hardcodeado en el path (`216`) es representativo: en la integración real se reemplaza por el `turno_id` almacenado en la reserva desplazada.\n\n**Mock 2da entrega:** Endpoint local que responde HTTP 200.", "operationId": "ext_rescheduleAppointmentM2", "tags": [ "[EXT] Turnos - Módulo 2" ], "parameters": [ { "name": "appointmentId", "in": "path", "description": "ID del turno en M2 (appointment_id devuelto por `POST /api/v1/appointments`)", "required": true, "example": 89, "schema": { "type": "integer", "example": 89 } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "starts_at": { "type": "string", "description": "Fecha y hora del inicio del turno, en formato YYYY-MM-DD HH:mm:ss" }, "ends_at": { "type": "string", "description": "Fecha y hora estipulada de fin del turno, en formato YYYY-MM-DD HH:mm:ss" } }, "required": [ "starts_at", "ends_at" ] }, "example": { "starts_at": "2026-05-28 16:00:30", "ends_at": "2026-05-28 16:30:30" } } }, "required": true }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ] }, "example": { "message": "The appointment was rescheduled successfully" } } }, "headers": {} }, "400": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Tipo de error" }, "details": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string", "description": "Campo mal utilizado o faltante" }, "message": { "type": "string", "description": "Mensaje para guiar hacia la solución del error" } }, "required": [ "field", "message" ] }, "description": "Lista de objetos con los campos y sus errores asociados" } }, "required": [ "error", "details" ] }, "example": { "error": "Validation error", "details": [ { "field": "id", "message": "id must be a number" } ] } } }, "headers": {} }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Tipo de error" }, "message": { "type": "string", "description": "Mensaje asociado al error, asignado por el desarrollador" }, "timestamp": { "type": "string", "description": "Fecha y hora de la petición, con estructura de ISO 8601" } }, "required": [ "error", "message", "timestamp" ] }, "example": { "error": "NotFoundError", "message": "Appointment id 12 not found", "timestamp": "2026-04-10T03:04:19.021Z" } } }, "headers": {} }, "500": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Tipo de error" }, "message": { "type": "string", "description": "Mensaje asociado al error, asignado por el desarrollador" }, "timestamp": { "type": "string", "description": "Fecha y hora de la petición, con estructura de ISO 8601" } }, "required": [ "error", "message", "timestamp" ] }, "example": { "error": "InternalServerError", "message": "Failed to find appointment", "timestamp": "2026-04-10T04:08:12.074Z" } } }, "headers": {} } }, "security": [] } }, "/auth/sso-exchange": { "post": { "summary": "Canjear un ticket SSO del Core por una sesión de M6", "deprecated": false, "description": "Canjea, servidor-a-servidor, un ticket SSO de un solo uso emitido por el Core (M10) contra `POST /auth/sso-exchange` del Core, y devuelve una sesión propia de M6: un JWT HS256 con el rol ya resuelto a partir de `user.roles[]` de la respuesta del Core — no el JWT del Core.\n\nEl rol se traduce con la tabla `CORE_ROLE_TO_INTERNAL` (`admin_internacion`→`ADMINISTRATIVO`, `Medico`→`MEDICO`, `limpieza`→`LIMPIEZA`, `admin`→`ADMINISTRATIVO`). Si ninguno de los roles del usuario mapea, devuelve `403` — el canje no otorga acceso a un usuario sin rol habilitado en M6.\n\nDeshabilitado (`404`) si `SSO_ENABLED=false`.\n\n> El callback del navegador (`/auth/sso?ticket=…&redirect=…`) y la validación anti-open-redirect del `redirect` son responsabilidad del frontend, no de este endpoint.", "operationId": "ssoExchange", "tags": [ "Auth" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SSOExchangeRequest" }, "example": { "ticket": "9f2c1b7a3e045e6f7a8b9c0d1e2f3a4b" } } }, "required": true }, "responses": { "200": { "description": "Ticket canjeado; sesión de M6 emitida", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SSOExchangeResponse" }, "example": { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "user": { "id": 42, "first_name": "Ana", "last_name": "Pérez", "email": "ana@example.com" }, "rol": "ADMINISTRATIVO" } } } }, "401": { "description": "Ticket inválido, ya usado o expirado", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "codigo": "NO_AUTENTICADO", "mensaje": "Ticket inválido, ya usado o expirado" } } } }, "403": { "description": "Los roles del usuario en el Core no mapean a ningún rol de M6", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "codigo": "NO_AUTORIZADO", "mensaje": "El usuario no tiene un rol habilitado en M6" } } } }, "404": { "description": "SSO deshabilitado (SSO_ENABLED=false)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "codigo": "RECURSO_NO_ENCONTRADO", "mensaje": "Not Found" } } } }, "502": { "description": "El Core no respondió al canje", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "codigo": "SERVICIO_EXTERNO_NO_DISPONIBLE", "mensaje": "No se pudo canjear el ticket contra el Core (M10)" } } } } }, "security": [] } }, "/auth/sso-ticket": { "post": { "summary": "Pedir un ticket SSO del Core para navegar hacia otro módulo", "deprecated": false, "description": "Lado saliente del SSO (inverso de `/auth/sso-exchange`): usa el `core_token` embebido en la sesión de M6 (guardado al canjear, ver `SSOExchangeResponse`) para pedirle al Core un ticket SSO en nombre del usuario logueado, y así poder navegar hacia otro módulo sin loguearse de nuevo.\n\nRequiere sesión de M6 vigente (`Authorization: Bearer <JWT de M6>`). Sesiones sin `core_token` embebido (p.ej. las del endpoint de desarrollo `GET /auth/token`, que no pasaron por un SSO real) no pueden usar este endpoint.\n\nDeshabilitado (`404`) si `SSO_ENABLED=false`.", "operationId": "ssoTicket", "tags": [ "Auth" ], "responses": { "200": { "description": "Ticket saliente emitido por el Core", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SSOTicketResponse" }, "example": { "ticket": "9f2c1b7a3e045e6f7a8b9c0d1e2f3a4b", "expires_in": 60 } } } }, "401": { "description": "Sesión sin core_token embebido, o el Core rechazó el core_token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "sin_sesion_core": { "summary": "Sesión sin core_token", "value": { "codigo": "SIN_SESION_CORE", "mensaje": "Esta sesión no se originó en un SSO real contra el Core — no se puede pedir un ticket saliente" } }, "core_token_invalido": { "summary": "core_token vencido o rechazado", "value": { "codigo": "NO_AUTENTICADO", "mensaje": "El token del Core asociado a esta sesión venció o fue rechazado — reiniciar el SSO" } } } } } }, "404": { "description": "SSO deshabilitado (SSO_ENABLED=false)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "codigo": "RECURSO_NO_ENCONTRADO", "mensaje": "Not Found" } } } }, "502": { "description": "El Core no respondió al pedido de ticket", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "codigo": "SERVICIO_EXTERNO_NO_DISPONIBLE", "mensaje": "No se pudo canjear el ticket contra el Core (M10)" } } } } }, "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", "description": "Prioridad clínica de una solicitud de internación o traslado. Ordenada de menor a mayor importancia.\n\n| Nivel | Uso típico |\n|-------|----------|\n| `MUY_BAJA` | Internación diferible sin urgencia clínica |\n| `BAJA` | Internación programada, paciente estable |\n| `MEDIA` | Internación programada estándar |\n| `ALTA` | Requiere cama dentro de las próximas horas |\n| `MUY_ALTA` | No puede postergarse más de 1 hora |\n| `URGENTE` | Emergencia vital, debe asignarse de inmediato |\n", "enum": [ "MUY_BAJA", "BAJA", "MEDIA", "ALTA", "MUY_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" }, "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 la solicitud. `null` si 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", "enum": [ "INGRESO", "TRASLADO" ], "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`.\n", "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.\n", "properties": { "evento": { "type": "string", "enum": [ "CAMA_LISTA" ], "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.\n", "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.\n", "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 }, "resultado": { "type": "string", "enum": [ "APROBADA", "RECHAZADA" ], "description": "Para tipo_movimiento=RESOLUCION_SOLICITUD: resultado de la resolución.", "nullable": true }, "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" }, "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.\n`CIRUGIA` solo aplica a camas con sector=QUIROFANO (mesas quirúrgicas).\n" }, "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" } } }, "ReservaQuirofanoCreateRequest": { "type": "object", "required": [ "paciente_id", "medico_cirujano_id", "fecha_hora_inicio", "fecha_hora_fin_estimada", "prioridad" ], "properties": { "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.\n" }, "observaciones": { "type": "string", "nullable": true, "example": "Colecistectomía laparoscópica programada" } }, "description": "Payload que M1 (HCE) envía para crear una reserva de quirófano programada. No incluye `turno_id`: M6 crea el turno en M2 (`POST /api/v1/appointments`) después de guardar la reserva, y almacena el `appointment_id` resultante." }, "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.\n", "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.\n\n| Nivel | Uso típico |\n|-------|-----------|\n| `MUY_BAJA` | Procedimientos estéticos o diferibles sin impacto clínico |\n| `BAJA` | Cirugías programadas de baja complejidad, pacientes estables |\n| `MEDIA` | Cirugías programadas estándar |\n| `ALTA` | Cirugías programadas con riesgo clínico relevante si se posponen |\n| `MUY_ALTA` | Cirugías programadas que no pueden postergarse más de 24hs |\n| `URGENTE` | Cirugía de emergencia con riesgo vital |\n\n**Quién la asigna:**\n\n- M2 (Turnos) elige la prioridad al crear una reserva programada vía `POST /camas/{camaId}/reservas`. Puede usar cualquier valor **excepto `URGENTE`**.\n- `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.\n\n**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`.\n", "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. No se especifica cama destino: M6 decide qué quirófano utilizar. `fecha_hora_inicio` se interpreta como \"no antes de\" y `fecha_hora_fin_estimada - fecha_hora_inicio` como la duración de la cirugía (algoritmo ASAP): M6 calcula el inicio real más temprano posible y reprograma las reservas programadas que haga falta.\n", "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.\n", "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).\n", "example": 78 }, "fecha_hora_inicio": { "type": "string", "format": "date-time", "description": "Interpretado como \"no antes de\": M6 puede asignar un inicio posterior si no hay quirófano libre en ese momento.\n", "example": "2025-01-18T14:00:00Z" }, "fecha_hora_fin_estimada": { "type": "string", "format": "date-time", "description": "Junto con `fecha_hora_inicio` define la duración estimada de la cirugía (`fecha_hora_fin_estimada - fecha_hora_inicio`); el horario final que asigna M6 preserva esa duración pero puede empezar más tarde.\n", "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.\n", "nullable": true, "example": "HOSP-001" }, "specialty_id": { "type": "integer", "description": "Preferencia de especialidad del quirófano a asignar. No es obligatoria ni excluyente: si no viene, o no hay quirófano libre de esa especialidad a tiempo, M6 usa cualquier quirófano compatible del hospital antes que dejar la urgencia sin asignar.\n", "nullable": true, "example": 43 }, "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 la reserva urgente creada (o ya existente, si fue un reintento idempotente) y qué reservas programadas, si alguna, se tuvieron que reprogramar para ubicarla.\n", "required": [ "mensaje", "reserva", "reservas_desplazadas" ], "properties": { "mensaje": { "type": "string", "example": "Reserva urgente creada exitosamente" }, "reserva": { "$ref": "#/components/schemas/ReservaQuirofanoResponse" }, "reservas_desplazadas": { "type": "array", "description": "Reservas PROGRAMADA que se reprogramaron (nunca canceladas) para ubicar la cirugía urgente. Vacío si había quirófano libre en el horario pedido. Con el algoritmo ASAP puede haber más de un elemento si varias reservas caían dentro de la ventana finalmente elegida.\n", "items": { "type": "object", "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ó).\n", "example": true } } } } } }, "QuirofanoCreateRequest": { "type": "object", "description": "Payload para dar de alta un nuevo quirófano. `tipo` y `sector` son fijos (`CIRUGIA` / `QUIROFANO`): M6 los setea internamente.", "required": [ "numero", "piso", "specialty_id", "hospital_id" ], "properties": { "numero": { "type": "integer", "example": 501 }, "piso": { "type": "integer", "example": 5 }, "specialty_id": { "type": "integer", "description": "ID de la especialidad quirúrgica (de M2, `GET /specialties?is_high_complexity=1`). Obligatorio para todos los quirófanos.", "example": 43 }, "hospital_id": { "type": "string", "example": "HOSP-001" }, "contraindicaciones_incompatibles": { "type": "array", "items": { "type": "string" }, "default": [] } } }, "QuirofanoResponse": { "type": "object", "properties": { "id": { "type": "integer", "example": 501 }, "numero": { "type": "integer", "example": 501 }, "piso": { "type": "integer", "example": 5 }, "specialty_id": { "type": "integer", "nullable": true, "example": 43 }, "estado": { "$ref": "#/components/schemas/EstadoCamaEnum" }, "hospital_id": { "type": "string", "example": "HOSP-001" }, "contraindicaciones_incompatibles": { "type": "array", "items": { "type": "string" } }, "ultima_actualizacion": { "type": "string", "format": "date-time" } } }, "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" } } } } } }, "SSOExchangeRequest": { "type": "object", "required": [ "ticket" ], "properties": { "ticket": { "type": "string", "description": "Ticket SSO de un solo uso emitido por el Core (POST /auth/sso-ticket).", "example": "9f2c1b7a3e045e6f7a8b9c0d1e2f3a4b" } } }, "SSOUser": { "type": "object", "required": [ "id", "first_name", "last_name", "email" ], "properties": { "id": { "type": "integer", "example": 42 }, "first_name": { "type": "string", "example": "Ana" }, "last_name": { "type": "string", "example": "Pérez" }, "email": { "type": "string", "example": "ana@example.com" } } }, "SSOExchangeResponse": { "type": "object", "required": [ "token", "user", "rol" ], "properties": { "token": { "type": "string", "description": "JWT HS256 propio de M6 (no el JWT del Core). Usar en Authorization: Bearer.", "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, "user": { "$ref": "#/components/schemas/SSOUser" }, "rol": { "type": "string", "enum": [ "ADMINISTRATIVO", "MEDICO", "LIMPIEZA" ], "description": "Rol interno de M6, resuelto a partir de los roles del usuario en el Core.", "example": "ADMINISTRATIVO" } } }, "SSOTicketResponse": { "type": "object", "required": [ "ticket", "expires_in" ], "properties": { "ticket": { "type": "string", "description": "Ticket SSO de un solo uso emitido por el Core, para navegar hacia otro módulo.", "example": "9f2c1b7a3e045e6f7a8b9c0d1e2f3a4b" }, "expires_in": { "type": "integer", "description": "Segundos de validez del ticket (~60s).", "example": 60 } } } }, "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 predeterminado",
"description": "API REST del módulo de Internación y Gestión de Camas para la red hospitalaria Health Grid.\n\n## Modelo de Dominio\n\nUn **EPISODIO DE INTERNACIÓN** comienza cuando se aprueba una solicitud de cama y termina\ncuando el Módulo 1 (HCE) notifica el alta médica.\n\nEl flujo principal es:\n\n1. Un médico solicita una cama desde HCE (M1)\n2. La solicitud llega a este módulo como webhook entrante\n3. Un administrativo la aprueba (con la cama pedida u otra), o la rechaza\n4. Al aprobar → se asigna la cama al paciente (estado `OCUPADA`)\n5. Los traslados también llegan como solicitudes desde HCE (M1) o se realizan directamente\n6. El alta médica llega como webhook desde HCE (M1)\n\n### Solicitudes\n\nLas solicitudes de internación y traslado llegan desde HCE (M1) y quedan en estado\n`PENDIENTE` hasta que un administrativo las resuelve.\n\n| Resolución | Efecto |\n|------------|--------|\n| `APROBAR` | Se ejecuta la acción (ingreso o traslado) con la cama solicitada |\n| `APROBAR_CON_CAMBIO` | Se ejecuta la acción con una cama distinta a la solicitada |\n| `RECHAZAR` | No se ejecuta ninguna acción. Se notifica a HCE |\n\n## Leyenda de Endpoints\n\n- **Sin prefijo:** Endpoints PROPIOS de este módulo (implementados por nosotros)\n- **Tag [EXT]:** Endpoints de otros módulos, documentados como referencia. Mockeados localmente en la 2da entrega\n\n## Webhooks Salientes (HTTP POST que este módulo dispara)\n\n| Evento | Receptor | Cuándo |\n|--------|----------|--------|\n| `SOLICITUD_RESUELTA` | Módulo 1 - HCE | Al aprobar o rechazar una solicitud |\n| `ALTA_MONITOREO` | Módulo 9 - Monitoreo | Al asignar una cama a un paciente (ingreso o traslado destino) |\n| `BAJA_MONITOREO` | Módulo 9 - Monitoreo | Al dar el alta médica o al trasladar un paciente (cama origen) |\n| `CAMA_LISTA` | Módulo 7 - Facturación | Al completar limpieza post-alta (cama pasa de EN_LIMPIEZA a DISPONIBLE) |\n\n## Webhooks Entrantes (HTTP POST que recibimos de otros módulos)\n\n| Evento | Emisor | Cuándo |\n|--------|--------|--------|\n| Solicitud de internación | Módulo 1 - HCE | Un médico solicita cama para internar un paciente |\n| Solicitud de traslado | Módulo 1 - HCE | Un médico solicita trasladar un paciente internado |\n| Alta médica | Módulo 1 - HCE | Un médico da el alta al paciente |\n| Alerta de emergencia | Módulo 9 - Monitoreo | Se detecta un código rojo en un paciente |\n\n## APIs Externas Consumidas\n\n| Módulo | Endpoint | Cuándo se usa |\n|--------|----------|---------------|\n| Core (M10) | `GET /usuarios/{pacienteId}` | Al aprobar una solicitud de internación |\n| Core (M10) | `POST /auth/validate-token` | En cada request (middleware JWT) |\n| HCE (M1) | `GET /pacientes/{pacienteId}/contraindicaciones` | Al aprobar una solicitud de internación |\n| HCE (M1) | `POST /hce/solicitudes/{solicitudHceId}/resultado` | Al resolver una solicitud |\n| HCE (M1) | `GET /hce/pacientes/{pacienteId}` | Al mostrar el detalle del paciente internado en una cama |\n| HCE (M1) | `POST /hce/movimientos` | Al asignar una cama o trasladar un paciente |\n| Turnos (M2) | `GET /turnos/{turnoId}` | Al aprobar solicitud con origen=CIRUGIA_PROGRAMADA |\n| Facturación (M7) | `POST /webhooks/internacion/cama-lista` | Al completar limpieza post-alta |\n| Monitoreo (M9) | `POST /webhooks/internacion/baja-monitoreo` | Al dar alta médica o trasladar (cama origen) |\n| Monitoreo (M9) | `POST /webhooks/internacion/alta-monitoreo` | Al asignar cama a un paciente (ingreso o traslado destino) |\n| HCE (M1) | `POST /hce/episodios/{episodioId}/eventos` | Al recibir alerta de emergencia de M9 |\n",
"version": "4.0.0",
"contact": {
"name": "Grupo Módulo 6 - UADE"
},
"license": {
"name": "Uso académico"
}
},
"tags": [
{
"name": "Auth"
},
{
"name": "Camas"
},
{
"name": "Quirófanos"
},
{
"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.\nPermite filtrar por piso, sector, estado y hospital.\n\n> **Nota:** Las camas con estado `BAJA_PERMANENTE` **no** se incluyen por defecto.\n\n> **Nota:** Los quirófanos (`tipo=CIRUGIA`) **no** se incluyen en este listado. Para gestionar quirófanos, usar `GET /quirofanos`.\n\n## Comportamiento por rol\n\n| Rol | Comportamiento |\n|-----|----------------|\n| `ADMINISTRATIVO`, `MEDICO` | Ve todas las camas con todos los filtros |\n| `LIMPIEZA` | Solo ve camas con estado `EN_LIMPIEZA`. Los demás filtros de estado se ignoran. |\n\n## Roles permitidos\n\n`MEDICO`, `ADMINISTRATIVO` y `LIMPIEZA`.\n",
"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",
"headers": {}
},
"401": {
"description": "Token JWT ausente, expirado o malformado",