CÓDIGO ABERTO PARA CONTAS MÉDICAS

Valide XML TISS antes de enviar à operadora.

O voa-tiss é o kit aberto da Voa Health para validar e gerar XML TISS, consultar TUSS e explicar glosas. Use a biblioteca Python offline, a API HTTP ou o MCP no seu agente de IA.

Testar no playground

Ver no GitHub

Código aberto · Apache-2.0 · dados públicos da ANS

Cuida do faturamento? Conheça os módulos →

pip install voa-tiss

from voa_tiss import examples, validate
report = validate(examples.load("lote-com-erros"))

claude mcp add --transport http voa-tiss https://tiss-api.voa.health/mcp

curl -s https://tiss-api.voa.health/openapi.json

Python 3.10+ · exemplo sintético · roda offline

MENOS RETRABALHO NO FATURAMENTO

O erro no XML TISS aparece tarde demais.

O lote volta rejeitado.

Erros de esquema, de hash ou de código TUSS só aparecem depois do envio.

A glosa chega sem explicação.

O código da Tabela 38 não diz o que corrigir.

Cada operadora tem a própria regra.

Elas ficam espalhadas em PDFs, portais e e-mails.

UM LOOP VERIFICÁVEL

Validar → corrigir → revalidar → enviar

Validar

Esquema XSD 4.03, TUSS, tabelas de domínio, hash e regras da operadora.

Corrigir

Achados corrigíveis trazem um patch JSON determinístico. O que depende de informação fica explícito.

Revalidar

Confira o lote após cada correção. A mesma entrada sempre dá o mesmo resultado.

Enviar e conciliar

Gere o XML final, leia o demonstrativo e entenda cada glosa.

Determinístico e verificável: o agente propõe, o voa-tiss confere.

PARA QUEM CONSTRÓI

API TISS e MCP para agentes de IA.

Integre validação de XML TISS, consulta TUSS e análise de glosas ao seu sistema ou agente. Contratos OpenAPI, esquemas JSON e documentação aberta para conferir cada resposta.

MCP remoto

Tools e resources para conectar seu agente. Sandbox aberto; demais ferramentas com sua chave Voa.

Documentação para máquinas

llms.txt como ponto de entrada para seu agente explorar o kit e a documentação.

Respostas estruturadas

Esquemas JSON e contrato OpenAPI para integrar, validar e conferir cada resposta.

Índice para agentes · llms.txt

https://tiss-api.voa.health/openapi.json

https://tiss-api.voa.health/mcp

Voa TISS em texto · instalação, integração e limites

O que vem no kit aberto.

Do lote TISS ao demonstrativo. Uma base comum para seu produto e seu agente.

Validação de lote TISS

TISS 4.03.00 completa; 4.02.00 com XSD e regras básicas.

Geração de XML

JSON para consulta e SP/SADT, com cálculo do hash.

Auditoria por operadora

Regras por operadora aplicadas antes do envio.

Glosa explicada · Tabela 38

Entenda o motivo e o que precisa ser conferido.

TUSS e tabelas de domínio

Busca offline em tabelas versionadas e verificadas.

Demonstrativo e conciliação

Leia decisões por guia e monte o plano de conciliação.

Operadora ANS e rede hospitalar

Cadastro e indicadores públicos; rede por CNES e CNPJ.

Operadora simulada

Sandbox para testar o envio de ponta a ponta.

Sem estado: o conteúdo das guias não é armazenado nem usado para treinar modelos.

MÓDULOS EM BREVE

Pague por unidade. Nunca por percentual do faturamento.

Para equipes que querem levar validação, recurso e acompanhamento para a rotina de contas médicas. Listas de espera disponíveis em breve.

Preço de lançamento previsto

Recurso de glosa com evidência clínica

Monta o recurso com a evidência do prontuário anexada.

R$ 4,90

por recurso enviado

Em breve

Preço de lançamento previsto

Extrator

Converte PDF, foto ou planilha em JSON TISS já validado. O que não tem evidência fica marcado como pendente.

R$ 0,39

por documento

Em breve

Preço de lançamento previsto

TISS Cloud

