Especificacao Tecnica para Integracao Com o Cadastro Nacional de Estabelecimentos de Sade v1-20

Departamento de Informtica do SUS - DATASUS
ESPECIFICAO TCNICA PARA

INTEGRAO COM O CNES
Verso 2.0
Arquivo: Especificao Tcnica para Integrao com o CNES.

Classificao da Informao: Comum, No Monitorada, No Crtica.
Impresso por: DATASUS
Cpia controlada nmero:
Sumrio
1. Objetivo ........................................................................................................ 1
2. Atores........................................................................................................... 1
3. Descrio do Processo .............................................................................. 1
4. Instalao e uso prtico da ferramenta de testes. ................................... 1
5. Integrao por Servio. .............................................................................. 8
5.1.
Elementos comuns usados nas mensagens SOAP ............................ 8
5.1.1.
Segurana ........................................................................................... 8
5.1.2.
Paginao............................................................................................ 8
5.2.
Servios .................................................................................................. 9
5.2.1.
EstabelecimentoSaudeService .......................................................... 9
5.2.1.1.
Operao: consultarEstabelecimentoSaude ................................ 9
5.2.1.2.
Operao: consultarPreCadastroCNES ...................................... 16
5.2.1.3.
Operao: localizarEstabelecimentoSaude ................................ 22
5.2.2.
VinculacaoProfissionalService ....................................................... 29
5.2.2.1.
Operao: detalharVinculacaoProfissionalSaude ..................... 29
5.2.2.2.
Operao: pesquisarVinculacaoProfissionalSaude .................. 34
5.2.3.
ProfissionalSaudeService................................................................ 39
5.2.3.1.
Operao: consultarProfissionaisSaude .................................... 39
5.2.3.2.
Operao: consultarProfissionalSaude ...................................... 44
5.2.4.
5.2.4.1.
5.2.5.
5.2.5.1.
5.2.6.
LeitoService ...................................................................................... 49
Operao: consultarLeitosCnes .................................................. 49
EquipamentoService ........................................................................ 51
Operao: consultarEquipamentos............................................. 51
CnesService ...................................................................................... 53
5.2.6.1.
Operao: consultarEstabelecimentoSaude .............................. 53
5.2.6.2.
Operao: consultarEstabelecimentoSaudePorMunicipio ....... 54
5.2.6.3.
Operao:
consultarDadosComplementaresEstabelecimentoSaude ........................... 55
Arquivo: Especificao Tcnica para Integrao com o CNES.

Classificao da Informao: Comum, No Monitorada, No Crtica.
Impresso por: DATASUS
Cpia controlada nmero:
Ministrio da Sade
DATASUS
1. Objetivo
Este documento tem por objetivo detalhar de forma tcnica como ser realizada a integrao de outros
sistemas ao CNES atravs dos servios disponibilizados. Sero descritos o processo completo, bem como
suas regras, interfaces e a especificao da integrao com WebService...
2. Atores
Esto definidos dois atores no processo de integrao, a saber:
Sistema de Origem Qualquer sistema que tiver autorizao para consumir as informaes do
CNES via WebServices.
Webservice CNES Servio disponibilizado para os sistemas que precisam consumir
informaes da base nacional do cadastro de estabelecimentos de sade.
3. Descrio do Processo
A integrao por servio ser realizada a partir de Web Service disponvel no barramento de servios. A
partir do consumo do servio ser possvel recuperar as informaes desejadas.
Para o consumo das informaes devem ser observados os seguintes critrios:
Ao realizar uma requisio ao WebService deve ser informado no Cabealho da mensagem o usurio e
senha para autenticao. Essa credencial do CNES pblica e disponibilizada neste tutorial.
Aps leitura deste tutorial, a rea tcnica a quem se destina este documento pode de imediato comear os
testes em homologao.
4. Instalao e uso prtico da ferramenta de testes.

1.
Instalao do Software SOAPUI

Para fazer o download do software SOAPUI clique no link abaixo:
http://www.soapui.org/downloads/soapui.html
Aps a instalao, ser criado um cone de acesso semelhante a este:
Clique duas vezes no cone para abrir o aplicativo.
Ser mostrada a tela inicial conforme mostra a figura 1 abaixo:
Arquivo: Especificao Tcnica para Integrao com o CNES

Classificao da Informao: Comum, No Monitorada, No Crtica
Ministrio da Sade
DATASUS
Figura 1: Tela inicial do Software SOAPUI.
2.
Criar Projeto SOAP

O segundo passo ser criar um projeto do tipo SOAP, que a tecnologia utilizada pelo servio do
CNES.
No menu principal clique em File -> New Soap Project conforme mostra a figura 2 abaixo:
Figura 2: Criar Projeto SOAP.
Ser aberta uma janela, conforme mostra a figura 3, para informar a URL do Webservice
(WSDL).

Ministrio da Sade
DATASUS
Figura 3: Inserir URL WSDL.

3.
Acessando o servio VinculacaoProfissionalService

Neste momento o usurio informar a WSDL do servio no qual precisa que o aplicativo SOAPUI gere
a estrutura necessria para acessar os servios disponveis.
Utilizaremos o exemplo do servio VinculacaoProfissionalService neste tutorial.
3.1. Gerando a Estrutura

Insira no campo Initial WSDL a WSDL de homologao do servio
VinculacaoProfissionalService e clique no boto OK:
http://servicoshm.saude.gov/cnes/VinculacaoProfissionalService/v1r0?wsdl
Figura 4: WSDL VinculacaoProfissionalService Ambiente de Homologao
O aplicativo ir acessar e carregar todos os servios disponveis que o WSDL disponibiliza. Ser
apresentada uma tela de carregamento conforme mostra a figura 5.

Ministrio da Sade
DATASUS
Figura 5: Carregando informaes do Servio.
Uma vez que o aplicativo carregou corretamente as informaes contidas no WSDL, ser
mostrada uma lista de servios disponveis conforme mostra a figura.
Figura 6: Lista de servios de acordo com o WSDL informado.
3.2. Acessando o Servio
Voc deve ter reparado que a ferramenta criou 2 VinculacaoProfissionalService.

Um chamado VinculacaoProfissionalServiceSOAP11Binding e o outro
VinculacaoProfissionalServiceSOAP12Binding.
Isso significa que o servio do CNES aceita tanto a verso do SOAP 1.1 quanto a verso 1.2.
Neste tutorial, utilizaremos a verso 1.2 do SOAP.
Para simular uma requisio ao servio de pesquisarVinculacaoProfissionalSaude, basta clicar
no sinal de [+] ao lado do servio e ser exibido uma requisio padro (Request) proveniente do
WSDL conforme mostra a figura 7.

Ministrio da Sade
DATASUS
Figura 7: Acessando a requisio do servio pesquisarVinculacaoProfissionalSaude.
Daremos um nome amigvel nossa requisio, para que possamos identificar melhor que tipo
de parmetros vamos enviar ao servio em questo. Clique com o boto direito do mouse em
cima da requisio (Request) e selecione a opo Rename conforme mostra a figura 8.
Figura 8: Selecione Rename.
Digite um nome amigvel, como por exemplo: PesquisarPorCpf e clique em OK.

Ministrio da Sade
DATASUS
Figura 9: Digite um nome amigvel.
Pronto! Agora vamos fazer uma simulao ao servio de

PesquisarVinculacaoProfissionalSaude.
D um duplo clique em cima da requisio (PesquisarPorCpf) para visualizar o XML que gerado
pela ferramenta SOAPUI conforme mostra a figura 10.
Figura 10: XML padro da requisio.

O CNES disponibiliza um arquivo de XML de exemplo de requisio para cada servio
disponibilizado.
Para este tutorial utilizaremos o arquivo de exemplo de requisio
request_pesquisar_vinculacao.xml.
Baixe o pacote de arquivos de exemplos de requisio do CNES e abra o arquivo indicado acima.
Substitua o contedo do XML gerado pelo SOAPUI pelo contedo do arquivo.

Ministrio da Sade
DATASUS
Figura 11: Substituindo o contedo.
Agora basta clicar no cone

da ferramenta SOAPUI para enviar a requisio (Request),
conforme mostra a figura 12.
A requisio ser enviada at o servio e ele retornar uma resposta (response).
Figura 12: XML padro da resposta (response).
Dessa forma, finalizamos o teste de integrao com o webService.

Para realizar novos testes, com diferentes servios do CNES, basta criar um novo projeto soap
com a WSDL do servio desejado, baixar o arquivo XML de exemplo de requisio do servio
correspondente e seguir os passos informados nesse tutorial.

Ministrio da Sade
DATASUS
5. Integrao por Servio.

A integrao por servio ser realizada a partir de Web Service disponvel no barramento de servios. A
partir do consumo do servio ser possvel recuperar e manter informaes do CNES.
5.1. Elementos comuns usados nas mensagens SOAP
5.1.1. Segurana
Para todas as operaes de todos os servios do CNES necessrio informar a credencial de
acesso utilizando o Header na mensagem SOAP.
Exemplo de Header na mensagem SOAP:

<soap:Header>
<wsse:Security soap:mustUnderstand="true" xmlns:wsse="http://docs.oasisopen.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility1.0.xsd">
<wsse:UsernameToken wsu:Id="UsernameToken-5FCA58BED9F27C406E14576381084652">
<wsse:Username>CNES.PUBLICO</wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wssusername-token-profile-1.0#PasswordText">cnes#2015public</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
</soap:Header>
5.1.2. Paginao
Para a maioria das operaes no portflio de servios do CNES, necessrio informar como
deve ser o comportamento da paginao em uma consulta. O objetivo da paginao limitar a
quantidade de dados retornados para aperfeioar a experincia do sistema cliente na
performance e tempo de respostas dos servios.
Cada pgina retornada em uma consulta somente poder conter 20 registros.
Exemplo de Paginao na mensagem SOAP (Request):

