juampisor commited on
Commit
a440d33
·
1 Parent(s): efe5cdf

Inhabilitacion M7 + docu

Browse files
app/config.py CHANGED
@@ -107,6 +107,11 @@ class Settings(BaseSettings):
107
  monitoreo_baja_event_type_id: int | None = None
108
  facturacion_cama_lista_event_type_id: int | None = None
109
 
 
 
 
 
 
110
  # ─── Endpoints internos (sistema, no usuario) ──────────────────────────
111
  # POST /api/v1/internal/reservas/tick (app/routers/internal.py) avanza
112
  # automáticamente RESERVADA→EN_CURSO→COMPLETADA según el horario de cada
 
107
  monitoreo_baja_event_type_id: int | None = None
108
  facturacion_cama_lista_event_type_id: int | None = None
109
 
110
+ # Pausa manual (2026-07) del cierre de facturación hacia M7: mientras esté en False,
111
+ # `facturacion.notify_cama_lista` no manda nada (ni evento ni REST), independientemente
112
+ # de `facturacion_cama_lista_event_type_id`. Reactivar poniendo esta variable en True.
113
+ facturacion_cierre_habilitado: bool = False
114
+
115
  # ─── Endpoints internos (sistema, no usuario) ──────────────────────────
116
  # POST /api/v1/internal/reservas/tick (app/routers/internal.py) avanza
117
  # automáticamente RESERVADA→EN_CURSO→COMPLETADA según el horario de cada
app/integrations/facturacion.py CHANGED
@@ -9,6 +9,7 @@ Dos canales, con payloads DISTINTOS (ver `notify_cama_lista`):
9
  del episodio que M6 empezó a persistir en la propia fila de `Cama` (ver
10
  `app/models/cama.py`) precisamente para poder armar este evento.
11
  """
 
12
  from datetime import date, datetime, timezone
13
 
14
  from supabase import Client
@@ -18,6 +19,8 @@ from app.integrations import core_events
18
  from app.integrations._base import _post
19
  from app.models.cama import Cama
20
 
 
 
21
 
22
  def _iso_z(dt: datetime | None) -> str | None:
23
  """
@@ -52,6 +55,15 @@ def notify_cama_lista(cama: Cama, db: Client) -> bool:
52
  if settings.mock_external_services:
53
  return True
54
 
 
 
 
 
 
 
 
 
 
55
  paciente_id = cama.paciente_id or 0
56
  id_evento_externo = f"M6-CIERRE-INT-{cama.id}-{paciente_id}-{date.today().isoformat()}"
57
 
 
9
  del episodio que M6 empezó a persistir en la propia fila de `Cama` (ver
10
  `app/models/cama.py`) precisamente para poder armar este evento.
11
  """
12
+ import logging
13
  from datetime import date, datetime, timezone
14
 
15
  from supabase import Client
 
19
  from app.integrations._base import _post
20
  from app.models.cama import Cama
21
 
22
+ logger = logging.getLogger(__name__)
23
+
24
 
25
  def _iso_z(dt: datetime | None) -> str | None:
26
  """
 
55
  if settings.mock_external_services:
56
  return True
57
 
58
+ if not settings.facturacion_cierre_habilitado:
59
+ # Pausa manual (2026-07): por ahora no se le manda a M7 el cierre de internación,
60
+ # ni por evento ni por REST — fire-and-forget, no frena el alta.
61
+ logger.info(
62
+ "Cierre de facturación (M7) desactivado — no se envía CIERRE_INTERNACION (cama=%s)",
63
+ cama.id,
64
+ )
65
+ return True
66
+
67
  paciente_id = cama.paciente_id or 0
68
  id_evento_externo = f"M6-CIERRE-INT-{cama.id}-{paciente_id}-{date.today().isoformat()}"
69
 
app/integrations/hce.py CHANGED
@@ -111,30 +111,22 @@ def notify_resultado_solicitud(
111
  motivo: str | None = None,
112
  ) -> bool:
113
  """
114
- Notifica a M1 el resultado (APROBADA / RECHAZADA) de una solicitud. Retorna True si OK.
 
115
 
116
- Además del webhook REST directo (sin cambios), publica el mismo evento al bus del Core
117
- (SOLICITUD_RESUELTA) vía `core_events.publish_event`. Es un no-op mientras
118
- `hce_solicitud_resuelta_event_type_id` no esté configurado — M1 todavía no compartió
119
- su `event_type_id` real (ver `M6_DISEÑO.md` §7).
120
  """
121
  if settings.mock_external_services:
122
  return True
123
  payload = {
 
124
  "resultado": resultado,
125
  "motivo": motivo,
126
  "timestamp": datetime.now(timezone.utc).isoformat(),
127
  }
128
- ok_rest = _post(
129
- f"{settings.m1_hce_url}/api/v1/hce/solicitudes/{solicitud_hce_id}/resultado", payload
130
- ) is not None
131
- # El body REST no lleva solicitud_hce_id (va en el path); el evento del bus sí lo
132
- # necesita, porque no hay URL que lo transporte implícitamente.
133
- core_events.publish_event(
134
- settings.hce_solicitud_resuelta_event_type_id,
135
- {**payload, "solicitud_hce_id": solicitud_hce_id},
136
- )
137
- return ok_rest
138
 
139
 
140
  def notify_movimiento(
 
111
  motivo: str | None = None,
112
  ) -> bool:
