Ticketing

In this view, we can work on everything related to Tickets sales.

Ticket Types

Ticket Types are the classes of tickets that can be sold. E.g.: Single Ticket, 10-ride Pass, Student Pass, etc.

In this section, we can create, edit, and delete the Ticket Types that the Agency accepts.

Create Ticket Type

In the Ticket Type view, we will see a list of Ticket Types already entered and can also generate new types.

To create new Ticket Types, follow these steps:

• Click on the New Card Type button.
• Assign a Name and define its characteristics:
  • Personal Card. A "Personal" type card is for the exclusive use of the cardholder. Example: Student Card, Senior Card...
  • Rechargeable Card. A "Rechargeable" type card can be used by one or more users by adding credit. Example: MonthlyCard, 10TripCard...
  • Sale-Eligible Card. If this checkbox is selected, the fields Price, Currency, and Validity Date will appear and must be filled in.
• Click on the Save Card Type button to create it.

Edit / Delete Ticket Type:

In the general Ticket Type view, for each Type in the list, click the Pencil icon to access the Edit Ticket Type view. In this view, we can Edit the characteristics of the Ticket Type or Delete it by clicking the Delete Ticket Type button.

Tickets

This view adds the Tickets in circulation and is where we add a special code. The special code is what differentiates a Personal Ticket, as it links the Ticket to the User.

Create Tickets

We can manually add Tickets by following these steps:

• Click the New Tickets button.
• Enter a unique code that will identify the physical Ticket.
• Add a Ticket Type that we previously created in the Ticket Types view.
• If necessary, associate the special code.
  • When adding the special code, a field appears to input the Expiration Date. This refers to the validity period of the special code.
• We can generate more than one Ticket in the same action by clicking the button.
• Finally, click the Save Tickets button to create them.

Add Tickets via CSV

If we have a CSV file with a list of Tickets, we can automatically add them by clicking the New Tickets button and then clicking Upload CSV Files . Select the file to upload and confirm.

The CSV file must be in "comma-separated" format, with each line formatted as follows:

Code, Ticket Type, Special Code, Expiration Date

After adding the CSV file, all the data will be uploaded into the app and can be completed if the CSV did not contain everything. Additional tickets can also be added manually or via another CSV file.

Finally, we can add the tickets by clicking the Save Tickets button.

Edit / Delete Tickets:

In the general Tickets view, we can see a list of the Tickets we have already created.

• Clicking the pencil icon allows us to edit the Ticket options in the list and modify them if needed.
• We can save the changes by clicking the button.
• We can also delete the Ticket by clicking the button.

Blacklist of Tickets

When editing a Ticket, we will also see the Blacklist option. By checking the checkbox in the Blacklist column, we can add the ticket to this list.

A Ticket on the Blacklist is blocked. We can set an expiration date for the block by clicking the icon that will appear after activating the checkbox.

This option is recommended when the Ticket's security and/or use is compromised, such as in cases of theft, loss, or non-payment.

Recharge Types

In this view, we can Create, Edit, and Delete Recharge Types. Recharge Types refer to the behavior of Tickets when validated (cost of the ride, validity, etc.).

Create Recharge Type

In the general Recharge Type view, click on New Recharge Type .

• First, assign a Name and specify which Ticket Types it will affect. After that, we need to specify the Recharge Type we want to create. It can be: Temporary, Wallet, Multi-ride, One-way, or Round-trip:

  • Temporary:
    • If there is no Start Date, just indicate the Validity Period (minutes, hours, days, etc.).
    • If there is a Start Date, we must specify the Period Type (Full or with an End Date for the period).
    • We can also indicate if there is a Max tickets per day and/or Price per ride (change "Recharge Prices" to "Ticket Price").
    • In all cases, we need to specify the Period.
  • Wallet:
    • In this type of ticket, we only need to specify the amount of Credits the Recharge will have.
  • Multi-ride:
    • In this type of ticket, we only need to specify the number of Rides the Recharge will have.
  • Round-trip:
    • In this type of ticket, we only need to specify the Validity Period.

