HL7

List Endpoints

Create Endpoint

Da de alta una conexión. La institución la fija el contexto, no el cuerpo. Que ``tenantId`` no sea un campo del contrato es deliberado: si viniera en el cuerpo habría que comprobarlo contra el contexto en cada ruta, y el día que alguien olvidara la comprobación el alta sería un endpoint plantado en la institución de otro.

Get Endpoint

Update Endpoint

Set Endpoint Status

Activa o pausa. Existe además del `PATCH` porque cortar el tráfico durante una ventana de mantenimiento es una operación de un clic, y hacerla depender de un cuerpo JSON invita a mandar de paso campos que nadie quería tocar. Pausar CONSERVA la fila y todo lo que se intercambió por ella. No hay borrado en esta API.

Test Endpoint Connection

Abre el canal y lo cierra, sin enviar nada. Se puede probar un endpoint **pausado o recién creado**: es justo cuando hace falta. Exigir que estuviera activo obligaría a encender la integración para saber si funciona, que es el orden contrario al que este botón existe para permitir.

Send Endpoint Test Message

Manda un `ADT^A08` sintético con `MSH-11` en `T` y espera su confirmación. A diferencia de la prueba de conexión, **esto deja rastro en el sistema de la contraparte**. Es una acción aparte por eso mismo: quien sólo quiere saber si el puerto está abierto no debería tener que escribir en la base de datos de un tercero para averiguarlo.

List Messages

El listado. Sin contenido crudo: para eso está el detalle, que sí se audita.

Message Counters

Pendientes, fallidos y muertos por endpoint. Va declarada ANTES de `/messages/{message_id}`: al revés, FastAPI casaría «counters» con el parámetro de ruta y esto respondería un 404.

Get Message

El detalle CON el contenido crudo, y por eso auditado. El mensaje lleva nombre, documento y diagnóstico del paciente: leerlo es un acceso a expediente y se anota como tal. La bitácora se escribe aunque la consulta no cambie nada — precisamente por eso: es el único rastro de que alguien lo leyó.

Discard Message

Cierra una incidencia de la cola muerta, dejando quién y cuándo.

Retry Message

Devuelve un mensaje fallido a la cola para el próximo ciclo del emisor. No lo envía aquí: encolar y enviar están separados en toda la integración, y hacer una excepción por venir de un botón abriría un socket a un tercero dentro de una petición HTTP. Lo que esto hace es adelantar la espera.

Endpoint Vocabulary

Los conjuntos de valores que acepta el formulario. Sale del código que los valida, no de una lista copiada en el portal: una versión HL7 que aparezca aquí y no en `SUPPORTED_HL7_VERSIONS` sería un desplegable que ofrece algo que el alta rechaza.