Integração de sistemas próprios

De cmd
Revisão de 13h31min de 7 de dezembro de 2017 por Marcela.pontes (Discussão | contribs) (Criou página com 'Esta sessão tem por objetivo orientar equipes técnicas de TI no desenvolvimento da integração de sistemas ao w''ebservice'' do CMD. Serão descritas as interfaces ''webser...')

(dif) ← Edição anterior | Revisão atual (dif) | Versão posterior → (dif)
Ir para: navegação, pesquisa

Esta sessão tem por objetivo orientar equipes técnicas de TI no desenvolvimento da integração de sistemas ao webservice do CMD. Serão descritas as interfaces webservice SOAP disponibilizadas no portfólio de serviços CMD existentes no barramento de serviços do DATASUS.

Descrição do Processo

Para acessar os serviços do CMD, o Estabelecimento de Saúde (ES) deverá possuir credencial de acesso ao Serviço ContatoAssistencialService e profissional cadastrado no CNES, permissão de transmissão de dados de contatos assistências.

A integração deverá iniciar em ambiente de homologação, por meio das credencias públicas disponibilizadas neste tutorial. O CPF e a senha do profissional serão validados pelo Serviço do CNES (A capacidade ValidaPermissão do serviço de CNES fazendo um relacionamento entre o CPF do operador e o código CNES do estabelecimento, do qual o operador tem permissão para transmitir contatos assistenciais.URL: http://hm-cnesservicos.datasus.gov.br/cnesservicos/PerfilService?wsdl) .

Ao concluir a integração em ambiente de homologação, deverão ser enviadas ao DATASUS as evidências de testes. Após análise dos testes realizados, serão geradas e disponibilizadas as credencias de acesso em ambiente de produção.

De posse deste documento, a equipe técnica de desenvolvimento poderá iniciar de imediato a integração de seus sistemas consumidores.

Instalação e uso prático da ferramenta de testes

Instalação do Software SOAPUI

Para fazer o download do software SOAPUI clique no link: http://www.soapui.org/downloads/soapui.html

Após download, ciar um projeto do tipo SOAP, que é a tecnologia utilizada pelo serviço do CMD.

Acesso ao serviço ContatoAssistencialService

Informar a WSDL do serviço ContatoAssistencialService para que o aplicativo SOAPUI gere a estrutura necessária para acessar e carregar todos os serviços disponíveis que o WSDL disponibiliza.

Ambiente de homologação: https://servicoshm.saude.gov.br/cmd/ContatoAssistencialService/v1r0?wsdl

Integração por Serviço

A integração por serviço será realizada a partir de webservice disponível no barramento de serviços.

As credenciais públicas de acesso são as seguintes:

·        Credencial do Serviço ContatoAssistencialService:

USUARIO_SERVICO: CADSUS.CMD

SENHA: *9p4-gNEDu85-eqh89X-2NB6f*H*_g

·        Credencial do Operador do CMD (relacionamento de CPF e CNES):

CPF_OPERADOR: 99999999999

SENHA: 2C0c75d9

Serviços

O ContatoAssistencialService tem o propósito de envio de informações essenciais dos contatos assistenciais de atenção à saúde realizados em território nacional, no âmbito público, suplementar e privado. O serviço fará consultas nas bases do CADSUS, CNES e SIGTAP (repositório de terminologia em uso) com o intuito de realizar a validação dos dados enviados através do CMD Desktop. Além disso, o serviço fará todas as validações de negócio referentes ao CMD antes de persisti-lo na base. baixo seguem as operações disponíveis:

PesquisarContatoAssistencial

·        Objetivo: Possibilitar a pesquisa dos contatos assistenciais enviados a partir de algumas informações fornecidas.

·        Arquivo de exemplo de Requisição: request_pesquisar_contato.xml

·        Parâmetros de entrada da requisição:

Parâmetro Tag Xml Correspondente Descrição Técnica

Ano Mês Atendimento* <con:anoMesAtendimento></con:anoMesAtendimento> Ano e Mês de atendimento com o formato YYYY/MM

Cnes Contato Assistencial * <con:cnesContatoAssistencial></con:cnesContatoAssistencial> CNES do Contato Assistencial*

Cns Individuo* <con:cnsIndividuo></con:cnsIndividuo> CNS do Individuo

·        Parâmetros de retorno da requisição:

Parâmetro Tag Xml Correspondente Descrição Técnica

Código Contato Assistencial <ns4:codigoContatoAssistencial></ns4:codigoContatoAssistencial> Código do Contato Assistencial Formato UUID Versão 4.

Ano Mês Atendimento <ns4:anoMesAtendimento></ns4:anoMesAtendimento> Ano Mês Atendimento

Cnes Contato Assistencial <ns4:cnesContatoAssistencial></ns4:cnesContatoAssistencial> CNES do Contato Assistencial

Cns Individuo <con:cnsIndividuo></con:cnsIndividuo> CNS do Individuo

Nome Completo Individuo <ns4:nomeCompleto> </ns4:nomeCompleto> Nome Individuo

Data Admissao <ns4:dataAdmissao></ns4:dataAdmissao> Data Admissão

Data Desfecho<ns4:dataDesfecho></ns4:dataDesfecho> Data Desfecho

Situação Contato Assistencial <ns4:situacaoContatoAssistencial></ns4:situacaoContatoAssistencial> Enumeração OK, COM_ADVERTENCIA, CANCELADO

DetalharContatoAssistencial

·        Objetivo: Possibilitar a pesquisa completa dos dados de um contato assistencial a partir de seu código de identificação. O Serviço retornará o detalhamento das informações de apenas um contato assistencial ou nenhum.

·        Arquivo de exemplo de Requisição: request_detalhar_contato.xml

·        Parâmetros de entrada da requisição:

Parâmetro Tag Xml Correspondente Descrição Técnica

Código Contato Assistencial* <con:codigoContatoAssistencial></con:codigoContatoAssistencial> Código do Contato Assistencial Formato UUID Versão 4.

·        Parâmetros de retorno da requisição:

Parâmetro Tag Xml Correspondente Descrição Técnica

Dados Contato Assistencial <con:DadosContatoAssistencial> Detalhe Do Contato </con:DadosContatoAssistencial> Detalhe Contato Assistencial. Especificado em Tabela I

IncluirContatoAssistencial

·        Objetivo: Possibilitar a inclusão das informações do conjunto mínimo de dados dos contatos assistenciais de atenção à saúde.

·        Arquivo de exemplo de Requisição: request_incluir_contato.xml

·        Parâmetros de entrada da requisição: Parâmetro Tag Xml Correspondente Descrição Técnica

Dados Contato Assistencial* <con:DadosContatoAssistencial> Detalhe Do Contato </con:DadosContatoAssistencial>

Detalhe Contato Assistencial. Especificado em Tabela I

·        Parâmetros de retorno da requisição: Parâmetro Tag Xml Correspondente Descrição Técnica

Código Retorno <con:codigoRetorno> </con:codigoRetorno> Enumeração: INCLUSAO REALIZADA CO

AlterarContatoAssistencial

·        Objetivo: Possibilitar a alteração das informações do conjunto mínimo de dados dos contatos assistenciais de atenção à saúde a partir do código do contato assistencial.

·        Arquivo de exemplo de Requisição: request_alterar_contato.xml

·        Parâmetros de entrada da requisição:

Parâmetro Tag Xml Correspondente Descrição Técnica

Dados Contato Assistencial* <con:DadosContatoAssistencial> Detalhe Do Contato </con:DadosContatoAssistencial>

Detalhe Contato Assistencial. Especificado em Tabela I

·        Parâmetros de retorno da requisição: Parâmetro Tag Xml Correspondente Descrição Técnica

Código Retorno <con:codigoRetorno> </con:codigoRetorno> Enumeração: ALTERACAO REALIZADA COM SUCESSO

CancelarContatoAssistencial

·        Objetivo: Possibilitar a exclusão lógica de um registro de contato assistencial a partir de seu código de identificação.

·        Arquivo de exemplo de Requisição: request_cancelar_contato.xml

·        Parâmetros de entrada da requisição: Parâmetro Tag Xml Correspondente Descrição Técnica

Código Contato Assistencial* <con:codigoContatoAssistencial></con:codigoContatoAssistencial> Código do Contato Assistencial Formato UUID Versão 4.

·        Parâmetros de retorno da requisição: Parâmetro Tag Xml Correspondente Descrição Técnica

Código Retorno <con:codigoRetorno> </con:codigoRetorno> Enumeração: CANCELAMENTO REALIZADO COM SUCESSO

Disponível em "https://wiki.saude.gov.br/cmd/index.php?title=Integração_de_sistemas_próprios&oldid=373"