• Then click Add Consumption to configure Consumptions:

  • A new window will open with two tabs (List of Consumptions and New Consumption).
  • In the List of Consumptions tab, we will see the list of consumptions we have created. We can also see the characteristics of each one by clicking
  • In the New Consumption tab, we can create a New Consumption and assign the corresponding amount or price to the Ticket.
  • We can assign the quantity of consumptions we want to add to the Ticket.

• Click Save Recharge Type to save it.

Edit Recharge Type

To edit any already created Recharge Type, go to the general Recharge Type view and click the icon to edit.

We can modify the Recharge Ticket and add more Consumptions if needed.

Delete Recharge Type

To delete any Recharge Type, just click the icon to remove it.

Consumptions

In this view, you can Create, Edit, and Delete Consumptions.

Create Consumptions

In the general view of Recharge Types, click on New Consumption .

Stop Groups

Stop Groups are a set of Stops useful for setting prices for Trips. Unlike Zones, the same Stop can be part of multiple Stop Groups.

Create Stop Groups

In the general view of Stop Groups, click on New Stop Group . Here, we will assign a Name to the Group and select one by one the Stops we want to group. We can also select Stops belonging to one or more Zones by expanding the list of Zones by clicking the button Zones . Finally, click the Save Group button.

Stop Map

From the general view of Stop Groups, by clicking the Map button, we can also access the Stop Map, where all the Stops, Zones, and Stop Groups we have created will be displayed, allowing us to identify them in a more visual way.

On the left side of the map view, we can see 3 tabs:

• In the Groups tab, we can see a list of all the Groups previously created.
  • By clicking on any of them, another list will unfold showing all the Stops that make up the Group.
  • By clicking on the checkbox for the same Group, they will be highlighted on the Map.
  • If there are Stops that are not assigned to any group, they will appear at the top of the list in a group called No Group.
• In the Zones tab, we can see a list showing all the Zones created (see the section Zones in the manual):
  • By clicking on any of them, another list will unfold showing all the Stops that make up the Zone.
  • Clicking the checkbox for each Zone will highlight it on the map, including its initial letter.
  • If there are Stops that are not assigned to any Zone, they will appear at the top of the list in a zone called No Zone.
• On the left side of the view, in the Stops tab, we can see a list showing all the Stops belonging to the agency.

In any of the tabs, by clicking on any Stop, a window will appear with more information about it. From there, we can also reassign it to a new Stop Group using the Change Stop Group button.

Edit / Delete Stop Groups

In the general view of Stop Groups, we will see a list of all the Stop Groups we have created:

• By clicking on the icon , we can edit each Stop Group.
• To delete a Stop Group, we must enter edit mode (icon ) and click on the Delete Group button.

In the general view of Stop Groups, we will also see a dropdown button Any Stop without Group that will indicate if there are any Stops not associated with any Group. This helps us identify them and add them to one, as it is necessary for the proper functioning of the Ticketing system that all Stops are assigned to a Stop Group.

Zones

From the Zones view, we can group Stops differently than in Stop Groups. Unlike Stop Groups, the same stop cannot belong to multiple Zones.

Create Zones

To create a new Zone, follow these steps:

• In the general view of Zones, click on New Zone .
• Assign a Name to the Zone.
• Select one by one the Stops that belong to the Zone.
• Click Save Zone to save.

Keep in mind that Zones can be created automatically when assigning a zone code to a Stop during Stop creation.

From the general view of Zones, by clicking the Map button, we can also access the Zone Map, where all the Zones and Stops we have created will be displayed, allowing us to identify them in a more visual way.

From the general view of Stop Groups, by clicking the Map button, we can also access the Stop Map, where all the Stops, Zones, and Stop Groups we have created will be displayed, allowing us to identify them in a more visual way.

On the left side of the map view, we can see 2 tabs:

