|
Download documentation/integrations/M1_integration_camas_quirofanos.md from Modulo-6/api: direct link, hf CLI and curl.
- Browser
- Download file 8.08 kB
-
https://huggingface.co/spaces/Modulo-6/api/resolve/main/documentation/integrations/M1_integration_camas_quirofanos.md
- Command line
-
hf download hf://spaces/Modulo-6/api/documentation/integrations/M1_integration_camas_quirofanos.md
-
curl -L -o M1_integration_camas_quirofanos.md https://huggingface.co/spaces/Modulo-6/api/resolve/main/documentation/integrations/M1_integration_camas_quirofanos.md
8.08 kB
| 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 <JWT>` — 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://<host-m6>/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). | |