Convertir PDF a PKPASS

Un ticket o certificado en PDF debe reconstruirse cuando el destinatario necesita añadirlo a Apple Wallet en lugar de abrirlo como documento. La conversión crea un pase nuevo y estructurado; no cambia el nombre del PDF ni conserva sus páginas automáticamente.

Qué es el formato PDF

PDF es un formato de descripción de páginas que conserva la tipografía, los gráficos, las imágenes y el diseño en distintos sistemas operativos e impresoras. Adobe Acrobat, Microsoft Word, LibreOffice, InDesign, los navegadores web, los escáneres y los sistemas de emisión de tickets crean archivos PDF.

Las aerolíneas, los organizadores de eventos, las empresas, las escuelas y las oficinas gubernamentales utilizan PDF para tickets, documentos de embarque, facturas, certificados, formularios, manuales y registros archivados. Un archivo puede contener texto seleccionable, gráficos vectoriales, imágenes incrustadas o una página escaneada. Es posible que un código de barras visible en una página no exponga sus datos como texto seleccionable.

Qué es el formato PKPASS

.pkpass es el formato de paquete basado en ZIP para los pases de Apple Wallet. Un paquete típico contiene una definición pass.json, imágenes como icon.png, un directorio de localización opcional, un manifest.json que contiene hashes de archivos y una signature criptográfica.

La definición estructurada puede contener campos de eventos, embarque, tiendas, cupones o pases genéricos, incluidos nombres, fechas, lugares, información de asientos, datos de contacto y un código de barras QR, Aztec, PDF417 o Code 128. Los datos de relevancia pueden activar la visualización en la pantalla bloqueada según la hora o la ubicación, y un emisor puede actualizar un pase mediante el servicio de actualización de pases de Apple.

Un pase de Wallet no es una copia editable ni imprimible del PDF. Conserva el documento original para recibos, condiciones, firmas, diagramas de asientos u otras páginas que no quepan en los campos de Wallet. Un pase puede incluir un enlace seguro al PDF original en un campo posterior, pero Wallet no es un visor de PDF general.

Cómo crear el pase

Para un ticket personal

1. Inspecciona el PDF para localizar el número del ticket, el nombre del pasajero o asistente, la fecha, el lugar, el asiento y el código de barras. Extrae el texto seleccionable con pdftotext ticket.pdf ticket.txt; renderiza o escanea la página si el código de barras es una imagen. Para los PDF escaneados, utiliza OCR y verifica manualmente cada valor.
2. Utiliza Pass2U Wallet en un iPhone para crear un pase personal sencillo. Selecciona una plantilla adecuada, escanea o introduce el código de barras, elige el formato del código de barras proporcionado por el emisor, introduce los campos visibles y añade la fecha o la ubicación si corresponde. Pass2U crea una representación para Wallet; no convierte las páginas del PDF.
3. Abre el archivo .pkpass generado en el iPhone y selecciona Add en Apple Wallet. Prueba el código de barras en el lugar o la puerta de acceso y conserva el PDF de origen como copia de seguridad. Pass2U es un servicio de terceros, por lo que debes consultar sus condiciones de gestión de datos antes de cargar un ticket que contenga información personal o de reserva.

Para una organización o un flujo de trabajo automatizado

1. Utiliza una plataforma establecida de Apple Wallet en línea, como PassKit o Passcreator, cuando necesites plantillas, distribución alojada, firma, enlaces para usuarios o actualizaciones de pases. Estos son servicios de generación de pases, no convertidores de PDF genéricos: asigna los datos del ticket a los campos del pase, carga los gráficos de Wallet, elige el formato del código de barras del emisor y genera el paquete firmado.
2. Para un flujo de trabajo autohospedado o de desarrollo, utiliza Node.js con passkit-generator u otra biblioteca de PassKit mantenida. Define valores como formatVersion, passTypeIdentifier, serialNumber, teamIdentifier, organizationName y el estilo de pase adecuado; después, añade los datos e imágenes extraídos del ticket.
3. Obtén las credenciales necesarias de Apple Developer y el certificado de pase de Wallet para el tipo de pase. Configura el certificado y la clave privada en el generador o la plataforma. El sistema crea manifest.json, lo firma y empaqueta el resultado como ticket.pkpass.
4. Distribuye el archivo por correo electrónico, mediante una descarga HTTPS o a través de una plataforma en línea utilizando el tipo MIME application/vnd.apple.pkpass. Prueba la instalación, el truncamiento de campos, la visualización de fechas, la relevancia en la pantalla bloqueada, el escaneo del código de barras y cualquier enlace al PDF en el campo posterior en un iPhone real.

Un convertidor de PDF de escritorio no puede inferir campos de ticket fiables a partir de gráficos arbitrarios de una página ni crear la firma necesaria de Apple. Una plataforma de pases puede gestionar la firma y la distribución, pero cargar un ticket transfiere sus datos personales y de reserva a ese proveedor.

Limitaciones de calidad y compatibilidad

• Los datos del código de barras son más importantes que la imagen del código de barras. Reutilizar la imagen del código de barras original puede funcionar, pero volver a escribir manualmente o decodificar incorrectamente su carga útil puede producir un pase que falle en el escáner.
• Utiliza el formato especificado por el emisor. Los documentos de embarque de aerolíneas suelen utilizar PDF417, mientras que los eventos suelen utilizar QR o Code 128; cambiar el formato o la carga útil puede impedir el escaneo.
• Algunas aerolíneas y sistemas de eventos utilizan códigos de barras rotatorios, firmados o validados por el servidor. Un código de barras copiado de un PDF puede estar caducado, haber sido utilizado ya o ser rechazado aunque parezca correcto. Es preferible utilizar el botón o pase de Wallet del propio emisor cuando esté disponible.
• PKPASS es principalmente un formato de Apple Wallet. Google Wallet, Samsung Wallet y las aplicaciones genéricas de tickets para Android requieren sus propios formatos de generación de pases o métodos de importación.
• El certificado debe ser válido y coincidir con el identificador del tipo de pase. Un paquete caducado, revocado, no coincidente o sin firmar no se instalará normalmente.
• Utiliza HTTPS para cualquier PDF enlazado y evita los enlaces que requieran un inicio de sesión que el flujo de Wallet del destinatario no pueda completar. Conserva el PDF original cuando el pase omita contenido legal u operativamente relevante.