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.
Instructions
- This section starts once Direct assignment has passed. It uses the same hub and address, with the journey in the opposite direction.
- The portal creates a new test journey and assigns it directly to your transfer company. Answer the event with a 2xx response.
- 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.
- 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.
- Transferz then moves the journey to PLANNED. Answer the status event with a 2xx response.
- Tell the portal whether your drivers use the Transferz Driver App. If they do, the section is done.
- 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.
- Each event step waits up to 5 minutes for a 2xx answer; a 2xx to an event Transferz delivers late still counts.
- 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
Links
- Guide:Assign driver and vehicle
- PUT/journeys/{id}/assign-driverAssign to driver
- PUT/journeys/{id}/assign-vehicleAssign vehicle
- PUT/journeys/{id}/status/driver-underwayUpdate status to 'driver underway'
- PUT/journeys/{id}/driver-positionUpdate driver position
- PUT/journeys/{id}/status/in-progressUpdate status to 'in progress'
- PUT/journeys/{id}/completeComplete journey