Konwertuj PDF na PKPASS

Bilet lub certyfikat PDF trzeba odtworzyć, gdy odbiorca musi dodać go do Apple Wallet zamiast otwierać go jako dokument. Konwersja tworzy nowy, ustrukturyzowany pass; nie zmienia nazwy pliku PDF ani nie zachowuje automatycznie jego stron.

Czym jest format PDF

PDF to format opisu strony, który zachowuje typografię, grafikę, obrazy i układ w różnych systemach operacyjnych oraz na różnych drukarkach. Adobe Acrobat, Microsoft Word, LibreOffice, InDesign, przeglądarki internetowe, skanery i systemy sprzedaży biletów tworzą pliki PDF.

Linie lotnicze, organizatorzy wydarzeń, firmy, szkoły i urzędy używają formatu PDF do biletów, dokumentów pokładowych, faktur, certyfikatów, formularzy, instrukcji i zarchiwizowanych dokumentów. Plik może zawierać zaznaczalny tekst, grafikę wektorową, osadzone obrazy lub zeskanowaną stronę. Kod kreskowy widoczny na stronie może nie udostępniać swoich danych jako zaznaczalnego tekstu.

Czym jest format PKPASS

.pkpass to format pakietu oparty na ZIP, przeznaczony dla passów Apple Wallet. Typowy pakiet zawiera definicję pass.json, obrazy takie jak icon.png, opcjonalny katalog lokalizacji, plik manifest.json zawierający hashe plików oraz kryptograficzny signature.

Ustrukturyzowana definicja może zawierać pola passów wydarzeń, pokładowych, sklepowych, kuponów lub ogólnych, w tym imiona i nazwiska, daty, miejsca, informacje o miejscach, dane kontaktowe oraz kod kreskowy QR, Aztec, PDF417 lub Code 128. Dane istotności mogą wywołać wyświetlenie na ekranie blokady według czasu lub lokalizacji, a wystawca może aktualizować pass za pośrednictwem usługi aktualizacji passów Apple.

Pass Wallet nie jest edytowalną ani przeznaczoną do drukowania kopią pliku PDF. Zachowaj oryginalny dokument na potrzeby potwierdzeń, warunków, podpisów, schematów miejsc lub innych stron, które nie pasują do pól Wallet. Pass może zawierać bezpieczny link do oryginalnego pliku PDF w polu tylnym, ale Wallet nie jest ogólną przeglądarką plików PDF.

Jak utworzyć pass

Jeden bilet osobisty

1. Sprawdź w pliku PDF numer biletu, imię i nazwisko pasażera lub uczestnika, datę, miejsce, miejsce na widowni oraz kod kreskowy. Wyodrębnij zaznaczalny tekst za pomocą pdftotext ticket.pdf ticket.txt; wyrenderuj lub zeskanuj stronę, jeśli kod kreskowy jest obrazem. W przypadku skanowanych plików PDF użyj OCR i ręcznie zweryfikuj każdą wartość.
2. Użyj aplikacji Pass2U Wallet na iPhonie, aby utworzyć prosty pass osobisty. Wybierz odpowiedni szablon, zeskanuj kod kreskowy lub wprowadź go ręcznie, wybierz format kodu kreskowego podany przez wystawcę, wprowadź widoczne pola oraz, jeśli jest to właściwe, dodaj datę lub lokalizację. Pass2U tworzy reprezentację w Wallet; nie konwertuje stron pliku PDF.
3. Otwórz wygenerowany plik .pkpass na iPhonie i wybierz Add w Apple Wallet. Przetestuj kod kreskowy w miejscu wydarzenia lub przy bramce i zachowaj źródłowy plik PDF jako kopię zapasową. Pass2U to usługa zewnętrzna, dlatego przed przesłaniem biletu zawierającego dane osobowe lub informacje o rezerwacji sprawdź jej zasady przetwarzania danych.

Organizacja lub zautomatyzowany workflow

1. Skorzystaj z uznanej platformy online dla Apple Wallet, takiej jak PassKit lub Passcreator, gdy potrzebujesz szablonów, hostowanej dystrybucji, podpisywania, linków dla użytkowników lub aktualizacji passów. Są to usługi generowania passów, a nie uniwersalne konwertery PDF: przypisz dane biletu do pól passa, prześlij grafiki Wallet, wybierz format kodu kreskowego wystawcy i wygeneruj podpisany pakiet.
2. W przypadku self-hosted lub deweloperskiego workflow użyj Node.js wraz z passkit-generator albo innej utrzymywanej biblioteki PassKit. Zdefiniuj wartości takie jak formatVersion, passTypeIdentifier, serialNumber, teamIdentifier, organizationName oraz odpowiedni styl passa, a następnie dodaj wyodrębnione dane biletu i obrazy.
3. Uzyskaj wymagane dane uwierzytelniające Apple Developer oraz certyfikat passa Wallet dla danego typu passa. Skonfiguruj certyfikat i klucz prywatny w generatorze lub na platformie. System tworzy plik manifest.json, podpisuje go i pakuje wynik jako ticket.pkpass.
4. Dystrybuuj plik za pośrednictwem wiadomości e-mail, pobierania HTTPS lub platformy online, używając typu MIME application/vnd.apple.pkpass. Przetestuj instalację, obcinanie pól, wyświetlanie daty, istotność na ekranie blokady, skanowanie kodu kreskowego oraz ewentualny link do pliku PDF w polu tylnym na prawdziwym iPhonie.

Komputerowy konwerter PDF nie potrafi wywnioskować wiarygodnych pól biletu z dowolnej grafiki strony ani utworzyć wymaganego przez Apple podpisu. Platforma passów może obsłużyć podpisywanie i dystrybucję, ale przesłanie biletu oznacza przekazanie jego danych osobowych i informacji o rezerwacji temu dostawcy.

Ograniczenia jakości i zgodności

• Dane kodu kreskowego są ważniejsze niż obraz kodu kreskowego. Ponowne użycie oryginalnego obrazu kodu kreskowego może zadziałać, ale ręczne przepisanie lub nieprawidłowe zdekodowanie jego zawartości może spowodować, że pass nie przejdzie weryfikacji skanera.
• Użyj formatu określonego przez wystawcę. Dokumenty pokładowe linii lotniczych często używają PDF417, natomiast wydarzenia często korzystają z QR lub Code 128; zmiana formatu lub zawartości może uniemożliwić skanowanie.
• Niektóre linie lotnicze i systemy obsługi wydarzeń używają obracających się, podpisanych lub weryfikowanych przez serwer kodów kreskowych. Skopiowany kod kreskowy z pliku PDF może być wygasły, już użyty lub odrzucony, nawet jeśli wygląda poprawnie. Jeśli jest dostępny, preferowany jest własny przycisk Wallet lub pass wystawcy.
• PKPASS to przede wszystkim format Apple Wallet. Google Wallet, Samsung Wallet i ogólne aplikacje biletowe na Androida wymagają własnych formatów generowania passów lub metod importu.
• Certyfikat musi być ważny i zgodny z identyfikatorem typu passa. Wygasły, unieważniony, niezgodny lub niepodpisany pakiet nie zainstaluje się prawidłowo.
• Używaj HTTPS dla każdego połączonego pliku PDF i unikaj linków wymagających logowania, którego odbiorca nie może ukończyć w ramach procesu Wallet. Zachowaj oryginalny plik PDF, jeśli pass pomija treści istotne prawnie lub operacyjnie.