Í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/). Para parámetros de color: añadir valor del color en formato hexadecimal
  • La lista de parámetros disponibles para personalizar el bono digital son:
    • mostrar_fecha_hasta: muestra la fecha fin del servicio si la duración del servicio es superior a uno (para activar indicar el valor "y").
    • mostrar_duracion_servicio: muestra la duración del servicio (para activar indicar el valor "y")
    • mostrar_hora_inicio: si el servicio tiene hora de inicio, muestra este valor en el bono (para activar indicar el valor "y").
    • mostrar_localizadorPRV: muestra el localizador del proveedor en los detalles del bono (para activar indicar el valor "y").
    • mostrar_localizadorReserva: muestra el localizador de la reserva en el detalle del bono (para activar indicar el valor "y").
    • mostrar_localizadorReserva_header: muestra el localizador de la reserva en la sección "header" (esquina superior derecha). Para activar indicar el valor "y".
    • show_thumbnail_image_service: muestra la imagen principal del producto si está configurada (para activar indicar el valor "y").
    • backgroundcolor: color de fondo del bono digital en formato exadecimal.
    • labelcolor: color para las etiquetas de los campos en formato exadecimal.
    • foregroundcolor: color para la fuente de los campos en formato exadecimal.
    • logo: valor en base64 para el logo
    • logo2x: valor en base64 para el logo2x
    • logo3x: valor en base64 para el logo3x
    • icon: valor en base64 para el icon
    • icon2x: valor en base64 para el icon2x
    • icon3x: valor en base64 para el icon3x
    • background: valor en base64 para la imagen de fondo
    • thumbnail: imagen en miniatura para el producto/servicio que se muestra junto a la descripción.
    • logotext: texto que se muestra en la parte superior del bono (por defecto se muestra en nombre de la empresa). Los valores posibles son:
      1. 1. hidden: oculta el campo
         2. proveedor_nombrefiscal: nombre fiscal del proveedor
         3. proveedor_nombre: nombre comercial del proveedor
         4. empresa_nombre: nombre de la empresa
         5. Texto libre: indicar cualquier otro valor
    • header: texto que se muestra en la parte superior derecha. Las valores posibles son:
      1. 1. hidden: oculta el valor del campo
         2. proveedor_nombrefiscal: nombre fiscal del proveedor
         3. proveedor_nombre: nombre comercial del proveedor
         4. empresa_nombre: nombre de la empresa
         5. Texto libre: indicar cualquier otro valor
         6. localizador_reserva: muestra el localizador de la reserva

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 desactivar el envío del pkpass en proveedores específicos.

Para 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: