Guida alla connessione

Come installare CLI e collegarla al tuo account Fatture in Cloud.

Cosa ti serve

Un account Fatture in Cloud con accesso all'azienda su cui vuoi lavorare.
Un computer con macOS, Linux o Windows e il terminale (su Windows, PowerShell).

1. Installa CLI

Su macOS e Linux, incolla nel terminale:

curl -fsSL https://raw.githubusercontent.com/16bitsrl/fattureincloud-cli/main/install.sh | sh

Su Windows, in PowerShell:

irm https://raw.githubusercontent.com/16bitsrl/fattureincloud-cli/main/install.ps1 | iex

Il programma viene installato nella tua cartella utente, senza permessi di amministratore. Se il terminale ti segnala che la cartella non è nel PATH, segui l'indicazione che compare a schermo, poi controlla che tutto funzioni con fic --version.

Quando esce una nuova versione, aggiorna con fic upgrade.

2. Collega il tuo account

Lancia:

fic auth:login

CLI ti mostra un indirizzo e un codice di otto caratteri, per esempio QQPF-TGMR, e prova ad aprire il browser da solo.

Apri l'indirizzo indicato (https://fattureincloud.it/connetti) e accedi con il tuo account Fatture in Cloud, se non l'hai già fatto.
Inserisci il codice mostrato nel terminale.
Controlla i permessi richiesti e conferma.

Il codice vale 5 minuti: se scade, rilancia fic auth:login. Appena confermi, il terminale mostra il tuo nome. Se hai una sola azienda viene impostata come predefinita, altrimenti scegli quale usare con fic company:set.

Al primo collegamento CLI chiede solo permessi di lettura. Non serve inserire la password nel terminale, e funziona anche se usi CLI su un server remoto: basta aprire l'indirizzo da qualsiasi dispositivo.

3. Aggiungi permessi quando servono

Se un comando deve scrivere sul tuo account, per esempio per creare una fattura, CLI si ferma prima di fare qualsiasi modifica e ti indica il permesso da aggiungere:

Missing permission: this command needs issued_documents.invoices:a.
Grant it with: fic auth:grant issued_documents.invoices:a

Lancia il comando suggerito e conferma come al punto 2: verranno chiesti i permessi che avevi già più quello nuovo. Puoi vedere in ogni momento i permessi attivi con fic auth:status.

Se sai già cosa ti serve puoi chiederlo subito, per esempio fic auth:login --grant=issued_documents.invoices:a, oppure dare accesso completo con fic auth:login --full. Rilanciando fic auth:login senza opzioni torni alla sola lettura.

4. Usa CLI

Lancia fic per vedere i comandi principali e fic skill per la guida completa. Se usi un agente AI come Claude Code, Codex o Cursor, chiedigli di lanciare fic e di seguire le istruzioni: quando deve collegare l'account o aggiungere un permesso ti mostrerà indirizzo e codice da confermare.

Scollegare l'account

Per eliminare le credenziali salvate sul tuo computer lancia fic auth:logout. Puoi revocare l'autorizzazione anche dalle impostazioni del tuo account Fatture in Cloud.

Problemi frequenti

"Not signed in": non hai ancora collegato l'account, lancia fic auth:login.
Il codice è scaduto: rilancia il comando, ne viene generato uno nuovo.
"Missing permission": aggiungi il permesso indicato con fic auth:grant.
"Permission denied" pur avendo il permesso: il tuo utente su Fatture in Cloud potrebbe non avere accesso a quella funzione, oppure il piano dell'azienda non la comprende.
Aggiornare CLI: rilancia il comando di installazione, scarica sempre l'ultima versione.

Per altro aiuto apri una issue su GitHub o scrivi a hello@16bit.it.