Manual Passo A Passo

Ministério da Saúde
Secretaria Executiva
Departamento de Informática do SUS
Coordenação de Interoperabilidade
MANUAL DE APOIO PARA SOLICITAÇÃO

DE CREDENCIAIS NO PORTAL DE SERVIÇOS
CNS
Índice
Acesso ao Portal de Serviços...................................................................................................................... 1

1. Solicitação de acesso ao portfólio CNS ............................................................................................... 2
• Passo 1.1 – Selecionar portfólio do serviço ................................................................................ 2
• Passo 1.2 – Solicitar Acesso para Homologação ......................................................................... 4
2. Solicitação de credencial de Integração ............................................................................................. 5
• Passo 2.1 - Realizar o login na conta gov.br ................................................................................ 5
• Passo 2.2 - Informe a origem da solicitação ............................................................................... 7
• Passo 2.3 - Identifique o Estabelecimento Cessionário ............................................................... 7
• Passo 2.4 - Endereço do Estabelecimento .................................................................................. 9
• Passo 2.5 - Identifique os Estabelecimentos Filhos..................................................................... 9
• Passo 2.6 - Indique o gestor responsável.................................................................................. 14
• Passo 2.7 - Identifique o Sistema Solicitante ............................................................................ 15
• Passo 2.8 - Descrição do Sistema Solicitante ............................................................................ 16
• Passo 2.9 - Integração com Outros Sistemas ............................................................................ 17
• Passo 2.10 - Períodos de Maior Acesso no Sistema .................................................................. 18
• Passo 2.11 - Selecionar Portfólio .............................................................................................. 19
• Passo 2.12 - Resumo da Solicitação .......................................................................................... 21
• Passo 2.13 - Termo de Uso ....................................................................................................... 22
3. Acompanhamento da solicitação de credencial ............................................................................... 23
• Passo 3.1 - Menu de Solicitações.............................................................................................. 24
• Passo 3.2 - Menu Gerenciar Credenciais .................................................................................. 25
• Passo 3.3 - Realização dos testes e captação de evidências ..................................................... 28
• Passo 3.4 - Solicitação de credencial de acesso ao ambiente de produção............................... 29
Acesso ao Portal de Serviços
Acesse o Portal de Serviços em: https://servicos-datasus.saude.gov.br/ .
Todos os navegadores são compatíveis, mas recomenda-se o uso do Google Chrome ou

Microsoft Edge (Internet Explorer).
O Portal de Serviços consiste em um catálogo de Web Services e APIs do Ministério da Saúde

(MS) para integração à Rede Nacional de Dados em Saúde – RNDS, dentre outros sistemas do
MS.
1
Manual de Apoio para Solicitações de Credenciais – V2021.10
1. Solicitação de acesso ao portfólio CNS

• Passo 1.1 – Selecionar portfólio do serviço
Selecione no menu principal o portfólio do serviço que deseja realizar a integração.
2
a
c
A página será composta por:

a. Menu lateral de navegação
b. Conteúdo informativo do serviço: contexto, objetivo, requisitos de acesso ao

ambiente de homologação, central de atendimento e acesso à documentação técnica
c. Conteúdo informativo sobre data da ultima atualização do portal, versão, modelo de
consumo e proprietário.
3
• Passo 1.2 – Solicitar Acesso para Homologação
Para prosseguir com a integração, clique no botão Solicitar Acesso para Homologação (a).
4
2. Solicitação de credencial de Integração

• Passo 2.1 - Realizar o login na conta gov.br
Abrirá a tela de autenticação da conta gov.br, maiores informações em Informações de
acesso .
A conta gov.br é um meio de acesso digital do usuário aos serviços públicos digitais. Esta conta
garante a identificação de cada cidadão que acessa os serviços digitais do governo, usando
computador, laptop/notebook ou smartphone.
• Para criar ou acessar sua conta, informe seu CPF no campo “Digite seu CPF” e depois
clique em Continuar.
5
• O usuário será solicitado a aprovar a Autorização de uso de dados pessoais, se de acordo,

clique em Autorizar.
Após realizar o login no gov.br, o usuário deverá autorizar a utilização dos dados cadastrados no
gov.br para acessar o Portal de Serviços.
Após realizar a autorização, é iniciado o fluxo de solicitação de acesso.
6
• Passo 2.2 - Informe a origem da solicitação
a b c
a. Ministério da Saúde: opção para sistemas hospedados dentro da infraestrutura do