<proc:Paginacao>
<pag:registroInicial>11</pag:registroInicial>
<pag:quantidadeRegistros>10</pag:quantidadeRegistros>
</proc:Paginacao>
Exemplo de Paginao na mensagem SOAP (Response):

<proc:Paginacao>
<pag:registroInicial>11</pag:registroInicial>
<pag:quantidadeRegistros>10</pag:quantidadeRegistros>
<pag:totalRegistros>15474</pag:totalRegistros>
</proc:Paginacao>

Ministrio da Sade
DATASUS
5.2. Servios
Abaixo esto detalhados os servios que tratam do fluxo de negcio necessrios para manter todos
os dados relacionados ao CNES.
5.2.1. EstabelecimentoSaudeService
Objetivo: EstabelecimentoSaudeService tem a inteno de prover acesso a informaes dos

Estabelecimentos de Sade (Posto de sade, servio de urgncia, academia da sade,
hospital, maternidade, centro de parto normal, farmcia popular, CAPS e Centro de
especialidade.). Este documento uma complementao da especificao do servio
Estabelecimento de Sade Service.
Contrato WSDL:
o
Ambiente de Homologao:
URL:
https://servicoshm.saude.gov.br/cnes/EstabelecimentoSaudeService/v1r0?wsdl
Ambiente de Produo:
URL:
https://servicos.saude.gov.br/cnes/EstabelecimentoSaudeService/v1r0?wsdl
5.2.1.1. Operao: consultarEstabelecimentoSaude

o
Objetivo: Recuperar os Estabelecimentos de Sade cadastrados no CNES.
Arquivo de exemplo de requisio: Request_Consultar_Estabelecimento.xml
Corpo da mensagem de requisio:
NDICE
1
2
3
4
5
6
7
8
9
10
11
12
TAGS
<soap:Body>
<est:requestConsultarEstabelecimentoSaude>
<fil:FiltroPesquisaEstabelecimentoSaude>
<cod:CodigoCNES>
<cod:codigo>?</cod:codigo>
</cod:CodigoCNES>
<cnpj:CNPJ>
<cnpj:numeroCNPJ>?</cnpj:numeroCNPJ>
</cnpj:CNPJ>
</fil:FiltroPesquisaEstabelecimentoSaude>
</est:requestConsultarEstabelecimentoSaude>
</soap:Body>
Descrio do corpo da mensagem de requisio:
IDX
1
CAMPO
DESCRIO DA TAG
Incio do corpo da mensagem

TIPO TAM
Ministrio da Sade
DATASUS
2
3
4
5
6
7
8
9
10
11
12
Incio de elemento
Incio de elemento
Incio de elemento
Cdigo
CNES
CNPJ
Cdigo CNES utilizado para consulta

Fim de elemento
Incio de elemento
Nmero CNPJ utilizado para consulta
Fim de elemento
Fim de elemento
Fim de elemento
Fim do corpo da mensagem
Texto
Texto
15
Corpo da mensagem de retorno:
NDICE
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
TAGS
<soap:Body>
<est:responseConsultarEstabelecimentoSaude>
<dad:DadosGeraisEstabelecimentoSaude>
<cod:CodigoCNES>
</cod:CodigoCNES>
<cod1:CodigoUnidade>
<cod1:codigo>?</cod1:codigo>
</cod1:CodigoUnidade>
<dad:nomeFantasia>
<nom:Nome>?</nom:Nome>
</dad:nomeFantasia>
<dad:nomeEmpresarial>
</dad:nomeEmpresarial>
<cnpj:CNPJ>
</cnpj:CNPJ>
<end:Endereco>
<end:identificador>?</end:identificador>
<end:TipoEndereco>?</end:TipoEndereco>
<end:TipoLogradouro>
<tip:codigoTipoLogradouro>?</tip:codigoTipoLogradouro>
<tip:descricaoTipoLogradouro>?</tip:descricaoTipoLogradouro>
</end:TipoLogradouro>
<end:nomeLogradouro>?</end:nomeLogradouro>
<end:numero>?</end:numero>

10
Ministrio da Sade
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
DATASUS
<end:complemento>?</end:complemento>
<end:Bairro>
<bair:codigoBairro>?</bair:codigoBairro>
<bair:descricaoBairro>?</bair:descricaoBairro>
</end:Bairro>
<end:CEP>
<cep:numeroCEP>?</cep:numeroCEP>
</end:CEP>
<end:Municipio>
<mun:codigoMunicipio>?</mun:codigoMunicipio>
<mun:nomeMunicipio>?</mun:nomeMunicipio>
<mun:UF>
<uf:codigoUF>?</uf:codigoUF>
<uf:siglaUF>?</uf:siglaUF>
<uf:codigoRegiao>?</uf:codigoRegiao>
<uf:nomeUF>?</uf:nomeUF>
</mun:UF>
</end:Municipio>
<end:Pais>
<pais:codigoPais>?</pais:codigoPais>
<pais:codigoPaisAntigo>?</pais:codigoPaisAntigo>
<pais:nomePais>?</pais:nomePais>
</end:Pais>
<end:municipioInternacional>?</end:municipioInternacional>
</end:Endereco>
<dad:dataAtualizacao>?</dad:dataAtualizacao>
<dir:Diretor>
<dir:CPF>
<cpf:numeroCPF>?</cpf:numeroCPF>
</dir:CPF>
<dir:nome>
<nom1:Nome>?</nom1:Nome>
</dir:nome>
</dir:Diretor>
<tip1:tipoUnidade>
<tip1:codigo>?</tip1:codigo>
<tip1:descricao>?</tip1:descricao>
</tip1:tipoUnidade>
<esf:esferaAdministrativa>
<esf:codigo>?</esf:codigo>
<esf:descricao>?</esf:descricao>
</esf:esferaAdministrativa>
<dad:MunicipioGestor>

11
Ministrio da Sade
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
DATASUS
<mun:UF>
</mun:UF>
</dad:MunicipioGestor>
<dad:Telefone>
<tel:identificador>?</tel:identificador>
<tel:TipoTelefone>
<tip2:codigoTipoTelefone>?</tip2:codigoTipoTelefone>
<tip2:descricaoTipoTelefone>?</tip2:descricaoTipoTelefone>
</tel:TipoTelefone>
<tel:DDI>?</tel:DDI>
<tel:DDD>?</tel:DDD>
<tel:numeroTelefone>?</tel:numeroTelefone>
</dad:Telefone>
<dad:Email>
<ema:identificador>?</ema:identificador>
<ema:descricaoEmail>?</ema:descricaoEmail>
<ema:tipoEmail>?</ema:tipoEmail>
<ema:validado>?</ema:validado>
</dad:Email>
<dad:Localizacao>
<loc:longitude>?</loc:longitude>
<loc:latitude>?</loc:latitude>
<loc:geoJson>?</loc:geoJson>
</dad:Localizacao>
<dad:perteceSistemaSUS>?</dad:perteceSistemaSUS>
</dad:DadosGeraisEstabelecimentoSaude>
</est:responseConsultarEstabelecimentoSaude>
</soap:Body>
Descrio do corpo da mensagem de retorno:
IDX
1
2
3
4
5
6
CAMPO
Cdigo CNES
DESCRIO DA TAG
Incio de elemento
Incio de elemento
Incio de elemento
Cdigo do Estabelecimento de Sade
Fim de elemento

TIPO
TAM
Numrico
12
Ministrio da Sade
DATASUS
7
8
Incio de elemento
Cdigo
Unidade
Sade
9
10
11
Nome
Fantasia
12
13
14
Nome
Empresarial
15
16
17
18
19
CNPJ
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
Cdigo da Unidade de Sade no CNES

Fim de elemento
Incio de elemento
Nome de Fantasia do
Estabelecimento
Fim de elemento
Incio de elemento
Nome Empresarial da Unidade de
Sade (Razo Social)
Fim de elemento
Incio de elemento
CNPJ do estabelecimento
Fim de elemento
Incio de elemento
Cdigo
Identificao Cdigo de identificao do endereo
Endereo
Tipo Endereo Cdigo do tipo do endereo
Incio de elemento
Tipo
Cdigo do tipo do logradouro
Logradouro
Descrio Tipo
Descrio do tipo de logradouro
Logradouro
Fim de elemento
Nome
Nome do logradouro
Logradouro
Nmero
Nmero do logradouro
Logradouro
Complemento
Complemento do logradouro
Logradouro
Incio de elemento
Cdigo Bairro Cdigo do bairro
Descrio
Descrio do bairro
Bairro
Fim de elemento
Incio de elemento
Cep
Cep do endereo
Fim de elemento
Incio de elemento
Cdigo
Cdigo do municpio do endereo
Municpio
Nome
Nome do municpio do endereo
Municpio
Incio de elemento

