Validate a patient event and return the generated HL7 message

Validate a patient event payload, generate its HL7 v2.x message, and send it. Parses the payload with ``PatientEvent.model_validate()`` and returns: - On success: ``{"valid": true, "data": ..., "version": ..., "hl7_message": ..., "segments": [...], "delivery": {...}}`` - On failure: ``{"valid": false, "errors": [<pydantic_validation_errors>]}`` When ``integration_configs`` carries a TCP/IP ``host``/``port`` (via ``config_meta`` or ``integration_details``), the generated message is also delivered over a plain TCP socket. Delivery is best-effort — an unreachable receiver or missing transport config is reported under ``delivery`` without failing the validation response.

Authentication

AuthorizationBearer

Static shared-secret token for internal service-to-service calls.

Query parameters

versionenumOptional

Target HL7 version for the generated message: 2.3, 2.5 or 2.7

Allowed values:

Request

This endpoint expects a map from strings to any.

Response

Successful Response

Errors

422
Unprocessable Entity Error