# Como funciona

### Fluxo de envio à RNDS <a href="#fluxo-envio" id="fluxo-envio"></a>

Ao finalizar uma consulta na Voa, o registro clínico é automaticamente processado e enviado à RNDS. O fluxo completo funciona da seguinte forma:

1. **Consulta finalizada** — O profissional encerra a consulta e os documentos clínicos são gerados
2. **Transformação FHIR** — Os dados da consulta (diagnósticos, prescrições, procedimentos, encaminhamentos) são convertidos para o padrão FHIR R4, seguindo os perfis brasileiros definidos pela RNDS
3. **Autenticação** — A Voa se autentica com o servidor da RNDS utilizando o certificado digital ICP-Brasil do estabelecimento
4. **Envio** — O documento FHIR é enviado ao barramento nacional da RNDS
5. **Confirmação** — Um identificador único do registro é retornado e armazenado, permitindo rastreabilidade completa

### Dados que são enviados <a href="#dados-enviados" id="dados-enviados"></a>

Para cada consulta, a Voa monta um **Bundle FHIR** contendo os seguintes recursos clínicos:

| Recurso               | Descrição                                       | Perfil RNDS                  |
| --------------------- | ----------------------------------------------- | ---------------------------- |
| **Composition**       | Estrutura principal do documento clínico        | BRRegistroAtendimentoClínico |
| **Encounter**         | Dados do atendimento (tipo, data, duração)      | BRContatoAssistencial        |
| **Patient**           | Identificação do paciente (CPF / CNS)           | BRIndivíduo                  |
| **Practitioner**      | Identificação do profissional de saúde          | BRProfissional               |
| **Organization**      | Estabelecimento de saúde (CNES)                 | BREstabelecimentoSaúde       |
| **Condition**         | Diagnósticos e problemas identificados (CID-10) | BRDiagnósticoAvaliado        |
| **Procedure**         | Procedimentos realizados                        | BRProcedimentoRealizado      |
| **MedicationRequest** | Prescrições médicas                             | BRPrescriçãoMedicamento      |
| **Observation**       | Observações clínicas e sinais vitais            | BRObservação                 |

### Dados que podem ser consultados <a href="#dados-consulta" id="dados-consulta"></a>

Além do envio, a Voa permite consultar dados no barramento nacional:

* **Paciente** — Dados demográficos e identificadores por CPF ou CNS
* **Profissional** — Dados do profissional de saúde por CNS
* **Estabelecimento** — Dados da organização de saúde por CNES

### Autenticação com a RNDS <a href="#autenticacao" id="autenticacao"></a>

A comunicação com a RNDS utiliza um modelo de segurança em duas camadas:

1. **Certificado digital ICP-Brasil** — Utilizado para autenticação mútua (mTLS) com o servidor da RNDS e obtenção de um token de acesso JWT
2. **Token JWT** — Incluído em todas as requisições subsequentes ao barramento FHIR, com validade de 30 minutos

A Voa gerencia automaticamente a renovação de tokens, garantindo que as requisições sejam sempre autenticadas sem intervenção manual.

{% hint style="warning" %}
O certificado digital deve ser do tipo **A1** (arquivo `.pfx` ou `.p12`), emitido por uma Autoridade Certificadora credenciada pela ICP-Brasil. Certificados do tipo A3 (em token físico) não são suportados para integração via API.
{% endhint %}

### Ambientes <a href="#ambientes" id="ambientes"></a>

A RNDS disponibiliza dois ambientes. Durante a ativação da integração, os testes são realizados em homologação antes de migrar para produção:

| Ambiente        | Uso                                 |
| --------------- | ----------------------------------- |
| **Homologação** | Testes e validação de conformidade  |
| **Produção**    | Envio oficial de registros clínicos |

### Conformidade e LGPD <a href="#conformidade" id="conformidade"></a>

* O envio de dados clínicos à RNDS é **amparado por legislação federal**, sendo obrigatório para estabelecimentos habilitados
* Todos os dados transitam via **conexão criptografada** (TLS 1.2+) com autenticação mútua por certificado digital
* A Voa mantém **registros de auditoria** de cada envio, incluindo timestamp, identificador do registro e status de resposta
* O paciente pode acessar seus registros enviados à RNDS pelo aplicativo **Conecte SUS**


---

# 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://docs.voa.health/integracao/rnds/como-funciona.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.