Histórico de lotes, glosas por operadora e alertas.

R$ 0,15

por guia acompanhada

1.000 guias/mês grátis

Preço fixo por unidade, nunca percentual do faturamento. Roda em nuvem no lançamento; híbrido ou self-hosted no plano Enterprise, sob consulta, com o dado clínico na sua infraestrutura.

PARA OPERADORAS

Operadora: publique suas regras e receba lotes certos.

Transforme regras espalhadas em uma fonte aberta e verificável. As regras ficam na pasta rules/ do repositório, cada uma com o campo mantenedor. Uma operadora verificada pelo domínio do e-mail recebe o selo oficial. O fluxo é um pull request público.

Falar com a Voa

Dúvidas sobre TISS, dados e integração.

O Voa TISS é gratuito?

A biblioteca Python voa-tiss e a operadora simulada são gratuitas e de código aberto. A API HTTP e o MCP exigem a chave obtida no login Voa para ferramentas além do sandbox. Recurso de glosa, Extrator e Voa TISS Cloud estão em desenvolvimento, com preços de lançamento previstos por unidade.

Meus dados ficam com a Voa?

A API e o MCP não armazenam o conteúdo das guias e nada é usado para treinar modelos. A telemetria agregada registra operação, códigos dos achados, operadora, versão TISS e data. Você pode desligá-la com X-Voa-Telemetry: off. A biblioteca offline não envia o conteúdo das guias.

Posso validar XML TISS offline?

Sim. A biblioteca Python voa-tiss valida XML TISS offline, com tabelas versionadas e verificadas por hash. A consulta de rede hospitalar baixa e verifica a base no primeiro uso; depois, você pode usar uma cópia local. API HTTP e MCP remoto precisam de internet.

Quais versões do TISS o voa-tiss suporta?

O voa-tiss oferece suporte completo ao TISS 4.03.00 e validação de esquema XSD e regras básicas para o TISS 4.02.00. A cobertura do software não substitui a conferência da versão e das regras exigidas pela operadora.

Como integrar o Voa TISS a um agente de IA?

Conecte um cliente compatível com MCP ao endpoint https://tiss-api.voa.health/mcp. Claude Code, Codex, ChatGPT e Cursor são exemplos de clientes. Configure sua chave Voa para ferramentas além do sandbox. Sistemas também podem integrar pela API HTTP, com contrato em https://tiss-api.voa.health/openapi.json.

De onde vêm os dados de operadoras?

Dos dados abertos da ANS, com licença CC BY e a fonte citada.

Posso usar o voa-tiss em um produto comercial?

Sim. A biblioteca voa-tiss é distribuída sob a licença Apache-2.0, que permite uso comercial conforme seus termos. O código está em github.com/Voa-Health/tiss e o pacote Python em pypi.org/project/voa-tiss/.

Qual é a diferença entre TISS e TUSS?

TISS significa Troca de Informação de Saúde Suplementar: é o padrão da ANS para a troca de informações na saúde suplementar. TUSS é a Terminologia Unificada da Saúde Suplementar, usada para identificar procedimentos e outros itens assistenciais. A TUSS é um componente do padrão TISS; validar o XML e conferir os códigos TUSS são verificações complementares.

Como começar a validar XML TISS em Python?

Instale o pacote com pip install voa-tiss em Python 3.10 ou superior. Importe examples e validate de voa_tiss e execute validate(examples.load("lote-com-erros")) para conferir um exemplo sintético. Depois, siga a documentação para usar seus próprios arquivos. O playground permite experimentar sem instalar a biblioteca.

Validar o XML TISS elimina todas as glosas?

Não. O Voa TISS identifica problemas cobertos pelo esquema XSD, tabelas, hash e regras implementadas. A validação ajuda a corrigir erros antes do envio, mas não garante autorização, aceitação do lote ou pagamento. Questões contratuais, regras específicas da operadora e análise clínica podem produzir outras glosas.

Consulte o padrão TISS e a terminologia TUSS na ANS ↗

Comece em um minuto.

Instale o kit aberto ou teste com um exemplo sintético no playground.

Terminal

pip install voa-tiss

Playground

GitHub