Endpoints

Base URL

https://integration.voa.health/v1

Todos os endpoints RNDS exigem autenticação via token Bearer JWT, da mesma forma que os demais endpoints da API Voa.

Authorization: Bearer <seu_token_jwt>

---

Enviar registro clínico à RNDS

POST /ehrs/{ehr_id}/rnds/submit

Envia os dados clínicos de uma consulta à RNDS no padrão FHIR R4. A Voa monta automaticamente o Bundle FHIR com todos os recursos necessários (Composition, Encounter, Condition, Procedure, MedicationRequest, etc.) a partir dos documentos e dados da consulta.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Description
document_type	string	Tipo do documento RNDS: RAC, RPM, REL (default: RAC)
patient_cpf	string	CPF do paciente (obrigatório)
patient_cns	string	CNS do paciente (opcional, usado quando disponível)
practitioner_cns	string	CNS do profissional de saúde responsável (obrigatório)
cnes	string	Código CNES do estabelecimento (obrigatório na primeira vez, depois é memorizado)

Response

200

{
  "status": "submitted",
  "rnds_record_id": "rnds_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "document_type": "RAC",
  "submitted_at": "2026-02-18T15:00:00Z",
  "ehr_id": "ehr_123456"
}

400

422

---

Consultar status de envio

GET /ehrs/{ehr_id}/rnds/status

Retorna o status do último envio à RNDS para uma consulta específica.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Response

200

{
  "ehr_id": "ehr_123456",
  "rnds_record_id": "rnds_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "accepted",
  "document_type": "RAC",
  "submitted_at": "2026-02-18T15:00:00Z",
  "last_updated_at": "2026-02-18T15:00:02Z"
}

404

Status possíveis

Status	Descrição
pending	Envio em processamento
accepted	Registro aceito pela RNDS
rejected	Registro rejeitado — verifique os detalhes do erro
replaced	Registro foi substituído por uma versão mais recente
deleted	Registro foi excluído da RNDS

---

Substituir registro na RNDS

PUT /ehrs/{ehr_id}/rnds/replace

Substitui um registro previamente enviado à RNDS. Útil quando o profissional faz correções no documento clínico após o envio inicial.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Description
practitioner_cns	string	CNS do profissional responsável pela correção

Response

200

{
  "status": "replaced",
  "rnds_record_id": "rnds_new-uuid-after-replacement",
  "previous_record_id": "rnds_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "replaced_at": "2026-02-18T16:30:00Z"
}

400

---

Excluir registro da RNDS

DELETE /ehrs/{ehr_id}/rnds

Remove um registro previamente enviado à RNDS. Esta ação é irreversível no barramento nacional.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Description
practitioner_cns	string	CNS do profissional que autoriza a exclusão
reason	string	Motivo da exclusão (obrigatório)

Response

200

{
  "status": "deleted",
  "rnds_record_id": "rnds_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "deleted_at": "2026-02-18T17:00:00Z"
}

400

A exclusão de registros na RNDS é uma operação sensível e irreversível. Certifique-se de que a exclusão é realmente necessária antes de executá-la.

---

Consultar paciente na RNDS

GET /rnds/patient

Consulta dados de um paciente no barramento nacional da RNDS.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Query Parameters

Name	Type	Description
cpf	string	CPF do paciente (obrigatório se não informar CNS)
cns	string	CNS do paciente (obrigatório se não informar CPF)

Response

200

{
  "patient": {
    "cpf": "123.456.789-00",
    "cns": "700000000000000",
    "name": "Nome do Paciente",
    "birth_date": "1990-05-15",
    "gender": "female"
  }
}

404

---

Consultar profissional na RNDS

GET /rnds/practitioner

Consulta dados de um profissional de saúde no barramento nacional.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Query Parameters

Name	Type	Description
cns	string	CNS do profissional de saúde (obrigatório)

Response

200

{
  "practitioner": {
    "cns": "700000000000001",
    "name": "Dr. Nome do Profissional",
    "specialty": "Clínica Médica",
    "council": "CRM",
    "council_number": "123456",
    "council_state": "MG"
  }
}

404

---

Rate limits

Os endpoints RNDS seguem os mesmos limites da API Voa:

• 1000 requisições por hora por token

• 10 requisições por segundo por token

O envio à RNDS envolve comunicação com o barramento nacional, o que pode adicionar latência de 2 a 5 segundos na resposta. Recomendamos implementar chamadas assíncronas para não bloquear a experiência do usuário.