Você está na página 1de 57

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).

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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.

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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.

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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.

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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.

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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.

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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:codigo>?</cod:codigo>
</cod:CodigoCNES>
<cod1:CodigoUnidade>
<cod1:codigo>?</cod1:codigo>
</cod1:CodigoUnidade>
<dad:nomeFantasia>
<nom:Nome>?</nom:Nome>
</dad:nomeFantasia>
<dad:nomeEmpresarial>
<nom:Nome>?</nom:Nome>
</dad:nomeEmpresarial>
<cnpj:CNPJ>
<cnpj:numeroCNPJ>?</cnpj:numeroCNPJ>
</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>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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>
<mun:codigoMunicipio>?</mun:codigoMunicipio>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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:nomeMunicipio>?</mun:nomeMunicipio>
<mun:UF>
<uf:codigoUF>?</uf:codigoUF>
<uf:siglaUF>?</uf:siglaUF>
<uf:codigoRegiao>?</uf:codigoRegiao>
<uf:nomeUF>?</uf:nomeUF>
</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 do corpo da mensagem
Incio de elemento
Incio de elemento
Incio de elemento
Cdigo do Estabelecimento de Sade
Fim de elemento

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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
Cdigo da regio (macrorregio)
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
Fim do corpo da mensagem

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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

Corpo da mensagem de requisio:

NDICE
1
2
3
4
5
6
7
8
9
10
o

TAGS
<soap:Body>
<est:requestConsultarPrecadastroCNES>
<fil:FiltroPesquisaPrecadastroCnes>
<cod:CodigoCNES>
<cod:codigo>?</cod:codigo>
</cod:CodigoCNES>
<fil:situacao>?</fil:situacao>
</fil:FiltroPesquisaPrecadastroCnes>
</est:requestConsultarPrecadastroCNES>
</soap:Body>

Descrio do corpo da mensagem de requisio:

IDX
1
2
3
4
5

CAMPO

Cdigo
CNES

6
7
8
9
10
o

Situao

DESCRIO DA TAG
Incio do corpo da mensagem
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
Fim do corpo da mensagem

Corpo da mensagem de retorno:

NDICE
1
2
3
4
5
6
7
8
9

TAGS
<soap:Body>
<est:responseConsultarPrecadastroCNES>
<dad:DadosPreCadastroCNES>
<cod:CodigoCNES>
<cod:codigo>?</cod:codigo>
</cod:CodigoCNES>
<cpf:CPF>
<cpf:numeroCPF>?</cpf:numeroCPF>
</cpf:CPF>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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:numeroCNPJ>?</cnpj:numeroCNPJ>
</cnpj:CNPJ>
<dad:NomeFantasia>
<nom:Nome>?</nom:Nome>
</dad:NomeFantasia>
<dad:NomeEmpresarial>
<nom:Nome>?</nom:Nome>
</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>
<cnpj:numeroCNPJ>?</cnpj:numeroCNPJ>
</dad:CNPJMantenedora>
<dad:NaturezaJuridicaMantenedora>
<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:NaturezaJuridicaMantenedora>
<dad:DataAtualizacao>?</dad:DataAtualizacao>
<end:Endereco>
<end:identificador>?</end:identificador>
<end:TipoEndereco>?</end:TipoEndereco>
<end:TipoLogradouro>
<tip1:codigoTipoLogradouro>?</tip1:codigoTipoLogradouro>
<tip1:descricaoTipoLogradouro>?</tip1:descricaoTipoLogradouro>
</end:TipoLogradouro>
<end:nomeLogradouro>?</end:nomeLogradouro>
<end:numero>?</end:numero>
<end:complemento>?</end:complemento>
<end:Bairro>
<bair:codigoBairro>?</bair:codigoBairro>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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

<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:Telefones>
<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:Telefones>
<ema:Email>
<ema:identificador>?</ema:identificador>
<ema:descricaoEmail>?</ema:descricaoEmail>
<ema:tipoEmail>?</ema:tipoEmail>
<ema:validado>?</ema:validado>
</ema:Email>
</dad:DadosPreCadastroCNES>
</est:responseConsultarPrecadastroCNES>
</soap:Body>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

18

Ministrio da Sade
o

DATASUS

Descrio do corpo da mensagem de retorno:

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
CNPJ do estabelecimento
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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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

Complemento do logradouro

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

