ADEGO — Manuale d’uso

ADEGO è un programma da riga di comando che automatizza le operazioni sul servizio Fatture e Corrispettivi dell’Agenzia delle Entrate: scarica le fatture, gestisce le richieste di file massivi e verifica partite IVA e codici fiscali. Non apre nessun browser: non serve Chrome né altro software oltre ad ADEGO.

ADEGO è un prodotto Esselabs (adego.esselabs.it). Per acquistare una licenza o chiedere assistenza: info@esselabs.it.

Indice

1. Primi passi
2. Scegliere l’utenza di lavoro
3. Scaricare le fatture
4. File massivi
5. Verificare una partita IVA o un codice fiscale
6. Dove vengono salvati i file
7. Aggiornamento, versione e log
8. Codici di uscita e uso negli script
9. Problemi frequenti
10. Riferimento rapido dei flag

1. Primi passi

Cosa serve

• Il file eseguibile adego (Windows o Linux a 64 bit).
• Una licenza ADEGO valida e la relativa chiave (vedi Licenza).
• Le credenziali di accesso ai servizi dell’Agenzia delle Entrate: username, password e PIN.

Licenza

Per vedere le informazioni sulla licenza usa adego license. Se sul computer non è presente nessuna licenza, ADEGO chiede di inserire la chiave di licenza ricevuta con l’acquisto: incollala e premi Invio. Anche al primo avvio di un qualsiasi comando che accede al servizio, in assenza di licenza, la chiave viene richiesta.

Come si usa

Ogni operazione è un comando, seguito dalle credenziali e da eventuali opzioni:

adego <comando> -u <username> -p <password> -c <pin> [opzioni]

Le credenziali si passano con tre opzioni valide per tutti i comandi che accedono al servizio:

Per l’elenco dei comandi: adego --help. Per le opzioni di un comando: adego <comando> --help. Per rileggere questo manuale dal terminale: adego man (intero) o adego man <comando> (solo la sezione del comando).

Attenzione alla password. Dopo tre password errate consecutive l’Agenzia delle Entrate blocca l’utente. Per questo ADEGO non ripete mai un accesso fallito: se ricevi un errore sulle credenziali, controllale con cura prima di riprovare.

Provare che l’accesso funzioni

adego login -u <username> -p <password> -c <pin>

Se tutto va bene stampa login OK: <username>.

2. Scegliere l’utenza di lavoro

Dopo l’accesso, il servizio chiede per conto di chi si opera. Le opzioni seguenti valgono per fatture, massivi, verifica e per i comandi utenza.

Se --opera è omesso con un incaricato, si usa incaricoDiretto. La modalità intermediarioNonDelegato non è al momento supportata.

Verificare la scelta

adego utenza -u <username> -p <password> -c <pin> --tipoutenza meStesso

Stampa, ad esempio, utenza OK: meStesso oppure utenza OK: incaricato, incaricante: XYZABC12D34E567F, opera: incaricoDelega, delegante: DEFGHI78L90M123N.

Scoprire quali utenze e incarichi hai a disposizione

Di default l’elenco è una tabella. Con --output json viene stampato un array JSON compatto su stdout, comodo in una pipe:

adego utenza lista-incaricanti -u <username> -p <password> -c <pin> \
      --tipoutenza incaricato --output json | jq '.[].value'

3. Scaricare le fatture

adego fatture -u <username> -p <password> -c <pin> \
      --tipoutenza meStesso \
      --tipologia R --tipodata R \
      --dalladata 01/03/2026 --alladata 31/03/2026 \
      --workdir D:/export

Il comando scarica le fatture del periodo con i relativi metadati, le raccoglie in un file ZIP e, a operazione conclusa, ne stampa il percorso su stdout.

Opzioni

Più le opzioni di utenza.

Nome del file ZIP

Il nome indica che cosa contiene:

Avanzamento

• Se lanci ADEGO da una console, durante lo scarico compare una barra di avanzamento (scritta su stderr: lo stdout resta riservato al percorso dello ZIP).
• Su Windows, con --pbar, compare anche una finestra con utente, utenza e soggetto, il resoconto con l’orario di ogni operazione e la barra di avanzamento. Si chiude da sola a lavoro finito. Fuori da Windows --pbar non ha effetto e resta la sola barra nel terminale.

Note

• Lo scarico di periodi lunghi può richiedere tempo; ADEGO attende fino a 2 ore.
• Se il portale è momentaneamente occupato, ADEGO riprova da solo e lo segnala nel resoconto.
• Su Windows due fatture con nome identico a meno di maiuscole e minuscole non si sovrascrivono: al secondo file viene dato un nome diverso.

4. File massivi

Per grandi volumi di fatture il portale offre i file massivi: si invia una richiesta, si attende che sia elaborata e si scarica il file prodotto. ADEGO copre tutti e tre i passaggi.

