# HL7v2

SanteDB support for HL7v2 messaging is implemented via `Hl7MessageHandler` daemon service in the `SanteDB.Message.HL7.dll` assembly. When enabled, the HL7v2 interface will process inbound messages by matching their trigger event and message type to a registered `IHL7MessageHandler` instance.

## Processing of HL7 Messages

When an inbound message is received via any registered transport, the following process is initiated:

1. The incoming message socket is consumed, if the message is received via SLLP then the client certificate is amended to the message receive event.
2. The message is converted to HL7v2.5 which is the canonical version of HL7 used within SanteDB for all handlers.
3. The `MSH-9` field is read and an applicable `IHl7MessageHandler` instance is located based on the trigger event.
4. The message handler authenticates the sender by:
   1. Using the client certificate information provided by the sending system, 
   2. Using the `MSH-3` and `MSH-4` fields and the `MSH-8` security value to authenticate the sending application/device,
   3. Optionally the `SFT-2` value is used to authenticate application
5. The message handler iterates over the segments and segment groups and calls `IHl7SegmentHAndler` instances to parse the message
6. The message handler performs the necessary actions based on the incoming message
7. The message handler returns a `Bundle` instance which the processor (again) calls `IHl7SegmentHandler` instances to parse the RIM based objects back into HL7v2
8. The server appends the necessary sending information and message metadata, 
9. The response is sent via the same channel it was received

## Related Topics

{% content-ref url="hl7v2/enabling-hl7v2-interfaces" %}
[enabling-hl7v2-interfaces](https://help.santesuite.org/developers/service-apis/hl7v2/enabling-hl7v2-interfaces)
{% endcontent-ref %}

{% content-ref url="hl7v2/hl7-authentication" %}
[hl7-authentication](https://help.santesuite.org/developers/service-apis/hl7v2/hl7-authentication)
{% endcontent-ref %}

{% content-ref url="hl7v2/santedb-hl7v2-implementation" %}
[santedb-hl7v2-implementation](https://help.santesuite.org/developers/service-apis/hl7v2/santedb-hl7v2-implementation)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.santesuite.org/developers/service-apis/hl7v2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.