Ministério da Saúde.
b. Outros: opção para sistemas de estabelecimentos de saúde públicos ou privados que
necessitem utilizar os serviços do Ministério da Saúde de acesso à RNDS.
c. Prontuário Eletrônico do cidadão / e-SUS APS:
• Passo 2.3 - Identifique o Estabelecimento Cessionário
a b
Em Certificado digital, são apresentadas duas opções válidas de autenticação por meio de
certificado digital ICP-Brasil, escolha uma opção e adicione o arquivo contendo a chave pública
ou privada referente à opção escolhida.
a. Certificado .cer: o usuário pode utilizar a chave pública previamente extraída de um

certificado digital válido. Informações sobre como realizar a extração, consulte o manual
neste link .
7
b. Certificado .pfx: o usuário pode utilizar um certificado digital do tipo A1 da cadeia ICP-
Brasil e então inserir sua chave privada. Esclarecemos que não será armazenada a chave
privada pelo DATASUS, esta será utilizada apenas para extrair a respectiva chave pública.
Após selecionar a opção desejada, clique no botão Validar chave pública, o campo Certificado
digital apresentará a palavra Válido, indicando que o certificado digital foi corretamente
validado.
c d
O usuário deverá inserir o número do CNES ou CNPJ do estabelecimento de Saúde (c) e então
deverá clicar em Consultar (d). Observe que os demais dados, referentes ao CNES informado,
serão preenchidos automaticamente.
ATENÇÃO: Os campos telefone e e-mail (e) estão disponíveis para edição e o usuário
deverá alterar essas informações para que correspondam as mais recentes utilizadas no
Estabelecimento de Saúde.
8
• Passo 2.4 - Endereço do Estabelecimento
O sistema carregará automaticamente todas as informações do estabelecimento identificadas

anteriormente.
• Passo 2.5 - Identifique os Estabelecimentos Filhos
Indicar se o estabelecimento em questão possui Estabelecimentos filhos a serem cadastrados.

Selecione a opção Sim ou Não.
Caso selecione a opção Não, passe para o próximo passo (Passo 2.6).
9
Caso selecione a opção Sim, aparecerá duas opções, Adicionar Estabelecimento Filho(a) ou
Importar CNES Filhos(b).
a b
10
Caso selecione a opção Adicionar Estabelecimento Filho, preencha o campo com respectivo
CNES ou CNPJ, então clique em Consultar (a), e o sistema preencherá os demais campos. Confira
as informações e clique o botão (b) Confirmar.
Caso exista mais de um estabelecimento filho, poderá anexar uma planilha com todos os CNES
filhos e importar de uma só vez. O arquivo deverá estar salvo com a extensão .CSV.
As células da planilha Excel devem estar preenchidas com a escrita CNES (coluna A1) e os
números de CNES (sete dígitos) a partir da cédula A2 para baixo, exatamente como demonstrado
na figura abaixo.
11
Para importar, basta selecionar a opção: Importar CNES filhos (a).
12
Será apresentada uma janela do sistema operacional usado para localizar a planilha de Excel
preenchida.
Então, clique em Abrir e o sistema preencherá os demais CNES inscritos na planilha, conforme o
exemplo abaixo.
13
• Passo 2.6 - Indique o gestor responsável
Preencha o campo CPF ou CNS do Gestor responsável pelo Estabelecimento e clique no botão
Consultar (a), o sistema deverá exibir as demais informações, sendo editáveis apenas os campos
E-mail e Telefone (b).
ATENÇÃO 1: Caso o Gestor responsável pelo Estabelecimento tenha um número atual de CNS,
será apresentado, de forma automática, a nova numeração.
14
ATENÇÃO 2: O Gestor responsável, deverá estar CADASTRADO no CNES do Estabelecimento.
• Passo 2.7 - Identifique o Sistema Solicitante
a b
c 0 d
e 0 f
Informe o sistema que integrará a API do Ministério da Saúde.
Obs.: Caso o Usuário esteja utilizando a opção Prontuário Eletrônico do Cidadão / e-SUS APS,
o sistema preencherá as demais informações automaticamente.
Caso o usuário esteja utilizando um sistema próprio ou adquirido de terceiros, deverá

