Configuración de la cuenta del escáner

Configuración de la cuenta

Para utilizar la aplicación de escaneo por primera vez es necesario configurar los siguientes elementos en la cuenta a través del back office:

1. Vaya a Administrador -> Usuarios para editar el usuario que utilizará la aplicación y actualice el nombre para mostrar, el nombre y el apellido si aún no se ha completado.

2. Vaya a Administración -> Escaneo para completar la configuración del flujo de trabajo y los modos del escáner, las preferencias, las validaciones, los pases y la ubicación. Haga clic en cualquiera de los enlaces anteriores para obtener más información sobre cada tema.

¡Ahora la cuenta está configurada para usar la aplicación de escaneo!

Flujos de trabajo y modos de escaneo

Para ver estas opciones, vaya a la sección Administrador -> Escaneo en el back office.

A partir de v9.x.x, los flujos de trabajo y modos de escaneo se han fusionado en una única forma de operación, por lo que esta configuración se ignorará al utilizar el escáner v9.

Flujos de trabajo de escaneo

Hay dos flujos de trabajo de escaneo diferentes: uno es el flujo de trabajo de Selección de viaje y el otro es el flujo de trabajo Simple.

Flujo de trabajo de selección de viaje

Si se selecciona este flujo de trabajo, para poder escanear será obligatorio seleccionar primero el viaje. Luego de seleccionar el viaje será posible escanear lo siguiente:

• billetes del tipo de producto de billetes.
• billetes del tipo de producto de reservas.
• pases.
• códigos de reserva.
• paquetes. desde v4.0.1 (solo en modo online)
• pases mensuales. desde v4.1.4
• pases flexibles. desde v5.11.10 (solo en modo online)
• Venta de billetes de productos seleccionados en el manifiesto sin mapas de asientos desde v7.2.0 (solo en modo online)
• Artículos canjeables desde v7.15.2 (solo en modo online)

Con este flujo de trabajo también es posible habilitar todas las validaciones descritas en la siguiente sección Validaciones de escaneo.

Este flujo de trabajo se admite en modo en línea o fuera de línea.

Tenga en cuenta que algunas funciones no están disponibles en el modo sin conexión. Para una referencia rápida, consulte la siguiente tabla:

Flujo de trabajo simple

Si se selecciona el flujo de trabajo simple, no es necesario seleccionar el viaje antes de escanear. El usuario simplemente inicia sesión, toca Escanear y podrá escanear lo siguiente:

• billetes del tipo de producto billete.
• billetes del tipo de producto reserva.
• billetes del tipo de producto evento.
• billetes del tipo de producto abono de transporte.
• paquetes. desde v4.0.1

No es posible utilizar la validación de escaneo cuando se utiliza el flujo de trabajo Simple, excepto las validaciones de tarifas que están disponibles en el flujo de trabajo Simple o de Selección de viaje.

El modo en línea es el único modo disponible para este flujo de trabajo.

Modos de escaneo

Hay dos modos disponibles: Fuera de línea y En línea.

Modo sin conexión

Este modo solo se puede utilizar con el flujo de trabajo de selección de viajes. No se necesita una conexión a Internet para poder escanear, sin embargo, será necesario descargar primero los datos (viajes, boletos, pases y códigos de respaldo) mediante la conectividad a Internet. Después del escaneo, también será necesario Internet para cargar todos los canjes.

Modo en línea

El modo en línea se puede utilizar para el flujo de trabajo de selección de viajes y es el modo predeterminado para el flujo de trabajo simple. Con este modo, se requiere una conexión a Internet para cada escaneo, por lo que no es necesario descargar datos ni cargar los canjes.

Configuración de selección de viaje

Para ver estas opciones, vaya a la sección Administrador -> Escaneo -> Aplicación de escáner en el back office.

Modo de escaneo

Esta opción permite al usuario seleccionar el modo en línea o fuera de línea.

Viajes visibles

Esta opción permite seleccionar en el escáner viajes que hayan comenzado hace 1 día (o más) y que aún estén en ruta.

Aceptar reservas embarcando a mitad de viaje

Con esta opción si tenemos un billete de A a D en una ruta que es A-B-C-D y el pasajero embarca en B o C entonces el canje será válido.

Aceptar embarques de igual o menor valor

Al habilitar esta opción, el pasajero podrá embarcar antes o después de la estación prevista siempre y cuando el precio sea igual o menor.

Canjes entre productos

