Índice de contenido

• Introducción
  • ¿Qué es un archivo de Bono digital o PKPASS?
• ¿Cómo funciona la descarga de bonos digitales (PKPass) en Dispongo?
• Configuración y personalizaciones del módulo desde el panel de control
• Opciones de configuración 
  • ¿Cómo desactivar el envió de ficheros PKPass para un proveedor?

Introducción

Para poder utilizar esta funcionalidad debes de tener contratados el módulo bono digital/fichero pkPass. Puedes consultar mas detalles escribiéndonos a peticiones@doblemente.com

Importante: Apple da una validez de una año en el certificado de cliente, por lo que antes de llegar a la fecha de caducidad es necesario solicitar la renovación a peticiones@doblemente.com

¿Qué es un archivo de Bono digital o PKPASS?

Un bono digital o PKPASS es un tipo de archivo que permite almacenar los datos de un servicios en nuestro teléfono así como un código QR con el localizador del proveedor del servicio.

Los teléfonos de Apple con sistema operativo IOS disponen de una aplicación nativa que gestiona estos ficheros, pero en el caso de Android a actualmente es necesario instalar desde su Play Store una aplicación para abrir y gestionar los ficheros de bonos digitales.

A parte de esta funcionalidad implementada en Dispongo y como información general los archivos PKPass también se puede usar en muchos otros casos como cupones descuento, tarjetas de socios, tarjetas de embarque,...

¿Cómo funciona la descarga de bonos digitales (PKPass) en Dispongo?

Una vez activo y configurado este módulo, al cliente le llegará incluido en el mail del bono una nueva sección con un enlace para descargar el fichero pkpass. Cuando se pulse sobre el icono "Add to Wallet" se iniciará la descarga y se añadirá el bono digital a nuestra cartera (wallet) de nuestro teléfono.

ejemplo de mail bono al cliente con el módulo activo de bono digital.

Configuración y personalizaciones del módulo desde el panel de control

En el panel de control de windows disponemos de un formulario para configuración y personalización del módulo. Estos datos se configuran durante el alta del módulo y no es necesario realizar ajustes por parte del usuario. 

Para acceder al formulario de configuración del bono digital iremos al menú: Expedientes >> Bono Digital >> Bono Digital

• Nombre: nombre descriptivo de la integración, por ejemplo "Apple Passbook Wallet"
• Tipo bono: seleccionar "Apple Wallet"
• TeamIdentifier: indicar el TeamID de la cuenta de desarrolador de Apple.
• PassIdentifier: indicar "Bundle ID" del App ID Configuration al crear el certificado en el portal de desarrollo de Apple (esto dato se encuentra dentro del certificado y lo utiliza el sistema de validación de IPhone para añadir y antes de añadir el pase al wallet)
• Certificado para la firma: certificado de cliente creado en el portal de desarrollo de Apple
• Certificado Apple's World Wide Developer Relations (WWDR): descargar desde el portal de desarrollo de apple: https://developer.apple.com/certificationauthority/AppleWWDRCA.cer
• Tipo código de barras: tipo de código de barras en el que se mostrará el localizador del proveedor en el Wallet del servicio descargado. Las opciones son:
  • 1. QR: código QR con el localizador del proveedor del servicio.
    2. PDF417: código de barras tipo PDF417 con el localizador del proveedor del servicio.
    3. Aztec: código de barras tipo Aztec con el localizador del proveedor del servicio.
    4. Code128: código de barras tipo Code128 con el localizador del proveedor del servicio.
    5. Igual que el Bono: realiza la misma configuración del código QR/Barras que se ha realizado en el configurado de códigos de barras/QR del sistema. Ver documentación de este módulo: Configurador de códigos QR/Barras en informes Dispongo

• Parámetros de configuración: en esta sección es necesario añadir los parámetros icon y logo:.
  • Para añadir parámetros de imágenes: pasar imagen a string/base64 (http://base64.wutils.com/encoding-online/)
  • Parámetros de color: añadir valor del color en formato hexadecimal

Consultar la referencia de la guía de diseño de Apple Developer para añadir más personalizaciones:  https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/PassKit_PG/Creating.html

Opciones de configuración 

¿Cómo desactivar el envió de ficheros PKPass para un proveedor?

Esta opción se añadió como ampliación al módulo principal y permite desde un campo en la ficha del proveedor desactivar el envió de la sección del bono digital en los mails de bonos al cliente.

Para poder activar esta funcionalidad acceder a la ficha del proveedor y dentro de la solapa "Otros datos" marcar la opción "No generar ni enviar bono digital al cliente"

Para la versión web del panel de control encontraremos esta opción dentro de la sección de notificaciones dentro de la ficha del proveedor: