Pular para o conteúdo

Ambientes

A RNDS tem dois ambientes. Nenhum dos dois é aberto, até a homologação inclusive exige credencial. Não existe sandbox público para testar.

Cada ambiente expõe dois endereços distintos: um para obter o token (Auth) e outro para trocar dados (EHR).

AmbienteAuth (obter token)EHR (trocar dados)
Homologação
exige credencial
ehr-auth-hmg.saude.gov.brehr-services.hmg.saude.gov.br
Produção
exige credencial
ehr-auth.saude.gov.br{uf}-ehr-services.saude.gov.brpor UF
  • Homologação. Ambiente nacional e único. Liberado pelo DATASUS após a aprovação da solicitação de acesso feita pelo gestor do estabelecimento no Portal de Serviços. É onde se produzem as evidências de conformidade exigidas para a homologação em produção.
  • Produção. O serviço de autenticação é nacional, mas o endereço de troca de dados (EHR) é por unidade federativa: o padrão é o prefixo da UF em minúsculas, por exemplo `sp-ehr-services.saude.gov.br` para São Paulo e `mg-ehr-services.saude.gov.br` para Minas Gerais.

Conferido em 26/08/2026.

O serviço de autenticação é nacional e único, mas o endereço de troca de dados em produção é por unidade federativa. O padrão é o prefixo da UF em minúsculas:

sp-ehr-services.saude.gov.br # São Paulo
mg-ehr-services.saude.gov.br # Minas Gerais
ba-ehr-services.saude.gov.br # Bahia

Se o seu sistema atende estabelecimentos em mais de um estado, isso precisa ser configuração, não constante. Vale desenhar assim desde o começo - trocar depois costuma implicar mexer em todas as chamadas.

Em homologação não existe essa divisão: o ambiente é nacional e único, o que significa que a topologia que você testa não é a que vai rodar em produção. Vale ter isso em mente ao planejar o teste de aceite.

A relação oficial de ambientes está em rnds-guia.saude.gov.br/docs/rnds/ambientes.