# Voa TISS — validador XML TISS, API HTTP e MCP

Fonte canônica: https://voa.health/tiss
Responsável: Voa Health — https://voa.health/
Idioma: pt-BR
Conteúdo revisado em: 2026-10-22

O voa-tiss é o kit aberto da Voa Health para validar e gerar XML TISS, consultar TUSS e explicar glosas. A biblioteca Python pode ser usada offline; a API HTTP e o MCP remoto precisam de internet.

## O que está disponível no kit aberto
- Validação de lote TISS: suporte completo ao TISS 4.03.00; TISS 4.02.00 com esquema XSD e regras básicas.
- Geração de XML de consulta e SP/SADT a partir de JSON, com cálculo do hash.
- Auditoria com regras por operadora implementadas no repositório.
- Explicação de códigos de glosa da Tabela 38.
- Busca em TUSS e tabelas de domínio versionadas.
- Leitura de demonstrativos e apoio à conciliação por guia.
- Dados públicos de operadoras da ANS e rede hospitalar por CNES e CNPJ.
- Operadora simulada para testes de envio.

## Começar em Python
Requisito: Python 3.10 ou superior.

```sh
pip install voa-tiss
```

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

O exemplo é sintético. Para usar seus arquivos, consulte a documentação do produto.

## Integração
- Produto e login: https://tiss-api.voa.health/
- Documentação: https://tiss-api.voa.health/docs
- Playground: https://tiss-api.voa.health/playground
- Contrato OpenAPI: https://tiss-api.voa.health/openapi.json
- Endpoint MCP: https://tiss-api.voa.health/mcp
- Código-fonte: https://github.com/Voa-Health/tiss
- Pacote Python: https://pypi.org/project/voa-tiss/
- Licença: https://www.apache.org/licenses/LICENSE-2.0

O sandbox é aberto. As demais ferramentas da API e do MCP exigem uma chave obtida no login Voa. A biblioteca é distribuída sob Apache-2.0 e permite uso comercial conforme os termos da licença.

## Dados e privacidade
A API e o MCP não armazenam o conteúdo das guias nem o usam para treinar modelos. A telemetria agregada registra operação, códigos dos achados, operadora, versão TISS e data. O cabeçalho X-Voa-Telemetry: off desliga essa telemetria. A biblioteca offline não envia o conteúdo das guias.

## Módulos em desenvolvimento
Para instituições e profissionais que desejam simplificar o ciclo de contas e glosas de sua operação.

Os valores abaixo são preços de lançamento previstos, não ofertas de módulos já disponíveis:
- Recurso de glosa com evidência clínica: R$ 6,90 por recurso enviado.
- Extrator de PDF, foto ou planilha para JSON TISS: R$ 0,49 por documento.
- TISS Cloud: R$ 0,05 por guia acompanhada, com previsão de 1.000 guias/mês grátis.
Listas de espera disponíveis em breve. Cobrança conforme o uso, com valor fixo por recurso, documento ou guia. Lançamento previsto em nuvem. O plano Enterprise oferece implantação híbrida ou na sua infraestrutura, sob consulta.

## Limites
A validação identifica os problemas cobertos pelo esquema, tabelas, hash e regras implementadas. Não garante autorização, aceitação do lote ou pagamento. Confira as exigências da operadora e a cobertura documentada de cada versão.

## Perguntas frequentes

### 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 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.