Cdigo do municpio do endereo

Numrico

Nome do municpio do endereo

Texto

60

Inicio de elemento
Cdigo do tipo do logradouro
Descrio do tipo de logradouro
Fim de elemento

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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
Cdigo da regio (macrorregio)
Nome da UF
Fim de elemento
Fim de elemento
Inicio de elemento
Cdigo do pas (SAI e SIH)

Texto
Texto
Texto
Texto

2
2
4
60

Numrico

Cdigo do pas antigo

Numrico

Nome do pas
Fim de elemento

Texto

60

Nome do municpio internacional

Texto

70

Numrico

Numrico

Texto

Numrico

Texto

100

Texto
Booleano

Fim de elemento
Inicio de elemento
Cdigo Identificador do Telefone
Inicio de elemento
Cdigo do tipo de telefone
Descrio do tipo de telefone
Fim de elemento
DDI
DDD
Nmero do telefone
Fim de elemento
Inicio de elemento
Cdigo identificador do email
Endereo do email
Tipo do email
Email validado
Fim de elemento
Fim de elemento
Fim de elemento
Fim do corpo da mensagem

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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

Corpo da mensagem de requisio:

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:longitude>?</loc:longitude>
<loc:latitude>?</loc:latitude>
<loc:geoJson>?</loc:geoJson>
</loc:Localizacao>
<tip:tipoUnidade>
<tip:codigo>?</tip:codigo>
<tip:descricao>?</tip:descricao>
</tip:tipoUnidade>
<pag:Paginacao>
<pag:posicaoRegistroInicio>?</pag:posicaoRegistroInicio>
<pag:quantidadeRegistrosPorPagina>?</pag:quantidadeRegistrosPorPagina>
<pag:quantidadeRegistros>?</pag:quantidadeRegistros>
</pag:Paginacao>
</fil:FiltroLocalizacaoEstabelecimentoSaude>
</est:requestLocalizarEstabelecimentoSaude>
</soap:Body>

Descrio do corpo da mensagem de requisio:

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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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
Fim do corpo da mensagem

Numrico

Numrico

Numrico

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

TAGS
<soap:Body>
<est:responseLocalizarEstabelecimentoSaude>
<res:ResultadosLocalizacaoEstabelecimentoSaude>
<res1:ResultadoLocalizacaoEstabelecimentoSaude>
<res1:EstabelecimentoSaude>
<cod:CodigoCNES>
<cod:codigo>?</cod:codigo>
</cod:CodigoCNES>
<cod1:CodigoUnidade>
<cod1:codigo>?</cod1:codigo>
</cod1:CodigoUnidade>
<dad:nomeFantasia>
<nom:Nome>?</nom:Nome>
</dad:nomeFantasia>
<dad:nomeEmpresarial>
<nom:Nome>?</nom:Nome>
</dad:nomeEmpresarial>
<cnpj:CNPJ>
<cnpj:numeroCNPJ>?</cnpj:numeroCNPJ>
</cnpj:CNPJ>
<end:Endereco>
<end:identificador>?</end:identificador>
<end:TipoEndereco>?</end:TipoEndereco>
<end:TipoLogradouro>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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

<tip:codigoTipoLogradouro>?</tip:codigoTipoLogradouro>
<tip:descricaoTipoLogradouro>?</tip:descricaoTipoLogradouro>
</end:TipoLogradouro>
<end:nomeLogradouro>?</end:nomeLogradouro>
<end:numero>?</end:numero>
<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>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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: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>
</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>
</res1:EstabelecimentoSaude>
</res1:ResultadoLocalizacaoEstabelecimentoSaude>
<pag:Paginacao>
<pag:posicaoRegistroInicio>?</pag:posicaoRegistroInicio>
<pag:quantidadeRegistrosPorPagina>?</pag:quantidadeRegistrosPorPagina>
<pag:quantidadeRegistros>?</pag:quantidadeRegistros>
</pag:Paginacao>
</res:ResultadosLocalizacaoEstabelecimentoSaude>
</est:responseLocalizarEstabelecimentoSaude>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

25

Ministrio da Sade

113

DATASUS

</soap:Body>

Descrio do corpo da mensagem de retorno:

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 do corpo da mensagem
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
CNPJ do estabelecimento
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
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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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

Cdigo do municpio do endereo

Numrico

