Powered by Smile CDR v2025.02.PRE-04 (build e75afbc13c)

On this page:

49.90 HL7 v2.x MLLP Listener 49.92 FHIR to HL7 v2.x Mapper Script

49.91.1HL7 v2.x MLLP Sender

The HL7 v2.x MLLP Sender configuration category includes the following configurable options:

Delay Between Failed Deliveries (millis)
Forward Persisted Messages
HL7 v2.x Destination Host
Request Path
HL7 v2.x Destination Port
Retry message on NAK
Send Timeout (millis)
Transport Protocol

49.91.2Property: Delay Between Failed Deliveries (millis)

Property Name	Delay Between Failed Deliveries (millis)
Property Key
Property Type	NON_NEGATIVE_INTEGER
Description	If set to a number above 0, sets the minimum number of milliseconds to wait after a failed delivery attempt before trying again.
Applies to Modules	HL7 v2.x Sending Endpoint
Default Value	`10000`
Example Property	`module.[MODULE_ID].config.delay_between_failed_deliveries.millis = 10000`

49.91.3Property: Forward Persisted Messages

Property Name	Forward Persisted Messages
Property Key
Property Type	BOOLEAN
Description	If enabled, sends persisted HL7 v2.x messages back out verbatim. See Storing HL7 v2.x Messages As-Is for details.
Applies to Modules	HL7 v2.x Sending Endpoint
Default Value	`false`
Example Property	`module.[MODULE_ID].config.forward_persisted_messages = false`

49.91.4Property: HL7 v2.x Destination Host

Property Name	HL7 v2.x Destination Host
Property Key
Property Type	STRING
Description	The TCP hostname to which this module will transmit.
Applies to Modules	HL7 v2.x Sending Endpoint
Default Value	(no default)
Example Property	`module.[MODULE_ID].config.host =`

49.91.5Property: Request Path

Property Name	Request Path
Property Key
Property Type	STRING
Description	The path to transmit messages to. Note that this applies only to HTTP transports and will be ignored for MLLP transports.
Applies to Modules	HL7 v2.x Sending Endpoint
Default Value	`/`
Example Property	`module.[MODULE_ID].config.path = /`

49.91.6Property: HL7 v2.x Destination Port

Property Name	HL7 v2.x Destination Port
Property Key
Property Type	POSITIVE_INTEGER
Description	The TCP port to which this module will transmit.
Applies to Modules	CDS Hooks REST Endpoint EasyShare SHL Endpoint (Admin) EasyShare SHL Endpoint (Public) FHIR Gateway REST Endpoint FHIR REST Endpoint (All FHIR Versions) FHIR REST Endpoint (DSTU2 - Deprecated) FHIR REST Endpoint (R3 - Deprecated) FHIR REST Endpoint (R4 - Deprecated) FHIRWeb Console HL7 v2.x Listening Endpoint HL7 v2.x Listening Endpoint (Deprecated) HL7 v2.x Sending Endpoint Hybrid Providers REST Endpoint JSON Admin API MDM UI Package Registry Endpoint Payer to Payer Product Portal SMART Outbound Security Subscription Websocket Endpoint appSphere
Default Value	(no default)
Example Property	`module.[MODULE_ID].config.port =`

49.91.7Property: Retry message on NAK

Property Name	Retry message on NAK
Property Key
Property Type	BOOLEAN
Description	If the receiving system responds with a non-positive acknowledgement message (e.g an ACK message with an `AE` response code), should we attempt to redeliver the message until we are successful?
Applies to Modules	HL7 v2.x Sending Endpoint
Default Value	`true`
Example Property	`module.[MODULE_ID].config.retry_message_on_nak = true`

49.91.8Property: Send Timeout (millis)

Property Name	Send Timeout (millis)
Property Key
Property Type	POSITIVE_INTEGER
Description	The number of milliseconds to wait for a response before timing out.
Applies to Modules	HL7 v2.x Sending Endpoint
Default Value	`10000`
Example Property	`module.[MODULE_ID].config.send_timeout.millis = 10000`

49.91.9Property: Transport Protocol

Property Name	Transport Protocol
Property Key
Property Type	ENUM
Values	`MLLP_OVER_TCP` `HL7_OVER_HTTP`
Description	Specifies the transport to use when sending HL7 v2.x messages. Note that most existing systems expect the MLLP protocol unless specifically configured otherwise.
Applies to Modules	HL7 v2.x Listening Endpoint HL7 v2.x Listening Endpoint (Deprecated) HL7 v2.x Sending Endpoint
Default Value	`MLLP_OVER_TCP`
Example Property	`module.[MODULE_ID].config.transport = MLLP_OVER_TCP`

49.90 HL7 v2.x MLLP Listener 49.92 FHIR to HL7 v2.x Mapper Script