• In the Zones tab, we can see a list of all the Zones previously created:
  • By clicking on any of them, another list will unfold showing all the Stops that make up the Zone.
  • Clicking the checkbox for each Zone will highlight it on the map.
  • If there are Stops that are not assigned to any Zone, they will appear at the top of the list in a zone called No Zone.
• On the left side of the view, in the Stops tab, we can see a list showing all the Stops belonging to the agency.
  • Clicking the dart icon will center the map on the location of the corresponding Stop.

In any of the tabs, by clicking on any Stop, a window will appear with more information about it. From there, we can also reassign it to a new Zone using the Change Zone button.

Edit / Delete Zones

In the general view of Zones, we will see a list of all the Zones we have created:

• By clicking on the icon , we can edit the data of each Zone, as well as add or remove Stops.
• To delete the Zone, we must enter edit mode (icon ) and deselect all the Stops associated with it.
• If we click on the header of the Stop in Zone column, the Stops that belong to the Zone will be placed at the top of the list.

Ticketing History

The Ticketing History view allows us to download a file with the requested information within the available options.

We can obtain these files in the same way as in the History view (see History).

Below are the fields by report type.

Sales with validation

Fields in this report:

• Driver: Indicates the name of the driver associated with the sale and validation if any.
• Card type: Indicates the type of card (e.g., Ticket).
• Ticket/Recharge: Indicates the name of the title (e.g., Round-trip ticket).
• RFID: Indicates the RFID number if any.
• Sale date: Indicates the date of the ticket sale.
• Sale time: Indicates the time of the ticket sale.
• Price: Indicates the price of the ticket.
• Currency: Indicates the currency of the ticket price.
• Deposit: Price of the physical card.
• Provider: Indicates the provider of the ticket.
• Bus sale: Indicates the bus associated with the ticket sale.
• Ticket date: Indicates the date associated with the ticket validation.
• Ticket time: Indicates the time associated with the ticket validation.
• Consumption: Indicates the type of consumption (e.g., consumption based on zones).
• Bus ticket: Indicates which vehicle the ticket validation is associated with.
• Line ticket: Indicates which line the ticket validation is associated with.
• Stop ticket: Indicates which stop the ticket validation is associated with.
• Transfer date: If the ticket made a transfer, the transfer date is indicated.
• Transfer time: If the ticket made a transfer, the transfer time is indicated.
• Bus transfer: If the ticket made a transfer, the bus associated with the transfer is indicated.
• Line transfer: If the ticket made a transfer, the line associated with the transfer is indicated.
• Stop transfer: If the ticket made a transfer, the stop associated with the transfer is indicated.

Sales

Fields in this report:

• Driver: Indicates the name of the driver associated with the sale and validation if any.
• Card type: Indicates the type of ticket (e.g., Ticket).
• Ticket/Recharge: Indicates the name of the ticket (e.g., Round-trip ticket).
• Sale ID: Internal ID number of the ticket sale.
• RFID: Indicates the RFID number if any.
• Sale date: Indicates the date of the ticket sale.
• Sale time: Indicates the time of the ticket sale.
• Price: Indicates the price of the ticket.
• Currency: Indicates the currency of the ticket price.
• Deposit: Price of the physical card.
• Provider: Indicates the provider of the ticket.
• Bus: Indicates which vehicle the sale is associated with if any.
• Payment type: Indicates the payment method (e.g., Cash).
• TPV/Kiosk: Identifies the device associated with the sale.
• Start of shift date (only for driver sales): Indicates when the driver's shift started.
• End of shift date (only for driver sales): Indicates when the driver's shift ended.
• Hours: Number of hours for the shift.

Validations

Fields in this report:

