Come salvare una stringa Base64 come file PDF
Una risposta API, l'XML di una fattura o un'email grezza contengono un lungo blocco di testo che inizia con JVBERi0 e ti serve il documento al suo interno: dalla ricerca del codice all'apertura del file.
Di Metin Ersoy · Aggiornato il 10 novembre 2026
Cos'è un PDF in Base64 e perché arriva come testo?
Base64 scrive un file usando solo lettere, cifre e pochi simboli. Così formati che accettano solo testo, come JSON, XML ed email, possono trasportare un PDF al loro interno. Il codice contiene una copia esatta del documento: decodificandolo ottieni di nuovo il file originale, byte per byte, con le eventuali firme digitali ancora valide.
Di solito lo incontri in questi casi:
- API di fatturazione e contabilità. Le piattaforme di fatturazione elettronica e i software di contabilità restituiscono spesso la versione PDF di una fattura in un campo Base64. Anche l'XML strutturato di una fattura (per esempio UBL) può contenere il PDF stampabile allo stesso modo.
- Spedizioni. Quando crei una spedizione, i corrieri di solito restituiscono l'etichetta come PDF in Base64.
- Pagamenti e banche. I servizi per ricevute, buste paga ed estratti conto possono restituire il documento in un campo di testo.
- Piattaforme di firma elettronica e gestione documenti. Il documento firmato torna dal servizio di firma in Base64.
- Sorgente delle email. Nel sorgente grezzo di un'email, gli allegati PDF sono memorizzati come blocchi Base64.
1. Trova il codice e copialo tutto
- Risposta JSON: cerca il campo che contiene il PDF, spesso si chiama pdf, content, data, document, file o label. Il valore inizia con JVBERi0. Copia tutto quello che si trova tra le virgolette. Puoi anche copiare l'intera risposta: lo strumento trova da solo la parte che inizia con JVBERi0.
- File XML: cerca l'elemento che contiene il PDF (per esempio EmbeddedDocumentBinaryObject) e copia il testo tra il tag di apertura e quello di chiusura. Gli a capo non sono un problema.
- Sorgente dell'email: apri «Mostra originale» o «Visualizza sorgente». L'allegato PDF è il blocco sotto le righe Content-Type: application/pdf e Content-Transfer-Encoding: base64. Copia tutto fino alla riga vuota successiva.
- Strumenti per sviluppatori: nella scheda Rete (Network) del browser apri la risposta, fai clic con il tasto destro sul campo e scegli «Copia valore». È molto più affidabile che selezionare a mano una stringa lunghissima.
Dato che il codice è così lungo, è facile tagliarne la fine. Dopo averlo copiato, controlla che quello che hai incollato finisca come nell'originale.
2. Converti il codice e controlla il documento
Apri Base64 in PDF, premi «Oppure scrivi o incolla il testo» e incolla il codice. Appena viene decodificato, compare la prima pagina con sotto il numero di pagine, la versione del PDF e la dimensione del file. Se il codice è salvato in un file .txt, basta selezionare quel file.
L'anteprima ti permette di verificare in un attimo:
- È il documento giusto? Il numero della fattura, il nome del cliente o i dati dell'etichetta si vedono già nella prima pagina.
- Il numero di pagine è quello che ti aspettavi? Se mancano pagine, il codice è stato copiato solo in parte.
- È protetto da password? In quel caso al posto dell'anteprima compare un avviso, e il file viene comunque salvato esattamente com'è.
3. Salva il PDF e aprilo
Premi «Scarica il PDF». Il file viene salvato senza modifiche e si apre in qualsiasi lettore PDF. Da lì decidi tu: raccogli le fatture di un mese in un unico file con Unire PDF, rendilo abbastanza leggero da inviarlo per email con Comprimere PDF oppure ricava un'immagine della prima pagina con PDF in JPG.
Cosa ti dice l'inizio del codice
| Il codice inizia con | Il file contenuto |
|---|---|
| JVBERi0 | Documento PDF |
| data:application/pdf;base64, | Documento PDF (data URI) |
| iVBORw0KGgo | Immagine PNG |
| /9j/ | Foto JPG |
| UEsDB | ZIP, Word (.docx) o Excel (.xlsx) |
| PD94bWwg | Testo XML (per esempio i dati stessi della fattura) |
L'ultima riga spiega un equivoco frequente con le fatture elettroniche: alcuni servizi inviano in Base64 l'XML della fattura invece di un PDF. Una volta decodificato, quel codice ti restituisce un testo XML leggibile, non un documento.
Errori comuni
Salvare il codice come file di testo con estensione .pdf. Il file contiene ancora il testo Base64 e il lettore lo segnala come danneggiato. Il codice va decodificato.
Copiare più del solo valore. Se alla fine del codice finiscono per sbaglio una «,» o la parola «status», il codice non è più valido. Copia solo il valore oppure l'intera risposta: lo strumento estrae il codice correttamente in entrambi i casi.
A capo inseriti come \n. Nelle stringhe JSON il codice può essere spezzato ogni 76 caratteri con \n. Quei caratteri non fanno parte del PDF e lo strumento li rimuove automaticamente.
La risposta sbagliata. Se il documento non è ancora pronto, alcune API restituiscono un campo vuoto o un messaggio di errore. Se il codice è molto corto, qualche centinaio di caratteri, con ogni probabilità è un testo di errore e non un PDF.
Una nota sulla privacy
Base64 non protegge il tuo documento, ne cambia soltanto il formato. Evita di decodificare fatture, contratti, referti medici o copie di documenti d'identità su siti che caricano il file su un server. Lo strumento di PDFVela decodifica il codice sul tuo dispositivo e continua a funzionare anche se vai offline dopo il caricamento della pagina.
Vuoi provarlo? È gratis e il tuo file resta sul tuo dispositivo.
Apri Base64 in PDF