Skip to content

Driver, vehicle and tracking

Proves your system assigns a driver and a vehicle to a journey and, if you use your own system instead of the Transferz Driver App, reports the driver's progress and position until the journey is completed.

Verified by:Webhook acknowledgedRequest observed

Instructions

  1. This section starts once Direct assignment has passed. It uses the same hub and address, with the journey in the opposite direction.
  2. The portal creates a new test journey and assigns it directly to your transfer company. Answer the event with a 2xx response.
  3. Right after that, the portal moves the pickup time to now, so the journey can be driven and completed during the test. Answer the pickup time change event with a 2xx response; there is nothing else to do.
  4. Assign a driver, then a vehicle, to that journey from your system. The portal shows the journey ID and waits for your calls; there is no time limit.
  5. Transferz then moves the journey to PLANNED. Answer the status event with a 2xx response.
  6. Tell the portal whether your drivers use the Transferz Driver App. If they do, the section is done.
  7. Otherwise, from your system: set the journey to DRIVER_UNDERWAY, send at least 3 different driver positions, answer the DRIVER_ARRIVED status event (Transferz sets this status), set the journey to JOURNEY_IN_PROGRESS and complete the journey. Send the driver's latitude and longitude with every status update and with completing the journey.
  8. Each event step waits up to 5 minutes for a 2xx answer; a 2xx to an event Transferz delivers late still counts.
  9. Calls made with Try it in the portal don't count.

Pass criteria

  • Your endpoint answers journeyFleetAssignedEvent, journeyExecutionDetailsUpdatedEvent and the PLANNED status event with 2xx, each within 5 minutes (a 2xx to an event Transferz delivers late still counts)
  • Successful assign-driver and assign-vehicle calls for the test journey from your system
  • With your own system: DRIVER_UNDERWAY, at least 3 different driver positions, the DRIVER_ARRIVED status event answered with 2xx within 5 minutes, JOURNEY_IN_PROGRESS and completing the journey, every status update and the completion with a valid position

Was this helpful?