Please note, this is an old guide for Server Deployment only, for Cloud service please use our Knowledge Base

Mobile app issues and what to do

Learn how to solved some of the potential problems with the app.

Error message “JSON Parese error: Unrecognized token” or “Could not connect to the host. Code: 500” or “Internal Server Error”

​​​This error might appear when Host URL has change. This might happen when SSL has been connected or disconnected and when a domain url via which you access the software has been change. In effect the Driver app connection fails. Here is what to do:

Solution 1.

  1. In your device (your phone) navigate to Settings -> Apps
  2. On list of apps find “ETO Driver” app and click on it
  3. Iin the ETO Driver app settings navigate to Storage and click Clear cache

You can find more information about how to clear the app cache here.

If you follow the instruction but the error persist, uninstall the app, restart the device and install the app again.

 

Solution 2.

  1. Go to your device (your phone)
  2. In driver app click Log out
  3. In login window, press a two arrow icon in the top right corner – this will take you to Accounts screen
  4. In the accounts screen press “X” icon in the top left corner, this will enable account removal mode
  5. Remove all accounts by clicking “X” icon displayed next to each account name
  6. Once the account has been successfully removed you can setup new account using new “HOST URL”. The Host URL can be found in EasyTaxiOffice Software in Settings -> Mobile Apps tab.

Potential issue: Driver install and login to app but not visible on the map ​​​

For the driver to appear on the map in dispatch, driver needs to:

  • Install the driver app
  • Login with details provided by the admin
  • Press Start button – this option switch on the tracking functionality
  • Ensure mobile GPS tracking functionality is on

Sometimes the Host URL might change while your are still logged in (for example you activate SSL certificate in your website and the URL now starts with https://), so in this case you need to logout and login again using correct Host URL

Potential issue: Network request failed error message ​​

If you see Network request failed error message, please ensure Host URL, Email and Password you enter in login form are correct. Also please check Potential issue: Driver install and login to app but not visible on the map section.

Potential issue: Can’t login to the app

Driver need to ensure Host URL, Email and Password are correct.
Admin should provide correct Host URL which can be found in Admin -> Settings -> Mobile Apps section. Each symbols matters, including last slash symbol ” / “, otherwise connection will not be possible.

Potential issue: Network Error message display on the device

For driver to be visible on the map in the dispatch screen, driver has to activate “Start” button in the app otherwise no location coordinates (GPS) will be shared with the system.

Potential issue: Driver is logged in the driver app but not visible on the map in the dispatch screen?

When this message is display, please ensure battery saving mode is disabled as it might cause connection problems with the server.
In case the SSL certificate is installed on your server, please make sure it is installed correctly and it is not returning a warning message saying that the connection is insecure.

Potential issue: Driver is visible on map but not moving?

This is cause by driver phone being set to battery saving mode which deactivates GPS feature which is required to obtain driver’s current location.
The system saves last received driver location, so if your driver battery goes into saving mode it will display last available location but from that point doesn’t receive information thus showing driver not moving on map.

Potential issue: I see this error message “NSURLErrorDomain Code=-1003”, what to do?

When this error message occur it means that the software installation (HOST URL) has changed recently, but it has not been updated in driver app settings. To fix this issue the driver needs to remove old settings from his mobile app (see the steps below) and establish new connection with the software by following instructions available in “Download App” tab in his account.

1. Clear app and offload data for Driver app, this online guide explains how to do it.
2. Remove the app and reinstall it.
3. Add new account and try again. Driver might need to swipe left to add a new account.

Potential issue: I can’t login to driver app with my admin account

If you see this error message “You must have a driver account to use this mobile app!” when login to driver app that means you are using wrong account type. The driver app was designed with driver in mind so only driver type accounts can use it. Admin can access his account by using internet browser e.g. Google Chrome, Firefox, Edge, Safari etc. To create new or manage existing driver accounts go to Users -> Drivers tab.

 

 

Didn’t help? Contact Support.