> For the complete documentation index, see [llms.txt](https://docs.voa.health/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.voa.health/integracao/fhir.md).

# FHIR

A Voa oferece uma API FHIR R5 para integração com outros sistemas de saúde.

```
https://api.voa.health/api/v1/fhir/
```

### Autenticação

A API usa SMART on FHIR, com acesso de sistema, de usuário e de paciente. A descoberta fica em:

```
https://api.voa.health/api/v1/fhir/.well-known/smart-configuration
```

### Resumo do paciente

O resumo clínico do paciente pode ser exportado como documento FHIR (`Bundle` com `type=document`), pronto para ser enviado a outro sistema.

### Terminologia

| Operação                                               | Uso                              |
| ------------------------------------------------------ | -------------------------------- |
| `CodeSystem/$lookup`                                   | Consultar um código              |
| `CodeSystem/$validate-code`, `ValueSet/$validate-code` | Validar um código                |
| `ValueSet/$expand`                                     | Listar os códigos de um conjunto |
| `ConceptMap/$translate`                                | Traduzir entre terminologias     |

Inclui as terminologias brasileiras, como os códigos oficiais da RNDS, CID-10, CIAP-2, LOINC e TUSS.

{% hint style="info" %}
O acesso à API FHIR é liberado sob demanda. Solicite em <integration@voahealth.com>.
{% endhint %}