• Validation type: Indicates the type of validation (e.g., Ticket, transfer…).
• Bus: Indicates the vehicle in which the ticket was validated.
• Driver: Indicates the name of the driver associated with the validation.
• Validation date: Indicates the ticket validation date.
• Validation time: Indicates the ticket validation time.
• Line: Indicates the line associated with the validation.
• Route: Indicates the route associated with the validation.
• Trip: Indicates the trip associated with the validation.
• Stop: Indicates the stop associated with the validation.
• Card type: Indicates the type of ticket (e.g., Ticket).
• Ticket/Recharge: Indicates the name of the ticket (e.g., Round-trip ticket).
• RFID: Valid records classified as Very delayed.
• Sale date: Percentage of valid records on time and very punctual.
• Sale time: Indicates the ticket sale time.
• Price: Indicates the ticket price.
• Currency: Indicates the currency of the ticket price.
• Provider: Indicates the provider of the ticket.
• Consumption: Indicates the type of consumption (e.g., consumption based on zones).

Sales Summary

Fields in this report:

• Day: Indicates the report date.
• Total buyers per recharge: Indicates how many buyers the recharge had on the specified date, broken down by ticket/recharge.
• Total income per recharge: Indicates the total income without identifying the currency, to facilitate further processing in tools like Excel, broken down by ticket/recharge.
• Total income/Buyer: The sum of all original ticket prices.
• Total distribution of sales by recharge: Indicates the percentage distribution of ticket/recharge sales (it may exceed 100% due to rounding).
• Total buyers per provider: Indicates the total number of sales per provider.
• Total distribution of providers: Indicates the percentage of sales per provider (it may exceed 100% due to rounding).

Validation Summary

Fields in this report:

• Day: Indicates the date.
• Total validations by line: Indicates validations broken down by line.
• Total validations by route: Indicates validations broken down by route.
• Total validations by stop: Indicates validations broken down by stop.
• Total validations by ticket: Indicates validations broken down by ticket.

Rechargeable Card History

Fields in this report:

• RFID: Unique identifier for the physical card.
• Driver: Indicates the name of the driver associated with the ticket/recharge sale.
• Card type: Indicates the type of card.
• Ticket/Recharge: Indicates the date of the ticket/recharge sale.
• Sale date: Indicates the date of the ticket/recharge sale.
• Sale time: Indicates the time of the ticket/recharge sale.
• Price: Indicates the price of the ticket/recharge sale.
• Currency: Indicates the currency of the ticket/recharge sale.
• Deposit: Price of the physical card.
• Provider: Indicates the provider of the sale.
• Bus sale: Indicates the bus number of the ticket/recharge sale, if available.
• Ticket date: Date when credit is spent on the card.
• Ticket time: Time when credit is spent on the card.
• Consumption: Type of consumption made at the time of credit usage.
• Bus ticket: Bus number where credit is spent.
• Line ticket: Line where credit is spent.
• Route ticket: Route where credit is spent.
• Stop ticket: Stop where credit is spent.

NIA Card History

Fields in this report:

• Bus: Indicates the vehicle where the NIA card was validated.
• Validation date: Indicates the date when the NIA card was validated.
• Validation time: Indicates the time when the NIA card was validated.
• Line: Indicates the line where the NIA card was validated.
• Route: Indicates the route where the NIA card was validated.
• Stop: Indicates the stop where the NIA card was validated.
• Card type: Indicates the type of the validated NIA card.
• RFID: Unique identifier for the physical card.
• Special: Internal code of the public administration that grants access to the NIA card.

Ticket History

Fields in this report:

• Ticket: Indicates the unique ticket number.
• Driver: Indicates the name of the driver who made the sale.
• Card type: Indicates the type of ticket (e.g., single, recharge).
• Ticket/Recharge: Indicates the type of ticket/recharge.
• Sale date: Indicates the ticket sale date.
• Sale time: Indicates the ticket sale time.
• Price: Indicates the price of the ticket.
• Currency: Indicates the currency in which the sale was made.
• Provider: Indicates the provider of the sale.
• Bus sale: Indicates the bus where the sale occurred.
• Ticket date: Indicates the ticket validation date.
• Ticket time: Indicates the ticket validation time.
• Consumption: Indicates the consumption type for the ticket.
• Bus ticket: Indicates the bus where the ticket was validated.
• Line ticket: Indicates the line where the ticket was validated.
• Route ticket: Indicates the route where the ticket was validated.
• Stop ticket: Indicates the stop where the ticket was validated.

