# CLI (https://docs.getbeel.com/it/api/cli)

Invia fatture, carica estratti conto e controlla le scadenze dal terminale.

Il comando `getbeel` usa l'[SDK TypeScript](/it/api/sdk-typescript). Node.js 20.19+.

```bash
npm install -g @getbeel/cli   # oppure: npx @getbeel/cli whoami
getbeel login                 # incolla una chiave da Impostazioni → Chiavi API e MCP
getbeel whoami
```

`login` verifica la chiave e la salva in `~/.config/getbeel/config.json` (leggibile solo da te). `GETBEEL_API_KEY` o `--api-key` hanno la precedenza (e vanno all'host predefinito, non a un base URL salvato con un'altra chiave); `getbeel logout` la dimentica. Inizia con una chiave di test (`gb_test_…`): gli invii vanno alla [sandbox](/it/api/sandbox).

## Comandi [#comandi]

| Comando                                                                         | Cosa fa                                                                   |
| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| `invoices list [--status s] [--limit n] [--cursor c] [--all]`                   | Fatture emesse                                                            |
| `invoices get <id>`                                                             | Una fattura                                                               |
| `invoices create --file fattura.json`                                           | Crea una bozza da un file JSON [CreateInvoiceRequest](/it/api/reference)  |
| `invoices validate --file fattura.xml`                                          | Controlla un XML FatturaPA                                                |
| `invoices send <id>`                                                            | Invia una bozza allo SDI (alla sandbox con una chiave di test)            |
| `received list [--status s] [--source s] [--all]`                               | Fatture ricevute                                                          |
| `bank statements upload <file> [--currency EUR]`                                | Carica un estratto conto (PDF, CSV, TXT, CBI, CAMT.053, MT940)            |
| `bank statements list [--all]`                                                  | Estratti conto e il loro stato                                            |
| `bank connections list`                                                         | Banche collegate                                                          |
| `bank connections sync <id>`                                                    | Sincronizza ora una banca                                                 |
| `taxes calendar [--from data] [--to data]`                                      | Scadenze fiscali                                                          |
| `taxes registers --period 2026-Q3`                                              | Registri IVA vendite e acquisti di un mese o trimestre                    |
| `taxes settlement --period 2026-10`                                             | Liquidazione IVA del periodo (da verificare)                              |
| `taxes report --type profit-and-loss --period 2026`                             | Report gestionale: conto economico, flussi di cassa, crediti              |
| `filings prepare --type bollo\|withholdings --period 2026-Q3 [--amount 200.00]` | Prepara un F24                                                            |
| `filings prepare --type vat_payment\|lipe --period 2026-10`                     | Salva la liquidazione IVA e prepara l'F24, o il file LIPE di un trimestre |
| `filings list [--all]`                                                          | Adempimenti preparati                                                     |

## Opzioni [#opzioni]

- `--json`: stampa il JSON dell'API (per script e `jq`); gli errori vanno su stderr in JSON.
- `--company <id>`: agisci su un'[azienda cliente](/it/api/companies).
- `--idempotency-key <chiave>`: per `create`, `send`, `upload` e `prepare` (altrimenti una casuale).
- `--base-url <url>`: un altro host dell'API (https; http solo per localhost).

Codici di uscita: `0` ok, `1` errore dell'API (stampato con codice e request id), `2` comando o opzioni errati.

```bash
getbeel invoices create --file fattura.json --json | jq -r .id | xargs getbeel invoices send
```