Esta opción permitirá canjear billetes de todos los productos asociados a un determinado viaje. Por ejemplo, si tenemos un producto de reserva asociado a un determinado viaje y también tenemos un producto de billetes asociado a él, entonces podremos canjear los billetes relacionados con el producto de billetes.

Aceptar tickets abiertos para O&D inverso

Esta opción permitirá escanear tickets abiertos para O&D inverso. La redención entre productos debe estar habilitada.

Nota: Los tickets abiertos solo funcionan en modo online

Los pases externos, pases flexibles y artículos canjeables siempre permiten O & D inverso, independientemente de esta configuración.

Aceptar reservas para el O&D inverso

Esta opción permitirá escanear reservas para el O&D inverso.

Los pases externos, pases flexibles y artículos canjeables siempre permiten O & D inverso, independientemente de esta configuración.

Preseleccione la estación según la ubicación del GPS

Al trabajar en el flujo de trabajo de selección de viaje, el selector de estación preseleccionará la estación en función de la ubicación actual del dispositivo.

Si no preselecciona la estación puede ser por una de las siguientes razones:

• El radio que utiliza para buscar estaciones cercanas es demasiado corto (o no se ha configurado ninguno). Se puede cambiar desde el back-office en admin --> escaneo --> Preseleccionar estación según GPS.
• El dispositivo no pudo recuperar la ubicación actual. En general, este error es temporal.

La recuperación de ubicación solo funciona cuando la aplicación está en primer plano, es decir, si el usuario cambia a otra aplicación o la pantalla se apaga, Android puede pausar la aplicación del escáner para liberar recursos del dispositivo. Además, si el usuario cierra la aplicación del escáner, dejará de enviar actualizaciones de ubicación.

Movimientos de tickets

Los movimientos de tickets ocurren cuando un ticket que tiene un horario asignado se escanea en uno diferente, es decir, se escanea en un horario diferente o en el mismo horario pero en una fecha diferente.

También puede suceder dentro del mismo horario si el pasajero sube a bordo en una estación diferente (y la configuración lo permite).

Tenga en cuenta que los movimientos de boletos están relacionados con las siguientes validaciones: Validar Viaje, Validar Fecha, Validar O&D.

Validar viaje

Siempre que el horario del billete no coincida con el del viaje seleccionado:

• Habilitado - Error: No es posible escanear el billete.
• Habilitado - Advertencia: Se preguntará al conductor si desea mover el billete o no.
• Deshabilitado: Si el movimiento es posible el sistema lo hará sin preguntar.

Validar fecha

Siempre que la fecha del billete no coincida con la del viaje seleccionado:

• Habilitado - Error: No es posible escanear el billete.
• Habilitado - Advertencia: Se preguntará al conductor si desea mover el billete o no.
• Deshabilitado: Si el movimiento es posible el sistema lo hará sin preguntar.

Validar O&D

Siempre que una de las estaciones del billete no pertenezca al viaje actual:

• Habilitado - Error: No es posible escanear el billete.
• Habilitado - Advertencia: Se preguntará al conductor si desea mover el billete o no.
• Deshabilitado: Si el movimiento es posible el sistema lo hará sin preguntar.

Escaneo de tickets abiertos

Los tickets abiertos no tienen un manifiesto asignado. Sin embargo, cuando se escanean, se les asigna el manifiesto correspondiente.

En el caso de que el manifiesto utilice mapas de asientos, el primer asiento disponible se asignará al boleto y se mostrará en la aplicación del escáner.

Validaciones de escaneo

Para habilitar las diferentes validaciones de escaneo, navegue a la sección Administrador -> Escaneo -> Validaciones de escaneo en el back office.

En esta sección encontrarás las siguientes validaciones:

Validar viaje: Valida que el número de horario del boleto coincida con el viaje seleccionado. Esta validación está disponible para el flujo de trabajo de selección de viaje.

Lea la sección Movimientos de boletos para comprender cómo se relaciona esta validación con los movimientos.

Validar fecha: Valida que la fecha del boleto coincida con la fecha del viaje seleccionado. Esta validación está disponible para el flujo de trabajo de selección de viaje.

Por favor, lea la sección Movimientos de boletos para entender cómo se relaciona esta validación con los movimientos.

Validar O&D: Valida que los O&D en el boleto sean parte del viaje seleccionado. Esta validación está disponible para el flujo de trabajo de selección de viaje.

Prevenir doble escaneo (para boletos abiertos con múltiples usos): Esta validación advertirá a la persona que escanea si escanea accidentalmente dos veces el mismo boleto en un corto período de tiempo. Esta validación está disponible para el flujo de trabajo de selección de viaje con modo en línea.