Numrico
31
Texto
150
Texto
255
Numrico
14
Numrico
Numrico
Numrico
Texto
60
Texto
255
Texto
20
Texto
50
Numrico
Texto
255
Numrico
Numrico
Texto
60
13
Ministrio da Sade
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
DATASUS
Cdigo UF
Sigla UF
Cdigo Regio
Nome UF
Cdigo Pas
Cdigo Pas
Antigo
Nome Pas
Cdigo da UF
Sigla da UF
Cdigo da regio (macrorregio)
Nome da UF
Fim de elemento
Fim de elemento
Incio de elemento
Cdigo do pas (SAI e SIH)
Texto
Texto
Texto
Texto
2
2
4
60
Numrico
Cdigo do pas antigo
Numrico
Texto
60
Texto
70
Nome do pas
Fim de elemento
Municpio
Nome do municpio internacional
Internacional
Fim de elemento
Data
Data de atualizao
Atualizao
Incio de elemento
Incio de elemento
CPF Diretor CPF do Diretor
Fim de elemento
Incio de elemento
Nome Diretor Nome do Diretor
Fim de elemento
Fim de elemento
Incio de elemento
Cdigo Tipo
Cdigo do tipo da unidade de sade
Unidade
Descrio Tipo Descrio do tipo da unidade de
Unidade
sade
Fim de elemento
Incio de elemento
Cdigo Esfera
Cdigo da esfera administrativa
Administrativa
Descrio
Esfera
Descrio da esfera administrativa
Administrativa
Fim de elemento
Incio de elemento
Cdigo
Municpio
Cdigo do municpio gestor
Gestor
Descrio
Municpio
Descrio do municpio gestor
Gestor
Incio de elemento
Cdigo UF
Cdigo da UF Gestor

Data
Numrico
Texto
60
14
Ministrio da Sade
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
DATASUS
Gestor
Sigla UF
Gestor
Cdigo Regio
Gestor
Nome UF
Gestor
Sigla da UF Gestor
Gestor
Nome da UF Gestor
Fim de elemento
Fim de elemento
Incio de elemento
Cdigo
Identificador Cdigo Identificador do Telefone
Telefone
Incio de elemento
Cdigo Tipo
Cdigo do tipo de telefone
Telefone
Descrio Tipo
Descrio do tipo de telefone
Telefone
Fim de elemento
DDI
DDI
DDD
DDD
Nmero
Nmero do telefone
Telefone
Fim de elemento
Incio de elemento
Identificador
Cdigo identificador do email
Email
Descrio
Endereo do email
Email
Tipo Email Tipo do email
Validado
Email validado
Fim de elemento
Incio de elemento
Longitude
Longitude
Latitude
Latitude
Geo Json
Geo Json
Fim de elemento
Pertence
Pertence Sistema SUS
Sistema SUS
Fim de elemento
Fim de elemento

Numrico
Numrico
Texto
Numrico
Texto
100
Texto
Booleano
Texto
Texto
9
9
15
Ministrio da Sade
DATASUS
5.2.1.2. Operao: consultarPreCadastroCNES

o
Objetivo: Recuperar os Estabelecimentos de Sade pr cadastrados no CNES.
Arquivo de exemplo de requisio: Request_Consultar_Pre_Cadastro.xml
NDICE
1
2
3
4
5
6
7
8
9
10
o
TAGS
<soap:Body>
<est:requestConsultarPrecadastroCNES>
<fil:FiltroPesquisaPrecadastroCnes>
<cod:CodigoCNES>
</cod:CodigoCNES>
<fil:situacao>?</fil:situacao>
</fil:FiltroPesquisaPrecadastroCnes>
</est:requestConsultarPrecadastroCNES>
</soap:Body>
IDX
1
2
3
4
5
CAMPO
Cdigo
CNES
6
7
8
9
10
o
Situao
DESCRIO DA TAG
Incio de elemento
Incio de elemento
Incio de elemento
TIPO
TAM
Cdigo CNES utilizado para consulta
Texto
Fim de elemento
Situao do Pr Cadastro: [A=ATIVO,
Domnio
D=DESATIVADO, E=EXCLUIDO]
Fim de elemento
Fim de elemento
NDICE
1
2
3
4
5
6
7
8
9
TAGS
<soap:Body>
<est:responseConsultarPrecadastroCNES>
<dad:DadosPreCadastroCNES>
<cod:CodigoCNES>
</cod:CodigoCNES>
<cpf:CPF>
</cpf:CPF>

16
Ministrio da Sade
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
DATASUS
<cnpj:CNPJ>
</cnpj:CNPJ>
<dad:NomeFantasia>
</dad:NomeFantasia>
<dad:NomeEmpresarial>
</dad:NomeEmpresarial>
<dad:NaturezaJuridica>
<nat:codigoNaturezaJuridica>?</nat:codigoNaturezaJuridica>
<nat:descricaoNaturezaJuridica>?</nat:descricaoNaturezaJuridica>
<nat:codigoNaturezaJuridicaConcla>?</nat:codigoNaturezaJuridicaConcla>
<nat:tipoNaturezaJuridica>
<tip:codigo>?</tip:codigo>
<tip:descricao>?</tip:descricao>
</nat:tipoNaturezaJuridica>
</dad:NaturezaJuridica>
<dad:CNPJMantenedora>
</dad:CNPJMantenedora>
<dad:NaturezaJuridicaMantenedora>
<nat:codigoNaturezaJuridica>?</nat:codigoNaturezaJuridica>
<nat:descricaoNaturezaJuridica>?</nat:descricaoNaturezaJuridica>
<nat:codigoNaturezaJuridicaConcla>?</nat:codigoNaturezaJuridicaConcla>
<nat:tipoNaturezaJuridica>
</nat:tipoNaturezaJuridica>
</dad:NaturezaJuridicaMantenedora>
<dad:DataAtualizacao>?</dad:DataAtualizacao>
<end:Endereco>
<tip1:codigoTipoLogradouro>?</tip1:codigoTipoLogradouro>
<tip1:descricaoTipoLogradouro>?</tip1:descricaoTipoLogradouro>
<end:Bairro>

17
Ministrio da Sade
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
DATASUS
</end:Bairro>
<end:CEP>
</end:CEP>
<end:Municipio>
<mun:UF>
</mun:UF>
</end:Municipio>
<end:Pais>
</end:Pais>
</end:Endereco>
<dad:Telefones>
<tel:TipoTelefone>
</tel:TipoTelefone>
</dad:Telefones>
<ema:Email>
</ema:Email>
</dad:DadosPreCadastroCNES>
</est:responseConsultarPrecadastroCNES>
</soap:Body>

18
Ministrio da Sade
o
DATASUS
IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
CAMPO
DESCRIO DA TAG
Inicio do corpo da mensagem
Inicio de elemento
Inicio de elemento
Inicio de elemento
Cdigo CNES Cdigo do Estabelecimento de Sade
Fim de elemento
Inicio de elemento
CPF
Nmero do CPF do estabelecimento
Fim de elemento
Inicio de elemento
CNPJ
Fim de elemento
Inicio de elemento
Nome
Nome de Fantasia do Estabelecimento
Fantasia
Fim de elemento
Inicio de elemento
Nome
Nome Empresarial da Unidade de Sade
Empresarial (Razo Social)
Fim de elemento
Inicio de elemento
Cdigo
Natureza
Cdigo da Natureza Jurdica
Jurdica
Descrio
Natureza
Descrio da natureza jurdica
Jurdica
Natureza
Jurdica
Cdigo da natureza jurdica CONCLA
CONCLA
Inicio de elemento
Tipo Natureza
Cdigo do tipo da natureza jurdica
Jurdica
Descrio
Descrio do tipo da natureza jurdica
Tipo Natureza
Fim de elemento
Fim de elemento
Inicio de elemento
CNPJ
Nmero CNPJ da mantenedora
Mantenedora
Fim de elemento
Inicio de elemento
Cdigo
Cdigo da natureza jurdica da
Natureza
mantenedora

TIPO
TAM
Numrico
Texto
11
Numrico
14
Texto
150
Texto
255
Texto
Texto
80
Texto
Texto
Texto
100
Texto
14
Texto
19
Ministrio da Sade
33
34
DATASUS
Mantenedora
Descrio
Natureza
Mantenedora
Cdigo
CONCLA
Mantenedora
35
Tipo Natureza
36
Mantenedora
Descrio
37 Tipo Natureza
Mantenedora
38
39
Data
40
Atualizao
41
Cdigo
42 Identificao
Endereo
Tipo
43
Endereo
44
Tipo
45
Logradouro
Descrio
46
Tipo
Logradouro
47
Nome
48
Logradouro
Nmero
49
Logradouro
Complemento
50
Logradouro
51
52 Cdigo Bairro
Descrio
53
Bairro
54
55
56
Cep
57
58
Cdigo
59
Municpio
60
Nome
Descrio da natureza jurdica da

mantenedora
Texto
100
Cdigo da natureza jurdica CONCLA da

mantenedora
Texto
Texto
Texto
100
Inicio de elemento
Cdigo do tipo de natureza jurdica da
mantenedora
Descrio do tipo de natureza jurdica da
mantenedora
Fim de elemento
Fim de elemento
Data de atualizao
Data
Inicio de elemento
Cdigo de identificao do endereo
Numrico
Cdigo do tipo do endereo
Numrico
Numrico
Texto
60
Nome do logradouro
Texto
255
Nmero do logradouro
Texto
20
Texto
50
Inicio de elemento
Cdigo do bairro
Numrico
Descrio do bairro
Texto
255
Fim de elemento
Inicio de elemento
Cep do endereo
Fim de elemento
Inicio de elemento
Numrico
Numrico
Texto
60
Inicio de elemento
Fim de elemento

20
Ministrio da Sade
DATASUS
Municpio
61
62
Cdigo UF
63
Sigla UF
64 Cdigo Regio
65
Nome UF
66
67
68
69 Cdigo Pas
Cdigo Pas
70
Antigo
71
Nome Pas
72
Municpio
73
Internacional
74
75
Cdigo
76 Identificador
Telefone
77
Cdigo Tipo
78
Telefone
Descrio
79
Tipo Telefone
80
81
DDI
82
DDD
Nmero
83
Telefone
84
85
Identificador
86
Email
Descrio
87
Email
88
Tipo Email
89
Validado
90
91
92
93
Inicio de elemento
Cdigo da UF
Sigla da UF
Nome da UF
Fim de elemento
Fim de elemento
Inicio de elemento
Texto
Texto
Texto
Texto
2
2
4
60
Numrico
Cdigo do pas antigo
Numrico
Nome do pas
Fim de elemento
Texto
60
Texto
70
Numrico
Numrico
Texto
Numrico
Texto
100
Texto
Booleano
Fim de elemento
Inicio de elemento
Cdigo Identificador do Telefone
Inicio de elemento
Fim de elemento
DDI
DDD
Nmero do telefone
Fim de elemento
Inicio de elemento
Endereo do email
Tipo do email
Email validado
Fim de elemento
Fim de elemento
Fim de elemento