Limite del portale: sono ammesse 3 richieste al giorno per ciascuna tipologia. Oltre, il portale rifiuta la richiesta e ADEGO riporta il messaggio ricevuto.

4.1 Inviare una richiesta

adego massivi richiesta -u <username> -p <password> -c <pin> \
      --tipoutenza meStesso \
      --tipologia R --tipodata R \
      --dalladata 01/03/2026 --alladata 31/03/2026

Stampa su stdout l’identificativo della richiesta, da conservare per i passi successivi. Le opzioni --tipologia e --tipodata hanno lo stesso significato visto per le fatture.

4.2 Consultare lo stato

adego massivi risposta -u <username> -p <password> -c <pin> \
      --tipoutenza meStesso --idrichiesta <id>

Mostra in tabella la richiesta (stato, date, esito). Senza --idrichiesta elenca le richieste del portale.

Per salvare l’elenco in un file, aggiungi --output csv oppure --output json: il file viene creato e il suo percorso viene stampato su stdout.

adego massivi risposta ... --idrichiesta <id> --output csv --workdir D:/export

4.3 Scaricare il file prodotto

Quando la richiesta risulta Elaborata:

adego massivi risposta -u <username> -p <password> -c <pin> \
      --tipoutenza meStesso --idrichiesta <id> --download --workdir D:/export

Se la richiesta è elaborata ma non ha prodotto file, il comando ne indica il motivo (ad esempio nessuna fattura nel periodo) e termina con codice di uscita 1.

I comandi massivi hanno un tempo massimo di 5 minuti per operazione.

5. Verificare una partita IVA o un codice fiscale

adego verifica <partita-iva|codice-fiscale> -u <username> -p <password> -c <pin> \
      --tipoutenza meStesso

Non serve alcun captcha: il controllo usa le stesse credenziali delle fatture. L’esito indica se il valore è valido e, per le partite IVA, riporta l’anagrafica: denominazione, indirizzo, codice destinatario e stato della partita IVA (ad esempio ATTIVA o CESSATA).

Una partita IVA cessata può risultare comunque valida: la validità riguarda la correttezza del numero, lo stato dice se è ancora in attività.

Opzioni

Il CSV usa il separatore ;, ha una riga di intestazione e una sola riga di dati; i campi annidati diventano colonne padre.campo.

Per un codice fiscale di persona fisica senza partita IVA non esiste anagrafica: l’esito contiene solo valida e il comando termina comunque con successo.

Esempi

adego verifica 01234567890 -u ... -p ... -c ... --tipoutenza meStesso
adego verifica 01234567890 ... --attiva 2025-12-31 --output json
adego verifica RSSMRA80A01H501U ... --cf --valida
adego verifica 01234567890 ... --output csv --file D:/export/verifica.csv

6. Dove vengono salvati i file

ADEGO crea sempre una cartella ADEGO nella destinazione scelta.

• Con --workdir <cartella> i file finiscono in <cartella>/ADEGO/....
• Senza --workdir: su Windows in C:\ADEGO\..., su Linux in ~/ADEGO/... (cartella home dell’utente).

7. Aggiornamento, versione, licenza e log

Il log contiene il dettaglio di ogni operazione (mai password, PIN o token) ed è la prima cosa da guardare, e da inviare all’assistenza, in caso di problemi. Viene ruotato automaticamente: non cresce all’infinito.

man, version, license, self-update e log non richiedono credenziali.

8. Codici di uscita e uso negli script

• 0: operazione riuscita.
• 1: errore (credenziali errate, richiesta rifiutata, rete, ecc.).

Su stdout compare solo il risultato utile — il percorso di uno ZIP o di un file, l’identificativo di una richiesta, la tabella o il JSON richiesti. Messaggi di errore, barre di avanzamento e diagnostica vanno su stderr e nel log. Questo rende ADEGO semplice da usare in script e da altri programmi:

for /f "delims=" %%Z in ('adego fatture -u %U% -p %P% -c %C% --tipoutenza meStesso ^
    --tipologia R --dalladata 01/03/2026 --alladata 31/03/2026') do set ZIP=%%Z
echo File prodotto: %ZIP%

ID=$(adego massivi richiesta -u "$U" -p "$P" -c "$C" --tipoutenza meStesso \
       --tipologia E --dalladata 01/03/2026 --alladata 31/03/2026) || exit 1

9. Problemi frequenti

10. Riferimento rapido dei flag

Credenziali (tutti i comandi che accedono al servizio): -u/--username, -p/--password, -c/--pin.

Utenza (utenza, fatture, massivi, verifica): --tipoutenza, --incaricante, --opera, --delegante, --piva.

Ricerca (fatture, massivi): --dalladata, --alladata (gg/mm/aaaa), --tipologia (E, R, MD; predefinito E), --tipodata (R, E; predefinito R, solo per le ricevute).

Destinazione (fatture, massivi risposta): --workdir.

© 2026 Esselabs (esselabs.it) — Software proprietario, tutti i diritti riservati.