Download app/integrations/facturacion.py from Modulo-6/api: direct link, hf CLI and curl.
- Browser
- Download file 4.66 kB
-
https://huggingface.co/spaces/Modulo-6/api/resolve/main/app/integrations/facturacion.py
- Command line
-
hf download hf://spaces/Modulo-6/api/app/integrations/facturacion.py
-
curl -L -o facturacion.py https://huggingface.co/spaces/Modulo-6/api/resolve/main/app/integrations/facturacion.py
4.66 kB
| """ | |
| M7 Facturación — notificación de cierre de internación para facturar. | |
| Dos canales, con payloads DISTINTOS (ver `notify_cama_lista`): | |
| - REST directo (`POST /api/v1/webhooks/internacion/cama-lista`): fallback/testing manual | |
| según M7 (`documentation/integrations/M7_integration.md`) — payload mínimo. | |
| - Evento del Core (`facturacion.internacion.cama-lista.requested`, `event_type_id=19`): | |
| la integración final confirmada por M7 — payload rico (`CIERRE_INTERNACION`), con datos | |
| del episodio que M6 empezó a persistir en la propia fila de `Cama` (ver | |
| `app/models/cama.py`) precisamente para poder armar este evento. | |
| """ | |
| import logging | |
| from datetime import date, datetime, timezone | |
| from supabase import Client | |
| from app.config import settings | |
| from app.integrations import core_events | |
| from app.integrations._base import _post | |
| from app.models.cama import Cama | |
| logger = logging.getLogger(__name__) | |
| def _iso_z(dt: datetime | None) -> str | None: | |
| """ | |
| ISO 8601 UTC con sufijo `Z`, como documenta M7 (`M7_integration.md`) y como se usa en | |
| el resto del proyecto — `datetime.isoformat()` sobre un aware UTC produce `+00:00`, no | |
| `Z`, y M7 puede no parsearlo igual (típico si su DTO usa `Instant`). | |
| """ | |
| if dt is None: | |
| return None | |
| return dt.astimezone(timezone.utc).isoformat().replace("+00:00", "Z") | |
| def notify_cama_lista(cama: Cama, db: Client) -> bool: | |
| """ | |
| Avisa a M7 que una cama quedó lista tras un alta — cierra la internación del lado de | |
| facturación. | |
| `db` no se usa dentro de la función (se dejó de reconstruir `camasUtilizadas` vía | |
| auditoría, campo que no forma parte del contrato real de M7 — ver `M6_DISEÑO.md` §7.2); | |
| se mantiene en la firma para no tocar el call site (`solicitud_service.procesar_alta_medica`). | |
| `idEventoExterno` es la clave de idempotencia que usa M7: se deriva de forma estable | |
| (cama + paciente + fecha del alta) para que un reintento del mismo evento no genere un | |
| alta duplicada en facturación. | |
| `idEpisodioExterno` viaja como `cama.episodio_id` (entero) cuando está poblado, o `None` | |
| si no: M1 todavía no provee ese dato en `AltaMedicaWebhook` (pendiente de coordinar — ver | |
| `M6_DISEÑO.md` §14 y `documentation/M6_INTEGRACION_M1_HCE.md`), así que hoy siempre es | |
| `None` en la práctica. M7 confirmó que sin ese dato el evento queda pendiente de completar | |
| del lado de ellos, no se rechaza. | |
| """ | |
| if settings.mock_external_services: | |
| return True | |
| if not settings.facturacion_cierre_habilitado: | |
| # Pausa manual (2026-07): por ahora no se le manda a M7 el cierre de internación, | |
| # ni por evento ni por REST — fire-and-forget, no frena el alta. | |
| logger.info( | |
| "Cierre de facturación (M7) desactivado — no se envía CIERRE_INTERNACION (cama=%s)", | |
| cama.id, | |
| ) | |
| return True | |
| paciente_id = cama.paciente_id or 0 | |
| id_evento_externo = f"M6-CIERRE-INT-{cama.id}-{paciente_id}-{date.today().isoformat()}" | |
| payload_rest = { | |
| "evento": "CAMA_LISTA", | |
| "idEventoExterno": id_evento_externo, | |
| "camaId": str(cama.id), | |
| "idPacienteExterno": paciente_id, | |
| "timestampEvento": _iso_z(datetime.now(timezone.utc)), | |
| } | |
| # Payload del evento del Core: exactamente el contrato que confirmó M7 por escrito | |
| # (`M7_integration.md`) y que documenta `M6_DISEÑO.md` §7.2 — sin campos extra | |
| # (`camaId`/`camasUtilizadas` no forman parte de ese contrato). | |
| payload_evento = { | |
| "evento": "CIERRE_INTERNACION", | |
| "idEventoExterno": id_evento_externo, | |
| "idInternacionExterna": cama.solicitud_hce_id, | |
| "idEpisodioExterno": int(cama.episodio_id) if cama.episodio_id is not None else None, | |
| "idPacienteExterno": paciente_id, | |
| "fechaIngreso": _iso_z(cama.fecha_ingreso), | |
| "fechaAlta": _iso_z(cama.alta_timestamp), | |
| "tipoAlta": cama.alta_tipo, | |
| "timestampEvento": _iso_z(datetime.now(timezone.utc)), | |
| } | |
| # Canal primario: evento via M10 Core (si el event_type_id está configurado). | |
| # Solo se cae al backup HTTP si el evento falla o no está configurado. | |
| event_type_id = settings.facturacion_cama_lista_event_type_id | |
| if event_type_id is not None: | |
| ok_event = core_events.publish_event(event_type_id, payload_evento, publisher_module="modulo_6") | |
| if ok_event: | |
| return True | |
| # Backup: REST directo a M7 (fallback/testing manual según M7_integration.md) | |
| return _post( | |
| f"{settings.m7_facturacion_url}/api/v1/webhooks/internacion/cama-lista", payload_rest | |
| ) is not None | |