Nome do municpio do endereo

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 do pas (SAI e SIH)
Cdigo Pas
Cdigo do pas antigo
Antigo
Nome Pas
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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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
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 Email Endereo do email
Tipo Email
Tipo do email
Validado
Email validado
Fim de elemento
Incio de elemento

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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
Quantidade total de registros
Registros
Fim de elemento
Fim de elemento
Fim de elemento
Fim do corpo da mensagem

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

Ambiente de Homologao:

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

Corpo da mensagem de requisio:

NDICE
Arquivo: Especificao Tcnica para Integrao com o CNES
Classificao da Informao: Comum, No Monitorada, No Crtica

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>
<cpf:numeroCPF>?</cpf:numeroCPF>
</fil:cpf>
<fil:cns>
<cns:numeroCNS>?</cns:numeroCNS>
</fil:cns>
</fil:IdentificacaoProfissional>
<fil:IdentificacaoEstabelecimento>
<fil:cnes>
<cod:codigo>?</cod:codigo>
</fil:cnes>
<fil:cnpj>
<cnpj:numeroCNPJ>?</cnpj:numeroCNPJ>
</fil:cnpj>
</fil:IdentificacaoEstabelecimento>
<fil:IdentificacaoVinculacao>
<fil:tipoVinculacao>?</fil:tipoVinculacao>
</fil:IdentificacaoVinculacao>
</fil:FiltroPesquisaVinculacao>
</vin:RequestVinculacao>
</soap:Body>

Descrio do corpo da mensagem de requisio:

IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14

CAMPO

CPF

CNS

CNES

DESCRIO DA TAG
Incio do corpo da mensagem
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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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
CNPJ do estabelecimento
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
Fim do corpo da mensagem

Texto

14

Texto

Corpo da mensagem de retorno:

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>
<nom:Nome>?</nom:Nome>
</dad:Nome>
<dad:CPF>
<cpf:numeroCPF>?</cpf:numeroCPF>
</dad:CPF>
<dad:CNS>
<cns:numeroCNS>?</cns:numeroCNS>
<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:codigo>?</cod:codigo>
</cod:CodigoCNES>
<dad1:NomeFantasia>
<nom1:Nome>?</nom1:Nome>
</dad1:NomeFantasia>
</vin1:Estabelecimento>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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>

Descrio do corpo da mensagem de retorno:

IDX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

CAMPO

DESCRIO DA TAG
Incio do corpo da mensagem
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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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
Cdigo CNES do estabelecimento
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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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
Fim do corpo da mensagem

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

Corpo da mensagem de requisio:

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>
<cpf:numeroCPF>?</cpf:numeroCPF>
</fil:cpf>
<fil:cns>
<cns:numeroCNS>?</cns:numeroCNS>
</fil:cns>
</fil:IdentificacaoProfissional>
<fil:IdentificacaoEstabelecimento>
<fil:cnes>
<cod:codigo>?</cod:codigo>
</fil:cnes>
<fil:cnpj>
<cnpj:numeroCNPJ>?</cnpj:numeroCNPJ>
</fil:cnpj>
</fil:IdentificacaoEstabelecimento>
</fil:FiltroPesquisaVinculacaos>
<Paginacao>
<pag:registroInicial>?</pag:registroInicial>
<pag:quantidadeRegistros>?</pag:quantidadeRegistros>
<pag:totalRegistros>?</pag:totalRegistros>
</Paginacao>
</vin:RequestVinculacaos>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

34

Ministrio da Sade

DATASUS

27

Descrio do corpo da mensagem de requisio:

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 do corpo da mensagem
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
Fim de elemento
Incio de elemento
CNPJ do estabelecimento
Fim de elemento
Fim de elemento
Fim de elemento
Incio 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 do corpo da mensagem

TIPO

TAM

Texto

11

Texto

15

Texto

Texto

14

Numrico

Numrico

Numrico

Corpo da mensagem de retorno:

IDX
Arquivo: Especificao Tcnica para Integrao com o CNES
Classificao da Informao: Comum, No Monitorada, No Crtica

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>
<nom:Nome>?</nom:Nome>
</dad:Nome>
<dad:CPF>
<cpf:numeroCPF>?</cpf:numeroCPF>
</dad:CPF>
<dad:CNS>
<cns:numeroCNS>?</cns:numeroCNS>
<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:codigo>?</cod:codigo>
</cod:CodigoCNES>
<dad1:NomeFantasia>
<nom1:Nome>?</nom1:Nome>
</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>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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:quantidadeRegistros>?</pag:quantidadeRegistros>
<pag:totalRegistros>?</pag:totalRegistros>
</Paginacao>
</vin:ResponseVinculacaos>
</soap:Body>

