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

{
  "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):

{
  "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

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).