> For the complete documentation index, see [llms.txt](https://docs.digibee.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/industry-solutions/hl7.md).

# HL7

O **HL7** envia informações para sistemas de saúde utilizando o protocolo de comunicação HL7 ([Health Level 7](https://info.hl7.org/orientation-station)), um padrão da indústria de saúde para troca de dados entre diferentes sistemas e dispositivos médicos.

## **Parâmetros**

Configure o conector utilizando os parâmetros abaixo. Os campos que suportam [expressões Double Braces](/documentation/connectors-and-triggers/pt-br/double-braces/overview.md) estão marcados na coluna **Suporta DB**.

{% tabs %}
{% tab title="General" %}

<table><thead><tr><th width="112">Parâmetro</th><th width="231">Descrição</th><th width="83">Tipo de dado</th><th width="81">Suporta DB</th><th width="100">Valor padrão</th><th width="125">Visível quando</th></tr></thead><tbody><tr><td><strong>Host</strong></td><td>Host do servidor HL7.</td><td>String</td><td>❌</td><td><code>hl7.server.com</code></td><td>—</td></tr><tr><td><strong>Port</strong></td><td>Porta do servidor HL7. O protocolo MLLP (Minimal Lower Layer Protocol) geralmente é executado na porta 2575.</td><td>Integer</td><td>❌</td><td><code>2575</code></td><td>—</td></tr><tr><td><strong>Connect Timeout (ms)</strong></td><td>Limite de tempo, em milissegundos, para a plataforma se conectar ao servidor.</td><td>Integer</td><td>❌</td><td><code>3000</code></td><td>—</td></tr><tr><td><strong>HL7 Message</strong></td><td>Campo de mensagem que contém os dados a serem enviados.</td><td>JSON</td><td>✅</td><td>N/A</td><td>—</td></tr><tr><td><strong>HL7 Message Charset</strong></td><td>Charset utilizado para codificar a mensagem HL7.</td><td>String</td><td>❌</td><td><code>UTF-8</code></td><td>—</td></tr><tr><td><strong>Advanced settings</strong></td><td>Quando ativado, exibe opções de configuração adicionais.</td><td>Boolean</td><td>❌</td><td><code>false</code></td><td>—</td></tr><tr><td><strong>Connection Pool</strong></td><td>Número de pools de conexão disponíveis.</td><td>Integer</td><td>❌</td><td><code>10</code></td><td><strong>Advanced Settings</strong> está habilitado</td></tr><tr><td><strong>Enable Retries</strong></td><td>Quando ativado, permite novas tentativas caso a execução falhe.</td><td>Boolean</td><td>❌</td><td><code>false</code></td><td><strong>Advanced Settings</strong> está habilitado</td></tr><tr><td><strong>Number of Retries</strong></td><td>Número de novas tentativas a serem realizadas caso a execução falhe.</td><td>Integer</td><td>❌</td><td><code>0</code></td><td><strong>Enable Retries</strong> está habilitado</td></tr><tr><td><strong>Time to Wait Between Retries (ms)</strong></td><td>Intervalo de tempo, em milissegundos, entre as novas tentativas.</td><td>Integer</td><td>❌</td><td><code>1000</code></td><td><strong>Enable Retries</strong> está habilitado</td></tr><tr><td><strong>Fail on Error</strong></td><td>Quando habilitado, a execução do pipeline é interrompida caso ocorra um erro. Quando desabilitado, o pipeline continua e a propriedade <code>success</code> retorna <code>false</code>.</td><td>Boolean</td><td>❌</td><td><code>false</code></td><td>—</td></tr><tr><td><strong>Raw Pass Through</strong></td><td>Quando ativado, retorna a mensagem HL7 original sem alterações em <code>"data"</code>, ignorando totalmente o ciclo de parse e encode: não há normalização de escapes, remoção de campos/componentes vazios no final, nem regeneração do MSH-2. Utilize esta opção quando a mensagem precisar chegar ao destino byte a byte (por exemplo, quando o sistema receptor realiza seu próprio parse). Deixe desativado para o comportamento padrão, que faz o parse e o re-encode da mensagem, um processo de normalização que não garante a preservação byte a byte.</td><td>Boolean</td><td>❌</td><td><code>false</code></td><td>—</td></tr></tbody></table>

{% endtab %}

{% tab title="Documentation" %}

| Parâmetro         | Descrição                                                                                          | Tipo de dado | Suporta DB | Valor padrão |
| ----------------- | -------------------------------------------------------------------------------------------------- | ------------ | ---------- | ------------ |
| **Documentation** | Campo opcional para descrever a configuração do conector e quaisquer regras de negócio relevantes. | String       | ❌          | N/A          |
| {% endtab %}      |                                                                                                    |              |            |              |
| {% endtabs %}     |                                                                                                    |              |            |              |

## **Fluxo de mensagens**

### **Output**

Quando o conector HL7 é executado, ele gera a seguinte estrutura JSON:

```json
{
  "success": true,
  "exitCode": 200
}
```

* `success`: `true` se a operação foi concluída com sucesso, `false` se falhou.
* `exitCode`: código de saída retornado pela operação.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/industry-solutions/hl7.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.