External History

Fields in this report:

• External code: Unique identifier for the sale.
• Driver: Indicates the name of the driver associated with the sale and validation, if any.
• Card type: Indicates the type of card (e.g., ticket).
• Ticket/Recharge: Indicates the name of the title (e.g., round-trip ticket).
• Sale date: Indicates the sale date of the title.
• Sale time: Indicates the sale time of the title.
• Price: Indicates the price of the title.
• Currency: Indicates the currency of the title price.
• Provider: Indicates the provider of the title.
• Bus sale: Indicates the bus associated with the ticket sale.
• Ticket date: Indicates the date associated with ticket validation.
• Ticket time: Indicates the time associated with ticket validation.
• Consumption: Indicates the type of consumption (e.g., how credits are spent depending on zones).
• Bus ticket: Indicates the vehicle associated with the ticket validation.
• Line ticket: Indicates the line associated with the ticket validation.
• Route ticket: Indicates the route associated with the ticket validation.
• Stop ticket: Indicates the stop associated with the ticket validation.
• Transfer date: If the ticket made a transfer, indicates the transfer date.
• Transfer time: If the ticket made a transfer, indicates the transfer time.
• Bus transfer: If the ticket made a transfer, indicates the bus for the transfer.

Validations vs Occupation

Fields in this report:

• Date: Indicates the ticket validation date.
• Bus: Indicates the bus where the ticket was validated.
• Route: Indicates the route where the ticket was validated.
• Expedition: Indicates the expedition where the ticket was validated.
• Position: Correlating number within the report.
• Stop Name: Indicates the stop where the ticket was validated.
• Stop Code: Indicates the stop code where the ticket was validated.
• Validated: Indicates the number of validations, according to POS.
• Boarded: Indicates the number of passengers boarded at the stop according to counters.
• Alighted: Indicates the number of passengers alighted at the stop, according to counters.
• Total: Passengers inside the vehicle at that moment according to counters.
• Time: Indicates the time of validation.

Price of Recharges per Trip

Fields in this report:

• Recharge: Indicates the recharge type.
• Card: Indicates the unique identification code of the recharge.
• Recharge Date: Indicates the date of the recharge.
• Recharge Time: Indicates the time of the recharge.
• Month: Indicates in which month the recharge was made.
• Total Trips: Indicates how many trips have been made with the recharge.
• Total Transfers: Indicates the total transfers made with the recharge.
• Price per Trip: Indicates the price per trip of the recharge.
• Total Price 1 (trips): Total trips * price per trip during a month.
• Total Price 2 (trips + transfers): (Total trips + transfers) * price per trip during a month.
• MAX (Total Price 1, Minimum Monthly): The maximum between total price 1 and the minimum monthly.
• MAX (Total Price 2, Minimum Monthly): The maximum.
• Currency: Indicates the currency of the recharge.

Cancellations

Fields in this report:

• Provider: Indicates the provider of the cancellation.
• Administrator: User name of the “WebManager” who made the cancellation, if applicable.
• Driver: Indicates the driver's name who canceled the ticket, if applicable.
• Vehicle: Indicates the vehicle where the ticket was canceled, if applicable.
• TPV/Kiosk: Indicates the identifying code of the device that canceled the ticket.
• Cancellation Date: Indicates the cancellation date.
• Cancellation Time: Indicates the cancellation time.
• Sale Date: Indicates the date when the canceled ticket was sold.
• Sale Time: Indicates the time when the canceled ticket was sold.
• Card Type: Indicates the type of card for the canceled ticket (ticket, recharge…).
• Ticket/Recharge: Indicates the type of ticket/recharge for the canceled ticket.
• RFID: Identifying number of the physical card.
• Deposit: Price of the physical card.
• Recharge Price: Indicates the price of the canceled ticket recharge.
• Currency: Indicates the currency of the recharge.

Shifts per Action

Fields in this report:

