> 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/cli.md).

# CLI

[Visão geral](https://docs.voa.health/integracao/tiss.md) · [MCP](https://docs.voa.health/integracao/tiss/mcp.md)

Instale com `pip install tiss` ou execute sem instalar com `uvx tiss validate lote.xml`.

| Comando                     | Uso                                                                              |
| --------------------------- | -------------------------------------------------------------------------------- |
| `tiss validate <paths...>`  | Valida XML/JSON ou pastas; aceita `--operadora` e `--format text\|json\|github`. |
| `tiss fix <arquivo>`        | Mostra um diff; `--write` grava no arquivo e `-o CAMINHO` grava em outro.        |
| `tiss hash <arquivo>`       | Calcula o hash; `--check` compara com o epílogo.                                 |
| `tiss glosa <código>`       | Consulta a Tabela 38.                                                            |
| `tiss tuss <código\|termo>` | Consulta um código ou busca por texto.                                           |
| `tiss operadora <registro>` | Consulta o perfil da operadora.                                                  |
| `tiss mapa <pasta>`         | Agrega achados; pode salvar JSON/HTML ou enviar o mapa.                          |
| `tiss mcp`                  | Inicia o MCP local em stdio; requer `tiss[mcp]`.                                 |
| `tiss serve`                | Inicia a API HTTP local; requer `tiss[server]`.                                  |

`validate --format` aceita `text`, `json` ou `github`. Códigos de saída: `0` sucesso, `1` achados ou itens não encontrados, `2` uso inválido ou entrada ilegível.

## GitHub Action e pre-commit

{% tabs %}
{% tab title="GitHub Actions" %}

```yaml
- uses: Voa-Health/tiss@v0
  with:
    paths: lotes/
```

{% endtab %}

{% tab title="pre-commit" %}

```yaml
repos:
  - repo: https://github.com/Voa-Health/tiss
    rev: v0.4.0
    hooks:
      - id: tiss-validate
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
O hook seleciona arquivos `.xml`. A Action exige `paths`; `operadora` é opcional. `version` usa `0.4.0` por padrão; use `local` para este checkout.
{% endhint %}
