Como integrar o webservice TISS da operadora: tutorial passo a passo
Se a sua clínica ainda envia lotes pelo portal da operadora copiando e colando XML, é hora de evoluir. A integração via webservice TISS automatiza o envio, devolve o protocolo em segundos e elimina o erro humano de upload manual. Neste tutorial você vai entender — em linguagem simples — como funciona o webservice e o que precisa fazer para ligar sua clínica nele.
O que é o webservice TISS?
envioLoteGuias, verificaElegibilidade e solicitacaoStatusProtocolo.Quais pré-requisitos você precisa antes de integrar o webservice TISS?
- Contrato ativo com a operadora e código de prestador.
- Credenciais do webservice (login, senha ou certificado A1).
- URL do WSDL homologação e produção.
- Um XML TISS válido — comece testando no validador TISS online para garantir que o arquivo passa no XSD antes de enviar.
Passo 1 — Como fazer a autenticação no webservice TISS?
Passo 2 — Como enviar o lote pelo webservice TISS?
envioLoteGuias. A resposta traz o número do protocolo.Passo 3 — Como consultar o retorno pelo webservice TISS?
solicitacaoStatusProtocolo. O retorno traz as guias aceitas, em análise ou rejeitadas. Use a diferença entre rejeição e glosa para tratar cada caso corretamente.Quais são os erros comuns na primeira integração com o webservice?
- Versão de TISS divergente entre cliente e operadora (veja guia de migração para TISS 4.03).
- Hash MD5 calculado sobre o XML formatado em vez do canônico.
- Certificado A1 expirado ou cadeia incompleta.
- Tags fora da ordem definida no XSD — algo que o validador TISS mostra antes de você enviar.
Onde encontrar vídeos para aprofundar em integração webservice TISS?
Perguntas frequentes
Posso testar o webservice antes de produção?
Sim. Praticamente toda operadora oferece ambiente de homologação. Use-o exaustivamente — envie lotes vazios, lotes com erro proposital e observe os códigos de retorno.
Preciso de certificado digital para usar o webservice?
Depende da operadora. Algumas exigem ICP-Brasil A1 para autenticar, outras aceitam usuário e senha. Confirme no manual técnico de cada uma.
E se o webservice estiver fora do ar?
Mantenha sempre o portal manual como plano B e implemente fila de reenvio automático no seu sistema.
Conclusão
Integrar com webservice TISS economiza horas por semana e reduz drasticamente a glosa por envio fora do prazo. Comece validando seu XML no validador TISS, evolua para o ambiente de homologação e só depois suba para produção. E para gerar os arquivos com a estrutura certa, use o gerador de guias TISS.
Continue lendo
- Tutoriais
Como gerar guias TISS em PDF no modelo oficial da ANS: tutorial do Gerar Guias
Tutorial completo do Gerar Guias do TISS Manager: transforme o XML do lote TISS em um PDF com cada guia preenchida no modelo oficial da ANS — consulta, SP/SADT, internação, honorários e despesas.
- Tutoriais
Como juntar vários XMLs TISS em um único lote: tutorial do Unificador
Tutorial completo do Unificador do TISS Manager: envie vários XMLs TISS de uma vez, junte tudo em um único lote válido, com deduplicação de guias, somatórios recalculados e hash MD5 correto.
- Tutoriais
Como usar o painel de Riscos de Glosa do TISS Manager: tutorial passo a passo
Tutorial completo do painel de Riscos de Glosa: como o motor de regras analisa cada guia, como interpretar os alertas e como criar regras personalizadas por operadora.