21
Ministrio da Sade
DATASUS
5.2.1.3. Operao: localizarEstabelecimentoSaude

o
Objetivo: Possibilitar a busca e apresentao de estabelecimentos de sade prximos

localizao do usurio. Informaes de identificao, endereo, telefone, tipo, distncia
do usurio e mdia de avaliaes do servio de sade. O servio dever permitir o uso
de dispositivos mveis.
Arquivo de exemplo de requisio: Request_Localizar_Estabelecimento.xml
NDICE
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
o
TAGS
<soap:Body>
<est:requestLocalizarEstabelecimentoSaude>
<fil:FiltroLocalizacaoEstabelecimentoSaude>
<loc:Localizacao>
</loc:Localizacao>
<tip:tipoUnidade>
</tip:tipoUnidade>
<pag:Paginacao>
<pag:posicaoRegistroInicio>?</pag:posicaoRegistroInicio>
<pag:quantidadeRegistrosPorPagina>?</pag:quantidadeRegistrosPorPagina>
<pag:quantidadeRegistros>?</pag:quantidadeRegistros>
</pag:Paginacao>
</fil:FiltroLocalizacaoEstabelecimentoSaude>
</est:requestLocalizarEstabelecimentoSaude>
</soap:Body>
IDX
1
2
3
4
5
6
7
8
9
10
11
CAMPO
Longitude
Latitude
Geo Json
DESCRIO DA TAG
Inicio do corpo da mensagem
Inicio de elemento
Inicio de elemento
Inicio de elemento
Longitude utilizada para consulta
Latitude utilizada para consulta
TIPO
Numrico
TAM
Texto
Texto
9
9
Fim de elemento
Inicio de elemento
Cdigo Tipo
Unidade
Descrio

22
Ministrio da Sade
DATASUS
Tipo
Unidade
12
13
14
15
16
17
18
19
20
Fim de elemento
Inicio de elemento
Posio
Registro
Posio inicial do registro na paginao
Incio
Quantidade
Registros Quantidade de registros por pgina
Pgina
Quantidade
Quantidade total de registros
Registros
Fim de elemento
Fim de elemento
Fim de elemento
Numrico
Numrico
Numrico
NDICE
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
TAGS
<soap:Body>
<est:responseLocalizarEstabelecimentoSaude>
<res:ResultadosLocalizacaoEstabelecimentoSaude>
<res1:ResultadoLocalizacaoEstabelecimentoSaude>
<res1:EstabelecimentoSaude>
<cod:CodigoCNES>
</cod:CodigoCNES>
<cod1:CodigoUnidade>
<cod1:codigo>?</cod1:codigo>
</cod1:CodigoUnidade>
<dad:nomeFantasia>
</dad:nomeFantasia>
<dad:nomeEmpresarial>
</dad:nomeEmpresarial>
<cnpj:CNPJ>
</cnpj:CNPJ>
<end:Endereco>

23
Ministrio da Sade
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
DATASUS
<end:Bairro>
</end:Bairro>
<end:CEP>
</end:CEP>
<end:Municipio>
<mun:UF>
</mun:UF>
</end:Municipio>
<end:Pais>
</end:Pais>
</end:Endereco>
<dad:dataAtualizacao>?</dad:dataAtualizacao>
<dir:Diretor>
<dir:CPF>
</dir:CPF>
<dir:nome>
</dir:nome>
</dir:Diretor>
<tip1:tipoUnidade>
<tip1:codigo>?</tip1:codigo>
<tip1:descricao>?</tip1:descricao>
</tip1:tipoUnidade>
<esf:esferaAdministrativa>

24
Ministrio da Sade
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
DATASUS
<esf:codigo>?</esf:codigo>
<esf:descricao>?</esf:descricao>
</esf:esferaAdministrativa>
<dad:MunicipioGestor>
<mun:UF>
</mun:UF>
</dad:MunicipioGestor>
<dad:Telefone>
<tel:TipoTelefone>
</tel:TipoTelefone>
</dad:Telefone>
<dad:Email>
</dad:Email>
<dad:Localizacao>
</dad:Localizacao>
<dad:perteceSistemaSUS>?</dad:perteceSistemaSUS>
</res1:EstabelecimentoSaude>
</res1:ResultadoLocalizacaoEstabelecimentoSaude>
<pag:Paginacao>
<pag:posicaoRegistroInicio>?</pag:posicaoRegistroInicio>
<pag:quantidadeRegistrosPorPagina>?</pag:quantidadeRegistrosPorPagina>
</pag:Paginacao>
</res:ResultadosLocalizacaoEstabelecimentoSaude>
</est:responseLocalizarEstabelecimentoSaude>

25
Ministrio da Sade
113
DATASUS
</soap:Body>
IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
CAMPO
DESCRIO DA TAG
Incio de elemento
Incio de elemento
Incio de elemento
Incio de elemento
Incio de elemento
Cdigo do Estabelecimento de
Cdigo CNES
Sade
Fim de elemento
Incio de elemento
Cdigo
Cdigo da Unidade de Sade no
Unidade Sade CNES
Fim de elemento
Incio de elemento
Nome de Fantasia do
Nome Fantasia
Estabelecimento
Fim de elemento
Incio de elemento
Nome
Nome Empresarial da Unidade de
Empresarial Sade (Razo Social)
Fim de elemento
Incio de elemento
CNPJ
Fim de elemento
Incio de elemento
Cdigo
Cdigo de identificao do
Identificao
endereo
Endereo
Tipo Endereo Cdigo do tipo do endereo
Incio de elemento
Tipo
Logradouro
Descrio Tipo
Logradouro
Fim de elemento
Nome
Nome do logradouro
Logradouro
Nmero
Nmero do logradouro
Logradouro
Complemento Complemento do logradouro

TIPO
TAM
Numrico
Numrico
31
Texto
150
Texto
255
Numrico
14
Numrico
Numrico
Numrico
Texto
60
Texto
255
Texto
20
Texto
50
26
Ministrio da Sade
DATASUS
Logradouro
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
Cdigo Bairro
Descrio
Bairro
Cep
Cdigo
Municpio
Nome
Municpio
Incio de elemento
Cdigo do bairro
Numrico
Descrio do bairro
Texto
255
Fim de elemento
Incio de elemento
Cep do endereo
Fim de elemento
Incio de elemento
Numrico
Numrico
Texto
60
Texto
Texto
Texto
Texto
2
2
4
60
Numrico
Numrico
Texto
60
Texto
70
Incio de elemento
Cdigo UF
Cdigo da UF
Sigla UF
Sigla da UF
Cdigo Regio Cdigo da regio (macrorregio)
Nome UF
Nome da UF
Fim de elemento
Fim de elemento
Incio de elemento
Cdigo Pas
Cdigo Pas
Cdigo do pas antigo
Antigo
Nome Pas
Nome do pas
Fim de elemento
Municpio
Internacional
Fim de elemento
Data
Data de atualizao
Atualizao
Incio de elemento
Incio de elemento
CPF Diretor
CPF do Diretor
Fim de elemento
Incio de elemento
Nome Diretor Nome do Diretor
Fim de elemento
Fim de elemento
Incio de elemento
Cdigo Tipo
Cdigo do tipo da unidade de sade
Unidade
Descrio Tipo Descrio do tipo da unidade de
Unidade
sade
Fim de elemento

Data
27
Ministrio da Sade
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
DATASUS
Incio de elemento
Cdigo Esfera
Cdigo da esfera administrativa
Administrativa
Descrio
Esfera
Descrio da esfera administrativa
Administrativa
Fim de elemento
Incio de elemento
Cdigo
Municpio
Cdigo do municpio gestor
Gestor
Descrio
Municpio
Descrio do municpio gestor
Gestor
Incio de elemento
Cdigo UF
Cdigo da UF Gestor
Gestor
Sigla UF Gestor Sigla da UF Gestor
Cdigo Regio Cdigo da regio (macrorregio)
Gestor
Gestor
Nome UF
Nome da UF Gestor
Gestor
Fim de elemento
Fim de elemento
Incio de elemento
Cdigo
Identificador Cdigo Identificador do Telefone
Telefone
Incio de elemento
Cdigo Tipo
Telefone
Descrio Tipo
Telefone
Fim de elemento
DDI
DDI
DDD
DDD
Nmero
Nmero do telefone
Telefone
Fim de elemento
Incio de elemento
Identificador
Email
Descrio Email Endereo do email
Tipo Email
Tipo do email
Validado
Email validado
Fim de elemento
Incio de elemento

Numrico
Texto
60
Numrico
Numrico
Texto
Numrico
Texto
Texto
Booleano
100
1
28
Ministrio da Sade
DATASUS
99
100
101
102
Longitude
Latitude
Geo Json
Pertence
Sistema SUS
103
104
105
106
Longitude
Latitude
Geo Json
Fim de elemento
Pertence Sistema SUS
Fim de elemento
Fim de elemento
Incio de elemento
Posio
Posio inicial do registro na
Registro Incio paginao
Quantidade
Registros
Quantidade de registros por pgina
Pgina
Quantidade
Registros
Fim de elemento
Fim de elemento
Fim de elemento
107
108
109
110
111
112
113
Numrico
Numrico
Numrico
5.2.2. VinculacaoProfissionalService
Objetivo: VinculacaoProfissionalService tem a inteno de fornecer informaes sobre o

