Summary

What is location tracking for QR/PIN driver sessions?
- GPS location tracking on the Qargo mobile app now runs for drivers who sign in with a one-time QR code or PIN code, not only for drivers who sign in with an email and password or a magic link.
- Location updates from these sessions feed into the same live tracking map that dispatchers already use, so QR/PIN drivers appear alongside email-authenticated drivers with no separate view.
Why was it introduced?
- QR and PIN sign-in is the usual access method for external carriers and subcontractor drivers who do not hold a Qargo account. Previously these drivers were never tracked, which is exactly the group where live visibility matters most.
- Tracking QR/PIN sessions removes the need for a separate third-party tracking product for carrier visibility, and it is a prerequisite for mobile-app-based arrival detection (geofencing) on subcontractor stops.
How does it work?
- When a driver opens the app with a QR or PIN code and starts an active trip, the app requests location permission and begins sending GPS updates, the same way it does for an email-authenticated driver.
- A "Location sharing on" indicator is shown on screen while tracking is active.
- Tracking stops automatically once the trip is completed. There is no background tracking between trips or during rest periods.

Prerequisites

The mobile app must be active for the resource. See Qargo Mobile APP: Activate the mobile app.
Drivers sign in with a QR or PIN code as usual. The one-time code option requires a supported app version.

A haulier working with external carriers wants every carrier driver visible on the live tracking map regardless of how the driver signs in, so a separate carrier-tracking product can be retired.
An operations team wants subcontractor drivers to appear on the tracking map so that automatic stop-arrival detection can later be built on top of the mobile app position data.

Term	Definition
QR/PIN session	A mobile app session opened with a one-time QR code or PIN code generated at dispatch, typically used by drivers without a Qargo account.
Resource allocation	The link between a driver or vehicle resource and a specific trip. Tracking updates from QR/PIN sessions are keyed to the resource allocation so each trip shows the correct position.
Live tracking map	The planning board map where dispatchers see the current position of drivers on active trips.

For the subcontractor's driver:
- The driver signs in with the QR or PIN code as today.
- After the trip opens, the app asks for location permission, the same prompt shown to email-authenticated drivers.
- Once permission is granted, the app sends location updates for the active trip and stops automatically when the trip is completed.
For the dispatcher:
- QR/PIN drivers appear on the live tracking map next to email-authenticated drivers, with no separate view and no extra setting to enable.
- Location is captured only while a trip is active, so there is no position data between trips or during rest periods.
- For generic subcontractor resources used across several concurrent trips, the current behaviour shows the last position per resource.

Issue	Resolution
A QR/PIN driver does not appear on the tracking map	Confirm the driver granted location permission on the device and that the trip is active. Tracking only runs during an active trip.
The one-time code sign-in option is not available	Ask the driver to update the mobile app to a supported version, then sign in again with the QR or PIN code.
A driver's position looks frozen on the map	Position updates stop when a trip is completed. Check whether the trip has already been completed and confirm location permission is still granted for the current trip.