Integração com a RNDS

Para garantir a interoperabilidade entre as aplicações de Saúde Digital, em especial Prontuário(s) Eletrônico(s) do Paciente (PEP), portais e aplicações (web e mobile), a troca de informações ocorre por meio de serviços (web services) RESTful, desenvolvidos de acordo com o padrão FHIR R4.

Identificadores do Registro Enviado a RNDS

Vale ressaltar que os registros são documentos computacionais, em formato JSON, compostos por perfis (profiles) do padrão FHIR R4. Cada registro enviado à RNDS possui dois identificadores:

• Identificador atribuído pelo sistema de origem: também chamado de identificador local, é o ID criado pelo sistema de origem para identificar univocamente o registro em sua base.

  No arquivo JSON, o identificador local deve ser informado no profile Bundle, propriedade identifier.value.

  "identifier": {
                  "system": "http://www.saude.gov.br/fhir/r4/NamingSystem/BRRNDS-1111",
                  "value": "3112009-06246116057"
              }

  Em "system"", deve-se completar a URI http://www.saude.gov.br/fhir/r4/NamingSystem/BRRNDS- com o número do identificador do solicitante (ver Identificador solicitante / NamingSystem).

• Identificador atribuído pela RNDS: também denominado de ID RNDS. Quando o registro é enviado com sucesso (header de resposta 201) à RNDS, no header location é gerada uma URL que é o identificador do registro na RNDS (ver Exemplos de consumo dos serviços).

  IMPORTANTE: os softwares integradores DEVEM SALVAR o identificador local e o ID RNDS para que possam realizar ações futuras como: pesquisa, substituição (ver Substituição de registro na RNDS) e exclusão.

Ambientes de Integração

Seguindo as boas práticas serão disponibilizados dois ambientes para a integração: homologação e produção.

Ambiente de Homologação

O ambiente de homologação tem como finalidade validar a integração, seus parâmetros de entradas, saídas e comportamentos negociais, permitindo a realização de testes antes da efetiva comunicação com o ambiente de produção. O ambiente de homologação é único, ou seja, todos os interessados em realizar o consumo dos serviços (web services) utilizarão o mesmo ambiente. Porém, mesmo usando o mesmo ambiente, as informações trafegadas (incluídas ou consultadas) estarão restritas aos estabelecimentos de saúde (CNES) elencados na etapa de credenciamento. Os endereços dos componentes de integração, no ambiente de homologação, são:

• Utilizado para obtenção do token em ambiente de homologação:

  https://ehr-auth-hmg.saude.gov.br/api/

• Utilizado para comunicação com demais serviços do ambiente de Homologação:

  https://ehr-services.hmg.saude.gov.br/api/

Evidências da Homologação

A partir dos testes realizados e da implementação local, serão aceitas como evidências dos testes em homologação um arquivo com:

• 1 print do validador com sucesso;
• 1 print do header de resposta de criação do registro na RNDS;
• 1 print do Bundle enviado.

Com essas evidências, o solicitante pode solicitar acesso ao ambiente de produção no Portal de Serviços.

Ambiente de Produção

O ambiente de produção é o ambiente estável e real que provê os serviços (web services) a serem consumidos. Para o ambiente produtivo, os integradores deverão acessar os endereços dos seus estados (UF). Durante o credenciamento, a credencial de acesso (Certificado Digital) será associada a um estabelecimento de saúde (CNES) (ou conjunto de estabelecimentos de saúde) no Portal de Serviços do DATASUS. Com isso, a credencial de acesso pertencerá a um estado (UF) específico. Acessos a estados diferentes não são permitidos e serão bloqueados automaticamente pelos serviços (web services). Os endereços dos componentes de integração, no ambiente de produção, por estado, são:

Estado	Endpoint
Acre	https://ac-ehr-services.saude.gov.br/api/
Alagoas	https://al-ehr-services.saude.gov.br/api/
Amapá	https://ap-ehr-services.saude.gov.br/api/
Amazonas	https://am-ehr-services.saude.gov.br/api/
Bahia	https://ba-ehr-services.saude.gov.br/api/
Ceará	https://ce-ehr-services.saude.gov.br/api/
Distrito Federal	https://df-ehr-services.saude.gov.br/api/
Espírito Santo	https://es-ehr-services.saude.gov.br/api/
Goiás	https://go-ehr-services.saude.gov.br/api/
Maranhão	https://ma-ehr-services.saude.gov.br/api/
Mato Grosso	https://mt-ehr-services.saude.gov.br/api/
Mato Grosso do Sul	https://ms-ehr-services.saude.gov.br/api/
Minas Gerais	https://mg-ehr-services.saude.gov.br/api/
Pará	https://pa-ehr-services.saude.gov.br/api/
Paraíba	https://pb-ehr-services.saude.gov.br/api/
Paraná	https://pr-ehr-services.saude.gov.br/api/
Pernambuco	https://pe-ehr-services.saude.gov.br/api/
Piauí	https://pi-ehr-services.saude.gov.br/api/
Rio de Janeiro	https://rj-ehr-services.saude.gov.br/api/
Rio Grande do Norte	https://rn-ehr-services.saude.gov.br/api/
Rio Grande do Sul	https://rs-ehr-services.saude.gov.br/api/
Rondônia	https://ro-ehr-services.saude.gov.br/api/
Roraima	https://rr-ehr-services.saude.gov.br/api/
Santa Catarina	https://sc-ehr-services.saude.gov.br/api/
São Paulo	https://sp-ehr-services.saude.gov.br/api/
Sergipe	https://se-ehr-services.saude.gov.br/api/
Tocantins	https://to-ehr-services.saude.gov.br/api/