Errores vs. advertencias

Algunas validaciones, cuando están habilitadas, tienen la opción de configurarse como un error o como una advertencia.

Por ejemplo, si configuramos la validación de fecha como error, cuando las fechas no coincidan no será posible canjear el billete. Sin embargo, si dicha validación se configura como advertencia, el conductor recibirá una advertencia, pero podrá canjear el billete (ya sea moviéndolo a la fecha seleccionada o dejando el billete en la fecha del manifiesto original).

NOTA: Por favor, tenga en cuenta que cuando una validación falla y se establece como un error, no será posible mover el ticket.

De forma predeterminada, todas las validaciones son de tipo advertencia.

Validación establecida como advertencia:

Validación establecida como error:

Validaciones de tarifas

Validar tarifa: Esta validación advertirá a la persona que escaneará con la advertencia personalizada que el usuario crea para la tarifa del boleto. En esta sección, el usuario puede crear advertencias personalizadas para cada tarifa y esa advertencia personalizada se mostrará si se escanea un boleto con esa tarifa. Esta validación está disponible para cualquier flujo de trabajo.

Validaciones de check-in (desde v7.23.0)

Validar estado de check-in: Esta validación permite configurar un mensaje personalizado que mostrará un mensaje diferente según el estado de check-in del pasajero al escanear el billete.

Incluso cuando la validación está activada, si algún mensaje queda vacío significa que no se presenta ninguna advertencia para ese estado de check-in.

Sólo se aplica a billetes escaneados en estaciones que requieren check-in.

Ventas de la aplicación Scanner (desde la versión v7.2.0)

El primer paso para comenzar a vender en la aplicación es configurar lo siguiente en el backoffice (en administración/escaneo)

Productos

Debe seleccionar el producto o los productos para los que puede vender entradas desde el escáner. Vea a continuación las familias de productos compatibles.

Solo se admiten productos de la familia de reservas -warning Actualmente no se admite la venta de viajes con mapas de asientos

Tarifas

Debe seleccionar al menos un tipo de tarifa por producto.

Métodos de pago

Debe seleccionar al menos un método de pago. Vea a continuación los métodos de pago admitidos.

El escáner solo admite los métodos de pago Square e InPerson que no requieren dirección ni ningún otro dato.

Además, solo los métodos de pago habilitados que están permitidos para el canal de back-office son elegibles para la aplicación de escáner.

Si necesita configurar el método de pago Square, siga esta guía.

Seguimiento de ubicación de la aplicación Scanner

Para comenzar a utilizar el seguimiento de ubicación de Scanner, configure la función de la siguiente manera:

En Backoffice, vaya a admin/scanning y desplácese hasta la parte inferior hasta encontrar la sección: Seguimiento de la ubicación de la aplicación del escáner

Nota: Si no ve esta opción, hable con soporte ya que esta es una función premium.

Ahora, seleccione los valores adecuados para:

• Frecuencia de captura (en segundos): con qué frecuencia la aplicación recopila la posición actual.
• Frecuencia de transferencia (en segundos): con qué frecuencia la aplicación envía la posición capturada a los servidores.
• Usar servidor Betterez: seleccione esta casilla de verificación si desea utilizar el servidor de ubicación Betterez para gestionar las actualizaciones de ubicación.
• Usar servidor personalizado: seleccione esta casilla de verificación si desea utilizar su propio servidor de ubicación para gestionar las actualizaciones de ubicación.

Una vez que la función esté configurada correctamente, proceda a habilitarla en el dispositivo como se explica aquí.

La recuperación de ubicación solo funciona cuando la aplicación está en primer plano, es decir, si el usuario cambia a otra aplicación o la pantalla se apaga, Android puede pausar la aplicación del escáner para liberar recursos del dispositivo. Además, si el usuario cierra la aplicación del escáner, dejará de enviar actualizaciones de ubicación.

Flujo de trabajo de escaneo de paquetes

Recuerde que para poder iniciar sesión en el escáner, el sistema debe conocer su nombre y apellido, por lo que, si aún no lo ha configurado, proceda con esto primero en el back-office.

1. Después de finalizar la transacción del paquete, se generará automáticamente una etiqueta "Recibido".

   

2. Una vez que se haya escaneado el código de barras del ticket del paquete, el estado se actualizará a "En tránsito" en la oficina administrativa y se creará un estado "En tránsito" en "Detalles del escaneo" cada vez que se realice un escaneo. El personal de la oficina administrativa también puede cambiar el estado del paquete haciendo clic en el botón debajo del campo "Acciones".

   