vnculo do profissional de sade com o estabelecimento de sade. Vnculo empregatcio,
autnomo, cooperativa, residncia, estgio, bolsa, intermediado e informal so tipos de
vinculaes existentes. O servio permitir a busca de quais profissionais esto vinculados a
cada estabelecimento de sade, dos estabelecimentos que o profissional realiza
atendimentos e de qual a ocupao e carga horria de cada profissional em cada vnculo,
dentre outras informaes.
Contrato WSDL:
o
URL:
https://servicoshm.saude.gov.br/cnes/VinculacaoProfissionalService/v1r0?wsdl
Ambiente de Produo:
URL:
https://servicos.saude.gov.br/cnes/VinculacaoProfissionalService/v1r0?wsdl
5.2.2.1. Operao: detalharVinculacaoProfissionalSaude

o
Objetivo: Detalhar os vnculos do profissional com o Estabelecimento de Sade.
Arquivo de exemplo de requisio: Request_Detalhar_Vinculacao.xml
NDICE
TAGS
29
Ministrio da Sade
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
DATASUS
<soap:Body>
<vin:RequestVinculacao>
<fil:FiltroPesquisaVinculacao>
<fil:IdentificacaoProfissional>
<fil:cpf>
</fil:cpf>
<fil:cns>
<cns:numeroCNS>?</cns:numeroCNS>
</fil:cns>
</fil:IdentificacaoProfissional>
<fil:IdentificacaoEstabelecimento>
<fil:cnes>
</fil:cnes>
<fil:cnpj>
</fil:cnpj>
</fil:IdentificacaoEstabelecimento>
<fil:IdentificacaoVinculacao>
<fil:tipoVinculacao>?</fil:tipoVinculacao>
</fil:IdentificacaoVinculacao>
</fil:FiltroPesquisaVinculacao>
</vin:RequestVinculacao>
</soap:Body>
IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
CAMPO
CPF
CNS
CNES
DESCRIO DA TAG
Incio de elemento
Incio de elemento
Incio de elemento
Incio de elemento
Nmero do CPF do profissional
Fim de elemento
Incio de elemento
Nmero do CNS do profissional
Fim de elemento
Fim de elemento
Incio de elemento
Incio de elemento
Cdigo CNES do estabelecimento

TIPO TAM
Texto
11
Texto
15
Texto
30
Ministrio da Sade
15
16
17
18
19
20
21
22
23
24
25
DATASUS
CNPJ
Cdigo
Vinculao
Fim de elemento
Incio de elemento
Fim de elemento
Fim de elemento
Incio de elemento
Cdigo identificador da vinculao do
profissional com o estabelecimento
Fim de elemento
Fim de elemento
Fim de elemento
Texto
14
Texto
IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
TAGS
<soap:Body>
<vin:ResponseVinculacao>
<vin1:Vinculacaos>
<vin1:Vinculacao>
<vin1:Profissional>
<dad:Nome>
</dad:Nome>
<dad:CPF>
</dad:CPF>
<dad:CNS>
<cns:dataAtribuicao>?</cns:dataAtribuicao>
<cns:tipoCartao>?</cns:tipoCartao>
<cns:manual>?</cns:manual>
<cns:justificativaManual>?</cns:justificativaManual>
</dad:CNS>
</vin1:Profissional>
<vin1:Estabelecimento>
<cod:CodigoCNES>
</cod:CodigoCNES>
<dad1:NomeFantasia>
</dad1:NomeFantasia>
</vin1:Estabelecimento>

31
Ministrio da Sade
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
o
DATASUS
<vin1:indVinculacao>?</vin1:indVinculacao>
<vin1:codigoModVinculo>?</vin1:codigoModVinculo>
<vin1:desCodigoModVinculo>?</vin1:desCodigoModVinculo>
<vin1:codigoTipoModVinculo>?</vin1:codigoTipoModVinculo>
<vin1:desTipoCodigoModVinculo>?</vin1:desTipoCodigoModVinculo>
<vin1:codigoSubTipoModVinculo>?</vin1:codigoSubTipoModVinculo>
<vin1:desSubTipoCodigoModVinculo>?</vin1:desSubTipoCodigoModVinculo>
<vin1:CBOs>
<vin2:CBO>
<vin2:codigoCBO>?</vin2:codigoCBO>
<vin2:descricaoCBO>?</vin2:descricaoCBO>
<vin2:qtCargaHorariaAmbulatotial>?</vin2:qtCargaHorariaAmbulatotial>
<vin2:qtCargaHorariaOutros>?</vin2:qtCargaHorariaOutros>
<vin2:qtCargaHorariaHospSus>?</vin2:qtCargaHorariaHospSus>
<vin2:comptInicio>?</vin2:comptInicio>
<vin2:comptFin>?</vin2:comptFin>
</vin2:CBO>
</vin1:CBOs>
</vin1:Vinculacao>
</vin1:Vinculacaos>
</vin:ResponseVinculacao>
</soap:Body>
IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
CAMPO
DESCRIO DA TAG
Incio de elemento
Incio de elemento
Incio de elemento
Incio de elemento
Incio de elemento
Nome
Nome do Profissional de Sade
Profissional
Fim de elemento
Incio de elemento
CPF
CPF do Profissional de Sade
Fim de elemento
Incio de elemento
CNS
Cns do Profissional
Data
Data de Atribuio do Carto
Atribuio
Tipo do Carto: [P=Provisrio,
Tipo Carto
D=Definitivo]
Identifica se o carto foi adicionado
Manual
manualmente

TIPO
TAM
Texto
150
Texto
15
Texto
15
Data
Domnio
Booleano
32
Ministrio da Sade
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
DATASUS
Justificativa Justificativa para a adio do carto

Manual
manual
Fim de elemento
Fim de elemento
Incio de elemento
Incio de elemento
CNES
Fim de elemento
Incio de elemento
Nome
Nome de fantasia do estabelecimento
Fantasia
Fim de elemento
Fim de elemento
Cdigo
Cdigo identificador da vinculao
Vinculao
Cdigo
Modalidade Cdigo da modalidade do vnculo
Vnculo
Descrio
Modalidade Descrio da modalidade do vnculo
Vnculo
Cdigo Tipo
Cdigo do tipo da modalidade do
Modalidade
vnculo
Vnculo
Descrio
Tipo
Descrio do tipo da modalidade do
Modalidade vnculo
Vnculo
Cdigo
Subtipo
Cdigo do subtipo da modalidade do
Modalidade vnculo
Vnculo
Descrio
Subtipo
Descrio do subtipo da modalidade
Modalidade do vnculo
Vnculo
Incio de elemento
Incio de elemento
Cdigo CBO Cdigo identificador do CBO
Descrio
Descrio do CBO
CBO
Carga Horria Carga horrio ambulatorial do
Ambulatorial profissional no estabelecimento
Carga Horria Carga horrio de outros tipos do
Outros
profissional no estabelecimento
Carga Horria
Carga horria hospital SUS
Hospital SUS
Incio do
Data de incio do vinculo
Vnculo

Texto
200
Texto
Texto
150
Texto
Texto
Texto
100
Texto
Texto
100
Texto
Texto
100
33
Ministrio da Sade
43
DATASUS
Fim do
Vnculo
44
45
46
47
48
49
Data de trmino do vnculo

Fim de elemento
Fim de elemento
Fim de elemento
Fim de elemento
Fim de elemento
5.2.2.2. Operao: pesquisarVinculacaoProfissionalSaude

o
Objetivo: Pesquisar as informaes do vnculo do profissional com o Estabelecimento

de Sade.
Arquivo de exemplo de requisio: Request_Pesquisar_Vinculacao.xml
IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
TAGS
<soap:Body>
<vin:RequestVinculacaos>
<fil:FiltroPesquisaVinculacaos>
<fil:IdentificacaoProfissional>
<fil:cpf>
</fil:cpf>
<fil:cns>
</fil:cns>
</fil:IdentificacaoProfissional>
<fil:IdentificacaoEstabelecimento>
<fil:cnes>
</fil:cnes>
<fil:cnpj>
</fil:cnpj>
</fil:IdentificacaoEstabelecimento>
</fil:FiltroPesquisaVinculacaos>
<Paginacao>
<pag:registroInicial>?</pag:registroInicial>
<pag:totalRegistros>?</pag:totalRegistros>
</Paginacao>
</vin:RequestVinculacaos>