preencher as informações abaixo manualmente.
(a) Nome: Deve ser informado o nome do sistema.
(b) Versão: Digite a versão utilizada do sistema.
(c) Linguagem: Informe a linguagem de programação predominante do sistema. Ex: Java, C#,
PHP, Etc.
(d) Arquitetura: Informe a arquitetura que o sistema foi desenvolvido. Ex: Rest, Web, Cliente
servidor, Etc.
(e) Banco de dados: Informe qual o banco de dados utilizado pela aplicação. Ex: Oracle,
Postgres,SQL, Etc.
(f) Versão: Informe qual a versão do banco de dados utilizado pela aplicação.
15
• Passo 2.8 - Descrição do Sistema Solicitante
d 00 e
(a) Resumo do Sistema: Descreva resumidamente os aspectos básicos do sistema, escopo e

desenvolvedor do sistema.
(b) O sistema é uma aplicação web?
• Selecione Sim, se o sistema for acessado por uma URL (via navegador de internet).
• Selecione Não, se o sistema é utilizado de forma local (por meio de software instalador).
• Informe a faixa de IP PÚBLICO que utilizará o sistema, insira o endereço IP Inicial (mais
baixo) e o endereço IP Final (mais alto).
ATENÇÃO: Em caso de qualquer consumo atípico do WebService, os usuários com IP’s

privados, inexistentes, e/ou com valores 0.0.0.0 ou 1.1.1.1, serão bloqueados
preventivamente para o consumo dos serviços.
16
(c) Qual tipo de equipe responsável pelo uso do serviço?
• Selecione a opção “Própria”, para equipe pertencente ao quadro de profissionais

contratados diretamente pelo estabelecimento.
• Selecione a opção “Terceirizada”, para equipe contratada por meio de um contrato de
prestação de serviços, os profissionais não possuem vínculo direto com o
estabelecimento.
• Selecione a opção “Outros”, para equipe que presta serviço por outros vínculos de
contratação (ex. Acordo de Cooperação Técnica).
(d) Quantidade de Atendimentos Registrados no Sistema: Informe a quantidade de atendimentos

que o sistema possui registrado.
(e) Data do Atendimento: Indique a data em que a contagem anterior foi realizada.
ATENÇÃO: É importante esclarecer que estas informações subsidiarão a adoção de medidas

de controle de acesso aos dados do serviço e as respostas a incidentes.
• Passo 2.9 - Integração com Outros Sistemas
O usuário deverá informar se o sistema para o qual está sendo solicitado a integração com o
serviço possui integrações com demais sistemas do Ministério da Saúde e assim deverá marcar a
opção sim ou não (a). Caso a opção sim seja escolhida, aparecerá um novo botão Adicionar
integração com outros sistemas (b), e será por meio dele que o usuário deverá preencher as
informações referentes às integrações.
17
• Passo 2.10 - Períodos de Maior Acesso no Sistema
O usuário deverá informar qual o horário que o sistema irá consumir e/ou enviar informações
para a API do serviço solicitado, para isso o usuário devera clicar no botão Adicionar período (a).
a b
Com a nova janela aberta, o usuário deverá escolher a o Período de maior acesso (a); deverá
indicar o período (b); e após isso, deverá clicar em confirmar (c).
18
• Passo 2.11 - Selecionar Portfólio
a b
c d
Selecione todos os serviços que deseja ter acesso e os seus respectivos métodos de
integração (operação).
(a) Mínimo de Atendimentos Previstos/Dia: Informe a quantidade mínima prevista de

atendimentos realizados por dia.
(b) Máximo de Atendimentos Previstos/Dia: Informe a quantidade máxima prevista de

atendimentos realizados por dia.
(c) Quantidade de Acesso em Período de Pico: Informe a quantidade de acessos no período