3. Cuando el paquete llega a la oficina de procesamiento, el estado se puede cambiar a "Listo para recoger" haciendo clic en el botón debajo del campo "Acciones". También se puede revertir a "En tránsito" si ocurre algo.

   

4. El estado "Entregado" se puede crear cuando el cliente retira el paquete o cuando este ya ha sido entregado simplemente haciendo clic en el botón "Entregado" ubicado debajo del campo "Acciones".

   

5. La secuencia de estados será 'Recibido' - 'En tránsito' - 'Listo para recoger' - 'Entregado', y todos los estados se pueden revertir al anterior excepto al estado 'Recibido'.

El historial de escaneo de paquetes también se puede encontrar en 'Inteligencia' - 'Informe de escaneo de paquetes'

Habilitación del flujo de trabajo de escaneo de paquetes para el escáner

El mismo flujo descrito anteriormente para el backoffice se puede habilitar para el escáner yendo a admin/scanning y desplazándose hasta la sección Parcels

Esta función está disponible en el escáner v8.4.1 y superiores.

Cancelación del canje de tickets

Los usuarios pueden cancelar el canje de reservas desde la página de manifiesto en la aplicación de escaneo. Para habilitar esta opción, desplácese hacia abajo en la página Administrador > Escaneo:

Puede habilitar o deshabilitar esta función y, opcionalmente, habilitarla solo para roles específicos.

Esta configuración se aplica a la aplicación Scanner v9.16.0 y versiones posteriores. En versiones anteriores de la aplicación, todos los usuarios pueden cancelar el canje de reservas.

Creación de una etiqueta NFC válida para un Pase

NFC solo funciona para el flujo de trabajo de selección de viaje.

Las etiquetas NFC deben codificarse como registros MimeType con la siguiente información.

• Tipo MIME: btrzscanningapp/passnumber
• Carga útil ASCII: {passNumberGoesHere}

Algunos programas de codificación pueden referirse a MimeType como ContentType

La aplicación se probó con etiquetas de tipo NTAG216 y NTAG213

Algunos ejemplos de software que se pueden utilizar para escribir la información en la etiqueta NFC:

• Herramientas NFC.
• Software de codificación GoToTags.
• Software de lectura y escritura GoToTags

Creación de un pase NFC con NFC Tools

Si elige utilizar el software NFC Tools, siga estos pasos:

1 - Abra la aplicación y vaya a escribir --> Agregar un registro --> Datos

2 - Complete lo siguiente y haga clic en Aceptar:

Tipo de contenido: btrzscanningapp/passnumber

Datos: {yourPassNumber}

Pases externos

Recuerda que para poder escanear pases externos, el sistema debe conocer tu nombre y apellido, así que por favor, si aún no lo has configurado, procede con esto primero en el back-office.

Para configurar pases externos, siga estas instrucciones:

1. En la página principal, haga clic en el icono "admin" en la esquina superior derecha de la página y busque "Pases externos" en el menú desplegable.
2. Una vez en la página "Pases externos", haga clic en "Descargar plantilla". Esto descargará un archivo .csv que tiene una tabla.
3. En la página "Pases externos", haga clic en "Mostrar instrucciones" y podrá ver una descripción de lo que se necesita en cada columna de la tabla. Los operadores deberán configurar un número de cuenta de pago de antemano. Para ello, vaya a la opción "Pagos" en el menú desplegable "admin". Seleccione "pay_on_account" y siga las instrucciones que aparecen allí.
4. Una vez que la plantilla de pase externo esté completa, vuelva a cargar el archivo .csv en el sistema.

Tenga en cuenta que cada plantilla es para un tipo de tarifa específico. Si necesita dos tipos de tarifa, por ejemplo, “Adulto” y “Niños”, deberá crear dos tablas separadas y cargarlas individualmente.

Validaciones admitidas

Al escanear un pase externo, se realizan algunas validaciones en el escáner. El administrador puede configurar dichas validaciones.

Validaciones a nivel de cuenta

Las siguientes validaciones se pueden configurar en Admin / Escaneo en el backoffice. Tenga en cuenta que estas configuraciones afectan a todos los productos.

• Aceptar billetes en viajes más económicos: si se configura, el usuario puede subir al autobús en cualquier estación que se encuentre entre el origen y el destino establecidos en el pase externo.

Validaciones adicionales que no se pueden configurar

• O&D inverso: todos los pases externos permiten el escaneo O&D inverso.

Códigos de respaldo

Recuerde que para poder escanear códigos de respaldo, el sistema debe conocer su nombre y apellido, por lo que, si aún no los ha configurado, proceda con esto primero en el back-office.

