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).
| Ambiente | Auth (obter token) | EHR (trocar dados) |
|---|---|---|
| Homologação exige credencial | ehr-auth-hmg.saude.gov.br | ehr-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 detalhe que pega: produção é por UF
Seção intitulada “O detalhe que pega: produção é por UF”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 Paulomg-ehr-services.saude.gov.br # Minas Geraisba-ehr-services.saude.gov.br # BahiaSe 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.