Histórico da Página

A comunicação TISS agora se integra ao ERP, eliminando a necessidade de uma infraestrutura separada (JBoss). Com essa mudança, a gestão do serviço é otimizada.

Para que a comunicação com o Progress funcione corretamente, é necessário que as variáveis TOTVS_HOST, TOTVS_USERNAME e TOTVS_PASSWORD estejam configuradas no servidor, podendo ser via parâmetros de inicialização do Tomcat (como serviço do Windows/Linux ou arquivo de configuração) ou variáveis de ambiente no servidor em que o Tomcat é inicializado.

Esse padrão é utilizado por outras aplicações e é possível que já estejam disponíveis em seu ambiente, e nesse caso, nenhuma ação é necessária.

Na página Configurar servidor de aplicação TOMCAT é possível verificar um exemplo de configuração.

Comunicação

• A URL do serviço deve ser o servidor + porta onde a aplicação está rodando:
  • Ex: http://servidor1:8080

Endpoints

• Quando o campo relacionado ao endpoint apontar para o novo serviço, o sistema realizará a comunicação via Tomcat.

Exemplo:
Editando e preenchendo o campo do endpoint da mensagem de Solicitação Status Protocolo: 

Ao realizar uma consulta de Status Protocolo a comunicação será realizada através do novo serviço e não mais pelo Foundation.

O novo serviço utiliza o conceito de Broker Escalável, onde é possível direcionar as chamadas ao Progress para um broker específico, isolando o back-end de outras aplicações, como o ERP por exemplo.

Toda comunicação encaminhada da aplicação totvs-java-hgp-tiss-webservices-40100.war ou totvs-java-hgp-tiss-webservices-40001.war para o Progress enviará na requisição a chave "x-totvs-server-alias" como "totvs-hgp-webservices", sendo necessário que o cliente inclua através dos Parâmetros Foundation (btb962aa) um novo registro contendo esse alias.

Exemplo:
No programa BTB962AA (Parâmetros Foundation), criar um novo registro contendo o alias "totvs-hgp-webservices": 

Na página Broker Escalável - Exemplo de como fazer uso do aplicativo e alias para chamadas REST é possível verificar maiores detalhes sobre essa configuração.

Gostaríamos de informar que a recente migração para o novo serviço TISS ao TOMCAT não afetou o uso das funcionalidades para clientes que utilizam programas de CPC na comunicação TISS.

O que isso significa para você:

• Processo de Utilização FamiliarUsual: As regras de negócio e operações em tela do TISS permanecem inalteradas, garantindo uma experiência familiar e intuitiva.
• Funcionalidades Acessíveis: Todas as funcionalidades do TISS que você já conhece e utiliza continuam disponíveis, sem necessidade de adaptação.
• Comunicação TISS: O processo de comunicação TISS via CPC permanece inalterado, sem interrupções ou modificações.

• Autenticação de Usuário na mensagem TISS
  O padrão TISS já prevê uma segurança via usuário e senha, essas informações agora passam a ser validadas conforme as regras de negócio do sistema.
  
  Segue abaixo a imagem das tags:
  
• Autenticação de usuário e senha no formato MD5
  Exemplo:
  
  

  
  

  
  

1. Regra de Negócio do Sistema
   No menu Manut. Usuários Portal Prestador (hat.secretary):
    
   

   1. Deve existir um registro do usuário e na aba de Cadastro conter as informações de Login e Senha :
      
      
      
      

      Aviso
      Ao preencher o campo Senha a senha é criptografada, para manter a segurança da privacidade da senha o campo na mensagem TISS é preenchido no formato MD5. Exemplo:

   2. Na aba Prestadores Associados deve haver um registro do prestador da mensagem com os devidos parâmetros:
      O campo "Papel" deve ser preenchido como Serviço/Prestador caso esteja como Padrão o usuário não terá permissão para realizar a comunicação TISS.
      O campo "Status" deve estar Ativo.
      
      Exemplo:
      
      
      

• Exemplo Mensagem TISS (Solicitação Status Protocolo):
  

• Solicitação Demonstrativo de Retorno
  

  Mensagem TISS	Endpoint TISS 4.01.00	Endpoint TISS 4.00.01
  Solicitação Demonstrativo de Retorno	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoDemonstrativoRetorno	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoDemonstrativoRetorno

  
  
  

• Solicitação Procedimento
  

  Mensagem TISS	Endpoint TISS 4.01.00	Endpoint TISS 4.00.01
  Solicitação Procedimento	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoProcedimento	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoProcedimento

  
  
  

          Exemplo:
         

• Solicitação Status Protocolo
  

  Mensagem TISS	Endpoint TISS 4.01.00	Endpoint TISS 4.00.01
  Solicitação Status Protocolo	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusProtocolo	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusProtocolo

  
  
  

• Solicitação Status Recurso Glosa
  

  Mensagem TISS	Endpoint TISS 4.01.00	Endpoint TISS 4.00.01
  Solicitação Status  Recurso Glosa	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusRecursoGlosa	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusRecursoGlosa

  
  
  

• Solicitação Status de Autorização
  

  Mensagem TISS	Endpoint TISS 4.01.00	Endpoint TISS 4.00.01
  Solicitação Status de Autorização	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/solicitacaoStatusAutorizacao	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/solicitacaoStatusAutorizacao

  
  
  Exemplo:
  

• Consulta Comunicação de Beneficiário
  

  Mensagem TISS	Endpoint TISS 4.01.00	Endpoint TISS 4.00.01
  Comunicação Beneficiário	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/comunicacaoBeneficiario	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/comunicacaoBeneficiario

  
  
  

• Verifica Elegibilidade
  

  Mensagem TISS	Endpoint TISS 4.01.00	Endpoint TISS 4.00.01
  Verifica Elegibilidade	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/pedidoElegibilidade	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/pedidoElegibilidade

  
  
  

• Recurso Glosa
  

  Mensagem TISS	Endpoint TISS 4.01.00	Endpoint TISS 4.00.01
  Recurso Glosa	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/recursoGlosa	http://seu-servidor:http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/recursoGlosa

  
  
  

• Cancela Guia
  

  Mensagem TISS	Endpoint TISS 4.01.00	Endpoint TISS 4.00.01
  Cancela Guia	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/cancelaGuia	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/cancelaGuia

  
  
  Exemplo:
  
  

• Lote de Guias
  

  Mensagem TISS	Endpoint TISS 4.01.00	Endpoint TISS 4.00.01
  Lote Guias	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/loteGuias40100/api/loteGuias	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/loteGuias

  
  
  

• Lote Anexo
  

  Mensagem TISS	Endpoint TISS 4.01.00	Endpoint TISS 4.00.01
  Lote Anexo	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/loteAnexo	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/loteAnexo

  
  
  

• Envio Documentos
  

  Mensagem TISS	Endpoint TISS 4.01.00	Endpoint TISS 4.00.01
  Envio de Documentos	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40100/api/envioDocumentos	http://seu-servidor:porta/totvs-hgp-tiss-webservices-40001/api/envioDocumentos

  
  
  Exemplo:
  
  

Estruturas Convertidas

• Prestador - Operadora
  
  
• Operadora - Prestador