Converti PDF in PKPASS

Un ticket o certificato PDF deve essere ricreato quando il destinatario deve aggiungerlo ad Apple Wallet invece di aprirlo come documento. La conversione crea un nuovo pass strutturato; non rinomina il PDF né ne conserva automaticamente le pagine.

Che cos'è il formato PDF

PDF è un formato di descrizione delle pagine che conserva tipografia, grafica, immagini e layout tra sistemi operativi e stampanti. Adobe Acrobat, Microsoft Word, LibreOffice, InDesign, i browser web, gli scanner e i sistemi di biglietteria creano file PDF.

Compagnie aeree, organizzatori di eventi, aziende, scuole e uffici pubblici usano PDF per ticket, documenti d'imbarco, fatture, certificati, moduli, manuali e documenti archiviati. Un file può contenere testo selezionabile, grafica vettoriale, immagini incorporate o una pagina acquisita tramite scansione. Un codice a barre visibile su una pagina potrebbe non esporre i propri dati come testo selezionabile.

Che cos'è il formato PKPASS

.pkpass è il formato di package basato su ZIP per i pass di Apple Wallet. Un package tipico contiene una definizione pass.json, immagini come icon.png, una directory di localizzazione facoltativa, un manifest.json contenente gli hash dei file e una signature crittografica.

La definizione strutturata può contenere campi per eventi, imbarco, negozi, coupon o pass generici, inclusi nomi, date, luoghi, informazioni sul posto a sedere, dati di contatto e un codice a barre QR, Aztec, PDF417 o Code 128. I dati di rilevanza possono attivare la visualizzazione sulla schermata di blocco in base all'ora o alla posizione, e un emittente può aggiornare un pass tramite il servizio di aggiornamento dei pass di Apple.

Un pass di Wallet non è una copia modificabile o stampabile del PDF. Conserva il documento originale per ricevute, condizioni, firme, schemi dei posti o altre pagine che non possono essere inserite nei campi di Wallet. Un pass può includere in un campo posteriore un link sicuro al PDF originale, ma Wallet non è un visualizzatore PDF generico.

Come creare il pass

Per un ticket personale

1. Esamina il PDF per individuare il numero del ticket, il nome del passeggero o partecipante, la data, il luogo, il posto e il codice a barre. Estrai il testo selezionabile con pdftotext ticket.pdf ticket.txt; esegui il rendering o acquisisci la pagina tramite scansione se il codice a barre è un'immagine. Per i PDF acquisiti tramite scansione, usa OCR e verifica manualmente ogni valore.
2. Usa Pass2U Wallet su un iPhone per un semplice pass personale. Seleziona un modello adatto, acquisisci tramite scansione o inserisci il codice a barre, scegli il formato del codice a barre fornito dall'emittente, inserisci i campi visibili e aggiungi la data o la posizione, se appropriato. Pass2U crea una rappresentazione per Wallet; non converte le pagine del PDF.
3. Apri il file .pkpass generato sull'iPhone e seleziona Add in Apple Wallet. Testa il codice a barre presso il luogo dell'evento o il varco e conserva il PDF di origine come backup. Pass2U è un servizio di terze parti, quindi verifica le condizioni relative alla gestione dei dati prima di caricare un ticket contenente informazioni personali o di prenotazione.

Per un'organizzazione o un workflow automatizzato

1. Usa una piattaforma online Apple Wallet consolidata, come PassKit o Passcreator, quando hai bisogno di modelli, distribuzione ospitata, signing, link per gli utenti o aggiornamenti dei pass. Questi sono servizi di generazione di pass, non convertitori PDF generici: associa i dati del ticket ai campi del pass, carica la grafica di Wallet, scegli il formato del codice a barre dell'emittente e genera il package firmato.
2. Per un workflow self-hosted o per sviluppatori, usa Node.js con passkit-generator o un'altra libreria PassKit mantenuta. Definisci valori come formatVersion, passTypeIdentifier, serialNumber, teamIdentifier, organizationName e lo stile di pass appropriato, quindi aggiungi i dati e le immagini estratti dal ticket.
3. Ottieni le credenziali Apple Developer e il certificato Wallet pass richiesti per il tipo di pass. Configura il certificato e la chiave privata nel generatore o nella piattaforma. Il sistema crea manifest.json, lo firma e impacchetta il risultato come ticket.pkpass.
4. Distribuisci il file tramite email, download HTTPS o una piattaforma online usando il MIME type application/vnd.apple.pkpass. Testa l'installazione, il troncamento dei campi, la visualizzazione della data, la rilevanza nella schermata di blocco, la scansione del codice a barre e qualsiasi link al PDF nel campo posteriore su un iPhone reale.

Un convertitore PDF desktop non può dedurre campi affidabili del ticket da una grafica di pagina arbitraria né creare la signature richiesta da Apple. Una piattaforma per pass può gestire signing e distribuzione, ma il caricamento di un ticket trasferisce i relativi dati personali e di prenotazione a tale provider.

Limiti di qualità e compatibilità

• I dati del codice a barre sono più importanti dell'immagine del codice a barre. Riutilizzare l'immagine originale del codice a barre può funzionare, ma riscrivere manualmente o decodificare in modo errato il relativo payload può produrre un pass che non viene accettato dallo scanner.
• Usa il formato specificato dall'emittente. I documenti d'imbarco delle compagnie aeree usano comunemente PDF417, mentre gli eventi utilizzano spesso QR o Code 128; la modifica del formato o del payload può impedire la scansione.
• Alcune compagnie aeree e alcuni sistemi per eventi usano codici a barre rotanti, firmati o convalidati dal server. Un codice a barre copiato da un PDF potrebbe essere scaduto, già utilizzato o rifiutato anche quando appare corretto. Quando disponibile, è preferibile usare il pulsante Wallet o il pass dell'emittente.
• PKPASS è principalmente un formato per Apple Wallet. Google Wallet, Samsung Wallet e le applicazioni generiche per ticket Android richiedono formati di generazione dei pass o metodi di importazione propri.
• Il certificato deve essere valido e corrispondere al pass type identifier. Un package scaduto, revocato, non corrispondente o non firmato non verrà installato normalmente.
• Usa HTTPS per qualsiasi PDF collegato ed evita link che richiedono un login che il workflow di Wallet del destinatario non può completare. Conserva il PDF originale quando il pass omette contenuti rilevanti dal punto di vista legale o operativo.