Converter PDF para PKPASS

Um bilhete ou certificado em PDF deve ser recriado quando o destinatário precisa adicioná-lo ao Apple Wallet em vez de abri-lo como um documento. A conversão cria um novo pass estruturado; ela não renomeia o PDF nem preserva automaticamente suas páginas.

O que é o formato PDF

PDF é um formato de descrição de páginas que preserva tipografia, gráficos, imagens e layout em diferentes sistemas operacionais e impressoras. Adobe Acrobat, Microsoft Word, LibreOffice, InDesign, navegadores da web, scanners e sistemas de emissão de bilhetes criam arquivos PDF.

Companhias aéreas, organizadores de eventos, empresas, escolas e órgãos governamentais usam PDF para bilhetes, documentos de embarque, faturas, certificados, formulários, manuais e registros arquivados. Um arquivo pode conter texto selecionável, gráficos vetoriais, imagens incorporadas ou uma página digitalizada. Um código de barras visível em uma página pode não disponibilizar seus dados como texto selecionável.

O que é o formato PKPASS

.pkpass é o formato de pacote baseado em ZIP para passes do Apple Wallet. Um pacote típico contém uma definição pass.json, imagens como icon.png, um diretório de localização opcional, um manifest.json contendo hashes de arquivos e uma signature criptográfica.

A definição estruturada pode conter campos de evento, embarque, loja, cupom ou passe genérico, incluindo nomes, datas, locais, informações de assento, dados de contato e um código de barras QR, Aztec, PDF417 ou Code 128. Os dados de relevância podem acionar a exibição na tela bloqueada por horário ou localização, e um emissor pode atualizar um pass por meio do serviço de atualização de passes da Apple.

Um pass do Wallet não é uma cópia editável ou imprimível do PDF. Mantenha o documento original para recibos, termos, assinaturas, diagramas de assentos ou outras páginas que não se encaixem nos campos do Wallet. Um pass pode incluir um link seguro para o PDF original em um campo posterior, mas o Wallet não é um visualizador geral de PDF.

Como criar o pass

Para um bilhete pessoal

1. Inspecione o PDF em busca do número do bilhete, nome do passageiro ou participante, data, local, assento e código de barras. Extraia o texto selecionável com pdftotext ticket.pdf ticket.txt; renderize ou digitalize a página se o código de barras for uma imagem. Para PDFs digitalizados, use OCR e verifique manualmente cada valor.
2. Use o Pass2U Wallet em um iPhone para criar um pass pessoal simples. Selecione um modelo adequado, digitalize ou insira o código de barras, escolha o formato de código de barras fornecido pelo emissor, insira os campos visíveis e adicione a data ou localização, se apropriado. O Pass2U cria uma representação para o Wallet; ele não converte as páginas do PDF.
3. Abra o arquivo .pkpass gerado no iPhone e selecione Add no Apple Wallet. Teste o código de barras no local ou portão e mantenha o PDF de origem como backup. O Pass2U é um serviço de terceiros; portanto, verifique seus termos de tratamento de dados antes de enviar um bilhete que contenha informações pessoais ou de reserva.

Para uma organização ou fluxo de trabalho automatizado

1. Use uma plataforma estabelecida do Apple Wallet, como PassKit ou Passcreator, quando precisar de modelos, distribuição hospedada, assinatura, links para usuários ou atualizações de passes. Esses são serviços de geração de passes, não conversores genéricos de PDF: mapeie os dados do bilhete para os campos do pass, carregue os gráficos do Wallet, escolha o formato de código de barras do emissor e gere o pacote assinado.
2. Para um fluxo de trabalho hospedado localmente ou de desenvolvimento, use Node.js com passkit-generator ou outra biblioteca PassKit mantida. Defina valores como formatVersion, passTypeIdentifier, serialNumber, teamIdentifier, organizationName e o estilo de pass apropriado; depois, adicione os dados e as imagens extraídos do bilhete.
3. Obtenha as credenciais necessárias do Apple Developer e o certificado de passe do Wallet para o tipo de pass. Configure o certificado e a chave privada no gerador ou na plataforma. O sistema cria o manifest.json, assina-o e empacota o resultado como ticket.pkpass.
4. Distribua o arquivo por e-mail, download HTTPS ou uma plataforma online usando o tipo MIME application/vnd.apple.pkpass. Teste a instalação, o truncamento dos campos, a exibição da data, a relevância na tela bloqueada, a leitura do código de barras e qualquer link para PDF em campo posterior em um iPhone real.

Um conversor de PDF para desktop não consegue inferir campos confiáveis de bilhetes a partir de elementos gráficos arbitrários da página nem criar a assinatura exigida pela Apple. Uma plataforma de passes pode cuidar da assinatura e da distribuição, mas o envio de um bilhete transfere seus dados pessoais e de reserva para esse provedor.

Limitações de qualidade e compatibilidade

• Os dados do código de barras são mais importantes do que a imagem do código de barras. Reutilizar a imagem original do código de barras pode funcionar, mas redigitar manualmente ou decodificar incorretamente sua carga útil pode produzir um pass que falha no scanner.
• Use o formato especificado pelo emissor. Documentos de embarque de companhias aéreas geralmente usam PDF417, enquanto eventos costumam usar QR ou Code 128; alterar o formato ou a carga útil pode impedir a leitura.
• Algumas companhias aéreas e sistemas de eventos usam códigos de barras rotativos, assinados ou validados pelo servidor. Um código de barras copiado de um PDF pode estar expirado, já ter sido usado ou ser rejeitado mesmo quando parece correto. O próprio botão ou pass do Wallet do emissor é preferível quando disponível.
• PKPASS é principalmente um formato do Apple Wallet. Google Wallet, Samsung Wallet e aplicativos genéricos de bilhetes para Android exigem seus próprios formatos de geração de passes ou métodos de importação.
• O certificado deve ser válido e corresponder ao identificador do tipo de pass. Um pacote expirado, revogado, incompatível ou não assinado não será instalado normalmente.
• Use HTTPS para qualquer PDF vinculado e evite links que exijam um login que o fluxo do Wallet do destinatário não consiga concluir. Preserve o PDF original quando o pass omitir conteúdo relevante do ponto de vista jurídico ou operacional.