de pico de utilização do sistema. Nesse campo é ideal que o valor esteja entre o mínimo e o
máximo de atendimentos informados anteriormente.
(d) Informe a Data início e Data fim estimados para utilização dos serviços.
(e) Ao clicar no botão Adicionar todos, será adicionado todos os serviços bem como as
respectivas operações.
19
Caso tenha informado uma operação que não corresponda a sua solicitação, basta clicar no botão
excluir (a), que o serviço será apagado do formulário.
Assim que todos os serviços que deseja estejam adicionados, clique no botão Continuar (b).
20
• Passo 2.12 - Resumo da Solicitação
Nesta etapa o usuário poderá verificar as informações que foram preenchidas nas etapas
anteriores. Ao fazer esse procedimento, clique em Próximo (a).
21
• Passo 2.13 - Termo de Uso
Efetue a leitura do Termo de Uso, clique em Li e aceito (a) e clique no botão Enviar solicitação
(b).
Com isso, o usuário deverá finalizar a solicitação de credencial de acesso ao ambiente de
homologação, e então a solicitação será analisada internamente pelas equipes de gestores e
responsáveis do Ministério da Saúde, para que possa ser efetivada a aprovação.
22
3. Acompanhamento da solicitação de credencial
a
/
A qualquer momento, o usuário poderá consultar o andamento de suas solicitações. Para isso, é
necessário inicialmente estar logado no Portal de Serviços por meio do botão Entrar com o Brasil
Cidadão (a).
Dessa forma, o usuário será redirecionado para o login do gov.br, onde deverá informar seu CPF
ou escolher a forma mais adequada para efetuar o seu login, conforme demonstrado
anteriormente no Passo 1 deste manual.
23
• Passo 3.1 - Menu de Solicitações
b c
Após estar logado no Portal de Serviços, o usuário poderá consultar o status das suas solicitações
enviadas clicando no menu Solicitações (a).
Sendo assim, o usuário pode acompanhar o status das suas solicitações na área Em Análise (b),
o qual indica que a solicitação de credencial enviada pelo usuário está sendo analisada pelas
equipes do Ministério da Saúde.
Após a análise, a solicitação entra na fila do Respostas (c) onde são listadas as solicitações
aprovadas ou negadas.
ATENÇÃO: É importante esclarecer que caso os dados informados estejam em desacordo com
as orientações deste manual, a solicitação de credencial de acesso poderá ser Negada.
24
• Passo 3.2 - Menu Gerenciar Credenciais
Assim que a solicitação é aprovada, será possível verificar a credencial no menu Gerenciar
Credenciais (a).
Para acompanhar de forma detalhada o status da aprovação dos serviços solicitados, clique o
botão (b) para expandir a solicitação.
Após esse procedimento, será possível visualizar com detalhes os serviços solicitados para
homologação conforme o exemplo abaixo.
25
Caso a solicitação seja Negada, será apresentado o botão Visualizar Justificativa (a).
26
Ao clicar no botão Visualizar Justificativa, será apresentada tela com o motivo da rejeição(a).
ATENÇÃO: Caso a solicitação seja para ambiente de homologação e esta vier a ser Negada, o
integrador deverá ajustar as informações e realizar uma nova solicitação de credencial de
acesso. Caso a solicitação seja para ambiente de produção, o integrador poderá atualizar a
mesma solicitação e reenviar para análise.
27
• Passo 3.3 - Realização dos testes e captação de evidências

Após a criação da credencial de homologação, realize os testes da implementação local e
salve como evidência de funcionamento um print de tela deste sistema contendo o
Request (onde deverá estar o Username gerado em homologação) e o Response indicando
o sucesso da consulta, conforme exemplo abaixo.
ATENÇÃO: Utilize Username e Password gerados para seu integrador em homologação!
Com estas evidências, o integrador poderá solicitar acesso ao ambiente de PRODUÇÃO no

portal de serviços.
28
• Passo 3.4 - Solicitação de credencial de acesso ao ambiente de produção

Após obter a aprovação do ambiente de homologação, será possível solicitar acesso ao
ambiente de produção. Para isso, o usuário deve acessar o menu Gerenciar Credenciais,
expandir a solicitação aprovada e, ao final, clicar no botão Solicitar acesso ao Ambiente de
produção (a), conforme a imagem abaixo.
Com isso, irá aparecer uma nova janela, onde o usuário deverá adicionar evidências (arquivos
PDF ou PNG, tamanho máximo de 10 Mb) da realização dos testes de homologação dos serviços.
Para tal, basta clicar no botão Carregar Arquivos (b), conforme a imagem abaixo.
ATENÇÃO: É importante esclarecer que, caso as evidências enviadas não estejam de acordo
com este manual, a solicitação poderá ser Negada.
29
Após realizar esse procedimento, o usuário poderá acompanhar o status dessa solicitação na aba
Em análise para produção (a), conforme a imagem abaixo.
Após a realização de todos os procedimentos e a análise do Ministério da Saúde serem

