CLI
Invia fatture, carica estratti conto e controlla le scadenze dal terminale.
Il comando getbeel usa l'SDK TypeScript. Node.js 20.19+.
npm install -g @getbeel/cli # oppure: npx @getbeel/cli whoami
getbeel login # incolla una chiave da Impostazioni → Chiavi API e MCP
getbeel whoamilogin 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.
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 |
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
--json: stampa il JSON dell'API (per script ejq); gli errori vanno su stderr in JSON.--company <id>: agisci su un'azienda cliente.--idempotency-key <chiave>: percreate,send,uploadeprepare(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.
getbeel invoices create --file fattura.json --json | jq -r .id | xargs getbeel invoices send