Descrio do corpo da mensagem de retorno:

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 do corpo da mensagem
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
Justificativa Justificativa para a adio do carto
Manual manual
Fim de elemento
Fim de elemento
Incio de elemento
Incio de elemento
CNES
Cdigo CNES do estabelecimento
Fim de elemento
Incio de elemento
Nome
Nome de fantasia do estabelecimento

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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
profissional no estabelecimento
Carga horrio de outros tipos do
profissional no estabelecimento
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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

38

Ministrio da Sade

DATASUS

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 do corpo da mensagem

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

Ambiente de Homologao:

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

Corpo da mensagem de requisio:

IDX
1
2
3
4
5
6
7
8
9
10
11
12

TAGS
<soap:Body>
<prof:requestConsultarProfissionaisSaude>
<fil:FiltroPesquisaEstabelecimentoSaude>
<cod:CodigoCNES>
<cod:codigo>?</cod:codigo>
</cod:CodigoCNES>
<cnpj:CNPJ>
<cnpj:numeroCNPJ>?</cnpj:numeroCNPJ>
</cnpj:CNPJ>
</fil:FiltroPesquisaEstabelecimentoSaude>
</prof:requestConsultarProfissionaisSaude>
</soap:Body>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

39

Ministrio da Sade

Descrio do corpo da mensagem de requisio:

IDX
1
2
3
4
5
6
7
8
9
10
11
12

DATASUS

CAMPO

CNES

CNPJ

DESCRIO DA TAG
Incio do corpo da mensagem
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
Fim do corpo da mensagem

TIPO

TAM

Texto

Texto

14

Corpo da mensagem de retorno:

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>
<nom:Nome>?</nom:Nome>
</prof1:Nome>
<prof1:CNS>
<cns:numeroCNS>?</cns:numeroCNS>
<cns:dataAtribuicao>?</cns:dataAtribuicao>
<cns:tipoCartao>?</cns:tipoCartao>
<cns:manual>?</cns:manual>
<cns:justificativaManual>?</cns:justificativaManual>
</prof1:CNS>
<prof1:CPF>
<cpf:numeroCPF>?</cpf:numeroCPF>
</prof1:CPF>
<prof1:CBO>
<cbo:codigoCBO>?</cbo:codigoCBO>
<cbo:descricaoCBO>?</cbo:descricaoCBO>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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:codigo>?</cod:codigo>
</cod:CodigoCNES>
<dad:NomeFantasia>
<nom1:Nome>?</nom1:Nome>
</dad:NomeFantasia>
</prof1:CNES>
<prof1:Email>
<ema:identificador>?</ema:identificador>
<ema:descricaoEmail>?</ema:descricaoEmail>
<ema:tipoEmail>?</ema:tipoEmail>
<ema:validado>?</ema:validado>
</prof1:Email>
<prof1: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>
<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>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

41

Ministrio da Sade

65
66
67
68
69
70
71
72

DATASUS

<pais:codigoPaisAntigo>?</pais:codigoPaisAntigo>
<pais:nomePais>?</pais:nomePais>
</end:Pais>
<end:municipioInternacional>?</end:municipioInternacional>
</prof1:Endereco>
</prof1:ProfissionalSaude>
</prof:responseConsultarProfissionaisSaude>
</soap:Body>

Descrio do corpo da mensagem de retorno:

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 do corpo da mensagem
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 de Atribuio do Carto

Data

Tipo do Carto: [P=Provisrio,


D=Definitivo]
Identifica se o carto foi adicionado
Manual
manualmente
Justificativa Justificativa para a adio do carto
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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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

Nome de fantasia do estabelecimento


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

Cdigo identificador do email

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
Complemento do logradouro
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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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
Cdigo do pas (SAI e SIH)

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
Fim de elemento
Fim de elemento
Fim do corpo da mensagem

5.2.3.2. Operao: consultarProfissionalSaude

Objetivo: Retornar dados de um nico profissional de sade

