Manual de Utilização do TISSNet
Contents
1. Provedor Conectividade ass 1 3 3 Prestador x Operadora Comunicando se via Provedor de Conectividade Contratado pela Operadora Neste caso segundo o que se ajustou no COPISS o provedor de conectividade equipara se a um departamento da operadora Assim a comunica o entre o provedor de conectividade e o prestador deve se fazer segundo os pa dr es do TISS tanto no que toca s mensagens quanto no concernente aos protocolos envolvidos Entre a operadora e o provedor de conectividade a comunica o pode assumir qualquer forma 16 11 2007 5 30 US TissNet 4 X al teri proibia Ts gt Provedor Conectividade 1 3 4 Prestador x Operadora Comunicando se Diretamente via Transmiss o Ponto a Ponto TIS SNet Com ambas as pontas utilizando o TISSNet o protocolo de comunica o ponto a ponto do aplicativo ser usado e as caixas de entrada e sa da dever o obedecer organiza o prevista Neste caso as mensagens ser o transmitidas em lotes para a operadora e quando o lote se encer rar o sentido da comunica o ser revertido e as mensagens da operadora para o prestador passa r o a vir para a caixa de entrada deste ltimo Como o TISSNet contata cada operadora ainda que n o haja mensagens destinadas a ela um even tual lote da operadora para o prestador ser enviado t o logo o prestador comande nova transmis s o para qualquer operadora ainda que n o seja a que deseja enviar o lote a ele todas2. o de decodifica o 14 30 fat TissNet 4 X Nacional d x ANS iir Nacional de Prestador Operadora Transmite a mensagem padronizada ACK Passa a mensagem ao despachante para proces samento Se recebeu ACK a mensagem chegou ao desti Quando termina o processamento da mensagem no Neste caso passa a esperar uma segunda pelo par despachante digestor envia a resposta resposta dada pelo digestor em execu o no deles ao prestador computador remoto se n o recebeu sinaliza que houve erro Se recebeu COMMIT apaga a mensagem da fila Se h mensagens da operadora para o prestador de transmiss o em contato transmite as mensagens uma a A A uma usando o mesmo processo explicado aqui Se h mais mensagens repet iclo at i di inem 9 e ARS agu o sentido da comunica o se reverte Se n o h mais mensagens transmite mensa gem padronizada EOT Ao final ou se nada houver a transmitir envia mensagem padr o EOT Entra em modo de espera por mensagens Os ciclos acima se repetem para todas as operadoras com as quais o prestador se relaciona Se n o houver mensagens do prestador para a operadora o prestador abre a conex o e envia EOT passan do a aguardar respostas da operadora Se a operadora n o tiver nada a enviar responder com ou tra mensagem EOT 2 4 3 Web Services No caso dos web services cada classe de implementa o tamb m chama o Despachante Antes dis
3. o de nodos TISSNet para distribui o aos seus presta dores ou inform los sobre os par metros de comunica o URL dos WSDL s dos servi os 16 11 2007 24 30 fat TissNet 4 X Nacional d tst ANS Meo de 4 USO DO TISSNET 4 1 Ativac o A forma de ativar o programa depende do sistema operacional em uso e do modo de opera o A tabela abaixo mostra como fazer dependendo do caso Usu rio Sistema Comando Prestador WINDOWS ou MacOS Clique duas v zes sobre o arquivo TissNetXXX jar no dire t rio de instala o Pode se criar um atalho para este arqui vo na rea de trabalho se se desejar faz lo Se isto n o funcionar use a instru o abaixo dada para sis temas LINUX Esta funciona sempre LINUX ou outro UNIX Abra uma janela de comando shell dusiquer V para a pasta na qual instalou o programa Digite o comando java jar TissNetXXX jar Se o UNIX conta com o KDE ou outro gerenciador de jane las equivalente pode se criar um cone na rea de trabalho que aponte para o comando acima permitindo a ativa o visual do programa Operadora Qualquer modo pon Abra uma janela de comandos no diret rio no qual o progra to a ponto ma est instalado Emita o comando java cp TissNetXXX jar br gov ans tiss servidor Ou vinte Qualquer web servi Ative o application server no qual se fez o deployment ces do TISSNetXXX jar 4 2 Enviando Mensagens Pr
4. os arquivos v lidos aqueles que representam mensagens TISS v lidas e formar uma fila de transmiss o mostrando a na tela Li ANS Nero GIENE Ponto a pulito Aguardando comandos SOLIC STATUS PROTOCOLO 123456789 gt 987654 SOLIC STATUS PROTOCOLO 123456789 gt 123456 Operadoras Prefer ncias 000000 ajuste os c digos o host e a porta 333333 localhost 123456 https portalgeinf 8181 tissTransmiteMensagem 444444 localhost 987654 https portalgeinf 8181 tissTransmiteMensagem 16 11 2007 26 30 fat TissNet 4 X Nacional d tt ANS Meo de 4 2 3 A Transmiss o Para iniciar um ciclo de transmiss o e recep o de mensagens basta ent o pressionar o bot o Transmite Quando um prestador pressiona o bot o Transmite de seu programa TissNet os seguintes passos s o dados 1 Para cada Nodo operadora cadastrado abre se um canal de comunica o 2 Enviam se todas as mensagens do prestador destinadas operadora se houver mensagens a enviar usando o canal apropriado para a operadora 3 No caso de transmiss o via web service se a resposta a uma mensagem for uma outra mensagem TISS ela ser entregue ao digestor especializado em tr fego de web services lembre se de que o digestor default o downloader que apenas coloca a mensagem na caixa de entrada e p ra Se este digestor replicar co
5. 999999 ser o gravados na pasta home tiss 20060226 999999 ABC123 O nome ser algo como 00000000000000000025 35b2ed93b6c0d07b96bfdfd6cbef4d xml A grava o neste padr o garante que as mensagens ser o recebidas na ordem em que devem ser processadas pelo aplicativo TISS do destinat rio Faz tamb m com que a mera c pia da pas ta base de recep o sirva tanto como um backup eficiente quanto como um log de transa es As mensagens recebidas devem ser importadas pelo aplicativo TISS operado na ordem em que fo ram gravadas Construir tal aplicativo responsabilidade de cada prestador ou operadora 16 11 2007 30 30
6. ER 10 2 4 Modelo de Operacda0O occcconcncconnnconnnccnnnnnrnnanornnnnornnnnorannnnrnnnnnrnnnnnrnnnnnrannnnrananananass 11 2 4 1 Modo Ponto a Ponto essssssssssesssesee nenne nne r ie nne nera nenne nennen nnns 11 2 4 2 Resumo do Protocolo de Comunica o no Modo Ponto a PONtO cccoccccccnccncccncnnancncnnonnnos 13 EO NCSEUTTORI SUU 15 2 5 A Configurac o seeeseseeiuseseuusnsauasuuuuamuaasusuuuamuuuusRu uu AR uua gau ua uu uaa uu au unn 16 2 6 Efici ncia de Transmiss o sseeeeeseeeeesen enn nnn naa annn uana rr 17 2 7 Proxy Servers eesessseeesuuuasss uu 4 ARARRRRARRRRRRRRRARRSERERRRARRSAERRRRRREESRRRRRRERSERRRRRRSRRSSSRRX 17 2 8 SOQUIANCAccccconnccccnnnnnnoconnnnnn ocn anno A RARARRRRRRRASRRRRRARRSRRSRRRRRREERRRRRASERIERRRRRERSERRRRRRSIRSSSRRX 17 2 8 1 Prote o da Mensagem e do Canal de TransMissd0O ooccoccocnncncnconcnnononconanonnnancnronanncnonnonos 17 2 8 2 Tratamento de Certificados DigitaiS oocoonccconncoccconcnnncnnncncnnccnncnoncnnnnnnnnnnnncnnnnnnnrnnnrnnnnnns 18 2 9 M ltiplas Vers es do Padr o eeeeeeeee eene ene nennen annua uauu sunu uuu uuu a un 18 3 INSTALACAO ssssssssessuuunuuuuhuhuu uuu RR RR AA AA uuu u uuu 20 3 1 Condi es Preliminares eeeeeereeeeeee nennen rr 20 3 2 Prestadores cada icanimana Estude VY REESE KA RIO WX EEG ARE RENE EAR DSO ea nan
7. NEAN NR EAR NS NE YER RENE E 21 3 2 1 Caso 1 N o Informatizado sssssssssssessessseeeeeee nennen nnn nnne nnn nenne nennen 21 3 2 2 Caso 2 Informatizado Usando Sistema Anterior ao TlSS ooccocccccncincnnonnnnnnnnnconannnananononnns 21 3 2 3 Caso 3 Informatizado com Sistema Integrado ao TISSNet ou Dotado de M dulo de Co munica o Equivalente sssssssesssessesesesenene nennen nennen ener nnt tene tese nennt rne nnne nnne nas 21 3 2 4 Caso 4 Informatizado com Sistema N o Integrado ao TISSNet e Sem M dulo de Comu nicacao Equivalente usa oie etie D eee oe See Tu rp adidas tede eut de Sana E pei nba pd 21 3 2 5 Uso de Web Services iic eie ada Rida qa TERRE nadas 22 3 3 OPeradoraS comocccconnnconnnccnnnncnnnnnrnnnn enn nn ARR RR ARRA RR GGRRAuXRRARASRRRXRRRRSARRRRSuRRSSSu Rug uu uan 22 3 3 1 Caso 1 Sem Web Services e Sem Certificado Digital para Canal SSL Seguro 22 3 3 2 Caso 2 Sem Web Services Mas Com Certificado Digital para Canal SSL Seguro 22 3 3 3 Caso 3 Com Web Services nennen nenne nnns snis nnne nennen s 23 4 USO DO TISSNET rrns sena nna nera n RRE suus uu ua uua aa uasa assa ssssssrusrrrruruuuesses sensns nons 25 4 1 AtIVA O mt E 25 4 2 Enviando Mensagens PrestadoreS mmmconnoncconnnnconnnncrannnncrnnnnnrananncrananoranannaninanss 25 4 2 1 Definindo Nodos de Comunica oO s sssssssresrertsrtrt
8. enviar mensagens para o pres tador desta forma O mesmo se aplica ao servi o tissTransmiteMensagemzZIP Nestes casos o digestor deve providenciar uma resposta imediata a cada mensagem recebida Um web service opera em um ciclo bem definido de pedido de servi o gt envio de resposta que se encerra com a resposta Assim n o h como reverter o sentido da comunica o para enviar um n mero arbitr rio de mensagens de volta para o prestador ao final da recep o das mensagens vindas deste 4 3 2 Web Services no Modo Ponto a Ponto Web services s o servi os on line O conceito de fila de transmiss o em princ pio estranho a eles Um web service normalmente opera em um ciclo simples de pedido de servi o envio de resposta sem filas l e c Operadoras que desejem usar web services para receber mensagens TISS pelo TISSNet devem estar preparadas para enviar as respostas a cada mensagem imediatamente ap s a recep o des tas Neste caso n o se utilizar o filas e o conte do de eventuais filas de transmiss o operadora gt prestador ser simplesmente ignorado A nica outra alternativa poss vel contar com um prestador que tamb m opere um web service de recep o de mensagens nos moldes do tissTransmiteMensagem ou do tissTransmiteMensa gemZIP A operadora ent o poder enviar suas mensagens contactando este servi o Neste con texto por m ser s
9. n o houver validador de certificados qualquer certificado digital v lido ser aceito para qualquer men sagem recebida 2 5 A Configura o O TISSNet pode ser configurado a partir de um arquivo tiss ini que esteja presente no diret rio a partir do qual ele chamado H defaults para quase todas as op es mas boa pr tica manter um arquivos destes atualizado com as suas op es particulares O arquivo tem coment rios descre vendo cada op o poss vel Um exemplo est na tabela abaixo tiss schema file schemas tissV2 01 03 xsd tiss versao atual 2201503 versao anterior mas ainda suportada dos esquemas tiss versao anterior 2 01 02 tiss schema anterior file schemas tissV2 01 02 xsd esquema de informacoes do TISSNet tissnet schema file schemas tissnetV2 01 03 xsd tiss timeout soquete 200000 tiss persistencia raiz home kurumin tmp tiss persistencia tiss log raiz home kurumin tmp tiss logs tiss recepcao raiz home kurumin tmp tiss recepcao tiss keystore padrao home kurumin tmp tiss chico keys tiss keystore senha xpto44 tiss truststore padrao home kurumin tmp tiss cacerts jks tiss truststore senha xpto44 tiss validador certificados HHH Pa r met ros do PRESTADOR 21 A A A A A tiss proxy host tiss proxy port Par metros da OPERADORA tiss transmissao raiz home kurumin tmp tiss transmissao tis
10. nodos podem ser cadastrados preenchendo se os dados sob a guia Operadoras na parte in ferior direita da tela ou pela importac o de um arquivo XML padronizado contendo uma ou mais de fini es de nodos Todos os nodos devem estar previamente cadastrados ou o TissNet se recusar a aceitar mensa gens destinadas s operadoras desconhecidas Assim comece a operac o cadastrando todas as operadoras com as quais seu prestador se relaciona IMPORTANTE Para abrir um novo registro em branco e cadastrar por digita o uma nova operadora basta clicar a guia Operadoras Se a operadora lhe enviou um arquivo XML com defini es de nodos arraste o para cima da ta bela sob a guia Operadoras Todas as defini es do arquivo ser o importadas Voc tamb m pode arrastar e soltar um diret rio inteiro se houver v rios arquivos em uma mesma pasta O TISSNet importar todos os arquivos XML que contenham defini es de nodos e ignorar os demais N o poss vel excluir nodos cadastrados mas voc pode modificar todos os dados transfor mando um nodo indesejado em outro ou pode apagar o arquivos nodos tis da pasta de persis t ncia e recadastrar todos os seus nodos depois 4 2 2 Formando a Fila de Transmiss o Feito o cadastramento dos nodos basta arrastar e soltar os arquivos ou a pasta que os cont m na rea retangular esquerda da tela do programa sob os bot es de comando O TissNet identifi car
11. objetos um com esta mensagem com a estrutura definida pelo padr o XML do TISS e outro com o dono do certificado chamado de principal A aplica o pode r neste momento sinalizar que o dono n o est autorizado a mandar aquela mensagem embora possua um certificado v lido E claro que isto s ser poss vel ser houver no principal do certifica do alguma informa o que possa ser cruzada com elementos da mensagem 2 9 M ltiplas Vers es do Padr o Ficou acertado nas reuni es do COPISS que quando uma nova vers o do padr o de conte do e estrutura fosse publicada a anterior deveria continuar a ser suportada por um tempo para que to dos pudessem se adequar ao novo padr o sem grandes traumas 16 11 2007 18 30 fat TissNet 4 X Nacional de xt ANS irs Nacional te Isto significa que qualquer sistema produtor de servicos ou consumidor de mensagens TISS deve ser capaz de manusear mensagens em pelo menos duas vers es do padr o O TISSNet em sua implementa o de web services a nica padronizada pelo comit tem supor te a duas vers es do padr o e isto pode ser configurado atrav s do arquivo de configura o tiss i ni A transmiss o ponto a ponto n o padronizada opera apenas com a ltima vers o embora na re cep o seja capaz de suportar at duas Assim adotando se o TISSNet as mensagens transmiti das dever o estar aderentes ltima vers o publicada do padr o mas as m
12. onde as prefer ncias podem ser informadas visualmente mas os valores ser o substitu dos por valores presentes no arquivo tiss ini a cada execu o Assim se se desejar utilizar apenas a tela de registro deve se evitar preencher valores tamb m no arquivo tiss ini mantendo o em branco 3 ATEN O ISSO IMPORTANTE Se se pretende usar comunica o ponto a ponto atrav s de web services se alguma ope radora com a qual o prestador se relaciona divulgar que sua transmiss o se faz preenchen do se o host com http lt qualquer coisa gt ou https lt qualquer coisa gt o prestador est neste caso deve se copiar todos os arquivos jar da subpasta lib extra da para a subpas 16 11 2007 21 30 fat TissNet 4 X Nacional d xs ANS ger Nacional de Pas A o so ta lib endorsed do diret rio no qual est instalado seu java runtime environment JRE Se a pasta endorsed n o existir l crie uma manualmente Isso necess rio porque a infraestrutura de cliente de web services do TISSNet 4 0 usa a vers o 2 1 da API JAXB e a vers o distribu da com o JRE 6 a 2 0 3 2 5 Uso de Web Services Por decis o do COPISS o uso de web services por prestadores e operadoras exigir canal seguro com m tua certifica o Se alguma operadora com a qual voc transaciona oferece este caminho para o tr fego de mensagens TISS e voc optar por utiliz
13. que possui certificado digital Nesta op o tanto web services quanto transmiss o ponto a ponto podem ser usadas Pas A o so 1 Projetar e construir um ValidadorCertificados para verificar a cada mensagem se o dono do certificado est autorizado a transmit la colocando o em um jar Este passo opcional mas se n o for feito qualquer certificado digital v lido ser aceito para qual quer mensagem 2 Projetar e construir digestores para cada um dos web services oferecidos colocando os tamb m em um jar pode ser o mesmo do passo 1 naturalmente 3 Extrair todo o conte do do zipfile em um diret rio qualquer escolhido Se um validador de certificados tiver sido constru do copiar o jar do passo 1 para o subdire t rio lib do diret rio no qual o ZIP do TISSNet foi extra do Isto permitir valida o de cer tificados em transmiss es ponto a ponto 5 Copiar o jar do passo 2 para o subdiret rio lib do diret rio no qual o ZIP do TISSNet foi ex tra do Isto permitir o uso pleno de transmiss es ponto a ponto Editar ent o o arquivo tiss ini registrando l as prefer ncias iniciais de execu o 7 Copiar o arquivo TissNetXXX jar para o diret rio de hot deployment do application ser ver ou se este n o suportar hot deployment comandar o deployment do servi o conti do no jar do TissNet 1 IMPORTANTE o TISSNet vem com os deployme
14. Isso se revelou problem tico quando o transmissor e o receptor operavam em velocidades muito diferentes o receptor s v zes recebia um bloco completo em mais de uma parte o que o levava erradamente a concluir que a transmiss o da mensagem havia se encerrado A partir da vers o 3 10 passou se a usar uma mensagem de controle EOM para sinalizar fim de mensagem Isso resolveu o problema mas como mudou o protocolo a comunica o entre um TISSNet de ver s o 3 9 ou anterior com outro de vers o 3 10 ou posterior deixou de ser poss vel Se o ponto a ponto for utilizado atrav s do web service tissTransmiteMensagem usa se um cli ente web service simples para transmitir mensagens As mensagens poder o seguir comprimidas ou n o Isto depender do que for julgado mais curto Codificar um string comprimido em base64 dependendo do tamanho do texto original pode produzir um resultado mais longo que ele Assim o TissNet faz uma an lise mensagem a mensagem do que tem a transmitir Se a vers o comprimida for mais curta quase sempre transmitir esta vers o se o texto claro for mais curto transmitir o texto claro A partir da vers o 4 0 um novo web service tissTransmiteMensagemZIP passou a poder ser usado em transmiss es ponto a ponto Este servi o que padronizado pelo COPISS envia as mensagens sempre em forma comprimida e devolve uma outra mensagem TISS no mesmo forma to como resposta 2 7 P
15. JAVA devem implementar a interface br gov ans tiss digestores Digestor Al m da infraestrutura ponto a ponto os seguintes web services foram constru dos Entrada Servico Sa da CancelaGuia TissCancelaGuia ReciboCancelaGuia LoteGuias TissLoteGuias ProtocoloRecebimento SolicitacaoDemonstrativoRetorno TissSolicitacaoDemonstrativoRetorno DemonstrativoRetorno SolicitacaoProcedimento TissSolicitacaoProcedimento AutorizacaoProcedimento SolicitacaoStatusProtocolo TissSolicitacaoStatusProtocolo SituacaoProtocolo STRING TissTransmiteMensagem STRING VerificaElegibilidade TissVerificaElegibilidade RespostaElegibilidade SolicitacaoStatusAutorizacao TissSolicitacaoStatusAutorizacao SituacaoAutorizacao Tipo da Mensagem XML da mensagem Tipo de Mensagem XML da mensagem TissTransmiteMensagemZIP resposta Note que o TissTransmiteMensagem pode ser usado para transmiss o ponto a ponto se n o se de sejar a utilizac o do servidor ponto a ponto propriet rio que o marcado com s foi definido a partir da vers o 3 5 e que o marcado com s passou a existir na vers o 4 0 A implementac o de refer ncia para web services usa annotations no padr o EJB 3 0 compat vel com application servers aderentes a JSR 181 Um exemplo destes application servers o GLAS SFISH sistema livre patrocinado em parte pela SUN o application server da SUN baseia se nes
16. SS O cliente TISSNet suporta este tipo de di logo quando uma mensagem TISS recebida em respos ta transmiss o de outra mensagem TISS o cliente TISSNet encaminha a resposta a um despa chante para processamento e este por sua vez a encaminha a um digestor nomeado se este di gestor responder com outra mensagem TISS ela ser transmitida operadora e o ciclo recome a r mantendo se at que um dos lados responda com uma mensagem que n o seja uma mensagem TISS Como o digestor padr o o Downloader as mensagens resposta ser o na pior hip tese postas na caixa de entrada do prestador e l ficar o aguardando processamento por seus aplicativos 1 3 6 Prestador x Operadora Comunicando se Diretamente com Web Service Interativo Pa dronizado TISS Este cen rio apesar de tecnologicamente mais avan ado que o anterior de opera o mais sim ples O prestador tem aplicativo capaz de consumir web services e a operadora responde on line a cada pedido de servi o 16 11 2007 7 30 A TissNet 4 X Nacional de q ANS ra po iai H v rios caminhos poss veis para o fluxo da informa o envolvendo ou n o o TISSNet Mas tudo se passar como se o aplicativo do prestador estivesse consumindo informa es geradas on line pelo sistema da operadora 16 11 2007 8 30 fat TissNet 4 X Nacional d tst ANS Meo de 2 CONCEITOS E DEFINI ES 2 1 O Que o TissNet O TissNet com
17. aguardar mensagem Transmite mensagem PONTA A Registra a identifica o do prestador para refe r ncia Estabelecida uma conex o come a o processo de transmiss o de mensagens prestador gt operado ra Para cada mensagem os seguintes passos s o executados Prestador Operadora Transforma a mensagem em uma seq ncia de bytes usando o charset ISO 8859 1 Usando o AgenteZIP comprime os bytes ge rando outro array de bytes Usando o AgenteRijndael e a chave RIJNDAEL corrente encripta a mensagem comprimida ge rando outro byte array Usando o texto original da mensagem modifica a chave RIJNDAEL corrente gerando a chave da pr xima opera o de decodifica o Calcula o string base64 correspondente men sagem comprimida e encriptada Envia a mensagem usando println sobre a gra vadora associada ao soquete Envia a mensagem padronizada EOM atrav s de um segundo println Espera a resposta do computador remoto 16 11 2007 Aguarda chegada dos bytes da mensagem Concatena os bytes de todos os blocos recebi dos at que receba a mensagem EOM Usando o processo inverso ao descrito no passo anterior para o prestador decodifica e expande o byte array recebido obtendo o texto da men sagem original no charset ISO 8859 1 Usando o texto original obtido modifica a chave RIJNDAEL gerando a chave da pr xima opera
18. ca o do prestador No modo operadora servidor ponto a ponto o programa nunca tenta se conectar a um prestador Quando o prestador se conecta a uma operadora o fluxo geral de opera es da comunica o o se guinte Prestador Operadora Abre conex o com a operadora usando o host Inicia thread dedicada ao atendimento da co e a porta definidos nex o e fica aguardando mensagens Seta o timeout do soquete de acordo com o Calcula primeira chave RIJNDAEL como o hash 16 11 2007 13 30 Ag ncia Nacional de Sa de Suplementar E s AN TissNet 4 X Prestador par metro correspondente em tiss ini Operadora MD5 do IP do cliente a data corrente a frase a dor imaterial que magoa teu riso Seta o timeout do soquete de acordo com o par metro do tiss ini Se se trata de soquete SSL comanda execu o de procedimentos de handshake SSL se hou ver erro abre novamente a conex o desta vez usando um soquete aberto n o protegido Executa handshake SSL se o canal puder ser protegido assim ou aborta a comunica o em caso contr rio Transmite mensagem HANDSHAKE Envia a base para a primeira chave RIJNDAEL Muda a chave RIJNDAEL gerando a primeira cha ve verdadeira Recebe a chave e inicializa sua c pia da chave RIJNDAEL com o texto recebido Muda a chave RIJNDAEL gerando a primeira cha ve verdadeira Passa a
19. cativo de seu fornecedor de programas ter que ser adaptado ao padr o TISS Pe a a seu fornecedor que fa a isso Seu fornecedor ter duas linhas b sicas de a o produzir uma vers o integr ao TISSNet ou dotada de componente de comunica o equivalente capaz de enviar e receber mensagens TISS de forma transparente sem requerer a es adicionais de sua parte produzir uma vers o que gere mensagens TISS sem no entanto transmit las automaticamen te Veja abaixo o que corresponde ao seu caso ap s a adapta o do aplicativo e siga o escrito l 3 2 3 Caso 3 Informatizado com Sistema Integrado ao TISSNet ou Dotado de M dulo de Co municac o Equivalente Se o sistema est neste caso a instala o do sistema deve contemplar tamb m toda a infraestru tura necess ria transmiss o das mensagens Neste caso bastar seguir os procedimentos de instala o de seu fornecedor 3 2 4 Caso 4 Informatizado com Sistema N o Integrado ao TISSNet e Sem M dulo de Comu nica o Equivalente Neste caso o sistema deve ser capaz de gerar mensagens XML aderentes ao padr o TISS e al m disso deve se instalar o TISSNet em separado Os seguintes passos devem ser seguidos Pas A o so Extrair todo o conte do do zipfile em um diret rio qualquer escolhido 2 Editar o arquivo tiss ini registrando l as prefer ncias iniciais de execu o Vale dizer que h uma tela no programa cliente
20. dos Digitais O ambiente JAVA usa o conceito de dep sito de chaves keystores para seguran a e autentica o digital Um keystore armazena os certificados do usu rio outro keystore armazena os certifi cados das autoridades certificadoras reconhecidas como confi veis pelo usu rio Este segundo keystore chamado de truststore por esta raz o A verifica o de validade de um certificado parte do protocolo de handshake SSL Nesta fase verifica se se o emissor do certificado apresentado pela outra parte consta do truststore Se n o constar o certificado rejeitado e a conex o interrompida Assim se a autoridade certificadora de um certificado que se queira aceitar n o constar das existen tes no ambiente deve se importar o certificado desta autoridade para o truststore do ambi ente atrav s do utilit rio keytool presente no JDK padr o da SUN O truststore padr o costuma estar em JAVA HOME gt jre lib security cacerts Infelizmente a aceita o do certificado condi o necess ria mas n o suficiente Se se parar por aqui qualquer dono de qualquer certificado v lido poderia enviar qualquer mensagem TISS para qualquer receptor mesmo que esta mensagem esteja associada a algu m que n o seja o dono do certificado Isto claramente indesej vel Para resolver este problema pode se implementar um validador de certificados que receber para cada mensagem recebida dois
21. e prateleira Ele n o pretende ser isso E uma implementa o de refer ncia do padr o e das boas pr ticas acertadas no COPISS Como tal demonstra que tais pr ticas s o exeq veis e pode servir de base para a constru o dos aplicativos reais que o mercado demandar O TISSNet distribu do em c digo fonte aberto livre dispon vel a todos os que dele desejarem se utilizar quer diretamente quer como base para constru o de suas solu es personalizadas O pro grama por ser mera implementa o de refer ncia n o tem qualquer garantia por parte da ANS nem conta com suporte formal a seu uso A ANS oferece um endere o de email tissnet i Gans gov br para que desenvolvedores e usu ri os que desejem utilizar o TISSNet como base para suas implementa es possam tirar d vidas e dis cutir problemas bem como apresentar sugest es de melhoria do c digo base 1 2 P blico Alvo deste Manual Este manual destina se a t cnicos de inform tica que desejem instalar ou customizar o TISSNet e a prestadores e operadoras que estejam implantando o padr o TISS tanto a partir de sistemas exis tentes quanto atrav s da contrata o de um novo aplicativo 1 3 Cen rios de Uso Prestadores e operadoras n o t m uso uniforme de tecnologia ou plataforma Para facilitar a visuali za o do modo de integra o do TISSNet a cada ambiente citam se aqui alguns cen rios poss veis de uso do software ou de s
22. empre melhor usar os web services interativos 4 3 3 Web Services no Modo Interativo Para publicar os web services previstos no padr o basta que a operadora os implemente no pa dr o de seu servidor de aplica es Para utilizar a infraestrutura do TISSNet deve se construir um digestor para cada servi o ofereci do Este digestor um programa classe JAVA que implementa a interface br gov ans tiss diges tores Digestor A interface tem apenas dois m todos um que a ltima oportunidade para validar uma mensagem rejeitando a se for o caso e outro que consome a mensagem gerando um objeto de resposta A natureza deste objeto depende do servi o e sua estrutura est definida no WSDL correspondente 4 4 As Caixas de Entrada de Mensagens no Modo Ponto a Ponto O TissNet grava todas as mensagens recebidas por seu digestor padr o br gov ans tiss digesto res Downloader em pastas chamadas lt tiss recepcao raiz ou a pasta base de recep o se definida visualmente gt lt data de recep o no formato AAAAMMDD gt lt c digo do destinat 16 11 2007 29 30 fat TissNet 4 X Nacional d st ANS Meo de rio gt c digo do remetente Os arquivos recebidos s o nomeados no padr o sequencial da mensagem TISS gt hash MD5 da mensagem TISS gt xml Assim se a pasta base para recep o for a homej tiss os arquivos recebidos no dia 26 02 2006 vindos do prestador ABC123 e destinados operadora
23. ensagens recebidas poder o estar aderentes tanto ltima quanto pen ltima vers o N o o ideal mas melhor do que nada afinal O que o TISSNet entende como ltima e pen ltima vers o s o os esquemas definidos pelos pa r metros tiss schema URL do esquema atual e tiss schema anterior URL do esquema anterior do tiss ini 16 11 2007 19 30 Ag ncia Nacional de Sa de Suplementar tia s AN 3 INSTALA O 3 1 Condi es Preliminares TissNet 4 X O TissNet distribu do como um arquivo comprimido em formato ZIP no qual est o seus compo nentes e a documenta o do aplicativo Depois da descompress o ocupa um espa o em disco de aproximadamente 55 MB a inclu da a documenta o e as bibliotecas de suporte ao uso de web services sem isso ocupa algo em torno de 5 MB Antes de se instalar o aplicativo deve se verificar se os seguintes pr requisitos m nimos est o atendidos Prestadores Operadoras Equipamento com capacidade de processamento m nima equivalente de um micro padr o IBM PC com processador AMD DURON 1 0 Ghz e 256 MB de mem ria Espa o em disco suficiente para armazenar as mensagens exportadas para a operadora e rece bidas dela no per odo de uma semana Acesso INTERNET para o equipamento direta mente ou atrav s de proxy server HTTP Java Runtime Environment JRE de vers o 1 6 ou superior instalado O TissNet n o fu
24. equado de prote o informa o que trafega O TISSNet trata esta ques t o por de uma criptografia secund ria O canal de transmiss o ponto a ponto em princ pio pode ser aberto ou protegido por SSL Neste l timo caso pode se usar certifica o simples apenas o servidor da operadora apresenta certifica do ou m tua tanto a operadora quanto o prestador t m que trocar certificados de seguran a Ainda que n o seja poss vel usar um canal criptografado seguro todas as mensagens transmitidas na op o ponto a ponto fluem comprimidas em padr o ZIP encriptadas por AES RIJNDAEL 256 bits e codificadas em base 64 Isto feito mesmo quando o canal SSL o que significa que neste caso haver uma dupla prote o Para maior prote o do canal a primeira chave de criptografia RIJNDAEL formada a partir de uma ra z enviada em texto claro da operadora para o prestador Embora a ra z da chave seja enviada em texto claro a chave real se forma em cada nodo e nunca transmitida pela rede A chave al m disto trocada a cada mensagem transmitida o que dificulta e em muito a quebra do sigilo O grau de certifica o simples ou m tua pode ser configurado no arquivo tiss ini par metro tiss certificado prestador O uso ou n o de SSL detectado automaticamente no caso de transmis s o ponto a ponto ou indicado pela URL de contato no caso da utiliza o de web services 2 8 2 Tratamento de Certifica
25. estadores Para enviar mensagens TISS para as operadoras os prestadores devem em primeiro lugar gerar os arquivos XML que cont m estas mensagens 4 2 1 Definindo Nodos de Comunicac o O TissNet tamb m precisa saber para onde transmitir cada mensagem preciso pois informar para cada operadora os dados relevantes para o servidor TissNet que ela opera Se a operadora oferece servico TISSNet ponto a ponto deve se registrar o nome do computador que executa o servidor e a porta de comunica o utilizada Se a operadora utilizar se dos web services tissTransmiteMensagem o web service que pode atuar como servidor para transmiss es ponto a ponto ou tissTransmiteMensagemZIP a porta es tar definida juntamente com o nome do computador remoto Assim o n mero da porta de comuni cac es n o precisar ser digitado a porta pode ser deixada com o valor zero 1 Se voc transmite arquivos muito grandes pode ser necess rio aumentar a mem ria dispon vel para o ambiente JAVA Neste caso chame o TISSNet com um par metro adequado como por exemplo Xmx512m java Xmx512m jar Tiss NetXXX jar por exemplo 2 Vale o mesmo da nota 1 acima para o caso de recepc o de arquivos grandes 16 11 2007 25 30 f TissNet 4 X Nacional d ANS LE Os dados que localizam o servico da operadora devem ser fornecidos a cada prestador por ela Estes dados definem um Nodo uma operadora remota que pode se comunicar com um prestador Os
26. eus derivados Vale dizer que os cen rios algumas v zes n o s o mutuamente excludentes podendo um mesmo prestador ou operadora encaixar se em mais de um 16 11 2007 4 30 fat TissNet 4 X Nacional de us ANS os de 1 3 1 Prestador x Operadora em Transmiss o Direta via POS ou Dispositivo Especializado Equivalente Este caso tem sido muito discutido no COPISS por se tratar de tecnologia na qual muito se investiu H que se achar um compromisso que garanta a preserva o dos investimentos e a manuten o do padr o TISS de mensagens Neste caso o TISSNet n o est envolvido O equipamento POS no entanto ter que transmitir e r r men ns n r o TISS o que ser responsabilidade de ambos os participantes do processo tanto prestadores quanto operadoras Prestador miss Oreradora gt Haver um prazo para isso naturalmente mas a discuss o deste prazo est fora do escopo deste documento 1 3 2 Prestador x Operadora Comunicando se via Provedor de Conectividade Contratado pelo Prestador Neste caso segundo o que se ajustou no COPISS o provedor de conectividade equipara se a um departamento do prestador Assim a comunica o entre o provedor de conectividade e a operadora deve se fazer segundo os padr es do TISS tanto no que toca s mensagens quanto no concernente aos protocolos envolvi dos Entre o prestador e o provedor de conectividade a comunica o pode assumir qualquer forma Prestador
27. fa TissNet 4 X Nacional d tut ANO oh end de TISSNet 4 X Guia de Uso 16 11 2007 1 30 fat TissNet 4 X AN Ag ncia Nacional de ud Sa de Suplementar Conteudo E INTRODUCAD c is 4 1 1 Origens e Objetivos do Projeto oommcconccoconcnccnnnnconnncrnnnnrrnnnnrananeranancrnnnnnrnnaarananess 4 1 2 Publico Alvo deste Manual a as 4 1 3 Cen rios de UsOo cereos ee A naaa 4 1 3 1 Prestador x Operadora em Transmiss o Direta via POS ou Dispositivo Especializado Equi O O 5 1 3 2 Prestador x Operadora Comunicando se via Provedor de Conectividade Contratado pelo A A 5 1 3 3 Prestador x Operadora Comunicando se via Provedor de Conectividade Contratado pela Operadora A menisa no sita ied lte eoe Piana Dos ua Ese eaqui durat di depend aja LATO na ola Monet Da aba oa ga dae La ha 5 1 3 4 Prestador x Operadora Comunicando se Diretamente via Transmiss o Ponto a Ponto TIS rec A A An 6 1 3 5 Prestador x Operadora Comunicando se Diretamente via Transmiss o com Web Servi ce em LOLES RERO 6 1 3 6 Prestador x Operadora Comunicando se Diretamente com Web Service Interativo Pa dronizado TISS id ap 7 2 CONCEITOS E DEFINICOES 0000000 uuu uan 9 2 1 O Que o TISSNet iiiulueeucuxuee acra aaa 9 2 2 Requisitos ODServadoS occoococonncconncrnnnconnncrnnnrnnncrnnncrnnnrrnnnrnnnnrnnncrnnnennnrnannranaananass 9 2 3 O Desenho B sico do TISSNet ce crue a e ner nnn nune x nm E c RR Ema ERR RRR
28. finida no COPISS como um conjunto padronizado de web servi ces 2 3 O Desenho B sico do TISSNet O TISSNet foi desenhado para ser extens vel permitindo que sem mudan as em sua programa o componentes possam ser agregados a ele quer na opera o ponto a ponto quer na opera o web services Para que possam ser usados estes componentes devem ser constru dos e empacotados em um ou mais arquivos jar e estes arquivos devem ser ou copiados para a pasta lib do diret rio de ins 16 11 2007 10 30 fat TissNet 4 X Nacional d x ANS ici Nacional de talalac o do TISSNet ou postos em local acess vel ao application server que esteja executando componentes do programa Ao n cleo de comunicac o podem ser agregados a Um validador de certificados que para conex es SSL pode ser configurado para validar mensagem a mensagem se o dono principal do certificado digital recebido est autoriza do a enviar aquela mensagem Esta classe JAVA deve implementar a interface br gov ans tiss nucleo ValidadorCertificados b Um conjunto de digestores que receber o cada transa o mensagem e responder o a ela Digestores separados podem ser especificados para cada um dos web services suportados e o pr prio TISSNet tem um digestor padr o Downloader capaz de pelo menos colocar na caixa de entrada do destinat rio as transa es recebidas na ordem apropriada Estas classes
29. lo seu prestador precisar de um certifi cado digital padronizado Para obter tal certificado entre em contacto com alguma autoridade certificadora que possa lhe ofe recer o servi o Entre em contacto com a operadora para saber mais detalhes sobre este caso O certificado ser ne cess rio qualquer que seja o cen rio no qual se esteja operando 3 3 Operadoras N o consideramos aqui a hip tese de uma operadora n o ter qualquer sistema informatizado de controle operacional Estamos supondo que todas os t m em algum grau 3 3 1 Caso 1 Sem Web Services e Sem Certificado Digital para Canal SSL Seguro Operadoras neste caso poder o apenas usar transmiss es ponto a ponto em batch sem qualquer servi o interativo e pela aus ncia de certificado digital n o v o dispor de canal de transmiss o pro tegido por SSL Pas A o so Extrair todo o conte do do zipfile em um diret rio qualquer escolhido Editar ent o o arquivo tiss ini registrando l as prefer ncias iniciais de execu o Montar um arquivo XML de defini o de nodos TISSNet para distribui o aos seus presta dores ou inform los sobre os par metros de comunica o relevantes nome ou endere o IP do servidor e porta de comunica o 3 3 2 Caso 2 Sem Web Services Mas Com Certificado Digital para Canal SSL Seguro Neste cen rio o canal pode ser protegido por SSL mas apenas transmiss es pon
30. m outra mensagem TISS ela ser trans mitida imediatamente repetindo se este passo at que ou o nodo remoto ou o digestor local responda com um string que n o seja XML de mensagem TISS v lida Quando isto aconte cer encerrar se a transmiss o da mensagem passando se pr xima da fila se n o houver mais nada na fila o programa seguir para o passo 7 Envia se um sinal de fim de transmiss o Aguarda se a primeira mensagem vinda da operadora ou outro sinal de fim de transmis s o Recebem se todas as mensagens da operadora se a primeira mensagem veio Passa se ao pr ximo nodo Assim mesmo que a fila de mensagens esteja vazia todas as operadoras ser o contactadas a cada ciclo para que eventuais mensagens que tenham para o prestador sejam recebidas 4 2 4 Usando Web Services Interativos Web services s o intrinsecamente transacionais funcionando em um ciclo pedido de servi o gt obten o de resposta O requisitante consome o servi o oferecido ou publicado pelo provedor do web service Para utilizar os web services previstos pelo TISS o prestador deve ter um aplicativo hospedeiro capaz de consumir tais servi os Se desejar utilizar a infraestrutura j constru da no TISSNet seu aplicativo deve instanciar uma das classes cliente de web services usando a URL do servi o informada pela operadora e feito isto invocar a opera o prevista l passando lhe o par metro e
31. me o do projeto houve grande preocupa o com o problema dos sistemas de comunica o legados dispositivos servi os e programas usados hoje pelas operadoras e prestadores O in vestimento nestas solu es n o foi pequeno e a preserva o dele deveria claro ser uma priorida de Assim o TissNet em sua primeira vers o foi levado ao COPISS como uma oferta para discuss o O comit desde l tem aperfei oado bastante a id ia e os requisitos do projeto bem como a defini o da fronteira do padr o o que ser exigido o que ser de uso obrigat rio e o que ser mantido como recomenda o ou boa pr tica sem no entanto ser de ado o compuls ria A comunica o ponto a ponto implementada no TISSNet por exemplo ainda n o de ado o obri gat ria nem um padr o de comunica o definido os web services ao contr rio ter o que se guir o padr o definido no COPISS e ter o que aderir aos WSDL s padr o do TISS Operado ras e prestadores NAO PODER O definir web services isoladamente sem aprova o do COPISS nem modificar os WSDL s aprovados pelo comit O TissNet enfim uma oferta p blica de sugest o de caminho a seguir para comunica o de men sagens TISS entre operadoras e prestadores e pretende ser uma oferta da ANS ao mercado cons tru da sempre em estreita colabora o com seus agentes O programa n o deve ser encarado como programa produto ou software d
32. n ciona nas vers es anteriores 1 5 do JRE e se a vers o n o for 1 6 deve se recompilar o programa a partir de seus fontes Esta ver s o pode ser obtida no site da SUN http ja va sun com Observadas estas restri es o sistema operacio nal do equipamento indiferente Equipamento servidor com folga de pot ncia su ficiente para atender s conex es dos prestado res tanto em mem ria quanto em CPU Reco menda se reservar pelo menos 512KB de mem ria para cada conex o esperada Espa o em disco suficiente para armazenar tanto as mensagens recebidas dos prestadores quanto as que devem ser enviadas para cada um deles O espa o deve ser suficiente para armazenar pelo menos uma semana de tr fego Conex o permanente deste equipamento com a INTERNET com banda livre suficientemente grande para acomodar as conex es simult neas esperadas e endere o IP fixo e acess vel a qualquer equipamento conectado web Uma porta TCP dedicada ao servi o que pode ser livremente escolhida E OU um application server compat vel com EJB 3 0 e JSR 181 se preferir receber mensagens pela implementa o de refer ncia do web service Java Runtime Environment JRE de vers o 1 6 ou superior instalado O TissNet n o funciona nas vers es anteriores 1 5 do JRE e se a ver s o n o for 1 6 deve se recompilar o progra ma a partir de seus fontes Esta vers o pode ser ob
33. n o foi testado na ANS Pode prescindir de interfaces visuais sendo manipulado programaticamente Pode executar em ambientes WINDOWS UNIX e Mac Pode ser um web service client Filas de Recep o Caixas de en trada Ordenadas por data de recep o destinat rio remeten te e sequencial de transa o TISS Suportam assim prestadores de servi os que atuem em nome de v rios destinat rios e ou remetentes Permitem processamento das mensagens em ordem de sequencial de transa o TISS Fila de Transmiss o do Prestador Caixa de sa da Administrada pelo aplicativo prestador pode ser usu rio leigo em inform tica Arquivos podem estar em qualquer pasta n o se exige uma organiza o de diret rios padr o Aplicativo monta a fila atrav s de opera es simples e intuitivas tipo arrastar e soltar Fila de Transmiss o da Operadora Caixa de sa da Processador de Mensagens Organizada em pastas cujos nomes s o os c digos dos prestadores na operadora N o preciso ordenar os arquivos por sequencial de transa o TISS Nomes dos arquivos contendo as mensagens podem ser quaisquer Aplicativo limpa a fila ap s transmiss o bem sucedida Modular permitindo que sejam agregados a ele digesto res constru dos separadamente Independente da camada de comunica o Suporte a SOA Service Oriented Architecture Implementa a camada de servi os padr o de
34. nt descriptors do GLASSFISH application server da SUN Se seu application server outro ser preciso abrir o jar do TISSNet e agregar seus deployment descriptors ou ent o recompilar todo o projeto a partir dos fontes adaptando o ao application server utiliza do em sua instala o Cabe destacar tamb m que o GLASSFISH V2 usado nos testes aderente API JAXB 2 1 O JRE 6 distribu do com a JAXB 2 0 Se seu application server n o aderente vers o 2 1 voc deve ou copiar os jars da pasta lib para jre home gt lib endorsed ou tornar estes jars acess veis a seu servidor ou recompilar todos o projeto com sua estrutura de suporte a web services 16 11 2007 23 30 fat TissNet 4 X Nacional d est ANS eoo de Pas Ac o so 8 Copiar o arquivo tiss ini depois de editado para o diret rio a partir do qual o application server l arquivos de configura o para que possa ser lido pelo web service quando do seu uso Se isto n o for feito o servi o ser iniciado com os valores default dos par me tros o que pode n o ser conveniente 9 Se um validador de certificados tiver sido constru do copiar o jar do passo 1 para um dire t rio que esteja no classpath do application server 10 Copiar o jar do passo 2 para um diret rio que esteja no classpath do application server 11 Montar um arquivo XML de defini
35. plementa a implementa o de refer ncia do padr o TISS posta disposi o dos prestadores e das operadoras recentemente pela ANS Enquanto a implementa o de refer ncia do sistema base permite o registro de transa es TISS e a composi o de mensagens TISS o TissNet cuida da transmiss o das mensagens formadas de um ponto a outro tornando as acess veis ao apli cativo TISS que executa nas instala es do destinat rio Todo o TissNet foi escrito na linguagem JAVA e o sistema completamente port til a mesma dis tribui o pode ser executada em qualquer equipamento ou sistema operacional Windows Unix inclusive Linux ou Macintosh que conte com um run time JAVA JRE 1 6 ou superior O aplicativo distribu do tem tr s faces uma face cliente ponto a ponto concebida para ser execu tada pelos prestadores uma face servidor ponto a ponto destinada s operadoras e uma face infraestrutura de suporte a web services que pode ser usada por ambos As tr s faces ou modalidades de operac o est o na mesmo biblioteca jar Isto mais econ mico j que h uma grande rea comum a elas 2 2 Requisitos Observados Mesmo sendo uma implementa o de refer ncia o projeto foi desenvolvido observando alguns re quisitos que s o v PORTABILIDADE o componente de comunica o deve poder executar em qualquer siste ma operacional v SEGURAN A o tr fego gerado pelo componente deve ser criptografado por padr o m
36. roxy Servers A face cliente ponto a ponto do TissNet e claro todos os web services podem funcionar atra v s de um proxy server se o equipamento do prestador n o tiver acesso direto INTERNET H no entanto as seguintes restri es a observar no caso do cliente ponto a ponto a O proxy deve ser do tipo HTTP Os proxies do tipo SOCKS n o s o suportados b O proxy n o deve exigir autentica o do usu rio c O proxy deve permitir abertura de t neis TLS para a porta usada pelo servidor da ope radora O TissNet sempre tenta emitir um comando CONNECT para fechar um t nel destes O tratamento de proxy servers no caso dos web services feito pelas classes de suporte aos protocolos HTTP e HTTPS sendo configurado pelo pr prio ambiente JAVA 2 8 Seguran a 2 8 1 Prote o da Mensagem e do Canal de Transmiss o O tratamento da seguran a no TISSNet varia com o modo de opera o 16 11 2007 17 30 fat TissNet 4 X Nacional d x ANS ici Nacional de O COPISS decidiu que um padr o uniforme e rigoroso de comunicac o s seria exigido para comuni cac o programa a programa via web services Decidiu tamb m que nestes casos o canal deve ria ser protegido por SSL com certificac o m tua tanto da operadora quanto do prestador Assim na comunica o ponto a ponto n o haver exig ncia de prote o por SSL desde que se con siga sem isto um n vel ad
37. s porta servidor 57057 tiss certificado prestador SIM Nome das classes que servirao como digestores para o que for transmitido pela via web services tiss digestor webservices transmitemensagem br gov ans tiss digestores Downloader tiss digestor webservices verificaelegibilidade br gov ans tiss digestores Downloader tiss digestor webservices solicitacaostatusprotocolo br gov ans tiss digestores Downloader tiss digestor webservices solicitacaostatusautorizacao br gov ans tiss digestores Downloader 16 11 2007 16 30 fa TissNet 4 X Nacional d axa ANS 22 Naciona de tiss digestor webservices solicitacaoprocedimento br gov ans tiss digestores Downloader tiss digestor webservices solicitacaodemonstrativoretorno br gov ans tiss digestores Downloader tiss digestor webservices loteguias br gov ans tiss digestores Downloader tiss digestor webservices cancelaguia br gov ans tiss digestores Downloader 2 6 Efici ncia de Transmiss o No modo ponto a ponto o TissNet utiliza os input streams e output streams do JAVA para envi ar e receber mensagens Estes objetos encapsulam muito da funcionalidade de bufferizac o e con trole de tr fego que de outra forma teria que ser implementada manualmente Na recepc o usa se um bloco de 1KB de tamanho e recebem se blocos at que um deles seja a mensagem de controle EOM At a vers o 3 9 inclusive a sinaliza o de fim de mensagem era a recep o de um bloco incom pleto
38. ser o con tactadas e o lote em quest o ser portanto recebido pelo prestador 1 3 5 Prestador x Operadora Comunicando se Diretamente via Transmiss o com Web Servi ce em Lotes Isto s se aplica quando a operadora s desejar oferecer web services sem servi o ponto a ponto convencional e o prestador n o for capaz de consumir os servi os interativos em suas aplica es E o caso mais complicado de operar pois o prestador estar transmitindo em lotes e suas mensagens fluir o como strings XML ele claro precisa da resposta a cada mensagem enviada em sua caixa de entrada e a operadora n o tem como reverter o sentido da comunica o para enviar suas respostas em lo tes nem como enviar todas as respostas depois em um eventual futuro contacto Neste cen rio um application server capaz de executar web services usar os servi os do TISS Net ou outro servi o constru do a partir do mesmo WSDL para receber as mensagens dos presta dores 16 11 2007 6 30 AA TissNet 4 X Ag ncia Nacional d dudo Suplementar As mensagens estar o sendo transmitidas como um string XML e as mensagens de resposta de vem ser enviadas logo ap s o recebimento de cada mensagem do prestador tamb m como um string XML A operadora deve preparar um digestor capaz de tratar as mensagens recebidas e de responder a cada uma na hora com a mensagem resposta apropriada prevista no padr o TI
39. stttttrtt rtrt trta nnne nnne nnne nennen 25 16 11 2007 2 30 f TissNet 4 X AN Ag ncia Nacional de q Sa de Suplementar 4 2 2 Formando a Fila de Transmiss8O ccsseseee RH eene meses serene arara aa 26 4 2 3 A Trans MISSI Oniu de ex a da tiia rua Va a a a ge ada eta Dade da DD box a EUA Da 27 4 2 4 Usando Web Services Interativos memes nr nrn nennen nnne 27 4 3 Enviando Mensagens OperadoraS cmomocconnccconnoronancrnnncrnnnnronannrrnannranansnananananass 29 4 3 1 Servidor Ponto a PODnLO crt sett bt a op Ra ewe cw Rae av Fera o qnd Erba ei n 29 4 3 2 Web Services no Modo Ponto a Ponto sereias renan ase e n 29 4 3 3 Web Services no Modo INteratiVO ococccocncncocononononononononannnnananonanonano nana ne nono ro nennen nan 29 4 4 As Caixas de Entrada de Mensagens no Modo Ponto a Ponto 29 16 11 2007 3 30 fat TissNet 4 X Nacional d x ANS ii Nacional de 1 INTRODU O 1 1 Origens e Objetivos do Projeto A necessidade do TissNet surgiu porque o TISS em sua primeira vers o n o previa padr es ou su gest es para a transmiss o de mensagens padronizadas de um ponto a outro Era um padr o de tro ca que n o trocava em suma Com o TissNet completou se o ciclo desejado as mensagens teriam um formato padr o e seriam encaminhadas de seu emissor a seu destinat rio por um conjunto bem estabelecido de padr es e recomenda es Desde o co
40. tCabecalho getIdentificacaoTransacao setDataRegistroTransacao DatatypeFactoryImpl newInstance newXMLGregorianCalendarDate 2006 10 10 DatatypeConstants FIELD UNDEFINED w parm getCabecalho getIdentificacaoTransacao setHoraRegistroTransacao DatatypeFactoryImpl newInstance newXMLGregorianCalendarTime 10 10 0 DatatypeConstants FIELD UNDEFINED w parm getCabecalho setVersaoPadrao 2 01 02 w parm getCabecalho getIdentificacaoTransacao setTipoTransacao StTipoTransacao SO LIC STATUS PROTOCOLO w parm getCabecalho getIdentificacaoTransacao setSequencialTransacao new BigInte Ger 3547 dg w parm setSolicitacaoStatusProtocolo new CtSolicitacaoStatusProtocolo w parm getSolicitacaoStatusProtocolo setDadosPrestador new CtContratado w parm getSolicitacaoStatusProtocolo getDadosPrestador setIdentificacao new CtIdenti ficacaoPrestador w parm getSolicitacaoStatusProtocolo getDadosPrestador getIdentificacao setCpf 44455566677 w parm getSolicitacaoStatusProtocolo getDadosPrestador setNomeContratado JOAQUIM MANUEL DE CARVALHO w parm getSolicitacaoStatusProtocolo setRegistroANS 123456 w parm getSolicitacaoStatusProtocolo setDataSolicitacao DatatypeFactoryImpl newInstance newXMLGregorianCalendarDate 2006 10 10 DatatypeConstants FIELD UNDEFINED w parm getSolicitacaoStatusProtocolo getNumeroProtocolo add new BigInteger 345670 w parm getSolicitacaoS
41. tatusProtocolo getNumeroProtocolo add new BigInteger 345684 w parm setHash b30f45cb2e68c6f60db900f5cd8c8e614d dispara pedido WsSituacaoProtocolo w resp w port tissSolicitacaoStatusProtocoloOperation w parm catch Exception ex TODO handle custom exceptions here ex printStackTrace 16 11 2007 28 30 fat TissNet 4 X Nacional d xd ANS ii Nacional de 4 3 Enviando Mensagens Operadoras 4 3 1 Servidor Ponto a Ponto O TissNet transmite mensagens para os prestadores automaticamente sempre que cada prestador contata o servidor da operadora Toda a iniciativa da comunica o do prestador O servidor da operadora passivo s tentando enviar mensagens aos prestadores quanto contactado por eles O sistema assume que a fila de transmiss o para um dado prestador s o os arquivos que est o sob a pasta lt tiss transmissao raiz isto um par metro do arquivo tiss ini gt lt c digo do prestador na operadora Para transmitir mensagens para o prestador portanto basta formar estas pastas Tudo que estiver nestas pastas se for uma mensagem TISS v lida ser enviado ao prestador Se o envio for bem sucedido os arquivos ser o exclu dos sen o permanecer o a indefinidamente at que o prestador os receba com sucesso important ssimo observar que se se optar por utilizar o web service tissTransmiteMensagem para a recep o de mensagens ponto a ponto ser imposs vel
42. te c digo e baixado junto com o J2EE 5 0 que usamos para testar a implementac o 2 4 Modelo de Operac o 2 4 1 Modo Ponto a Ponto 16 11 2007 11 30 TissNet 4 X de jona Sa de Suplementar Ag ncia Nac S AN nd 4 djzuabesua ya pusut 551 n ap ar Eli ad cu amp s3zl palm JB PRO ui J01536 g Japeojumod qpyauaby Wo qayaby Sapepalido JEs 09 eneldo aby galg p o 551 59pepalidoJJES 0g EEEE E ae pufrjaiuaDy EE uae sua pau SEA 551 1 W DESSIMISUBA JTJ JOPAS Puoldunga gua etis qual SOPEIUI OPERIRA EEVEE auo gt gt gt 5 12 30 16 11 2007 fa TissNet 4 X Nacional d us ANS toiros Nacionai de Como se nota tanto o web service quanto o servidor ponto a ponto usam um Despachante para orientar o consumo das mensagens recebidas e este Despachante por sua vez invoca o Digestor apropriado depois de se for o caso passar a mensagem e o principal conectado a um Validador Certificados O Despachante assim uma esp cie de ponto de converg ncia de todas as mensagens que de vem ser consumidas pelo destinat rio No lado cliente toda a opera o comandada por uma classe n o visual o ClienteFuncional O cliente visual uma mera camada de apresenta o para comand la Isto torna poss vel o enve lopamento do ClienteFuncional como uma DLL ActiveX transformando o em
43. tida no site da SUN http java sun com Observadas estas restri es o sistema operacio nal do equipamento indiferente O TISSNet testado na ANS em plataforma WINDOWS XP SP2 e LINUX KURUMIN 7 0 ambos com JDK 1 6 UPDATE 2 O application server usado nos testes das implementa es de web ser vices o GLASSFISH V2 b58 No desenvolvimento usa se o NETBEANS 6 0 beta 2 em ingl s A instala o em si compreende os passos descritos nos t picos abaixo Nem todos os passos se apli cam a todas as situa es Siga O prescrito no caso em que se enquadrar melhor 16 11 2007 20 30 fat TissNet 4 X Nacional d xd ANS iir Nacional de 3 2 Prestadores 3 2 1 Caso 1 N o Informatizado Prestadores n o informatizados que desejem contratar um sistema devem procurar no mercado por alternativas aderentes ao padr o TISS Cabe ressaltar que o padr o prev opera o com guias em papel e n o exige que se tenha um sistema informatizado Contratado este sistema ele prestador estar enquadrado em um dos casos abaixo Basta seguir o preconizado no caso que melhor se adaptar nova realidade Optando por operar sem sistema informatizado de suporte ao TISS o prestador estar obrigado a utilizar as guias padronizadas em papel previstas pelo padr o TISS Consulte o hot site do TISS em http www ans gov br 3 2 2 Caso 2 Informatizado Usando Sistema Anterior ao TISS Neste caso o apli
44. to descobre o Digestor que deve ser usado consultando par metros do arquivo tiss ini Final mente analisa o retorno do Despachante para ver se cont m um objeto de resposta ou uma sinali za o de erro Dependendo do que achar retorna o objeto ou levanta uma exce o prevista no WSDL do servi o Vale observar que o Despachante recebe um objeto MensagemTISS como par metro este objeto tem a mesma estrutura do elemento XML de mesmo nome previsto no padr o TISS enquanto o Digestor manipula um objeto MensagemTiss este objeto mais antigo existindo desde o TISS Net 1 0 um super envelope para a mensagem mantendo sua representa o em 3 formatos texto XML estrutura DOM e objeto MensagemTISS Construir um objeto MensagemTISS a partir dos par metros recebidos responsabilidade de cada provedor de servi o endpoint construir um objeto MensagemTiss a partir de um Mensagem TISS tarefa do Despachante finalmente interpretar o objeto MensagemrTiss e produzir o objeto resposta desejado miss o de cada Digestor A figura abaixo ilustra este ciclo 16 11 2007 15 30 ES TissNet 4 X Nacional de q Sa de Suplementar Principal Digestor MensagemTISS MensagemTiss Na figura os objetos em verde teriam que ser constru dos na aplica o do usu rio os objetos sal m o s o componentes standard do TISSNet Se nenhum digestor for constru do o TISSNet usar seu digestor padr o o Downloader se
45. to a ponto poder o ter lugar Pas A o so 1 Projetar e construir um ValidadorCertificados para verificar a cada mensagem se o 16 11 2007 22 30 Pag AN Ag ncia Nacional de TissNet 4 X Sa de Suplementar Pas so A o dono do certificado est autorizado a transmit la colocando o em um jar Este passo opcional mas se n o for feito qualquer certificado digital v lido ser aceito para qual quer mensagem ou se n o se exigir certificados dos prestadores qualquer um poder transmitir in forma es Extrair todo o conte do do zipfile em um diret rio qualquer escolhido Se um validador de certificados tiver sido constru do copiar o jar do passo 1 para o subdire t rio lib do diret rio no qual o ZIP do TISSNet foi extra do Editar ent o o arquivo tiss ini registrando l as prefer ncias iniciais de execu o Montar um arquivo XML de defini o de nodos TISSNet para distribui o aos seus presta dores ou inform los sobre os par metros de comunica o relevantes nome ou endere o IP do servidor e porta de comunica o 3 3 3 Caso 3 Com Web Services Todos os web services dever o segundo decis o do COPISS ser oferecidos atrav s de canal se guro SSL com certifica o m tua tanto a operadora quanto o prestador ter o que ter certifica dos digitais Assim se a operadora oferecer web services supomos
46. um ActiveX Ser ver que pode ser embutido em aplicativos WINDOWS A p gina http java sun com j2se 1 4 2 docs guide beans axbridge developerguide index html cont m um roteiro b sico sobre como fazer o envelopamento de uma classe JAVA em um servidor ActiveX Vale observar que a ANS n o testou o roteiro mencionado acima e n o pode oferecer uma implementa o pronta produzida por ele 2 4 2 Resumo do Protocolo de Comunica o no Modo Ponto a Ponto Duas instala es TISSNet operando no modo ponto a ponto se comunicam seguindo um protocolo pr prio implementado pela classe de objetos br gov ans tiss nucleo Conexao O protocolo bem simples baseando se nas seguintes mensagens Mensagem Texto da Mensagem Significado Uso ACK O ack OK para blocos de mensagens recebidos com su cesso COMMIT O COMMIT OK para mensagens completas recebidas EOM 996 EOM Sinal de fim de mensagem a mensagem TISS sendo transmitida acabou EOT Q9o EOT Sinal de fim de transmiss o n o h mais mensa gens TISS a transmitir para o destinat rio HANDSHAKE O the quick brown fox Pedido de ra z de chave de criptografia Esta a jumped over the lazy dog primeira mensagem enviada assim que se esta belece uma conex o PONTA A Q96 PTAx onde x a iden Identifica o do parceiro para o computador re tifica o da ponta trans moto missora para a ponta re ceptora Toda a iniciativa da comuni
47. un dial de seguran a comprovada e aceit vel v LEVEZA as informa es transmitidas devem fluir no menor n mero poss vel de bytes com o m ximo poss vel de compress o v FACILIDADE DE USO um prestador leigo deve poder transmitir seus dados com um m ni mo de dificuldades de ordem t cnica v MODULARIDADE o componente de comunica o deve poder se integrar de forma transpa rente a uma aplica o desenvolvida que deve ter a liberdade para comand lo internamen te ou seja o componente deve se apresentar como um objeto opaco com uma interface de uso bem definida v EXTENSIBILIDADE o componente de comunica o deve poder ser facilmente expandido para incorporar novas t cnicas e formas de transmiss o Isto levou construc o de algumas caracter sticas especiais nos componentes desenvolvidos A ta bela abaixo sumaria isto Componente Caracter sticas Gestor de comunica o ponto a ponto Protocolo de amplo uso TCP IP Rede p blica de amplo uso INTERNET Suporte a proxy servers Suporte a SSL opcional Identifica o por certificado opcional simples ou m tua 16 11 2007 9 30 ram xs ANS Speer TissNet 4 X Componente Caracter sticas Detecc o autom tica de SSL Fallback autom tico SSL gt soquetes comuns Pode ser encapsulado e distribu do como um ActiveX Server em plataforma WINDOWS isso depende de software propriet rio e
48. xigido Deve se ter em mente que a res posta pode ser a Um objeto resposta bem definido que depende do servi o que foi acionado definido no WS DL b Uma condi o de erro exception como previsto no WSDL c Nulo Abaixo pode se ver um trecho de c digo JAVA para uma chamada destas Vale dizer que n o ne cess rio que se escrevam programas na linguagem JAVA para que os web services possam ser consumidos web services s o interoper veis podendo se escrever os provedores em uma lingua gem e os clientes em outra try 16 11 2007 27 30 US TissNet 4 X Nacional de al ANS ena do inicializa servico tissSolicitacaoStatusProtocoloV2 01 02 w cliente new tissSolicitacaoStatusProtocoloV2 01 02 http localhost 8181 tissSolicitacaoStatusProtocolo tissSolicitacaoStatusProtoco loV2 01 02 wsdl TissSolicitacaoStatusProtocoloPortType w port w cliente getPort constr i par metro WsSolicitacaoStatusProtocolo w parm new WsSolicitacaoStatusProtocolo w parm setCabecalho new CabecalhoTransacao w parm getCabecalho setOrigem new CabecalhoTransacao Origem w parm getCabecalho getOrigem setCodigoPrestadorNaOperadora 987654321 w parm getCabecalho setDestino new CabecalhoTransacao Destino w parm getCabecalho getDestino setRegistroANS 123456 w parm getCabecalho setIdentificacaoTransacao new CabecalhoTransacao IdentificacaoTran sacao w parm ge
Download Pdf Manuals
Related Search