> For the complete documentation index, see [llms.txt](https://docs.voa.health/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.voa.health/integracao/tiss.md).

# tiss

Pacote open source para validar, corrigir e gerar documentos TISS, consultar TUSS e dados abertos da ANS.

## Instalação

{% tabs %}
{% tab title="pip" %}

```sh
pip install tiss
```

{% endtab %}

{% tab title="uv" %}

```sh
uv add tiss
```

{% endtab %}

{% tab title="uvx" %}

```sh
uvx tiss --help
```

{% endtab %}
{% endtabs %}

Requer Python 3.10+.

## Primeiros passos

{% tabs %}
{% tab title="1 · Python" %}

```python
from tiss import examples, validate

report = validate(examples.load("lote-com-erros"))
[(finding.code, finding.severity) for finding in report.findings]
```

{% endtab %}

{% tab title="2 · CLI" %}

```sh
tiss validate lote.xml
```

{% endtab %}
{% endtabs %}

### 3. Adicione o MCP local

```sh
claude mcp add tiss -- uvx --from "tiss[mcp]" tiss mcp
```

## Escolha a interface

| Interface        | Guia                                                                             |
| ---------------- | -------------------------------------------------------------------------------- |
| Python           | [Tutoriais](/integracao/tiss/tutoriais.md)                                       |
| CLI              | [CLI](/integracao/tiss/cli.md)                                                   |
| MCP local        | [MCP](/integracao/tiss/mcp.md)                                                   |
| MCP remoto / API | [API HTTP](/integracao/tiss/api.md)                                              |
| CI               | [GitHub Action e pre-commit](/integracao/tiss/cli.md#github-action-e-pre-commit) |

## Fluxo

```mermaid
flowchart LR
    XML --> validate --> findings --> fix --> revalidate
    revalidate -->|até 3 rodadas| validate
```

{% hint style="info" %}
Sem chave, apenas as operações `sandbox_*` da API hospedada respondem. Crie uma chave `sk_tiss_` no [painel da organização](https://tiss-api.voa.health/org).
{% endhint %}

Catálogo de [códigos de validação](https://github.com/Voa-Health/tiss/blob/main/docs/codigos.md).

Veja também [API HTTP](/integracao/tiss/api.md), [regras por operadora](/integracao/tiss/regras-operadora.md), [CLI](/integracao/tiss/cli.md) e [MCP](/integracao/tiss/mcp.md).