Aproveche este sistema basado en códigos QR para generar identificaciones escaneables, para identificar y ordenar los tickets de múltiples fuentes. Estos códigos únicos básicamente organizan los tickets tan pronto como se validan, lo que a su vez hace que los procesos de contabilidad y conciliación del back-end sean más eficientes.

Para configurar un código de respaldo:

-En el menú desplegable de administración, seleccione "Escaneo" y desplácese hacia abajo hasta "Códigos de respaldo".

-Haga clic en "Agregar nuevo" y complete los detalles necesarios. Tenga en cuenta que se debe crear un pago en cuenta antes de configurar un código. Para ello, vaya a la opción "Pagos" en el menú desplegable "Administrador" y seleccione "pay_on_account"; luego siga las instrucciones que se indican allí.

-Haga clic en ‘Guardar’ y haga clic en el icono de impresión en el lado derecho para obtener el código QR asociado

-Este código QR se puede imprimir o escanear con un teléfono móvil. Para escanearlo, el flujo de trabajo debe configurarse en "Selección de viaje" en Admin > Escaneo

Pases Flex

Configuración

Antes de utilizar los pases Flex, asegúrate de que ya has configurado los productos y el método de pago especial para los pases Flex. Los siguientes enlaces te explicarán cómo hacerlo.

• Crear los productos Flex Pass
• Crear el método de pago Flex Pass
• En Admin / Escaneo, asegúrese de que estas opciones estén configuradas:
• Flujo de trabajo de escaneo: Selección de viaje
• Modo de escaneo: En línea

Validaciones admitidas

Al escanear un pase flexible, se realizan varias validaciones en el escáner. El administrador puede configurar dichas validaciones.

Validaciones a nivel de producto

Las siguientes validaciones se pueden configurar en la página del producto

• Mes de validez
• Usos por día
• Usos por viaje
• Número máximo de usos
• Número total de días para usar el pase flexible
• Días de vencimiento
• Id. de solicitud
• Restringir pasajeros
• Evitar superposiciones de horarios en diferentes viajes
• En toda la red: esto se puede configurar en el tipo de precio del producto y, para el escáner, significará si el pasajero puede subir al autobús en cualquier estación o no.

Validaciones a nivel de cuenta

Las siguientes validaciones se pueden configurar en Admin / Escaneo en el backoffice. Tenga en cuenta que estas configuraciones afectan a todos los productos.

• Aceptar billetes en viajes más económicos: si se configura, el usuario puede subir al autobús en cualquier estación que se encuentre entre el origen y el destino establecidos en el pase Flex.

Validaciones adicionales que no se pueden configurar

• O&D inverso: todos los pases Flex permiten el escaneo O&D inverso.

Escaneo de Flex Passes

Recuerda que para poder acceder al escáner el sistema debe conocer tu nombre y apellido, por lo que, si aún no lo has configurado, procede con esto primero en el back-office.

Cuando el pasajero compre un Flex Pass, se le enviará por correo electrónico el código QR del Flex Pass para utilizarlo al embarcar. Este se puede utilizar como cualquier otro billete escaneable.

De manera interna, se genera una reserva real cuando el usuario escanea un pase Flex. Esa reserva tendrá una transacción pagada con el método de pago del pase Flex y un monto de $0. Además, esta reserva se utiliza para los cálculos de capacidad y los informes de número de pasajeros.

Tenga en cuenta que la parte de reserva es invisible para el pasajero cuando se utiliza con el escáner. Lo único que verá el pasajero será el pase Flex.

Elementos canjeables (RI)

Configuración de RI

Antes de usar elementos canjeables, asegúrese de haber configurado los paquetes como se explica aquí.

Validaciones admitidas por RI

Al escanear un artículo canjeable, se realizan algunas validaciones en el escáner:

Validaciones de RI a nivel de producto

Actualmente, cualquier validación o configuración a nivel de producto no tiene efecto al escanear un artículo canjeable con la aplicación de escáner.

Validaciones de RI a nivel de cuenta

Las siguientes validaciones se pueden configurar en Admin / Escaneo en el backoffice. Tenga en cuenta que esta configuración afecta a todos los productos.

• Aceptar boletos en viajes más económicos: si se configura, el usuario puede subir al autobús en cualquier estación que se encuentre entre el origen y el destino establecidos en el elemento canjeable.

RI Validaciones adicionales que no se pueden configurar

• O&D inverso: todos los artículos canjeables permiten el escaneo O&D inverso.