Arquivo de exemplo de requisio: Request_Consultar_Profissional.xml

Corpo da mensagem de requisio:

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:numeroCNS>?</cns:numeroCNS>
<cns:dataAtribuicao>?</cns:dataAtribuicao>
<cns:tipoCartao>?</cns:tipoCartao>
<cns:manual>?</cns:manual>
<cns:justificativaManual>?</cns:justificativaManual>
</cns:CNS>
<cpf:CPF>
<cpf:numeroCPF>?</cpf:numeroCPF>
</cpf:CPF>
</fil:FiltroPesquisaProfissionalSaude>
</prof:requestConsultarProfissionalSaude>
</soap:Body>

Descrio do corpo da mensagem de requisio:

IDX

CAMPO

DESCRIO DA TAG

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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 do corpo da mensagem


Incio de elemento
Incio de elemento
Incio de elemento
Cns do Profissional

CNS
Data
Data de Atribuio do Carto
Atribuio
Tipo do Carto: [P=Provisrio,
Tipo Carto
D=Definitivo]
Identifica se o carto foi adicionado
Manual
manualmente
Justificativa Justificativa para a adio do carto
Manual manual
Fim de elemento
Incio de elemento
CPF
CPF do Profissional de Sade
Fim de elemento
Fim de elemento
Fim de elemento
Fim do corpo da mensagem

Texto

15

Data
Domnio
Booleano
Texto

200

Texto

15

Corpo da mensagem de retorno:

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>
<nom:Nome>?</nom:Nome>
</prof1:Nome>
<prof1:CNS>
<cns:numeroCNS>?</cns:numeroCNS>
<cns:dataAtribuicao>?</cns:dataAtribuicao>
<cns:tipoCartao>?</cns:tipoCartao>
<cns:manual>?</cns:manual>
<cns:justificativaManual>?</cns:justificativaManual>
</prof1:CNS>
<prof1:CPF>
<cpf:numeroCPF>?</cpf:numeroCPF>
</prof1:CPF>
<prof1:CBO>
<cbo:codigoCBO>?</cbo:codigoCBO>
<cbo:descricaoCBO>?</cbo:descricaoCBO>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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:codigo>?</cod:codigo>
</cod:CodigoCNES>
<dad:NomeFantasia>
<nom1:Nome>?</nom1:Nome>
</dad:NomeFantasia>
</prof1:CNES>
<prof1:Email>
<ema:identificador>?</ema:identificador>
<ema:descricaoEmail>?</ema:descricaoEmail>
<ema:tipoEmail>?</ema:tipoEmail>
<ema:validado>?</ema:validado>
</prof1:Email>
<prof1: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>
<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>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

46

Ministrio da Sade

65
66
67
68
69
70
71
72

DATASUS

<pais:codigoPaisAntigo>?</pais:codigoPaisAntigo>
<pais:nomePais>?</pais:nomePais>
</end:Pais>
<end:municipioInternacional>?</end:municipioInternacional>
</prof1:Endereco>
</prof1:ProfissionalSaude>
</prof:responseConsultarProfissionaisSaude>
</soap:Body>

Descrio do corpo da mensagem de retorno:

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 do corpo da mensagem
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 de Atribuio do Carto

Data

Tipo do Carto: [P=Provisrio,


D=Definitivo]
Identifica se o carto foi adicionado
Manual
manualmente
Justificativa Justificativa para a adio do carto
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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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

Nome de fantasia do estabelecimento


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

Cdigo identificador do email

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
Complemento do logradouro
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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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
Cdigo do pas (SAI e SIH)

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
Fim de elemento
Fim de elemento
Fim do corpo da mensagem

68
69
70
71
72

5.2.4. LeitoService

Objetivo: Retornar dados dos Leitos do Estabelecimento de Sade.

Contrato WSDL:
o

Ambiente de Homologao:

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

Corpo da mensagem de requisio:

IDX
1
2
3
4
5
6
7

TAGS
<soap:Body>
<leit:requestConsultarLeitosCNES>
<cod:CodigoCNES>
<cod:codigo>?</cod:codigo>
</cod:CodigoCNES>
</leit:requestConsultarLeitosCNES>
</soap:Body>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

49

Ministrio da Sade

Descrio do corpo da mensagem de requisio:

IDX
1
2
3
4
5
6
7

CAMPO

CNES