34
Ministrio da Sade
DATASUS
27
IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
</soap:Body>
CAMPO
CPF
CNS
CNES
CNPJ
DESCRIO DA TAG
Incio de elemento
Incio de elemento
Incio de elemento
Incio de elemento
Nmero do CPF do profissional
Fim de elemento
Incio de elemento
Nmero do CNS do profissional
Fim de elemento
Fim de elemento
Incio de elemento
Incio de elemento
Fim de elemento
Incio de elemento
Fim de elemento
Fim de elemento
Fim de elemento
Incio de elemento
Posio
Registro
Incio
Quantidade
Pgina
Quantidade
Registros
Fim de elemento
Fim de elemento
TIPO
TAM
Texto
11
Texto
15
Texto
Texto
14
Numrico
Numrico
Numrico
IDX
TAGS
35
Ministrio da Sade
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
DATASUS
<soap:Body>
<vin:ResponseVinculacaos>
<vin1:Vinculacaos>
<vin1:Vinculacao>
<vin1:Profissional>
<dad:Nome>
</dad:Nome>
<dad:CPF>
</dad:CPF>
<dad:CNS>
</dad:CNS>
</vin1:Profissional>
<vin1:Estabelecimento>
<cod:CodigoCNES>
</cod:CodigoCNES>
<dad1:NomeFantasia>
</dad1:NomeFantasia>
</vin1:Estabelecimento>
<vin1:indVinculacao>?</vin1:indVinculacao>
<vin1:codigoModVinculo>?</vin1:codigoModVinculo>
<vin1:desCodigoModVinculo>?</vin1:desCodigoModVinculo>
<vin1:codigoTipoModVinculo>?</vin1:codigoTipoModVinculo>
<vin1:desTipoCodigoModVinculo>?</vin1:desTipoCodigoModVinculo>
<vin1:codigoSubTipoModVinculo>?</vin1:codigoSubTipoModVinculo>
<vin1:desSubTipoCodigoModVinculo>?</vin1:desSubTipoCodigoModVinculo>
<vin1:CBOs>
<vin2:CBO>
<vin2:codigoCBO>?</vin2:codigoCBO>
<vin2:descricaoCBO>?</vin2:descricaoCBO>
<vin2:qtCargaHorariaAmbulatotial>?</vin2:qtCargaHorariaAmbulatotial>
<vin2:qtCargaHorariaOutros>?</vin2:qtCargaHorariaOutros>
<vin2:qtCargaHorariaHospSus>?</vin2:qtCargaHorariaHospSus>
<vin2:comptInicio>?</vin2:comptInicio>
<vin2:comptFin>?</vin2:comptFin>
</vin2:CBO>

36
Ministrio da Sade
45
46
47
48
49
50
51
52
53
54
DATASUS
</vin1:CBOs>
</vin1:Vinculacao>
</vin1:Vinculacaos>
<Paginacao>
<pag:registroInicial>?</pag:registroInicial>
<pag:totalRegistros>?</pag:totalRegistros>
</Paginacao>
</vin:ResponseVinculacaos>
</soap:Body>
IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
CAMPO
DESCRIO DA TAG
Incio de elemento
Incio de elemento
Incio de elemento
Incio de elemento
Incio de elemento
Nome
Nome do Profissional de Sade
Profissional
Fim de elemento
Incio de elemento
CPF
Fim de elemento
Incio de elemento
CNS
Cns do Profissional
Data
Atribuio
Tipo Carto
D=Definitivo]
Manual
manualmente
Manual manual
Fim de elemento
Fim de elemento
Incio de elemento
Incio de elemento
CNES
Fim de elemento
Incio de elemento
Nome

TIPO
TAM
Texto
150
Texto
15
Texto
15
Data
Domnio
Booleano
Texto
200
Texto
Texto
150
37
Ministrio da Sade
DATASUS
Fantasia
26
27
28
29
30
31
32
33
34
Fim de elemento
Fim de elemento
Cdigo
Vinculao
Cdigo
Modalidade
Vnculo
Descrio
Modalidade
Vnculo
Cdigo Tipo
Modalidade
Vnculo
Descrio
Tipo
Modalidade
Vnculo
Cdigo
Subtipo
Modalidade
Vnculo
Descrio
Subtipo
Modalidade
Vnculo
35
36
37 Cdigo CBO
Descrio
38
CBO
Carga
39
Horria
Ambulatorial
Carga
40
Horria
Outros
Carga
41
Horria
Hospital SUS
Incio do
42
Vnculo
Fim do
43
Vnculo
44
45
46
47
48
Cdigo identificador da vinculao
Texto
Cdigo da modalidade do vnculo
Texto
Descrio da modalidade do vnculo
Texto
100
Cdigo do tipo da modalidade do

vnculo
Texto
Descrio do tipo da modalidade do

vnculo
Texto
100
Cdigo do subtipo da modalidade do

vnculo
Texto
Descrio do subtipo da modalidade do

vnculo
Texto
100
Incio de elemento
Incio de elemento
Cdigo identificador do CBO
Descrio do CBO
Carga horrio ambulatorial do
Carga horrio de outros tipos do
Carga horria hospital SUS
Data de incio do vinculo
Data de trmino do vnculo
Fim de elemento
Fim de elemento
Fim de elemento
Fim de elemento
Incio de elemento

38
Ministrio da Sade
DATASUS
Posio
Registro
Incio
Quantidade
Pgina
Quantidade
Registros
Fim de elemento
Fim de elemento
49
50
51
52
53
54
Numrico
Numrico
Numrico
5.2.3. ProfissionalSaudeService
Objetivo: ProfissionalSaudeService tem a inteno de fornecer informaes sobre os

profissionais cadastrados no CNES.
Contrato WSDL:
o
URL:
https://servicoshm.saude.gov.br/cnes/ProfissionalSaudeService/v1r0?wsdl
Ambiente de Produo:
URL: https://servicos.saude.gov.br/cnes/ProfissionalSaudeService/v1r0?wsdl
5.2.3.1. Operao: consultarProfissionaisSaude
Objetivo: Retornar uma lista de profissionais por estabelecimento.
Arquivo de exemplo de requisio: Request_Consultar_Profissionais.xml
IDX
1
2
3
4
5
6
7
8
9
10
11
12
TAGS
<soap:Body>
<prof:requestConsultarProfissionaisSaude>
<fil:FiltroPesquisaEstabelecimentoSaude>
<cod:CodigoCNES>
</cod:CodigoCNES>
<cnpj:CNPJ>
</cnpj:CNPJ>
</fil:FiltroPesquisaEstabelecimentoSaude>
</prof:requestConsultarProfissionaisSaude>
</soap:Body>

39
Ministrio da Sade
IDX
1
2
3
4
5
6
7
8
9
10
11
12
DATASUS
CAMPO
CNES
CNPJ
DESCRIO DA TAG
Incio de elemento
Incio de elemento
Incio de elemento
Nmero CNES do estabelecimento
Fim de elemento
Incio de elemento
Nmero CNPJ do estabelecimento
Fim de elemento
Fim de elemento
Fim de elemento
TIPO
TAM
Texto
Texto
14
IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
TAGS
<soap:Body>
<prof:responseConsultarProfissionaisSaude>
<prof1:ProfissionalSaude>
<prof1:dataAtualizacao>?</prof1:dataAtualizacao>
<prof1:Nome>
</prof1:Nome>
<prof1:CNS>
</prof1:CNS>
<prof1:CPF>
</prof1:CPF>
<prof1:CBO>
<cbo:codigoCBO>?</cbo:codigoCBO>
<cbo:descricaoCBO>?</cbo:descricaoCBO>

40
Ministrio da Sade
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
DATASUS
</prof1:CBO>
<prof1:CNES>
<cod:CodigoCNES>
</cod:CodigoCNES>
<dad:NomeFantasia>
</dad:NomeFantasia>
</prof1:CNES>
<prof1:Email>
</prof1:Email>
<prof1:Endereco>
<end:Bairro>
</end:Bairro>
<end:CEP>
</end:CEP>
<end:Municipio>
<mun:UF>
</mun:UF>
</end:Municipio>
<end:Pais>

41
Ministrio da Sade
65
66
67
68
69
70
71
72
DATASUS
</end:Pais>
</prof1:Endereco>
</prof1:ProfissionalSaude>
</prof:responseConsultarProfissionaisSaude>
</soap:Body>
IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
CAMPO
Data
Atualizao
Nome
CNS
Data
Atribuio
DESCRIO DA TAG
Incio de elemento
Incio de elemento
TIPO
Data de atualizao do registro
Data
TAM
Incio de elemento
Nome do Profissional
Incio de elemento
Incio de elemento
Cns do Profissional
Texto
255
Texto
15
Data

D=Definitivo]
Manual
manualmente
Manual
manual
Fim de elemento
Incio de elemento
CPF
Cpf do profissional
Fim de elemento
Incio de elemento
Cdigo CBO Cdigo do CBO do profissional
Descrio
Descrio do CBO do profissional
CBO
Fim de elemento
Incio de elemento
Incio de elemento
CNES
Cdigo do estabelecimento de sade
Fim de elemento
Incio de elemento
Tipo Carto

Domnio
Booleano
Texto
200
Texto
11
Numrico
Texto
150
Numrico
42
Ministrio da Sade
27
DATASUS
Nome
Fantasia
28
29
30
31
32
33
34
35
36
Identificador
Email
Descrio
Email
Tipo Email
Validado

de sade
Fim de elemento
Fim de elemento
Incio de elemento
Texto
255
Numrico
Endereo do email
Texto
100
Tipo do email
Email validado
Fim de elemento
Incio de elemento
Texto
Booleano
Identificador
Identificador do endereo
Endereo
38 Tipo Endereo Tipo do Endereo
39
Incio de elemento
Tipo
40
Cdigo do Tipo do logradouro
Logradouro
Descrio Tipo
41
Descrio do tipo do logradouro
Logradouro
42
Fim de elemento
Nome
43
Nome do logradouro
Logradouro
Nmero
44
Nmero do logradouro
Logradouro
Complemento
45
Logradouro
46
Incio de elemento
47 Cdigo Bairro Cdigo do Bairro
Descrio
48
Descrio do bairro
Bairro
49
Fim de elemento
50
Incio de elemento
51
CEP
CEP
52
Fim de elemento
53
Incio de elemento
Cdigo
54
Cdigo do municpio
Municpio
Nome
55
Nome do Municpio
Municpio
56
Incio de elemento
57
Cdigo UF Cdigo da UF
58
Sigla UF
Sigla da UF
59 Cdigo Regio Cdigo da regio (macrorregio)
60
Nome UF
Nome da UF
61
Fim de elemento
37

