Transporte
El pase de transporte transforma sus títulos de transporte en un pase dinámico, siempre disponible en Apple Wallet y Google Wallet. La información del trayecto, los horarios de salida y los datos de los pasajeros se almacenan de forma segura y pueden actualizarse en tiempo real — sin que sus clientes tengan que abrir una aplicación.
Para crear una nueva plantilla de pase de transporte, acceda al módulo «Plantillas de pases» (Hub > Wallet > Plantillas de pases).
Haga clic en el botón Crear una plantilla de pase.
Una vez creada su plantilla, deberá definir las personalizaciones de la plantilla desde el módulo Plantillas de pases.
Debe crearse una plantilla por ruta o servicio de transporte. Si opera varias rutas, cree una plantilla por ruta.
Paso 1 - Configuración
Este primer paso le permite definir la información básica de su plantilla:
- Nombre: el nombre interno de su plantilla. Solo es visible para usted y su equipo en su licencia. Recomendamos adoptar una convención de nomenclatura clara.
- Tipo: el tipo de su plantilla de pase. Determina el diseño visual y los campos disponibles para esta plantilla.
El nombre de su plantilla es el que aparece en su lista de pases y en los informes. Si prevé emitir pases para varias rutas, incluya el nombre de la ruta y el tipo de transporte en el nombre de la plantilla desde el principio.
Paso 2 - Campos
Los campos son los datos que alimentan sus pases. Cada campo que desee mostrar o utilizar, ya sea fijo o personalizado, debe definirse aquí en primer lugar.
Existen dos tipos de campos:
- Campos comunes: el valor es fijo e idéntico para todos los pases generados a partir de esta plantilla. No puede modificarse al crear el pase. Utilícelos para los datos propios de la ruta, idénticos para cada pasajero: nombre del emisor, logotipo del operador.
- Campos de pase: el valor puede sustituirse al crear el pase. El valor definido aquí es el valor predeterminado, utilizado si no se proporciona ningún otro valor. Utilícelos para los datos propios de cada trayecto: origen, destino, tipo de tarifa.
Deberá añadir todos los campos que utilizará en su plantilla de pase. Estos campos podrán incluirse en sus pases y determinarán los datos mostrados a los usuarios. En el paso 3, definirá dónde se mostrarán estos campos en el pase.
Los campos que deban personalizarse según los atributos del perfil deberán configurarse en las personalizaciones de la plantilla.
Es posible que observe que algunos campos aparecen tanto en los campos comunes como en los campos de pase — por ejemplo logo. Esto es intencionado: Apple Wallet permite personalizar ciertas propiedades a nivel del pase individual, lo que significa que cada pase emitido puede tener su propio valor. Google Wallet, en cambio, no admite este nivel de personalización para estas mismas propiedades y requiere un valor único compartido por todos los pases. Si emite pases para ambas plataformas, definir el campo en ambas secciones garantiza la máxima flexibilidad.
Campos comunes
Los campos comunes definen los datos propios de la ruta, compartidos por todos los pases generados a partir de esta plantilla.
Los campos comunes son compartidos por todos los pases generados a partir de esta plantilla. Sus valores solo pueden modificarse actualizando la plantilla directamente. Tenga en cuenta que las modificaciones realizadas en los campos comunes solo se aplicarán a los pases recién creados. Los pases existentes solo pueden actualizarse mediante una campaña de actualización.
| Clave | Tipo | Descripción |
|---|---|---|
issuerName | String | El nombre de la organización emisora del pase (ej.: Mi Empresa). Se muestra en el pase y es utilizado por los lectores de pantalla. |
transitLogo | Image | El logotipo del operador de transporte que se muestra en el pase. Tamaño recomendado: 512×512 px. Utilice un PNG con fondo transparente. |
Campos de pase
Los campos de pase controlan la apariencia visual del pase y los datos personalizados que se muestran para cada trayecto individual.
A diferencia de los campos comunes, estos campos están reservados para las propiedades que contienen los datos únicos de un pase específico emitido para un usuario específico. Estos campos pueden modificarse al crear o actualizar un pase.
| Clave | Tipo | Descripción |
|---|---|---|
backgroundColor | Color | El color de fondo del pase en formato hexadecimal (ej.: #FFFFFF). |
foregroundColor | Color | El color del texto principal del pase (ej.: #000000). Asegure un contraste suficiente con el color de fondo para garantizar la legibilidad. |
labelColor | Color | El color de las etiquetas de campo (ej.: #000000). Las etiquetas son los pequeños títulos que aparecen encima de cada valor. |
icon | Image | El icono de la aplicación que se muestra en las notificaciones del sistema y en la lista de pases. Tamaño: 29×29 pt (@2x: 58×58 px). PNG con fondo transparente. |
logo | Image | Su logotipo que se muestra en la esquina superior izquierda del pase. Tamaño: 160×50 pt (@2x: 320×100 px). Fondo transparente obligatorio. |
footer | Image | Una fina franja que se muestra en la parte inferior del pase, encima del código de barras. Tamaño: 286×15 pt (@2x: 572×30 px). Frecuentemente utilizada para logotipos de socios o menciones reglamentarias. |
heroImage | Image | Una gran imagen decorativa que se muestra en el pase. Tamaño: 1032×336 px. Para usarla con visuales de ruta o transporte. |
from | String | El código o nombre abreviado del lugar de salida (ej.: AMS). Se muestra como origen en el pase. |
to | String | El código o nombre abreviado del destino (ej.: RDM). Se muestra como destino en el pase. |
fromName | String | El nombre completo del lugar de salida (ej.: Ámsterdam). Se muestra bajo el código de origen para mayor legibilidad. |
toName | String | El nombre completo del destino (ej.: Róterdam). Se muestra bajo el código de destino para mayor legibilidad. |
fareName | String | El tipo de tarifa o servicio asociado al trayecto (ej.: Todas las horas). |
from, to, fromName, toName y fareName son los campos que generalmente inyectará de forma dinámica al emitir el pase, ya que varían según el trayecto.
Añadir y eliminar campos
Tiene la posibilidad de eliminar campos marcando la casilla a la izquierda del campo y haciendo clic en Eliminar campos.
También tiene la posibilidad de añadir campos si faltan algunos. Haga clic en Añadir un campo.
Para el campo añadido, deberá elegir:
- el tipo: string, blob, date, number, money, color, image, JSON o boolean
- la clave: el nombre técnico del campo
- el valor: el valor predeterminado del campo
Paso 3 - Diseño
Una vez añadidos todos los campos que desea utilizar en su plantilla en el segundo paso, podrá definir cómo se renderizará su pase en cada plataforma. Este paso está dividido en dos pestañas, una para Apple Wallet y otra para Google Wallet.
- Apple Wallet
- Google Wallet
Apple Wallet
La pestaña Apple Wallet está dividida en cuatro subpestañas: General, Diseño, Datos y Semántica.
La plantilla de pase de transporte se presenta de la siguiente manera:
General
En esta pestaña, puede personalizar la información básica de su pase. Para cada campo:
- Puede elegir campos comunes o campos de pase que haya definido en el paso anterior. Solo estarán disponibles los campos con el formato esperado.
- Puede añadir un nuevo campo: si olvidó añadir un campo en el paso anterior, puede añadirlo aquí y se añadirá automáticamente a la lista de campos del paso 2.
- Puede optar por usar otro valor, un valor estático que no prevé reutilizar en otros campos.
La siguiente tabla presenta los campos y su descripción.
| Campo | Descripción |
|---|---|
| Nombre de la organización | El nombre que se muestra bajo su logotipo en el anverso del pase. Generalmente el nombre de su operador de transporte. |
| Descripción | Una breve descripción textual utilizada por las herramientas de accesibilidad y la búsqueda en el dispositivo. Ejemplo: Ámsterdam a Róterdam – Tren. |
| Tipo de transporte | El tipo de vehículo de transporte. Las opciones disponibles son: Air, Boat, Bus, Generic, Train. Determina el icono nativo que se muestra entre el origen y el destino en el pase. |
| Identificador de agrupación | Agrupa los pases relacionados en Apple Wallet. Útil para los viajes con múltiples tramos donde se emite un pase por tramo. |
| Identificadores de App Store | Vincula su pase a una aplicación en la App Store. Aparece un banner invitando al usuario a instalar su aplicación en el reverso del pase. |
| URL de lanzamiento de la aplicación | Una URL que abre directamente su aplicación cuando se selecciona desde el pase. Requiere un identificador de App Store. |
| Información de usuario | Un campo de metadatos para transmitir datos personalizados no mostrados con el pase. Útil para el seguimiento interno o la vinculación con el CRM. |
| Impedir el uso compartido de pases | Cuando está activado, impide que el pasajero transfiera el pase. Recomendado para los billetes nominativos. |
Diseño
La subpestaña Diseño corresponde directamente a los campos de pase definidos en el segundo paso. Seleccione el campo correspondiente para cada elemento visual mediante el menú desplegable.
Para el pase de transporte, los elementos visuales disponibles son: Texto del logotipo, Icono (29×29 pt, @2x: 58×58 px), Logotipo (160×50 pt, @2x: 320×100 px), Pie (286×15 pt, @2x: 572×30 px), Color de fondo, Color de primer plano y Color de etiquetas.
En el lado derecho de su pantalla dispone de una vista previa de su plantilla de pase.
Datos
La subpestaña Datos le permite asignar sus campos a las zonas visuales del pase (Encabezado, Principales, Secundarios, Auxiliares y Reverso). Utilice las columnas Etiqueta, Clave y Valor para controlar lo que se muestra en cada zona y en qué orden.
Para cada zona del pase:
-
Puede añadir un campo, para el que deberá definir diferentes propiedades. Tenga en cuenta que aquí está definiendo el diseño del pase. Por lo tanto, definirá las etiquetas a mostrar y el valor a presentar. Estos dos elementos no provienen necesariamente del mismo campo definido en el paso 2.
- Clave: la clave única para la combinación etiqueta/valor
- Etiqueta: la etiqueta del campo, que es la parte que se muestra arriba
- Valor: el valor del campo, que es la parte que se muestra abajo
- Alineación: la alineación del campo
Como está definiendo el diseño de su plantilla de pase, puede jugar con los diferentes campos:
- Ejemplo 1: puede decidir poner «SALIDA» como etiqueta y el nombre del lugar de salida como valor.
- Ejemplo 2: puede decidir poner el código de salida como etiqueta y el código de destino como valor.
- Puede eliminar un campo de esta zona del pase marcando la casilla a la izquierda del campo y haciendo clic en Eliminar campos.
- Puede modificar un campo haciendo clic en él.
El orden de los campos en cada zona determina su orden de visualización de izquierda a derecha en el pase. Utilice la vista previa en tiempo real a la derecha para verificar el diseño a medida que realiza la configuración.
Semántica
Las semánticas son metadatos legibles por máquinas que Apple utiliza para alimentar funciones del sistema como las sugerencias de Siri, la búsqueda Spotlight y la visualización proactiva en la pantalla de bloqueo. No son visibles en el pase en sí — funcionan silenciosamente en segundo plano para hacer su pase más inteligente.
Para los pases de transporte, las semánticas están organizadas en nueve categorías:
- Información del viaje — datos principales del trayecto: código de confirmación, número de confirmación, fechas de embarque y salida originales y actuales, fechas de llegada, duración, estado del transporte, motivo del estado, control de seguridad y preferencias de sonido.
- Origen — detalles de salida: andén de salida, nombre de la estación de salida, ubicación de salida (latitud/longitud) y descripción del lugar de salida.
- Destino — detalles de llegada: andén de destino, nombre de la estación de destino, ubicación de destino y descripción del lugar de destino.
- Información del transportista — detalles del operador: proveedor de transporte, nombre del vehículo, número del vehículo y tipo de vehículo.
- Información de embarque — detalles de embarque: grupo de embarque, número de secuencia de embarque y estado de prioridad.
- Información de asientos — detalles del asiento: configuración de asientos.
- Información del pasajero — detalles del pasajero: prefijo de nombre, sufijo de nombre, nombre de pila, segundo nombre, apellido, apodo y representación fonética.
- Tarificación — el precio del billete: código de divisa e importe.
- Otros — datos contextuales adicionales, en particular el acceso Wi-Fi (redes a las que el pase puede dar acceso).
Rellenar las semánticas es opcional pero muy recomendable para los pases de transporte — un pase con semánticas configuradas se mostrará automáticamente en la pantalla de bloqueo del pasajero cuando se aproxime la hora de salida.
Para cada semántica:
- Puede elegir campos comunes o campos de pase que haya definido en el paso anterior. Solo estarán disponibles los campos con el formato esperado.
- Puede añadir un nuevo campo: si olvidó añadir un campo en el paso anterior, puede añadirlo aquí y se añadirá automáticamente a la lista de campos del paso 2.
- Puede optar por usar otro valor, un valor estático que no prevé reutilizar en otros campos.
Google Wallet
La pestaña Google Wallet está dividida en cuatro subpestañas: General, Diseño, Datos comunes y Datos del pase.
La plantilla de pase de transporte se presenta de la siguiente manera:
General
En esta pestaña, puede personalizar la información básica de su pase. Para cada campo:
- Puede elegir campos comunes o campos de pase que haya definido en el paso anterior. Solo estarán disponibles los campos con el formato esperado.
- Puede añadir un nuevo campo: si olvidó añadir un campo en el paso anterior, puede añadirlo aquí y se añadirá automáticamente a la lista de campos del paso 2.
- Puede optar por usar otro valor, un valor estático que no prevé reutilizar en otros campos.
La siguiente tabla presenta los campos y su descripción.
| Campo | Descripción |
|---|---|
| Activar Smart Tap | Activa la validación sin contacto NFC para los terminales compatibles con Google Smart Tap. |
| Animación de seguridad | Un patrón de seguridad animado que se muestra en el pase para prevenir la falsificación. Las opciones varían según la implementación. |
| Requisito de desbloqueo | Define si el dispositivo debe estar desbloqueado para mostrar o validar el pase. |
| Múltiples dispositivos y titulares permitidos | Controla si el pase puede ser guardado por varios usuarios. Definir en Single User para los billetes nominativos. |
| URL de la página de inicio | Una URL que se muestra en el pase y enlaza a su sitio web o plataforma de reservas. Corresponde a un valor de campo común. |
| Elegibilidad para capturas de pantalla | Controla si el pase puede capturarse en pantalla en el dispositivo. |
| Restricción NFC | Define restricciones adicionales sobre el comportamiento de validación NFC. |
Diseño
La subpestaña Diseño corresponde directamente a los campos de pase definidos en el paso 2. Para Google Wallet, solo dos elementos visuales son configurables: la imagen principal (516×168 pt, subida en @2x: 1032×336 px) y el color de fondo. Seleccione el campo de pase correspondiente para cada uno mediante el menú desplegable.
Datos comunes
La subpestaña Datos comunes asocia sus campos comunes a la plantilla de datos estructurada de Google Wallet para el transporte. Seleccione el campo común correspondiente para cada ubicación mediante el menú desplegable.
Para cada campo:
- Puede elegir campos comunes que haya definido en el paso anterior. Solo estarán disponibles los campos con el formato esperado.
- Puede añadir un nuevo campo: si olvidó añadir un campo en el paso anterior, puede añadirlo aquí y se añadirá automáticamente a la lista de campos del paso 2.
- Puede optar por usar otro valor, un valor estático que no prevé reutilizar en otros campos.
Datos genéricos
| Campo | Descripción |
|---|---|
| Nombre del emisor | El nombre de la organización emisora del pase. Corresponde a issuerName. |
| Logotipo | El logotipo del operador de transporte. Corresponde a transitLogo. Tamaño: 512×512 px. |
| Logotipo grande | Una versión ampliada opcional del logotipo del operador. |
| Nombre del operador | El nombre del operador de transporte. |
| Tipo de transporte | El tipo de vehículo de transporte (ej.: Tren, Autobús, Ferry). Determina la presentación visual en Google Wallet. |
| Activar el itinerario de un solo segmento | Cuando está activado, muestra el pase como un trayecto de tramo único en lugar de un itinerario de múltiples tramos. |
Etiquetas personalizadas
| Campo | Descripción |
|---|---|
| Etiqueta del número de billete | El texto que se muestra como título del campo número de billete (ej.: Billete, N.º de billete). |
| Etiqueta de la categoría de concesión | El texto que se muestra como título del campo tarifa reducida (ej.: Tarifa, Categoría). |
| Etiqueta del término de transporte | El texto que se muestra como título del campo destino final (ej.: Término, Destino). |
| Etiqueta del andén | El texto que se muestra como título del campo andén de salida (ej.: Andén, Vía). |
| Etiqueta de la zona | El texto que se muestra como título del campo zona de viaje (ej.: Zona, Sector). |
| Etiqueta del vagón | El texto que se muestra como título del campo número de vagón (ej.: Vagón, Coche). |
| Etiqueta del coche | El texto que se muestra como título del campo número de coche (ej.: Coche, Vehículo). |
| Etiqueta del asiento | El texto que se muestra como título del campo número de asiento (ej.: Asiento, Plaza). |
| Etiqueta del nombre tarifario | El texto que se muestra como título del campo nombre de la tarifa (ej.: Tarifa, Tipo de tarifa). |
| Etiqueta de la clase tarifaria | El texto que se muestra como título del campo clase tarifaria (ej.: Clase, Cabina). |
| Etiqueta del recibo de compra | El texto que se muestra como título del campo recibo (ej.: Recibo, N.º de recibo). |
| Etiqueta del código de confirmación | El texto que se muestra como título del campo código de reserva (ej.: Confirmación, Referencia). |
| Etiqueta del valor nominal | El texto que se muestra como título del campo valor nominal del billete (ej.: Valor, Importe). |
| Etiqueta del precio de compra | El texto que se muestra como título del campo precio pagado (ej.: Precio, Importe pagado). |
| Etiqueta del mensaje de descuento | El texto que se muestra como título del campo descuento aplicado (ej.: Descuento, Reducción). |
Datos del pase
La subpestaña Datos del pase asocia sus campos de pase a los datos específicos de cada trayecto que se muestran en el pase de Google Wallet.
Para cada campo:
- Puede elegir campos de pase que haya definido en el paso anterior. Solo estarán disponibles los campos con el formato esperado.
- Puede añadir un nuevo campo: si olvidó añadir un campo en el paso anterior, puede añadirlo aquí y se añadirá automáticamente a la lista de campos del paso 2.
- Puede optar por usar otro valor, un valor estático que no prevé reutilizar en otros campos.
Datos del billete de transporte
| Campo | Descripción |
|---|---|
| Número de billete | El número único del billete. |
| ID de trayecto | El identificador único del trayecto. |
| Tipo de trayecto | El tipo de trayecto (ej.: Solo ida, Ida y vuelta). |
| Estado del billete | El estado actual del billete. |
| Estado personalizado del billete | Un estado personalizado para el billete. |
| Tipo de pasajero | El tipo de pasajero (ej.: Adulto, Niño, Persona mayor). |
| Nombre(s) del/de los pasajero(s) | El/los nombre(s) del/de los pasajero(s) que viajan con este billete. |
| Categoría de concesión | La categoría de tarifa reducida aplicada a este billete. |
| Categoría de concesión personalizada | Una categoría de tarifa reducida personalizada. |
Detalles de compra
| Campo | Descripción |
|---|---|
| Número de recibo de compra | El número de recibo de la compra del billete. |
| Fecha de compra | La fecha en que se compró el billete. |
| ID de cuenta | El identificador de la cuenta asociada a la compra. |
| Código de confirmación | El código de confirmación de la reserva. |
| Código de divisa del valor nominal | La divisa del valor nominal del billete. |
| Valor nominal | El valor nominal del billete. |
| Código de divisa del importe de compra | La divisa del precio de compra real. |
| Importe de compra | El precio realmente pagado por el billete. |
| Mensaje de descuento | Un mensaje que describe cualquier descuento aplicado al billete. |
Segmento de billete
La sección segmento de billete define los detalles del viaje para cada tramo, incluyendo el Origen, el Destino, la Fecha de salida y la Fecha de llegada.
Restricciones — define cualquier restricción adicional aplicable al billete.
Enlaces de aplicación le permite proporcionar información sobre una aplicación complementaria, dividida en tres subpestañas — Android, iOS y Web — cada una con los siguientes campos: imagen del logotipo de la aplicación, URL de la aplicación, título y descripción.
Otros le permite enriquecer el reverso del pase de Google Wallet con contenido adicional:
- Mensajes — mensajes contextuales que se muestran al titular del pase.
- Imágenes — imágenes adicionales que se muestran en el pase.
- Textos informativos — bloques de texto informativo (ej.: condiciones generales, información de viaje).
- Enlaces — enlaces externos que se muestran en el pase (ej.: hacia su plataforma de reservas o su aplicación).
Previsualice siempre las versiones Apple Wallet y Google Wallet de su pase antes de publicarlo. La vista previa en tiempo real en el lado derecho de la pantalla se actualiza al instante a medida que realiza la configuración.
Paso 4 - Pertinencia
La pertinencia define cuándo y dónde su pase se muestra automáticamente en la pantalla de bloqueo del pasajero, sin necesidad de activar manualmente una notificación.
Para los pases de transporte, la pertinencia es una de las funcionalidades más impactantes disponibles — un billete que aparece automáticamente en la pantalla de bloqueo del pasajero cuando se acerca a la estación o al punto de salida elimina toda fricción en el momento preciso en que se necesita.
Localizaciones
Añada coordenadas GPS para activar la visualización del pase en la pantalla de bloqueo cuando el pasajero entre en un radio definido alrededor de un lugar. Para los pases de transporte, los casos de uso más relevantes son:
- La estación o parada de salida
- La estación o parada de destino
Beacons (solo Apple Wallet)
Los beacons BTLE permiten una activación ultra-precisa en interiores, imposible de lograr con el GPS. Si sus estaciones o paradas han desplegado beacons Bluetooth en las entradas o en los andenes, puede configurar el pase para que se muestre automáticamente cuando el dispositivo del pasajero detecte un beacon específico.
Configure cada beacon con su UUID, y opcionalmente sus valores Major y Minor para una segmentación más precisa.
La pertinencia por beacon requiere un despliegue físico de hardware beacon in situ. Coordínese con el operador de la estación o del lugar antes de configurar esta opción.
Paso 5 - Código de barras
El código de barras es el elemento escaneable que conecta su título de transporte digital con su infraestructura física de acceso o validación.
| Formato | Descripción | Recomendación |
|---|---|---|
| None | Ningún código de barras se muestra en el pase. | Solo si su validación se basa exclusivamente en NFC. |
| QR Code | Código de barras matricial 2D. Gran capacidad de datos, escaneo rápido, ampliamente compatible. | Recomendado para la mayoría de las implementaciones de transporte. |
| PDF417 | Código de barras apilado 2D. | Utilícelo si su sistema de validación requiere específicamente el PDF417. |
| 1D (Code 128) | Código de barras lineal. Baja capacidad de datos. | Adecuado para implementaciones simples con códigos cortos. |
| Aztec | Código de barras matricial 2D. Compacto y eficiente, nativo de Apple Wallet. | Adecuado si su infraestructura de escaneo lo admite. |
El QR Code es el formato más universalmente compatible para los pases de transporte. Si su infraestructura de validación existente utiliza un formato de código de barras específico, utilícelo aquí para garantizar la compatibilidad con sus validadores y sistemas de acceso.