• Shift Type: Indicates the shift type (sale and validation, validation only, sale only…).
• Driver: Indicates the driver's name for the shift.
• Vehicle: Indicates the vehicle of the shift.
• Shift Start: Indicates the date and time the shift started.
• Shift End: Indicates the date and time the shift ended.
• Hours: Indicates the total hours of the shift.

Transaction Numbering

Fields in this report:

• Date: Indicates the transaction date.
• Time: Indicates the transaction time.
• Taxable Base: Indicates the taxable base.
• VAT: Indicates the VAT in € of the taxable base.
• Total: Indicates the total cost of the transaction.
• Currency: Indicates the currency of the transaction.
• Correlating Number: Unique correlating number.
• Ticket/Recharge: Indicates the type of ticket/recharge.
• Sale ID: Unique identifier of the transaction.
• Offline Correlating: Internal number of the sales device if it had no internet connection.

Unvalidated Sales

Fields in this report:

• Date: Indicates the sale date.
• Time: Indicates the sale time.
• Ticket/Recharge: Indicates the type of ticket/recharge.
• Provider: Indicates the provider of the sale.
• Driver: Indicates the driver of the sale, if applicable.
• Price: Indicates the price of the sale.
• Currency: Indicates the currency of the sale.
• Sale ID: Unique identifier of the sale.
• TPV/Kiosk: Identifies the device used for the sale.

Settlements

Fields in this report:

• To settle:

  • Driver: Identifies the driver.
  • Shift ID: Identifying code of the shift.
  • Start Time: Date and time the shift started.
  • End Time: Date and time the shift ended.
  • Shift Type: Indicates the type of shift assigned to the sales device.
  • Total Sales: Indicates the total sales, in euros, per shift.

• Settled:

  • Driver: Identifies the driver.
  • Shift ID: Identifying code of the shift.
  • Start Time: Date and time the shift started.
  • End Time: Date and time the shift ended.
  • Shift Type: Indicates the type of shift assigned to the sales device.
  • Total Sales: Indicates the total sales, in euros, per shift.
  • Deposit Code: Identifier of the deposit.
  • Deposit Time: Indicates the date and time when the deposit was made.
  • Total Deposited: Indicates how much was deposited in euros.
  • Used Deposit: Indicates in euros how much deposit was used to settle.
  • Used Wallet: Indicates the amount of credit used from the wallet to settle.
  • Depositor Code: Identifies the device where the deposit was made.
  • User: Indicates which user validated the settlements.

• Partially Settled:

  • Driver: Identifies the driver.
  • Shift ID: Identifying code of the shift.
  • Start Time: Date and time the shift started.
  • End Time: Date and time the shift ended.
  • Shift Type: Indicates the type of shift assigned to the sales device.
  • Total Sales: Indicates the total sales, in euros, per shift.
  • Total Settled: Indicates in euros how much has been settled for the shift.

Providers

In this view, we can create, edit, and delete Providers.

Create Providers

To create a new Provider, follow these steps:

• In the general Providers view, click on New Provider .
• Assign a Name to the Provider and, if necessary, specify which Agency/ies it belongs to.
• Specify whether it is of Internal or External type.
• Finally, indicate the provider's sales format: TPV (on the bus), Kiosk, or Online.

Edit / Delete Providers:

In the general view, you will see a list of all the Providers we have created:

• Click on the Edit Provider icon ( ) to access and edit its details. Or, if you want to Delete it, click on [Delete Provider].

In the general Providers view, you will see a list of all Providers we have created:

• Click on the icon to edit each Provider.
• To delete a Provider, enter edit mode (icon ) and click the Delete Provider button.

Cancellations

In the Cancellations view, we can access canceled tickets:

• In the main Cancellations view, we will see a list, by default, of Drivers, but we can change it to the list of Providers by using the tab above the search bar.
• Select the Driver or Provider (only one) that you wish to view.
• Choose a date in the dropdown below the list and click Get Sales.
• Below the previous button, a list will appear with all the cancellations related to the selected Driver or Provider for the indicated date.
• To delete Cancellations, click on the button.

Passengers

This section of the manual is currently under construction.