⚙️ Log de integração TISS

Aba "Integração TISS" da operadora

Do manual: abrir esta parte no manual completo ›

Em produção desde 15/10/2026 (#619). É opcional e configurada por operadora, com o endereço do webservice e as credenciais que a própria operadora fornece. Sem nada configurado, aparece "Operadora sem integração TISS configurada — as telas continuam como hoje."

1. Abra a operadora para editar

   Configurações › Operadoras → editar. Na edição aparecem as abas "Dados da operadora" e "Integração TISS" ("Webservices da operadora (elegibilidade, autorização, lotes...)").

2. Credenciais do prestador

   Marque Integração ativa e informe as credenciais do prestador (a senha fica cifrada: "Senha definida — deixe em branco para manter." / "Remover senha"). Código do prestador: "Vazio = código da operadora. Vale só para os webservices."

3. Certificado e assinatura (se a operadora pedir)

   "Usar certificado cliente (mTLS)", "Assinar XML" e o certificado, que mostra "(válido até dd/mm/aaaa)".

4. Endereços dos webservices

   Um campo por transação (Verificar elegibilidade, Solicitação de procedimento, Status da autorização, Envio de lote de guias, Status do protocolo, Demonstrativo de retorno, Recurso de glosa, Status do recurso de glosa, Cancelamento de guia, Lote de anexos). Hoje só a elegibilidade é usada; os demais endereços podem ser guardados, mas nenhum fluxo os usa ainda.

5. Teste e salve

   Testar conexão ("Conexão OK") e Salvar integração ("Integração TISS salva com sucesso").

Configuração por convênio: "A configuração do convênio, se existir, substitui a da operadora." Sem configuração própria: "Este convênio usa a configuração padrão da operadora. Salve para criar uma configuração própria."

Onde se usa: botão "Verificar elegibilidade" no Agendamento e no Acolhimento — ver Agendamento.

Log de integração TISS: menu Configurações › "Log de integração TISS" (rota /portal/configuracoes/log-integracao-tiss) — "Chamadas aos webservices das operadoras", com filtros, paginação e o XML de envio ("Envio (senha mascarada)"). Sem permissão: "Você não tem permissão para ver o XML das transações."

Como o "negar por padrão" (#667) não está ligado, colaborador sem configuração nessas permissões vê a configuração e o log; salvar, testar e verificar exigem a permissão concedida (administrador tem tudo).

Novo — out/2026 TISS fases 2 a 4 — primeira versão no ar, em validação (telas em 22/10 e servidor em 23/10/2026): o menu Faturamento › Retorno da operadora reúne lote, demonstrativos, autorização online e recurso de glosa por webservice, usando os endereços cadastrados acima. Está em validação (#620/#622/#623 abertas): não há garantia de que todas as operadoras funcionem — teste com a sua e, se não funcionar, siga pelo caminho de hoje (XML, portal da operadora).

Lição: integração TISS da operadora

Do manual: abrir esta parte no manual completo ›

Desde 15/10/2026, ao editar uma operadora aparecem as abas "Dados da operadora" e "Integração TISS" ("Webservices da operadora (elegibilidade, autorização, lotes...)"). É opcional: sem nada configurado, "Operadora sem integração TISS configurada — as telas continuam como hoje."

1. Peça à operadora o endereço dos webservices e as credenciais do prestador.
2. Na aba Integração TISS, marque Integração ativa e preencha as Credenciais do prestador (a senha fica cifrada: "Senha definida — deixe em branco para manter."; o código do prestador vazio = código da operadora) e, se a operadora exigir, Certificado e assinatura ("Usar certificado cliente (mTLS)", "Assinar XML").
3. Em Endereços dos webservices, preencha ao menos Verificar elegibilidade (há campos para as outras transações, mas hoje nenhum fluxo os usa).
4. Clique em Testar conexão ("Conexão OK") e em Salvar integração.

Um convênio pode ter configuração própria ("A configuração do convênio, se existir, substitui a da operadora."). Com a integração ativa, o agendamento e o acolhimento ganham o botão "Verificar elegibilidade"; as chamadas ficam em Configurações › Log de integração TISS (filtros e XML de envio com a senha mascarada). Permissões novas no grupo Configurações: TISS_INTEGRACAO (VIEW vê configuração e log; UPDATE salva e testa) e TISS_ELEGIBILIDADE (VIEW vê o status; CREATE verifica). Só a elegibilidade funciona hoje; autorização online, envio de lote, demonstrativos e recurso de glosa são as fases 2 a 4 🟠 Roadmap (#620–#623).