Numrico
Texto
Texto
Texto
60
Texto
255
Texto
20
Texto
50
Numrico
Texto
255
Numrico
Numrico
Texto
60
Texto
Texto
Texto
Texto
2
2
4
60
43
Ministrio da Sade
DATASUS
62
63
64
Cdigo Pas
Cdigo Pas
Antigo
Nome Pas
65
66
67
68
69
70
71
72
Fim de elemento
Incio de elemento
Numrico
Cdigo do pas antigo
Numrico
Texto
60
Texto
70
Nome do pas
Fim de elemento
Municpio
Internacional
Fim de elemento
Fim de elemento
Fim de elemento
5.2.3.2. Operao: consultarProfissionalSaude
Objetivo: Retornar dados de um nico profissional de sade
Arquivo de exemplo de requisio: Request_Consultar_Profissional.xml
IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
TAGS
<soap:Body>
<prof:requestConsultarProfissionalSaude>
<fil:FiltroPesquisaProfissionalSaude>
<cns:CNS>
</cns:CNS>
<cpf:CPF>
</cpf:CPF>
</fil:FiltroPesquisaProfissionalSaude>
</prof:requestConsultarProfissionalSaude>
</soap:Body>
IDX
CAMPO
DESCRIO DA TAG

TA
M
TIPO
44
Ministrio da Sade
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
DATASUS

Incio de elemento
Incio de elemento
Incio de elemento
Cns do Profissional
CNS
Data
Atribuio
Tipo Carto
D=Definitivo]
Manual
manualmente
Manual manual
Fim de elemento
Incio de elemento
CPF
Fim de elemento
Fim de elemento
Fim de elemento
Texto
15
Data
Domnio
Booleano
Texto
200
Texto
15
IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
TAGS
<soap:Body>
<prof:responseConsultarProfissionaisSaude>
<prof1:ProfissionalSaude>
<prof1:dataAtualizacao>?</prof1:dataAtualizacao>
<prof1:Nome>
</prof1:Nome>
<prof1:CNS>
</prof1:CNS>
<prof1:CPF>
</prof1:CPF>
<prof1:CBO>
<cbo:codigoCBO>?</cbo:codigoCBO>
<cbo:descricaoCBO>?</cbo:descricaoCBO>

45
Ministrio da Sade
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
DATASUS
</prof1:CBO>
<prof1:CNES>
<cod:CodigoCNES>
</cod:CodigoCNES>
<dad:NomeFantasia>
</dad:NomeFantasia>
</prof1:CNES>
<prof1:Email>
</prof1:Email>
<prof1:Endereco>
<end:Bairro>
</end:Bairro>
<end:CEP>
</end:CEP>
<end:Municipio>
<mun:UF>
</mun:UF>
</end:Municipio>
<end:Pais>

46
Ministrio da Sade
65
66
67
68
69
70
71
72
DATASUS
</end:Pais>
</prof1:Endereco>
</prof1:ProfissionalSaude>
</prof:responseConsultarProfissionaisSaude>
</soap:Body>
IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
CAMPO
Data
Atualizao
Nome
CNS
Data
Atribuio
DESCRIO DA TAG
Incio de elemento
Incio de elemento
TIPO
Data
TAM
Incio de elemento
Nome do Profissional
Incio de elemento
Incio de elemento
Cns do Profissional
Texto
255
Texto
15
Data

D=Definitivo]
Manual
manualmente
Manual
manual
Fim de elemento
Incio de elemento
CPF
Cpf do profissional
Fim de elemento
Incio de elemento
Cdigo CBO Cdigo do CBO do profissional
Descrio
Descrio do CBO do profissional
CBO
Fim de elemento
Incio de elemento
Incio de elemento
CNES
Cdigo do estabelecimento de sade
Fim de elemento
Incio de elemento
Tipo Carto

Domnio
Booleano
Texto
200
Texto
11
Numrico
Texto
150
Numrico
47
Ministrio da Sade
27
DATASUS
Nome
Fantasia
28
29
30
31
32
33
34
35
36
Identificador
Email
Descrio
Email
Tipo Email
Validado

de sade
Fim de elemento
Fim de elemento
Incio de elemento
Texto
255
Numrico
Endereo do email
Texto
100
Tipo do email
Email validado
Fim de elemento
Incio de elemento
Texto
Booleano
Identificador
Identificador do endereo
Endereo
38 Tipo Endereo Tipo do Endereo
39
Incio de elemento
Tipo
40
Cdigo do Tipo do logradouro
Logradouro
Descrio Tipo
41
Descrio do tipo do logradouro
Logradouro
42
Fim de elemento
Nome
43
Nome do logradouro
Logradouro
Nmero
44
Nmero do logradouro
Logradouro
Complemento
45
Logradouro
46
Incio de elemento
47 Cdigo Bairro Cdigo do Bairro
Descrio
48
Descrio do bairro
Bairro
49
Fim de elemento
50
Incio de elemento
51
CEP
CEP
52
Fim de elemento
53
Incio de elemento
Cdigo
54
Cdigo do municpio
Municpio
Nome
55
Nome do Municpio
Municpio
56
Incio de elemento
57
Cdigo UF Cdigo da UF
58
Sigla UF
Sigla da UF
59 Cdigo Regio Cdigo da regio (macrorregio)
60
Nome UF
Nome da UF
61
Fim de elemento
37

Numrico
Texto
Texto
Texto
60
Texto
255
Texto
20
Texto
50
Numrico
Texto
255
Numrico
Numrico
Texto
60
Texto
Texto
Texto
Texto
2
2
4
60
48
Ministrio da Sade
DATASUS
62
63
64
Cdigo Pas
Cdigo Pas
Antigo
Nome Pas
65
66
67
Fim de elemento
Incio de elemento
Numrico
Cdigo do pas antigo
Numrico
Texto
60
Texto
70
Nome do pas
Fim de elemento
Municpio
Internacional
Fim de elemento
Fim de elemento
Fim de elemento
68
69
70
71
72
5.2.4. LeitoService
Objetivo: Retornar dados dos Leitos do Estabelecimento de Sade.
Contrato WSDL:
o
URL: https://servicoshm.saude.gov.br/cnes/LeitoService/v1r0?wsdl
Ambiente de Produo:
URL: https://servicos.saude.gov.br/cnes/LeitoService/v1r0?wsdl
5.2.4.1. Operao: consultarLeitosCnes
Objetivo: Retornar dados dos Leitos do Estabelecimento de Sade.
Arquivo de exemplo de requisio: Request_Consultar_Leitos.xml
IDX
1
2
3
4
5
6
7
TAGS
<soap:Body>
<leit:requestConsultarLeitosCNES>
<cod:CodigoCNES>
</cod:CodigoCNES>
</leit:requestConsultarLeitosCNES>
</soap:Body>

49
Ministrio da Sade
IDX
1
2
3
4
5
6
7
CAMPO
CNES
DESCRIO DA TAG
Incio de elemento
Incio de elemento
Fim de elemento
Fim de elemento
TIPO
TAM
Texto
IDX
1
2
3
4
5
6
7
8
9
10
11
DATASUS
TAGS
<soap:Body>
<leit:responseConsultarLeitosCNES>
<leit1:leito>
<leit1:codigo>?</leit1:codigo>
<leit1:descricao>?</leit1:descricao>
<leit1:dataAtualizacao>?</leit1:dataAtualizacao>
<leit1:quantidadeLeito>?</leit1:quantidadeLeito>
<leit1:quantidadeLeitoSUS>?</leit1:quantidadeLeitoSUS>
</leit1:leito>
</leit:responseConsultarLeitosCNES>
</soap:Body>
IDX
1
2
3
4
5
6
CAMPO
Cdigo
Descrio
Data
Atualizao
DESCRIO DA TAG
Incio de elemento
Incio de elemento
Cdigo do leito
Descrio do leito
TIPO
TAM
Texto
Texto
6
60
Data

50
Ministrio da Sade
DATASUS
Quantidade
Leito
Quantidade
Leito SUS
7
8
9
10
11
Quantidade de leitos
Quantidade de leitos SUS
Numrico
Numrico
Fim de elemento
Fim de elemento
5.2.5. EquipamentoService
Objetivo: Retornar dados dos equipamentos do Estabelecimento de Sade.
Contrato WSDL:
o
URL:
https://servicoshm.saude.gov.br/cnes/EquipamentoService/v1r0?wsdl
o
Ambiente de Produo:
URL:
https://servicos.saude.gov.br/cnes/EquipamentoService/v1r0?wsdl
5.2.5.1. Operao: consultarEquipamentos
Objetivo: Retornar dados dos equipamentos do Estabelecimento de Sade.
Arquivo de exemplo de requisio: Request_Consultar_Equipamentos.xml
IDX
1
2
3
4
5
6
7
TAGS
<soap:Body>
<equ:requestConsultarEquipamentos>
<cod:CodigoCNES>
</cod:CodigoCNES>
</equ:requestConsultarEquipamentos>
</soap:Body>
IDX
1
2
3
CAMPO
DESCRIO DA TAG
Incio de elemento
Incio de elemento

TIPO
TAM
51
Ministrio da Sade
4
5
6
7
o
CNES

Fim de elemento
Fim de elemento
Texto
IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
DATASUS
TAGS
<soap:Body>
<equ:responseConsultarEquipamentos>
<equ1:Equipamento>
<equ1:codigo>?</equ1:codigo>
<equ1:descricao>?</equ1:descricao>
<tip:tipoEquipamento>
</tip:tipoEquipamento>
<equ1:destinacao>?</equ1:destinacao>
<equ1:quantidadeEquipamento>?</equ1:quantidadeEquipamento>
<equ1:quantidadeUso>?</equ1:quantidadeUso>
<equ1:TpSUS>
<equ1:codigo>?</equ1:codigo>
</equ1:TpSUS>
</equ1:Equipamento>
</equ:responseConsultarEquipamentos>
</soap:Body>
IDX
1
2
3
4
5
6
7
8
9
10
CAMPO
Cdigo
Equipamento
Descrio
Equipamento
DESCRIO DA TAG
Incio de elemento
Incio de elemento
Cdigo do equipamento
Descrio do equipamento
TIPO
TAM
Numrico
Texto
60
Numrico
Texto
60
Numrico
Incio de elemento
Cdigo Tipo
Cdigo do tipo do equipamento
Equipamento
Descrio Tipo
Descrio do tipo do equipamento
Equipamento
Fim de elemento
Destinao
Destinao do equipamento