finalizadas, o usuário receberá um e-mail informando o resultado da análise. Em caso de
aprovação, ele obterá a credencial de acesso ao ambiente de produção. Em caso de resultado de
negativa da credencial, o usuário deverá seguir os passos informados no e-mail para proceder
com os ajustes necessários, e então, solicitar a credencial de produção novamente.
ATENÇÃO: No Portal de Serviços, as páginas de cada serviço respectivamente,

adicionalmente disponibilizam um rol de arquivos para auxiliar os processos de integração
nos ambientes de homologação e produção.
30

Manual Passo A Passo

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual Passo A Passo

Enviado por

Direitos autorais:

Formatos disponíveis

Ministério da Saúde

MANUAL DE APOIO PARA SOLICITAÇÃO

Acesso ao Portal de Serviços...................................................................................................................... 1

Acesso ao Portal de Serviços

Acesse o Portal de Serviços em: https://servicos-datasus.saude.gov.br/ .

Todos os navegadores são compatíveis, mas recomenda-se o uso do Google Chrome ou

O Portal de Serviços consiste em um catálogo de Web Services e APIs do Ministério da Saúde

1. Solicitação de acesso ao portfólio CNS

A página será composta por:

b. Conteúdo informativo do serviço: contexto, objetivo, requisitos de acesso ao

• Passo 1.2 – Solicitar Acesso para Homologação

2. Solicitação de credencial de Integração

• O usuário será solicitado a aprovar a Autorização de uso de dados pessoais, se de acordo,

• Passo 2.2 - Informe a origem da solicitação

a. Ministério da Saúde: opção para sistemas hospedados dentro da infraestrutura do

• Passo 2.3 - Identifique o Estabelecimento Cessionário

a. Certificado .cer: o usuário pode utilizar a chave pública previamente extraída de um

• Passo 2.4 - Endereço do Estabelecimento

O sistema carregará automaticamente todas as informações do estabelecimento identificadas

• Passo 2.5 - Identifique os Estabelecimentos Filhos

Indicar se o estabelecimento em questão possui Estabelecimentos filhos a serem cadastrados.

Para importar, basta selecionar a opção: Importar CNES filhos (a).

• Passo 2.6 - Indique o gestor responsável

ATENÇÃO 2: O Gestor responsável, deverá estar CADASTRADO no CNES do Estabelecimento.

• Passo 2.7 - Identifique o Sistema Solicitante

Informe o sistema que integrará a API do Ministério da Saúde.

Caso o usuário esteja utilizando um sistema próprio ou adquirido de terceiros, deverá

• Passo 2.8 - Descrição do Sistema Solicitante

(a) Resumo do Sistema: Descreva resumidamente os aspectos básicos do sistema, escopo e

ATENÇÃO: Em caso de qualquer consumo atípico do WebService, os usuários com IP’s

(c) Qual tipo de equipe responsável pelo uso do serviço?

• Selecione a opção “Própria”, para equipe pertencente ao quadro de profissionais

(d) Quantidade de Atendimentos Registrados no Sistema: Informe a quantidade de atendimentos

ATENÇÃO: É importante esclarecer que estas informações subsidiarão a adoção de medidas

• Passo 2.9 - Integração com Outros Sistemas

• Passo 2.10 - Períodos de Maior Acesso no Sistema

• Passo 2.11 - Selecionar Portfólio

(a) Mínimo de Atendimentos Previstos/Dia: Informe a quantidade mínima prevista de

(b) Máximo de Atendimentos Previstos/Dia: Informe a quantidade máxima prevista de

(c) Quantidade de Acesso em Período de Pico: Informe a quantidade de acessos no período

• Passo 2.12 - Resumo da Solicitação

• Passo 2.13 - Termo de Uso

3. Acompanhamento da solicitação de credencial

• Passo 3.1 - Menu de Solicitações

• Passo 3.2 - Menu Gerenciar Credenciais

• Passo 3.3 - Realização dos testes e captação de evidências

ATENÇÃO: Utilize Username e Password gerados para seu integrador em homologação!

Com estas evidências, o integrador poderá solicitar acesso ao ambiente de PRODUÇÃO no

• Passo 3.4 - Solicitação de credencial de acesso ao ambiente de produção

Após a realização de todos os procedimentos e a análise do Ministério da Saúde serem

ATENÇÃO: No Portal de Serviços, as páginas de cada serviço respectivamente,

Você também pode gostar