Buenas, les dejamos la referencia de M6 (Internación y Gestión de Camas) que necesitan para: 1. Usar el vocabulario correcto de sectores/tipos de cama al armar sus solicitudes de internación/traslado hacia M6. 2. Mandarnos cirugías urgentes por nuestro endpoint REST. --- ## 1. Enums de M6 para solicitudes de cama Cuando HCE crea una solicitud hacia M6 (evento `internacion.solicitud.creada`, `event_type_id=14`, o su equivalente REST `POST /webhooks/hce/solicitud`), los campos `cama_solicitada_id`/`cama_destino_solicitada_id` referencian una cama concreta del catálogo de M6. Ese catálogo describe cada cama con estos dos enums — les sirve para mostrar/filtrar el tipo correcto en su UI o para pedir el sector adecuado al crear la solicitud. ### 1.1 `SectorEnum` — sector del hospital | valor | significado | |---|---| | `UTI` | Unidad de Terapia Intensiva | | `SALA_COMUN` | Internación general | | `QUIROFANO` | Quirófano (cirugía) | | `GUARDIA` | Guardia/emergencias | | `NEONATOLOGIA` | Neonatología | ### 1.2 `TipoCamaEnum` — tipo de cama dentro del sector | valor | significado | |---|---| | `ESTANDAR` | Cama estándar de internación | | `PEDIATRICA` | Cama pediátrica | | `AISLAMIENTO` | Cama de aislamiento (infeccioso/inmunodeprimido) | | `CRITICA` | Cama crítica (UTI/alta complejidad) | | `CIRUGIA` | Cama/box de quirófano | > ⚠️ **Ojo con el vocabulario**: esto es el catálogo interno de M6, distinto del que usa el > propio schema de solicitudes de HCE (`SolicitudCamaCreate`), que hoy usa strings libres > como `"UTI — Unidad de Terapia Intensiva"` para `sector` y `Baja/Media/Alta` para > `prioridad`. Los valores de esta tabla son los que **M6 espera recibir** en > `cama_solicitada_id` (referencia a una cama concreta, no al sector como string) — > `SectorEnum`/`TipoCamaEnum` son metadata de esa cama, no campos que HCE tenga que mandar > directamente en la solicitud. ### 1.3 Otros enums que sí viajan directamente en la solicitud Estos sí forman parte del payload que HCE manda a M6 (`SolicitudHceWebhook`): | enum | valores | campo | |---|---|---| | `TipoSolicitudEnum` | `INTERNACION`, `TRASLADO` | `tipo` | | `PrioridadSolicitudEnum` | `MUY_BAJA`, `BAJA`, `MEDIA`, `ALTA`, `MUY_ALTA`, `URGENTE` | `prioridad` | | `OrigenIngresoEnum` | `GUARDIA`, `CIRUGIA_PROGRAMADA` | `origen` | | `TipoAltaEnum` | `ALTA_MEDICA`, `ALTA_VOLUNTARIA`, `TRASLADO_EXTERNO`, `DEFUNCION` | `tipo_alta` (en el alta médica) | Todos en mayúsculas y con guion bajo (snake case en mayúsculas), sin acentos. --- ## 2. Cómo mandarnos una cirugía urgente **Endpoint:** `POST /api/v1/webhooks/hce/cirugia-urgente` Es un **webhook REST síncrono** — no va por el bus de eventos del Core (a diferencia de las solicitudes de internación/traslado). La respuesta llega en el mismo request, con el quirófano ya asignado (o el motivo de por qué no se pudo). **Autenticación:** `Authorization: Bearer ` — mismo mecanismo que el resto de webhooks de M6 (token de la cuenta de servicio, vía Core/SSO). ### 2.1 Body del request ```json { "solicitud_urgencia_hce_id": "URG-000123", "paciente_id": 10500, "medico_cirujano_id": 45, "medico_solicitante_id": 20, "fecha_hora_inicio": "2026-07-17T18:00:00Z", "fecha_hora_fin_estimada": "2026-07-17T20:00:00Z", "diagnostico": "Apendicitis aguda", "hospital_id": "1", "specialty_id": 3, "timestamp": "2026-07-17T17:45:00Z" } ``` | campo | tipo | obligatorio | notas | |---|---|---|---| | `solicitud_urgencia_hce_id` | string | sí | id de HCE — clave de idempotencia: reenviar el mismo id no crea una reserva duplicada, devuelve la existente con `200` | | `paciente_id` | int | sí | | | `medico_cirujano_id` | int | sí | | | `medico_solicitante_id` | int | sí | | | `fecha_hora_inicio` | datetime | sí | ver algoritmo ASAP abajo — **no** es necesariamente el horario real asignado | | `fecha_hora_fin_estimada` | datetime | sí | debe ser posterior a `fecha_hora_inicio` (si no, `422`) | | `diagnostico` | string | no | | | `hospital_id` | string | no | | | `specialty_id` | int | no | preferencia de especialidad del quirófano — ver abajo | | `timestamp` | datetime | sí | | ### 2.2 Algoritmo ASAP (as soon as possible) M6 **no reserva necesariamente la ventana tal cual la mandan**: - `fecha_hora_inicio` se interpreta como **"no antes de"**. - La duración de la cirugía = `fecha_hora_fin_estimada - fecha_hora_inicio`. - M6 calcula el **inicio real más temprano posible** entre los quirófanos compatibles del hospital, que puede ser posterior al `fecha_hora_inicio` pedido (si todos están ocupados en ese horario). - `specialty_id` es una **preferencia, no un filtro obligatorio**: si no viene, o no hay ningún quirófano libre de esa especialidad, M6 usa cualquier quirófano compatible del hospital antes que dejar al paciente sin asignar. - Si hace falta, M6 puede **reprogramar** reservas programadas (no urgentes) que estén en el medio del hueco elegido — esas reservas desplazadas vienen listadas en la respuesta (ver abajo) y M6 les avisa a M2 (Turnos) por su cuenta. ### 2.3 Respuestas | status | cuándo | |---|---| | `201` | Reserva urgente creada | | `200` | Ya existía una reserva para ese `solicitud_urgencia_hce_id` (idempotencia — no se crea de nuevo) | | `409` | No hay ningún quirófano compatible/operable disponible | | `401` | Token inválido/ausente | | `422` | Payload inválido (ej. `fecha_hora_inicio >= fecha_hora_fin_estimada`) | Body de la respuesta (`201`/`200`): ```json { "mensaje": "Reserva urgente creada. Se reprogramaron las reservas 45", "reserva": { "id": 88, "cama_id": 12, "paciente_id": 10500, "prioridad": "URGENTE", "origen": "EMERGENCIA", "estado": "RESERVADA", "fecha_hora_inicio": "2026-07-17T18:30:00Z", "fecha_hora_fin_estimada": "2026-07-17T20:30:00Z", "observaciones": "Apendicitis aguda", "desplazada_por_reserva_id": null, "created_at": "2026-07-17T17:45:03Z" }, "reservas_desplazadas": [ { "reserva_id": 45, "cama_id": 12, "turno_id": 900, "prioridad_original": "MEDIA", "notificado_a_m2": true } ] } ``` - `reserva.fecha_hora_inicio` es el horario **real** asignado — puede diferir del que pidieron (ver ASAP arriba). - `reservas_desplazadas` puede venir vacío. Cuando trae elementos, son reservas programadas que se reprogramaron para hacerle lugar a la urgente; `notificado_a_m2: true` indica que esa reserva tenía un `turno_id` de M2 y ya se le avisó. ### 2.4 Ejemplo `curl` ```bash curl -X POST https:///api/v1/webhooks/hce/cirugia-urgente \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "solicitud_urgencia_hce_id": "URG-000123", "paciente_id": 10500, "medico_cirujano_id": 45, "medico_solicitante_id": 20, "fecha_hora_inicio": "2026-07-17T18:00:00Z", "fecha_hora_fin_estimada": "2026-07-17T20:00:00Z", "diagnostico": "Apendicitis aguda", "hospital_id": "1", "specialty_id": 3, "timestamp": "2026-07-17T17:45:00Z" }' ``` --- ## 3. Movimientos de cama (ingreso y traslado) — ya activo del lado de M6 Desde 2026-07, M6 llama a `POST /api/v1/internacion/ingreso` (`IngresoInternacionRequest`) no solo en el ingreso inicial, sino también **en cada traslado**, reenviando el mismo `id_episodio` que ya tenía asignado (el que ustedes crearon al crear la solicitud). Según su propio contrato, eso no crea un episodio nuevo — agrega un movimiento más al mismo episodio (`id_movimiento` en la respuesta). Si esta interpretación no es la que esperan del lado de M1, o el reuso repetido del mismo `id_episodio` genera algún problema en su lado, avisennos para ajustar. --- Cualquier duda sobre estos contratos, las fuentes exactas en el repo de M6 son `app/schemas/enums.py` (enums), `app/schemas/reserva.py` + `app/routers/webhooks.py::recibir_cirugia_urgente` (cirugía urgente), y `app/integrations/hce.py::notify_movimiento` (movimientos de cama).