GetbeelDocs

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 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.

Comandi

ComandoCosa fa
invoices list [--status s] [--limit n] [--cursor c] [--all]Fatture emesse
invoices get <id>Una fattura
invoices create --file fattura.jsonCrea una bozza da un file JSON CreateInvoiceRequest
invoices validate --file fattura.xmlControlla 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 listBanche collegate
bank connections sync <id>Sincronizza ora una banca
taxes calendar [--from data] [--to data]Scadenze fiscali
taxes registers --period 2026-Q3Registri IVA vendite e acquisti di un mese o trimestre
taxes settlement --period 2026-10Liquidazione IVA del periodo (da verificare)
taxes report --type profit-and-loss --period 2026Report 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-10Salva 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 e jq); gli errori vanno su stderr in JSON.
  • --company <id>: agisci su un'azienda cliente.
  • --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.

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

In questa pagina