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
Buenas, les dejamos la referencia de M6 (Internación y Gestión de Camas) que necesitan para:
- Usar el vocabulario correcto de sectores/tipos de cama al armar sus solicitudes de internación/traslado hacia M6.
- 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"parasectoryBaja/Media/Altaparaprioridad. Los valores de esta tabla son los que M6 espera recibir encama_solicitada_id(referencia a una cama concreta, no al sector como string) —SectorEnum/TipoCamaEnumson 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
{
"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_iniciose 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_iniciopedido (si todos están ocupados en ese horario). specialty_ides 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):
{
"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_inicioes el horario real asignado — puede diferir del que pidieron (ver ASAP arriba).reservas_desplazadaspuede venir vacío. Cuando trae elementos, son reservas programadas que se reprogramaron para hacerle lugar a la urgente;notificado_a_m2: trueindica que esa reserva tenía unturno_idde M2 y ya se le avisó.
2.4 Ejemplo curl
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).