DESCRIO DA TAG
Incio do corpo da mensagem
Incio de elemento
Incio de elemento
Nmero CNES do estabelecimento
Fim de elemento
Fim de elemento
Fim do corpo da mensagem

TIPO

TAM

Texto

Corpo da mensagem de retorno:

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>

Descrio do corpo da mensagem de retorno:

IDX
1
2
3
4
5
6

CAMPO

Cdigo
Descrio
Data
Atualizao

DESCRIO DA TAG
Incio do corpo da mensagem
Incio de elemento
Incio de elemento
Cdigo do leito
Descrio do leito

TIPO

TAM

Texto
Texto

6
60

Data de atualizao do registro

Data

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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
Fim do corpo da mensagem

5.2.5. EquipamentoService

Objetivo: Retornar dados dos equipamentos do Estabelecimento de Sade.

Contrato WSDL:
o

Ambiente de Homologao:

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

Corpo da mensagem de requisio:

IDX
1
2
3
4
5
6
7

TAGS
<soap:Body>
<equ:requestConsultarEquipamentos>
<cod:CodigoCNES>
<cod:codigo>?</cod:codigo>
</cod:CodigoCNES>
</equ:requestConsultarEquipamentos>
</soap:Body>

Descrio do corpo da mensagem de requisio:

IDX
1
2
3

CAMPO

DESCRIO DA TAG
Incio do corpo da mensagem
Incio de elemento
Incio de elemento

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

TIPO

TAM

51

Ministrio da Sade

4
5
6
7
o

CNES

Nmero CNES do estabelecimento


Fim de elemento
Fim de elemento
Fim do corpo da mensagem

Texto

Corpo da mensagem de retorno:

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:codigo>?</tip:codigo>
<tip:descricao>?</tip:descricao>
</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>

Descrio do corpo da mensagem de retorno:

IDX
1
2
3
4
5
6
7
8
9
10

CAMPO

Cdigo
Equipamento
Descrio
Equipamento

DESCRIO DA TAG
Incio do corpo da mensagem
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

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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
Fim do corpo da mensagem

Numrico

Numrico

Numrico

5.2.6. CnesService

Objetivo: Retornar dados do Estabelecimento de Sade.

Contrato WSDL:
o

Ambiente de Homologao:

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: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>
Arquivo: Especificao Tcnica para Integrao com o CNES
Classificao da Informao: Comum, No Monitorada, No Crtica

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, .
Possveis Mensagens de erro:

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: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 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: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>
<soap:Body>
<cnes:requestConsultarEstabelecimentoSaudePorMunicipio>
<mun:Municipio>
<!--Optional:-->
<mun:codigoMunicipio>[IBGE]</mun:codigoMunicipio>
<!--Optional:-->
<mun:nomeMunicipio>[NOME MUNICPIO]</mun:nomeMunicipio>
<!--Optional:-->
<mun:UF>
<uf:codigoUF>[UF]</uf:codigoUF>
<!--Optional:-->
<uf:siglaUF>[SIGLA UF]</uf:siglaUF>
<!--Optional:-->
<uf:codigoRegiao>[REGIO]</uf:codigoRegiao>
<!--Optional:-->
<uf:nomeUF>[NOME UF]</uf:nomeUF>
</mun:UF>
</mun:Municipio>
</cnes:requestConsultarEstabelecimentoSaudePorMunicipio>
</soap:Body>
</soap:Envelope>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

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..
Possveis Mensagens de erro:

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: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 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: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>
<soap:Body>
<cnes:requestConsultarDadosComplementaresEstabelecimentoSaude>
<cnes:MunicipioCNES>
<!--Optional:-->
<mun:codigoMunicipio>[IBGE]</mun:codigoMunicipio>
<!--Optional:-->
<mun:nomeMunicipio>[NOME MUNICPIO]</mun:nomeMunicipio>
<!--Optional:-->
<mun:UF>
<uf:codigoUF>[UF]</uf:codigoUF>
<!--Optional:-->
<uf:siglaUF>[SIGLA UF]</uf:siglaUF>
<!--Optional:-->
<uf:codigoRegiao>[REGIO]</uf:codigoRegiao>
<!--Optional:-->
<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>

Arquivo: Especificao Tcnica para Integrao com o CNES


Classificao da Informao: Comum, No Monitorada, No Crtica

55