> ## Documentation Index
> Fetch the complete documentation index at: https://userepass.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Invoices (CLI)

> Comandos de envio, validação, rejeição, cobrança e download de notas fiscais.

O grupo `invoices` gerencia as notas fiscais do fluxo [fiscal](/docs/conceitos/fiscal): envio do arquivo (PDF/XML) com os dados declarados, validação ou rejeição e download por URL pré-assinada.

## Envio

`submit` usa `--upload` (não `--data`) para o arquivo, mais flags nomeadas para os dados declarados da NF. `nf-number`, `issuer-cnpj`, `declared-amount-cents` e `recipient-name` são obrigatórias; `nf-series` é opcional. `submit` **não é re-tentado automaticamente**. Em caso de falha, reenvie de forma controlada.

```bash theme={null}
repass invoices submit inv_xxx \
  --upload ./nota-fiscal.pdf \
  --nf-number "12345" \
  --issuer-cnpj "12.345.678/0001-90" \
  --declared-amount-cents 25000 \
  --recipient-name "Repass Tecnologia LTDA"
```

## Consulta

```bash theme={null}
# Listar (paginado; filtros por afiliado, payout, status e competência)
repass invoices list --status validated --json

# Recorte por competência (mês): criadas em [created-after, created-before)
repass invoices list --created-after 2026-06-01T00:00:00Z --created-before 2026-07-01T00:00:00Z --json

# Buscar uma nota
repass invoices get inv_xxx --json
```

`invoices list` é paginado. Veja [Paginação](/docs/cli/paginacao) para `--all` e cursores.

## Validação, rejeição e cobrança

`remind` cobra novamente a NF **pendente** (lembrete ao afiliado). Só vale enquanto a nota está `pending`.

```bash theme={null}
repass invoices validate inv_xxx                                        # aprova a nota
repass invoices reject inv_xxx --data '{"reason":"valor diverge"}'      # rejeita com motivo, reabre a pendência
repass invoices remind inv_xxx                                          # cobra novamente a NF pendente
```

## Download

`file` retorna uma URL temporária (pré-assinada) para o arquivo enviado.

```bash theme={null}
repass invoices file inv_xxx --json
```

```json repass invoices file inv_xxx --json theme={null}
{ "url": "https://…", "expiresAt": "2026-07-02T18:00:00Z" }
```

<Note>
  Para o schema completo de cada corpo (campos declarados, tipos de arquivo aceitos e status) e os campos de cada objeto retornado, consulte a página SDK equivalente ([Invoices](/docs/sdk/recursos/invoices)) e a [Referência da API](/docs/convencoes/ids-e-recursos). As regras de negócio estão em [Fiscal](/docs/conceitos/fiscal).
</Note>