52
Ministrio da Sade
11
12
13
14
15
16
17
18
DATASUS
Quantidade
Equipamento
Quantidade do equipamento no
estabelecimento de sade
Quantidade do equipamento em
Quantidade Uso
uso no estabelecimento de sade
Incio de elemento
Disponibilidade Indica se o equipamento est
SUS
disponvel no SUS
Fim de elemento
Fim de elemento
Fim de elemento
Numrico
Numrico
Numrico
5.2.6. CnesService
Objetivo: Retornar dados do Estabelecimento de Sade.
Contrato WSDL:
o
URL:
https://servicoshm.saude.gov.br/cnes/CnesService/v1r0?wsdl.
o
Ambiente de Produo:
URL:
https://servicos.saude.gov.br/cnes/CnesService/v1r0?wsdl.
5.2.6.1. Operao: consultarEstabelecimentoSaude
o
o
o
Parmetros de entrada: Nmero do CNES (7 posies)

Retorno correto: Estabelecimento, Profissionais Sade, Leitos, Habilitaes,
Equipamentos, Samus.
Possveis Mensagens de erro:
Nmero CNES 1111111 invlido. CNES deve ter 7 dgitos e conter somente
nmeros.
Nenhum resultado foi encontrado para a consulta solicitada.

Exemplo:
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
xmlns:cnes="http://servicos.saude.gov.br/cnes/v1r0/cnesservice"
xmlns:cod="http://servicos.saude.gov.br/schema/cnes/v1r0/codigocnes">
<soap:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wsswssecurity-secext-1.0.xsd">
<wsse:UsernameToken wsu:Id="Id-0001334008436683-000000002c4a1908-1"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
</wsse:Security>
53
Ministrio da Sade
DATASUS
</soap:Header>
<soap:Body>
<cnes:requestConsultarEstabelecimentoSaude>
<cod:CodigoCNES>
<cod:codigo>[Informar o Cdigo CNES]</cod:codigo>
</cod:CodigoCNES>
</cnes:requestConsultarEstabelecimentoSaude>
</soap:Body>
</soap:Envelope>
5.2.6.2. Operao: consultarEstabelecimentoSaudePorMunicipio
o
o
o
o
Parmetros de entrada: Cdigo Municpio (Cgido IBGE 6 posies), Nome Municpio,

Estado, Sigla Estado, Cdigo Regio, nome UF.
Retorno correto: CNES, Nome Fantasia, .

Exemplo:
xmlns:mun="http://servicos.saude.gov.br/schema/corporativo/v1r2/municipio"
xmlns:uf="http://servicos.saude.gov.br/schema/corporativo/v1r1/uf">
<soap:Header>
</wsse:Security></soap:Header>
<soap:Body>
<cnes:requestConsultarEstabelecimentoSaudePorMunicipio>
<mun:Municipio>

<mun:codigoMunicipio>[IBGE]</mun:codigoMunicipio>

<mun:nomeMunicipio>[NOME MUNICPIO]</mun:nomeMunicipio>

<mun:UF>
<uf:codigoUF>[UF]</uf:codigoUF>

<uf:siglaUF>[SIGLA UF]</uf:siglaUF>

<uf:codigoRegiao>[REGIO]</uf:codigoRegiao>

<uf:nomeUF>[NOME UF]</uf:nomeUF>
</mun:UF>
</mun:Municipio>
</cnes:requestConsultarEstabelecimentoSaudePorMunicipio>
</soap:Body>
</soap:Envelope>

54
Ministrio da Sade
DATASUS
5.2.6.3. Operao: consultarDadosComplementaresEstabelecimentoSaude
o
o
o
o
Parmetros de entrada: Cdigo Municpio (Cgido IBGE 6 posies), Nome Municpio,

Estado, Sigla Estado, Cdigo Regio, nome UF e Competncia (AAAAMM)
Retorno correto: Tipo de Gesto, Tipo Unidade, Descrio e Quantidade
Estabelecimento..

Exemplo:
xmlns:mun="http://servicos.saude.gov.br/schema/corporativo/v1r2/municipio"
xmlns:uf="http://servicos.saude.gov.br/schema/corporativo/v1r1/uf"
xmlns:cmpt="http://servicos.saude.gov.br/schema/cnes/v1r0/cmpt">
<soap:Header>
</wsse:Security></soap:Header>
<soap:Body>
<cnes:requestConsultarDadosComplementaresEstabelecimentoSaude>
<cnes:MunicipioCNES>

<mun:codigoMunicipio>[IBGE]</mun:codigoMunicipio>

<mun:nomeMunicipio>[NOME MUNICPIO]</mun:nomeMunicipio>

<mun:UF>
<uf:codigoUF>[UF]</uf:codigoUF>

<uf:siglaUF>[SIGLA UF]</uf:siglaUF>

<uf:codigoRegiao>[REGIO]</uf:codigoRegiao>

<uf:nomeUF>[NOME UF]</uf:nomeUF>
</mun:UF>
</cnes:MunicipioCNES>
<cmpt:cmpt>
<cmpt:cmpt>[COMPETNCIA]</cmpt:cmpt>
</cmpt:cmpt>
</cnes:requestConsultarDadosComplementaresEstabelecimentoSaude>
</soap:Body>
</soap:Envelope>

55

Especificacao Tecnica para Integracao Com o Cadastro Nacional de Estabelecimentos de Sade v1-20

Caricato da

Informazioni sul documento

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Especificacao Tecnica para Integracao Com o Cadastro Nacional de Estabelecimentos de Sade v1-20

Caricato da

Copyright:

Formati disponibili

Departamento de Informtica do SUS - DATASUS

ESPECIFICAO TCNICA PARA

Arquivo: Especificao Tcnica para Integrao com o CNES.

Cpia controlada nmero:

Elementos comuns usados nas mensagens SOAP ............................ 8

Operao: consultarEstabelecimentoSaude ................................ 9

Operao: consultarPreCadastroCNES ...................................... 16

Operao: localizarEstabelecimentoSaude ................................ 22

Operao: detalharVinculacaoProfissionalSaude ..................... 29

Operao: pesquisarVinculacaoProfissionalSaude .................. 34

Operao: consultarProfissionaisSaude .................................... 39

Operao: consultarProfissionalSaude ...................................... 44

Operao: consultarEstabelecimentoSaude .............................. 53

Operao: consultarEstabelecimentoSaudePorMunicipio ....... 54

Arquivo: Especificao Tcnica para Integrao com o CNES.

Cpia controlada nmero:

4. Instalao e uso prtico da ferramenta de testes.

Instalao do Software SOAPUI

Arquivo: Especificao Tcnica para Integrao com o CNES

Figura 1: Tela inicial do Software SOAPUI.

Criar Projeto SOAP

Figura 2: Criar Projeto SOAP.

Arquivo: Especificao Tcnica para Integrao com o CNES

Figura 3: Inserir URL WSDL.

Acessando o servio VinculacaoProfissionalService

3.1. Gerando a Estrutura

Figura 4: WSDL VinculacaoProfissionalService Ambiente de Homologao

Arquivo: Especificao Tcnica para Integrao com o CNES

Figura 5: Carregando informaes do Servio.

Figura 6: Lista de servios de acordo com o WSDL informado.

3.2. Acessando o Servio

Voc deve ter reparado que a ferramenta criou 2 VinculacaoProfissionalService.

Arquivo: Especificao Tcnica para Integrao com o CNES

Figura 7: Acessando a requisio do servio pesquisarVinculacaoProfissionalSaude.

Figura 8: Selecione Rename.

Digite um nome amigvel, como por exemplo: PesquisarPorCpf e clique em OK.

Arquivo: Especificao Tcnica para Integrao com o CNES

Figura 9: Digite um nome amigvel.

Pronto! Agora vamos fazer uma simulao ao servio de

Figura 10: XML padro da requisio.

Arquivo: Especificao Tcnica para Integrao com o CNES

Figura 11: Substituindo o contedo.

Agora basta clicar no cone

Figura 12: XML padro da resposta (response).

Dessa forma, finalizamos o teste de integrao com o webService.

Arquivo: Especificao Tcnica para Integrao com o CNES

5. Integrao por Servio.

5.1. Elementos comuns usados nas mensagens SOAP

Exemplo de Header na mensagem SOAP:

Exemplo de Paginao na mensagem SOAP (Request):

Exemplo de Paginao na mensagem SOAP (Response):

Arquivo: Especificao Tcnica para Integrao com o CNES

Objetivo: EstabelecimentoSaudeService tem a inteno de prover acesso a informaes dos

5.2.1.1. Operao: consultarEstabelecimentoSaude

Objetivo: Recuperar os Estabelecimentos de Sade cadastrados no CNES.

Arquivo de exemplo de requisio: Request_Consultar_Estabelecimento.xml

Corpo da mensagem de requisio:

Descrio do corpo da mensagem de requisio:

Arquivo: Especificao Tcnica para Integrao com o CNES

Cdigo CNES utilizado para consulta

Corpo da mensagem de retorno:

Arquivo: Especificao Tcnica para Integrao com o CNES

Arquivo: Especificao Tcnica para Integrao com o CNES