api / documentation /integrations /M1_integration_camas_quirofanos.md
juampisor's picture
Arreglo
ea9df53
|
Raw History Blame Contribute Delete
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).