Handle Boarding & Deboarding Flow
Overview
The Dual OTP-based Sign-In/Sign-Out mechanism ensures accurate verification of employee boarding and deboarding during trips.
The system generates two distinct OTPs:
Boarding OTP – Generated when the driver accepts the trip.
Deboarding OTP – Generated after successful boarding confirmation.
OTP Delivery & Visibility
Displayed to employees in-app.
Delivered via SMS (and email/push notifications when supported).
Can be validated by the driver only within the configured geofence radius.
Dependencies
ETS Version: 25.06 or above
Driver App Version: v6.4.0 or above
Configurations
PMS — Driver App
1. Geofence & Timeout Settings
| Config | Meaning |
|---|---|
SIGN_IN_GEO_FENCE_IN_METERS = 300 | Driver must be within 300m of pickup to allow employee sign-in. |
SIGN_OFF_GEO_FENCE_IN_METERS = signOutRestrictionGeofenceInMetres | Driver must be within the configured drop geofence radius to allow sign-off. |
SIGN_IN_TIMEOUT_IN_MINUTES = 3 | Sign-in attempt expires after 3 minutes. |
SIGN_OFF_TIMEOUT_IN_MINUTES = 3 | Sign-off attempt expires after 3 minutes. |
2. Geofence / Time Restrictions
| Config | Meaning |
ENABLE_GEO_FENCE_RESTRICTION_DURING_SIGN_IN = false | Sign-in does not depend on geofence. |
ENABLE_GEO_FENCE_RESTRICTION_DURING_SIGN_OFF = true | Sign-off must follow geofence restriction. |
ENABLE_TIME_RESTRICTION_DURING_SIGN_IN = false | No time restriction for sign-in. |
ENABLE_TIME_RESTRICTION_DURING_SIGN_OFF = false | No time restriction for sign-off. |
3. Sync Behavior
| Config | Meaning |
FEATURE_MAKE_EMPLOYEE_SIGN_IN_SYNCHRONOUS_WITH_SERVER = true | Sign-in is server-validated (synchronous API). |
FEATURE_MAKE_EMPLOYEE_SIGN_OFF_SYNCHRONOUS_WITH_SERVER = true | Sign-off is server-validated synchronously. |
FEATURE_MAKE_DUTY_START_END_SYNCHRONOUS = true | Duty start/end sync immediately with the server. |
FEATURE_MAKE_LEG_START_END_SYNCHRONOUS = true | Leg start/end sync immediately with the server. |
4. Combined Condition Behavior
| Config | Meaning |
SHOULD_REQUIRE_BOTH_GEO_FENCE_AND_TIME_CONDITIONS_FOR_ENABLING_SIGN_IN_OTP_RESTRICTION = false | Geofence OR time is enough for sign-in OTP restriction. |
SHOULD_REQUIRE_BOTH_GEO_FENCE_AND_TIME_CONDITIONS_FOR_ENABLING_SIGN_OFF_OTP_RESTRICTION = false | Geofence OR time is enough for sign-off OTP restriction. |
5. Feature Flags
| Config | Meaning |
FEATURE_EMPLOYEE_PIN_VERIFICATION_ENABLED = true | Employee PIN verification enabled (required for OTP). |
PMS — ETS
1. OTP Direction Control
| Config | Meaning |
EMPLOYEE_SIGN_IN_SIGN_OUT_OTP_DIRECTION = "BOTH" | OTP required for both sign-in and sign-out. |
2. OTP Flow Settings
| Config | Meaning |
ENABLE_SIGN_OUT_OTP_POST_SIGN_IN = true | Deboarding OTP generated only after successful sign-in OTP validation. |
ENABLE_OTP_BASED_SIGN_IN = true | Enables OTP-based sign-in. |
ENABLE_EMPLOYEE_SIGN_IN_SIGN_OUT_OTP = true | Master flag for enabling employee OTP. |
3. OTP Length
| Config | Meaning |
EMPLOYEE_OTP_LENGTH | OTP length fixed as 4 digits. |
✔️ Summary
Dual OTP ensures accurate employee boarding & deboarding validation.
OTPs displayed in-app and delivered via SMS for reliability.
Strict geofence logic ensures validation happens only at the correct location.
All operations sync immediately with the server and are fully auditable.
PMS–Driver App and PMS–ETS configurations must be aligned for the feature to function.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article