113
  """
114
+ Notifica a M1 el resultado (APROBADA / RECHAZADA) de una solicitud, publicando el evento
115
+ SOLICITUD_RESUELTA (`event_type_id=25`) al bus del Core. Retorna True si OK.
116
 
117
+ Corrección 2026-07: el REST directo (`POST /hce/solicitudes/{id}/resultado`) se deprecó
118
+ — ese path no existe en el contrato real de M1 (ver su OpenAPI), y era la causa de que
119
+ M1 nunca viera el resultado real de la solicitud. Canal único: el evento del bus.
 
120
  """
121
  if settings.mock_external_services:
122
  return True
123
  payload = {
124
+ "solicitud_hce_id": solicitud_hce_id,
125
  "resultado": resultado,
126
  "motivo": motivo,
127
  "timestamp": datetime.now(timezone.utc).isoformat(),
128
  }
129
+ return core_events.publish_event(settings.hce_solicitud_resuelta_event_type_id, payload)
 
 
 
 
 
 
 
 
 
130
 
131
 
132
  def notify_movimiento(
documentation/M6_DISEÑO.md CHANGED
@@ -245,10 +245,10 @@ Margen de precisión aceptable: con un cron cada 1–5 minutos, una cirugía pue
245
 
246
  | Evento | Receptor | Endpoint receptor / evento del bus | Cuándo |
247
  |--------|----------|-------------------|--------|
248
- | `SOLICITUD_RESUELTA` | M1 HCE | `POST /hce/solicitudes/{solicitudHceId}/resultado` (REST); evento `event_type_id=25`, activo — confirmado por M1 | Al aprobar o rechazar una solicitud |
249
  | `ALTA_MONITOREO` | M9 Monitoreo | `POST /webhooks/internacion/alta-monitoreo` (REST); evento `event_type_id=26`, activo — confirmado por M9. Payload incluye `cama_id` (destino) | Al asignar cama (ingreso o destino de traslado) |
250
  | `BAJA_MONITOREO` | M9 Monitoreo | `POST /webhooks/internacion/baja-monitoreo` (REST); evento `event_type_id=27`, activo — confirmado por M9. Payload incluye `cama_id` (origen) | Al dar el alta o al trasladar (cama origen) |
251
- | `CAMA_LISTA` / `CIERRE_INTERNACION` | M7 Facturación | `POST /webhooks/internacion/cama-lista` (REST, fallback/testing); evento `facturacion.internacion.cama-lista.requested` (`event_type_id=19`, activo) | Al completar limpieza post-alta (`EN_LIMPIEZA → DISPONIBLE`) |
252
 
253
  **M7 confirmó su integración por escrito** (`documentation/integrations/M7_integration.md`):
254
  cola `facturacion.requests`, `event_type_id: 19`, `publisher_module: "modulo_6"`. El
@@ -348,22 +348,20 @@ devuelve sincrónicamente qué quirófano/reserva se asignó y qué reservas se
348
  no hay hoy un canal async equivalente. Migrarla requiere antes acordar con M1 un evento de
349
  respuesta (`correlation_id` + `response_event_id`). Sigue siendo solo REST.
350
 
351
- **Lado saliente — los 4 `event_type_id` reales ya están activos.** Las 4 notificaciones de
352
- §7.2 (`SOLICITUD_RESUELTA=25`, `ALTA_MONITOREO=26`, `BAJA_MONITOREO=27`, `CAMA_LISTA=19`)
353
- siguen el mismo bus; el evento y la cola los crea y posee **el receptor** (M1/M9/M7), no M6
354
- — por la misma regla del tutorial que aplica al revés en §7.1. Los 4 equipos ya
355
- compartieron su id.
356
-
 
 
 
 
 
 
357
  `app/integrations/core_events.py::publish_event(event_type_id, payload)` sigue siendo un
358
- no-op explícito si algún `event_type_id is None` (mismo mecanismo, por si algún deploy no
359
- tiene la variable cargada), pero en `.env` las 4 settings
360
- (`hce_solicitud_resuelta_event_type_id`, `monitoreo_alta_event_type_id`,
361
- `monitoreo_baja_event_type_id`, `facturacion_cama_lista_event_type_id`) ya tienen su valor
362
- real. Las 4 funciones `notify_*` (`hce.notify_resultado_solicitud`,
363
- `monitoreo.notify_alta`/`notify_baja`, `facturacion.notify_cama_lista`) hacen **dual-write**:
364
- siguen llamando al webhook REST directo y además llaman a `publish_event`, que ahora sí
365
- publica al bus real. `monitoreo.notify_alta`/`notify_baja` además llevan `cama_id` en el
366
- payload desde esta corrección (2026-07) — destino en el alta, origen en la baja.
367
 
368
  ---
369
 
 
245
 
246
  | Evento | Receptor | Endpoint receptor / evento del bus | Cuándo |
247
  |--------|----------|-------------------|--------|
248
+ | `SOLICITUD_RESUELTA` | M1 HCE | Solo evento (`event_type_id=25`) — el REST se deprecó 2026-07: `POST /hce/solicitudes/{id}/resultado` no existe en el contrato real de M1 | Al aprobar o rechazar una solicitud |
249
  | `ALTA_MONITOREO` | M9 Monitoreo | `POST /webhooks/internacion/alta-monitoreo` (REST); evento `event_type_id=26`, activo — confirmado por M9. Payload incluye `cama_id` (destino) | Al asignar cama (ingreso o destino de traslado) |
250
  | `BAJA_MONITOREO` | M9 Monitoreo | `POST /webhooks/internacion/baja-monitoreo` (REST); evento `event_type_id=27`, activo — confirmado por M9. Payload incluye `cama_id` (origen) | Al dar el alta o al trasladar (cama origen) |
251
+ | `CAMA_LISTA` / `CIERRE_INTERNACION` | M7 Facturación | **Pausado 2026-07** (`facturacion_cierre_habilitado=false`) — no se manda ni REST ni evento; código listo (`event_type_id=19`) para reactivar poniendo la variable en `true` | Al completar limpieza post-alta (`EN_LIMPIEZA → DISPONIBLE`) |
252
 
253
  **M7 confirmó su integración por escrito** (`documentation/integrations/M7_integration.md`):
254
  cola `facturacion.requests`, `event_type_id: 19`, `publisher_module: "modulo_6"`. El
 
348
  no hay hoy un canal async equivalente. Migrarla requiere antes acordar con M1 un evento de
349
  respuesta (`correlation_id` + `response_event_id`). Sigue siendo solo REST.
350
 
351
+ **Lado saliente — los 4 `event_type_id` reales ya se compartieron**, pero no las 4
352
+ notificaciones están dual-write ni activas hoy:
353
+ - `ALTA_MONITOREO=26`/`BAJA_MONITOREO=27` (M9): dual-write completo (REST + evento), activos.
354
+ `monitoreo.notify_alta`/`notify_baja` llevan además `cama_id` en el payload desde esta
355
+ corrección (2026-07) — destino en el alta, origen en la baja.
356
+ - `SOLICITUD_RESUELTA=25` (M1): **ya no es dual-write** — el REST se deprecó (2026-07, el path
357
+ no existe en el contrato real de M1); ahora es evento-only.
358
+ - `CAMA_LISTA/CIERRE_INTERNACION=19` (M7): **pausado** (2026-07,
359
+ `facturacion_cierre_habilitado=false`) — ni evento ni REST hasta reactivarlo.
360
+
361
+ El evento y la cola de cada notificación los crea y posee **el receptor** (M1/M9/M7), no M6 —
362
+ misma regla del tutorial que aplica al revés en §7.1.
363
  `app/integrations/core_events.py::publish_event(event_type_id, payload)` sigue siendo un
364
+ no-op explícito si `event_type_id is None`.
 
 
 
 
 
 
 
 
365
 
366
  ---
367
 
documentation/M6_EVENTOS_RABBITMQ.md CHANGED
@@ -154,19 +154,34 @@ La deduplicación por id de origen (`solicitud_hce_id`, etc., exigida en `M6_DIS
154
  - Si `event_type_id is None` → **no-op**: loguea a nivel `info` y devuelve `True`, sin ningún request HTTP.
155
  - Si hay un id configurado → `POST /events/log` real contra el Core (`{"event_type_id", "publisher_module", "payload": json.dumps(payload)}`).
156
 
157
- Los 4 puntos de notificación saliente de M6 (`M6_DISEÑO.md` §7.2) hacen **dual-write**: siguen llamando al webhook REST directo, y además llaman a `publish_event`:
158
 
159
  | Función | Notificación | Receptor | Config del `event_type_id` | Estado |
160
  |---|---|---|---|---|
161
- | `hce.notify_resultado_solicitud` | `SOLICITUD_RESUELTA` | M1 HCE | `hce_solicitud_resuelta_event_type_id` | **Activo — `event_type_id=25`, confirmado por M1** |
162
  | `monitoreo.notify_alta` | `ALTA_MONITOREO` | M9 Monitoreo | `monitoreo_alta_event_type_id` | **Activo — `event_type_id=26`, confirmado por M9** |
163
  | `monitoreo.notify_baja` | `BAJA_MONITOREO` | M9 Monitoreo | `monitoreo_baja_event_type_id` | **Activo — `event_type_id=27`, confirmado por M9** |
164
- | `facturacion.notify_cama_lista` | `CIERRE_INTERNACION` (`facturacion.internacion.cama-lista.requested`) | M7 Facturación | `facturacion_cama_lista_event_type_id` | **Activo — `event_type_id=19`, confirmado por escrito** |
165
 
166
  El evento/cola de cada notificación lo crea y comparte el módulo receptor, no M6 (misma
167
- regla que aplica al revés en §2.2). Los 4 ya están activos. Su payload es distinto entre sí
168
- — ver `app/integrations/facturacion.py::notify_cama_lista` y `M6_DISEÑO.md` §7.2/§14.9 para
169
- el detalle completo del de M7, incluido el bloqueante de `idEpisodioExterno`.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
170
 
171
  **Corrección 2026-07 (`cama_id` en los eventos de M9):** `ALTA_MONITOREO`/`BAJA_MONITOREO`
172
  ahora llevan también `cama_id` en el payload — M9 lo necesita para saber a qué cama
@@ -229,11 +244,12 @@ RABBITMQ_PORT=5672
229
  RABBITMQ_VHOST=/
230
  INTERNACION_REQUESTS_QUEUE=internacion.requests
231
 
232
- # Publisher saliente — los 4 confirmados y activos:
233
- HCE_SOLICITUD_RESUELTA_EVENT_TYPE_ID=25
234
  MONITOREO_ALTA_EVENT_TYPE_ID=26
235
  MONITOREO_BAJA_EVENT_TYPE_ID=27
236
  FACTURACION_CAMA_LISTA_EVENT_TYPE_ID=19
 
237
  ```
238
 
239
  Las credenciales del broker (`login`/`password` en `aio_pika.connect_robust`) son `CORE_SERVICE_EMAIL`/`CORE_SERVICE_PASSWORD`, ya definidas para el resto de la integración con el Core — no hay settings de usuario/password nuevas para RabbitMQ.
 
154
  - Si `event_type_id is None` → **no-op**: loguea a nivel `info` y devuelve `True`, sin ningún request HTTP.
155
  - Si hay un id configurado → `POST /events/log` real contra el Core (`{"event_type_id", "publisher_module", "payload": json.dumps(payload)}`).
156
 
157
+ Los 4 puntos de notificación saliente de M6 (`M6_DISEÑO.md` §7.2):
158
 
159
  | Función | Notificación | Receptor | Config del `event_type_id` | Estado |
160
  |---|---|---|---|---|
161
+ | `hce.notify_resultado_solicitud` | `SOLICITUD_RESUELTA` | M1 HCE | `hce_solicitud_resuelta_event_type_id` | **Activo — solo evento, `event_type_id=25`** |
162
  | `monitoreo.notify_alta` | `ALTA_MONITOREO` | M9 Monitoreo | `monitoreo_alta_event_type_id` | **Activo — `event_type_id=26`, confirmado por M9** |
163
  | `monitoreo.notify_baja` | `BAJA_MONITOREO` | M9 Monitoreo | `monitoreo_baja_event_type_id` | **Activo — `event_type_id=27`, confirmado por M9** |
164
+ | `facturacion.notify_cama_lista` | `CIERRE_INTERNACION` (`facturacion.internacion.cama-lista.requested`) | M7 Facturación | `facturacion_cama_lista_event_type_id` | **Pausado — `facturacion_cierre_habilitado=false`, no se manda nada (ni evento ni REST)** |
165
 
166
  El evento/cola de cada notificación lo crea y comparte el módulo receptor, no M6 (misma
167
+ regla que aplica al revés en §2.2). Su payload es distinto entre sí — ver
168
+ `app/integrations/facturacion.py::notify_cama_lista` y `M6_DISEÑO.md` §7.2/§14.9 para el
169
+ detalle completo del de M7, incluido el bloqueante de `idEpisodioExterno`.
170
+
171
+ **Corrección 2026-07 — `SOLICITUD_RESUELTA` deja de ser dual-write.** M1 estaba leyendo las
172
+ aprobaciones como rechazadas. Se detectó que el REST directo (`POST /hce/solicitudes/{id}/
173
+ resultado`) apuntaba a un path que **no existe** en el contrato real de M1 (su OpenAPI expone
174
+ `POST /solicitudes-cama/{id}/resolver` con el schema `SolicitudCamaResolver`, que usa el campo
175
+ `decision: aceptada|rechazada`, no `resultado: APROBADA|RECHAZADA`). Se deprecó el REST
176
+ directo — `hce.notify_resultado_solicitud` ahora publica **solo** el evento del bus. **Pendiente
177
+ de confirmar con M1**: si su consumer de eventos usa el mismo vocabulario `decision/aceptada`
178
+ en vez de `resultado/APROBADA`, el problema original podría persistir por el bus — no se tocó
179
+ el payload del evento en esta corrección, solo se sacó el REST.
180
+
181
+ **Pausa manual 2026-07 — `CIERRE_INTERNACION` (M7) desactivado.** Nueva setting
182
+ `facturacion_cierre_habilitado` (default `false`) corta `notify_cama_lista` antes de armar
183
+ cualquier payload — no sale ni evento ni REST a M7 mientras esté en `false`. Reactivar
184
+ poniendo la variable en `true` (sin otro cambio de código).
185
 
186
  **Corrección 2026-07 (`cama_id` en los eventos de M9):** `ALTA_MONITOREO`/`BAJA_MONITOREO`
187
  ahora llevan también `cama_id` en el payload — M9 lo necesita para saber a qué cama
 
244
  RABBITMQ_VHOST=/
245
  INTERNACION_REQUESTS_QUEUE=internacion.requests
246
 
247
+ # Publisher saliente:
248
+ HCE_SOLICITUD_RESUELTA_EVENT_TYPE_ID=25 # solo evento — REST deprecado
249
  MONITOREO_ALTA_EVENT_TYPE_ID=26
250
  MONITOREO_BAJA_EVENT_TYPE_ID=27
251
  FACTURACION_CAMA_LISTA_EVENT_TYPE_ID=19
252
+ FACTURACION_CIERRE_HABILITADO=false # pausa manual — M7 no recibe nada mientras esté en false
253
  ```
254
 
255
  Las credenciales del broker (`login`/`password` en `aio_pika.connect_robust`) son `CORE_SERVICE_EMAIL`/`CORE_SERVICE_PASSWORD`, ya definidas para el resto de la integración con el Core — no hay settings de usuario/password nuevas para RabbitMQ.
documentation/M6_EVENTOS_REFERENCIA.md CHANGED
@@ -67,18 +67,22 @@ Todos llegan a la cola `internacion.requests` del Core. Fire-and-forget (no espe
67
 
68
  | id | evento | receptor | qué es |
69
  |----|--------|----------|--------|
70
- | **25** | `SOLICITUD_RESUELTA` | M1 HCE | Resultado (APROBADA/RECHAZADA) de una solicitud |
71
  | **26** | `ALTA_MONITOREO` | M9 Monitoreo | Paciente entra a monitoreo en una cama |
72
  | **27** | `BAJA_MONITOREO` | M9 Monitoreo | Paciente sale de monitoreo de una cama |
73
- | **19** | `CIERRE_INTERNACION` | M7 Facturación | Cama liberada tras alta → cerrar y facturar |
74
 
75
- Los 4 están activos (dual-write: REST directo + evento del bus).
 
76
 
77
- **25 — SOLICITUD_RESUELTA → M1** (`hce.notify_resultado_solicitud`)
78
  ```json
79
  { "solicitud_hce_id": "HCE-123", "resultado": "APROBADA",
80
  "motivo": null, "timestamp": "2026-07-17T15:00:00Z" }
81
  ```
 
 
 
82
 
83
  **26/27 — ALTA_MONITOREO / BAJA_MONITOREO → M9** (`monitoreo.notify_alta` / `notify_baja`)
84
  ```json
@@ -88,7 +92,7 @@ Los 4 están activos (dual-write: REST directo + evento del bus).
88
  > Regla de `cama_id`: ingreso → cama destino (alta) · traslado → baja(cama origen) +
89
  > alta(cama destino) · alta médica → cama liberada (baja).
90
 
91
- **19 — CIERRE_INTERNACION → M7** (`facturacion.notify_cama_lista`)
92
  ```json
93
  {
94
  "evento": "CIERRE_INTERNACION",
 
67
 
68
  | id | evento | receptor | qué es |
69
  |----|--------|----------|--------|
70
+ | **25** | `SOLICITUD_RESUELTA` | M1 HCE | Resultado (APROBADA/RECHAZADA) de una solicitud — **solo evento**, REST deprecado |
71
  | **26** | `ALTA_MONITOREO` | M9 Monitoreo | Paciente entra a monitoreo en una cama |
72
  | **27** | `BAJA_MONITOREO` | M9 Monitoreo | Paciente sale de monitoreo de una cama |
73
+ | **19** | `CIERRE_INTERNACION` | M7 Facturación | Cama liberada tras alta → cerrar y facturar — **pausado** |
74
 
75
+ M9 sigue en dual-write (REST + evento). M1 pasó a evento-only (2026-07). M7 está pausado
76
+ (2026-07, `facturacion_cierre_habilitado=false`) — no sale nada hasta reactivarlo.
77
 
78
+ **25 — SOLICITUD_RESUELTA → M1** (`hce.notify_resultado_solicitud`, solo evento del bus)
79
  ```json
80
  { "solicitud_hce_id": "HCE-123", "resultado": "APROBADA",
81
  "motivo": null, "timestamp": "2026-07-17T15:00:00Z" }
82
  ```
83
+ > ⚠️ Pendiente de confirmar con M1: su contrato REST (`SolicitudCamaResolver`) usa el campo
84
+ > `decision: aceptada|rechazada`, no `resultado: APROBADA|RECHAZADA`. Si su consumer de
85
+ > eventos usa el mismo vocabulario, esto puede seguir leyéndose al revés.
86
 
87
  **26/27 — ALTA_MONITOREO / BAJA_MONITOREO → M9** (`monitoreo.notify_alta` / `notify_baja`)
88
  ```json
 
92
  > Regla de `cama_id`: ingreso → cama destino (alta) · traslado → baja(cama origen) +
93
  > alta(cama destino) · alta médica → cama liberada (baja).
94
 
95
+ **19 — CIERRE_INTERNACION → M7** (`facturacion.notify_cama_lista`) — **pausado, no se envía hoy**
96
  ```json
97
  {
98
  "evento": "CIERRE_INTERNACION",
documentation/integrations/M1_integration_camas_quirofanos.md ADDED
@@ -0,0 +1,185 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ Buenas, les dejamos la referencia de M6 (Internación y Gestión de Camas) que necesitan para:
2
+ 1. Usar el vocabulario correcto de sectores/tipos de cama al armar sus solicitudes de
3
+ internación/traslado hacia M6.
4
+ 2. Mandarnos cirugías urgentes por nuestro endpoint REST.
5
+
6
+ ---
7
+
8
+ ## 1. Enums de M6 para solicitudes de cama
9
+
10
+ Cuando HCE crea una solicitud hacia M6 (evento `internacion.solicitud.creada`,
11
+ `event_type_id=14`, o su equivalente REST `POST /webhooks/hce/solicitud`), los campos
12
+ `cama_solicitada_id`/`cama_destino_solicitada_id` referencian una cama concreta del catálogo
13
+ de M6. Ese catálogo describe cada cama con estos dos enums — les sirve para mostrar/filtrar
14
+ el tipo correcto en su UI o para pedir el sector adecuado al crear la solicitud.
15
+
16
+ ### 1.1 `SectorEnum` — sector del hospital
17
+
18
+ | valor | significado |
19
+ |---|---|
20
+ | `UTI` | Unidad de Terapia Intensiva |
21
+ | `SALA_COMUN` | Internación general |
22
+ | `QUIROFANO` | Quirófano (cirugía) |
23
+ | `GUARDIA` | Guardia/emergencias |
24
+ | `NEONATOLOGIA` | Neonatología |
25
+
26
+ ### 1.2 `TipoCamaEnum` — tipo de cama dentro del sector
27
+
28
+ | valor | significado |
29
+ |---|---|
30
+ | `ESTANDAR` | Cama estándar de internación |
31
+ | `PEDIATRICA` | Cama pediátrica |
32
+ | `AISLAMIENTO` | Cama de aislamiento (infeccioso/inmunodeprimido) |
33
+ | `CRITICA` | Cama crítica (UTI/alta complejidad) |
34
+ | `CIRUGIA` | Cama/box de quirófano |
35
+
36
+ > ⚠️ **Ojo con el vocabulario**: esto es el catálogo interno de M6, distinto del que usa el
37
+ > propio schema de solicitudes de HCE (`SolicitudCamaCreate`), que hoy usa strings libres
38
+ > como `"UTI — Unidad de Terapia Intensiva"` para `sector` y `Baja/Media/Alta` para
39
+ > `prioridad`. Los valores de esta tabla son los que **M6 espera recibir** en
40
+ > `cama_solicitada_id` (referencia a una cama concreta, no al sector como string) —
41
+ > `SectorEnum`/`TipoCamaEnum` son metadata de esa cama, no campos que HCE tenga que mandar
42
+ > directamente en la solicitud.
43
+
44
+ ### 1.3 Otros enums que sí viajan directamente en la solicitud
45
+
46
+ Estos sí forman parte del payload que HCE manda a M6 (`SolicitudHceWebhook`):
47
+
48
+ | enum | valores | campo |
49
+ |---|---|---|
50
+ | `TipoSolicitudEnum` | `INTERNACION`, `TRASLADO` | `tipo` |
51
+ | `PrioridadSolicitudEnum` | `MUY_BAJA`, `BAJA`, `MEDIA`, `ALTA`, `MUY_ALTA`, `URGENTE` | `prioridad` |
52
+ | `OrigenIngresoEnum` | `GUARDIA`, `CIRUGIA_PROGRAMADA` | `origen` |
53
+ | `TipoAltaEnum` | `ALTA_MEDICA`, `ALTA_VOLUNTARIA`, `TRASLADO_EXTERNO`, `DEFUNCION` | `tipo_alta` (en el alta médica) |
54
+
55
+ Todos en mayúsculas y con guion bajo (snake case en mayúsculas), sin acentos.
56
+
57
+ ---
58
+
59
+ ## 2. Cómo mandarnos una cirugía urgente
60
+
61
+ **Endpoint:** `POST /api/v1/webhooks/hce/cirugia-urgente`
62
+
63
+ Es un **webhook REST síncrono** — no va por el bus de eventos del Core (a diferencia de las
64
+ solicitudes de internación/traslado). La respuesta llega en el mismo request, con el
65
+ quirófano ya asignado (o el motivo de por qué no se pudo).
66
+
67
+ **Autenticación:** `Authorization: Bearer <JWT>` — mismo mecanismo que el resto de webhooks
68
+ de M6 (token de la cuenta de servicio, vía Core/SSO).
69
+
70
+ ### 2.1 Body del request
71
+
72
+ ```json
73
+ {
74
+ "solicitud_urgencia_hce_id": "URG-000123",
75
+ "paciente_id": 10500,
76
+ "medico_cirujano_id": 45,
77
+ "medico_solicitante_id": 20,
78
+ "fecha_hora_inicio": "2026-07-17T18:00:00Z",
79
+ "fecha_hora_fin_estimada": "2026-07-17T20:00:00Z",
80
+ "diagnostico": "Apendicitis aguda",
81
+ "hospital_id": "1",
82
+ "specialty_id": 3,
83
+ "timestamp": "2026-07-17T17:45:00Z"
84
+ }
85
+ ```
86
+
87
+ | campo | tipo | obligatorio | notas |
88
+ |---|---|---|---|
89
+ | `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` |
90
+ | `paciente_id` | int | sí | |
91
+ | `medico_cirujano_id` | int | sí | |
92
+ | `medico_solicitante_id` | int | sí | |
93
+ | `fecha_hora_inicio` | datetime | sí | ver algoritmo ASAP abajo — **no** es necesariamente el horario real asignado |
94
+ | `fecha_hora_fin_estimada` | datetime | sí | debe ser posterior a `fecha_hora_inicio` (si no, `422`) |
95
+ | `diagnostico` | string | no | |
96
+ | `hospital_id` | string | no | |
97
+ | `specialty_id` | int | no | preferencia de especialidad del quirófano — ver abajo |
98
+ | `timestamp` | datetime | sí | |
99
+
100
+ ### 2.2 Algoritmo ASAP (as soon as possible)
101
+
102
+ M6 **no reserva necesariamente la ventana tal cual la mandan**:
103
+ - `fecha_hora_inicio` se interpreta como **"no antes de"**.
104
+ - La duración de la cirugía = `fecha_hora_fin_estimada - fecha_hora_inicio`.
105
+ - M6 calcula el **inicio real más temprano posible** entre los quirófanos compatibles del
106
+ hospital, que puede ser posterior al `fecha_hora_inicio` pedido (si todos están ocupados en
107
+ ese horario).
108
+ - `specialty_id` es una **preferencia, no un filtro obligatorio**: si no viene, o no hay
109
+ ningún quirófano libre de esa especialidad, M6 usa cualquier quirófano compatible del
110
+ hospital antes que dejar al paciente sin asignar.
111
+ - Si hace falta, M6 puede **reprogramar** reservas programadas (no urgentes) que estén en el
112
+ medio del hueco elegido — esas reservas desplazadas vienen listadas en la respuesta (ver
113
+ abajo) y M6 les avisa a M2 (Turnos) por su cuenta.
114
+
115
+ ### 2.3 Respuestas
116
+
117
+ | status | cuándo |
118
+ |---|---|
119
+ | `201` | Reserva urgente creada |
120
+ | `200` | Ya existía una reserva para ese `solicitud_urgencia_hce_id` (idempotencia — no se crea de nuevo) |
121
+ | `409` | No hay ningún quirófano compatible/operable disponible |
122
+ | `401` | Token inválido/ausente |
123
+ | `422` | Payload inválido (ej. `fecha_hora_inicio >= fecha_hora_fin_estimada`) |
124
+
125
+ Body de la respuesta (`201`/`200`):
126
+
127
+ ```json
128
+ {
129
+ "mensaje": "Reserva urgente creada. Se reprogramaron las reservas 45",
130
+ "reserva": {
131
+ "id": 88,
132
+ "cama_id": 12,
133
+ "paciente_id": 10500,
134
+ "prioridad": "URGENTE",
135
+ "origen": "EMERGENCIA",
136
+ "estado": "RESERVADA",
137
+ "fecha_hora_inicio": "2026-07-17T18:30:00Z",
138
+ "fecha_hora_fin_estimada": "2026-07-17T20:30:00Z",
139
+ "observaciones": "Apendicitis aguda",
140
+ "desplazada_por_reserva_id": null,
141
+ "created_at": "2026-07-17T17:45:03Z"
142
+ },
143
+ "reservas_desplazadas": [
144
+ {
145
+ "reserva_id": 45,
146
+ "cama_id": 12,
147
+ "turno_id": 900,
148
+ "prioridad_original": "MEDIA",
149
+ "notificado_a_m2": true
150
+ }
151
+ ]
152
+ }
153
+ ```
154
+
155
+ - `reserva.fecha_hora_inicio` es el horario **real** asignado — puede diferir del que pidieron
156
+ (ver ASAP arriba).
157
+ - `reservas_desplazadas` puede venir vacío. Cuando trae elementos, son reservas programadas
158
+ que se reprogramaron para hacerle lugar a la urgente; `notificado_a_m2: true` indica que esa
159
+ reserva tenía un `turno_id` de M2 y ya se le avisó.
160
+
161
+ ### 2.4 Ejemplo `curl`
162
+
163
+ ```bash
164
+ curl -X POST https://<host-m6>/api/v1/webhooks/hce/cirugia-urgente \
165
+ -H "Authorization: Bearer $TOKEN" \
166
+ -H "Content-Type: application/json" \
167
+ -d '{
168
+ "solicitud_urgencia_hce_id": "URG-000123",
169
+ "paciente_id": 10500,
170
+ "medico_cirujano_id": 45,
171
+ "medico_solicitante_id": 20,
172
+ "fecha_hora_inicio": "2026-07-17T18:00:00Z",
173
+ "fecha_hora_fin_estimada": "2026-07-17T20:00:00Z",
174
+ "diagnostico": "Apendicitis aguda",
175
+ "hospital_id": "1",
176
+ "specialty_id": 3,
177
+ "timestamp": "2026-07-17T17:45:00Z"
178
+ }'
179
+ ```
180
+
181
+ ---
182
+
183
+ Cualquier duda sobre estos contratos, las fuentes exactas en el repo de M6 son
184
+ `app/schemas/enums.py` (enums) y `app/schemas/reserva.py` +
185
+ `app/routers/webhooks.py::recibir_cirugia_urgente` (cirugía urgente).
tests/test_core_events.py CHANGED
@@ -54,9 +54,11 @@ def test_publish_event_con_id_pero_post_falla_devuelve_false(monkeypatch):
54
  # ─── notify_* : REST sin cambios + publish_event adicional (hoy no-op) ─────
55
 
56
 
57
- def test_notify_resultado_solicitud_sigue_llamando_rest_igual_que_antes(monkeypatch):
 
 
58
  monkeypatch.setattr(settings, "mock_external_services", False)
59
- monkeypatch.setattr(settings, "hce_solicitud_resuelta_event_type_id", None)
60
  rest_calls = []
61
  publish_calls = []
62
  monkeypatch.setattr(
@@ -71,14 +73,12 @@ def test_notify_resultado_solicitud_sigue_llamando_rest_igual_que_antes(monkeypa
71
  ok = hce.notify_resultado_solicitud("HCE-SOL-1", "APROBADA", motivo=None)
72
 
73
  assert ok is True
74
- assert len(rest_calls) == 1
75
- url, rest_payload = rest_calls[0]
76
- assert url == f"{settings.m1_hce_url}/api/v1/hce/solicitudes/HCE-SOL-1/resultado"
77
- assert "solicitud_hce_id" not in rest_payload # el body REST no cambia
78
  assert len(publish_calls) == 1
79
  event_type_id, event_payload = publish_calls[0]
80
- assert event_type_id is None # no configurado todavía
81
  assert event_payload["solicitud_hce_id"] == "HCE-SOL-1"
 
82
 
83
 
84
  def test_notify_alta_sin_event_type_id_usa_rest_como_backup(monkeypatch):
@@ -167,9 +167,34 @@ def test_notify_baja_con_event_type_id_publica_al_bus_con_cama_id(monkeypatch):
167
  assert payload["cama_id"] == 9
168
 
169
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
170
  def test_notify_cama_lista_sigue_llamando_rest_con_payload_minimo(monkeypatch):
171
  """El REST directo es fallback/testing manual según M7 — payload mínimo, sin cambios."""
172
  monkeypatch.setattr(settings, "mock_external_services", False)
 
173
  monkeypatch.setattr(settings, "facturacion_cama_lista_event_type_id", None)
174
  rest_calls = []
175
  monkeypatch.setattr(
@@ -199,6 +224,7 @@ def test_notify_cama_lista_publica_evento_rico_con_datos_del_episodio(monkeypatc
199
  """El evento del Core (event_type_id=19, confirmado por M7) lleva el payload rico
200
  CIERRE_INTERNACION con los datos del episodio persistidos en la Cama."""
201
  monkeypatch.setattr(settings, "mock_external_services", False)
 
202
  monkeypatch.setattr(settings, "facturacion_cama_lista_event_type_id", 19)
203
  monkeypatch.setattr("app.integrations.facturacion._post", lambda *a, **k: {"ok": True})
204
  publish_calls = []
@@ -242,6 +268,7 @@ def test_notify_cama_lista_manda_episodio_id_como_entero_cuando_esta_poblado(mon
242
  solicitud — ver M6_INTEGRACION_M1_HCE.md §4.3), no desde el webhook de alta médica.
243
  Tiene que salir como entero en el evento, igual que idPacienteExterno."""
244
  monkeypatch.setattr(settings, "mock_external_services", False)
 
245
  monkeypatch.setattr(settings, "facturacion_cama_lista_event_type_id", 19)
246
  monkeypatch.setattr("app.integrations.facturacion._post", lambda *a, **k: {"ok": True})
247
  publish_calls = []
 
54
  # ─── notify_* : REST sin cambios + publish_event adicional (hoy no-op) ─────
55
 
56
 
57
+ def test_notify_resultado_solicitud_solo_publica_evento_sin_rest(monkeypatch):
58
+ """Corrección 2026-07: el REST a M1 (`/hce/solicitudes/{id}/resultado`) se deprecó — ese
59
+ path no existe en el contrato real de M1. Canal único: el evento del bus."""
60
  monkeypatch.setattr(settings, "mock_external_services", False)
61
+ monkeypatch.setattr(settings, "hce_solicitud_resuelta_event_type_id", 25)
62
  rest_calls = []
63
  publish_calls = []
64
  monkeypatch.setattr(
 
73
  ok = hce.notify_resultado_solicitud("HCE-SOL-1", "APROBADA", motivo=None)
74
 
75
  assert ok is True
76
+ assert len(rest_calls) == 0 # el REST ya no se llama
 
 
 
77
  assert len(publish_calls) == 1
78
  event_type_id, event_payload = publish_calls[0]
79
+ assert event_type_id == 25
80
  assert event_payload["solicitud_hce_id"] == "HCE-SOL-1"
81
+ assert event_payload["resultado"] == "APROBADA"
82
 
83
 
84
  def test_notify_alta_sin_event_type_id_usa_rest_como_backup(monkeypatch):
 
167
  assert payload["cama_id"] == 9
168
 
169
 
170
+ def test_notify_cama_lista_desactivado_no_envia_nada(monkeypatch):
171
+ """Pausa manual (2026-07, `facturacion_cierre_habilitado=False` por default): no se manda
172
+ nada a M7, ni evento ni REST, y la función devuelve True (fire-and-forget)."""
173
+ monkeypatch.setattr(settings, "mock_external_services", False)
174
+ monkeypatch.setattr(settings, "facturacion_cierre_habilitado", False)
175
+ rest_calls = []
176
+ publish_calls = []
177
+ monkeypatch.setattr(
178
+ "app.integrations.facturacion._post",
179
+ lambda *a, **k: rest_calls.append((a, k)) or {"ok": True},
180
+ )
181
+ monkeypatch.setattr(
182
+ "app.integrations.core_events.publish_event",
183
+ lambda *a, **k: publish_calls.append((a, k)) or True,
184
+ )
185
+
186
+ cama = make_cama(id=315, paciente_id=7)
187
+ ok = facturacion.notify_cama_lista(cama, db=None)
188
+
189
+ assert ok is True
190
+ assert rest_calls == []
191
+ assert publish_calls == []
192
+
193
+
194
  def test_notify_cama_lista_sigue_llamando_rest_con_payload_minimo(monkeypatch):
195
  """El REST directo es fallback/testing manual según M7 — payload mínimo, sin cambios."""
196
  monkeypatch.setattr(settings, "mock_external_services", False)
197
+ monkeypatch.setattr(settings, "facturacion_cierre_habilitado", True)
198
  monkeypatch.setattr(settings, "facturacion_cama_lista_event_type_id", None)
199
  rest_calls = []
200
  monkeypatch.setattr(
 
224
  """El evento del Core (event_type_id=19, confirmado por M7) lleva el payload rico
225
  CIERRE_INTERNACION con los datos del episodio persistidos en la Cama."""
226
  monkeypatch.setattr(settings, "mock_external_services", False)
227
+ monkeypatch.setattr(settings, "facturacion_cierre_habilitado", True)
228
  monkeypatch.setattr(settings, "facturacion_cama_lista_event_type_id", 19)
229
  monkeypatch.setattr("app.integrations.facturacion._post", lambda *a, **k: {"ok": True})
230
  publish_calls = []
 
268
  solicitud — ver M6_INTEGRACION_M1_HCE.md §4.3), no desde el webhook de alta médica.
269
  Tiene que salir como entero en el evento, igual que idPacienteExterno."""
270
  monkeypatch.setattr(settings, "mock_external_services", False)
271
+ monkeypatch.setattr(settings, "facturacion_cierre_habilitado", True)
272
  monkeypatch.setattr(settings, "facturacion_cama_lista_event_type_id", 19)
273
  monkeypatch.setattr("app.integrations.facturacion._post", lambda *a, **k: {"ok": True})
274
  publish_calls = []