Implementando Web Services do Padrão TISS V3.02.01 em Java – Análise Componente de Comunicação – Parte 1

Análise do Componente de Comunicação - Parte 1

No post passado tivemos uma pequena introdução do que se trata o padrão TISS, e baixamos o Componente de Comunicação. Você pode acessá-lo
aqui.
Ao extrair os arquivos no .zip, vemos dois tipos de arquivos: .xsd e wsdl.

Não é objetivo deste post explicar todos os conceitos em envolvem Webservices, mas vou conceituar brevemente alguns termos.

WSDL (Web Services Description Language ) é uma linguagem baseada em XML utilizada para descrever Web Services funcionando como um contrato do serviço. Trata-se de um documento escrito em XML que além de descrever o serviço, especifica como acessá-lo e quais as operações ou métodos disponíveis.

XSD (Xml Schema Describes) também é linguagem baseada em XML, e em linhas gerais define as regras para se criar um objeto, como atributos e seus respectivos tipos, tamanho, regras de validação utilizando REGEX e etc.

Na Parte 1 vamos focar nos wsdls:

• tissCancelaGuiaV3_02_01.wsdl
• tissComunicacaoBeneficiarioV3_02_01.wsdl
• tissLoteAnexoV3_02_01.wsdl
• tissLoteGuiasV3_02_01.wsdl
• tissRecursoGlosaV3_02_01.wsdl
• tissSolicitacaoDemonstrativoRetornoV3_02_01.wsdl
• tissSolicitacaoProcedimentoV3_02_01.wsdl
• tissSolicitacaoStatusAutorizacaoV3_02_01.wsdl
• tissSolicitacaoStatusProtocoloV3_02_01.wsdl
• tissSolicitacaoStatusRecursoGlosaV3_02_01.wsdl
• tissVerificaElegibilidadeV3_02_01.wsdl

Abra um dos arquivos listados acima em um editor de texto da sua preferência ou no próprio browser.
Observe que temos uma tag operation:

<br /> <operation name="tissVerificaElegibilidade_Operation"><br /> <input message="tns:tissVerificaElegibilidade_Request"/><br /> <output message="tns:tissVerificaElegibilidade_Response"/><br /> <fault name="TissFault" message="tns:tissFault"/><br /> </operation><br />

tissVerificaElegibilidade_Operationé o nome de método do nosso Webservice.

Um webservice pode ter vários métodos, mas o padrão adotado foi um método por wsdl.
Ainda dentro de operation, podemos ver as tags input e output. Elas apontam tipos complexos definidos nos arquivos .xsd. Temos aí a definição dos parâmetros de entrada e saída desta função.
Observe também que os tipos indicados como entrada e saída também são mapeados:
<br /> <message name="tissVerificaElegibilidade_Request"><br /> <part name="pedidoElegibilidade" element="ans:pedidoElegibilidadeWS"/><br /> </message><br /> <message name="tissVerificaElegibilidade_Response"><br /> <part name="respostaElegibilidade" element="ans:respostaElegibilidadeWS"/><br /> </message><br />

Abra os demais arquivos .wsdl e veja que todos possuem o mesmo padrão.