JDispatch Mobile App

Using The Mobile App

Basic Usage Notes

Deliveries and Delivery Confirmation

Pickups and Pickup Confirmations

Driver Communication

 

 

 

Additional Notes / Configuration Options

Setting Up A Device

Overview

This document outlines the setup of new phones for use with the jDispatch module.

Setting Up Drivers

The first thing that is required is to set up drivers in your integrated ERP. These steps will vary by system, so please confirm with your IT team how to set up drivers for use with JDispatch.

Activiating Your Device

If this is a new android phone, you will also need to complete the initial setup of the phone so that you may download the JDispatch app. These steps may vary, but generally you just need to turn on the phone and follow the initial prompts to set up date, time, language, etc. When you reach the point of entering in an email address, you will need to enter in a valid Gmail email address. If you do not have one, you can set one up at gmail.com. Once it is set up, this email can be used on any number of devices. 

There may be one or two more prompts aftwerwards, but you should end up at the basic android home screen.

Install JDispatch

Sign In To JDispatch Dashboard

https://www.jdispatch.ca/dashboard.php

 

Open JDispatch and Allow Location Permissions

When you first open the app, it should ask a number of questions about permissions. These permissions must be allowed in order for JDispatch to properly report driver and delivery location

If you deny any of these permissions, the driver's location may not be reported to the JDispatch server and the driver location map may not work correctly or at all.

JDispatch requires location services to always be active, so you may receive a number of messages about allowing permissions

Register The Device

Once you have allowed all driver permissions, youshould have a message warning you that the phone is not registered.

Assign a Driver to The Phone

Updating Sonim Devices

A number of Sonim XP7700 devices are registered with the JDispatch service. A number of these devices are currently running an older version of Android which will disable push notifications. An additional problem with these devices is that the built in Adnroid OS update no longer works. 

In order to update these devices to a more current version of Android to enable push notifications, you will need to follow these steps:

In order to update, we will need to install an app outside the Play store which is direct from Sonim. 

  1. Download a barcode scanner app. This one is recommended: https://play.google.com/store/apps/details?id=com.google.zxing.client.android&hl=en
    1. From your device's home screen, open the app tray
    2. Open the Play store app

    3. Search for 'Barcode Scanner' and select the app from ZXing Team

    4. Once the app is open, Click Install

  2. Enable unknown sources to install apps. 
    1. From the device's home screen, open your app tray

    2. Open the Settings app

    3. Navigate to Security

    4. Select the Unknown Sources option

    5. You will see a warning message on screen. This is expected, please tap OK.

    6.  Return to the main home screen.
  3. Now, you can install the Sonim updater app.
    1. From your device's home screen, open the app tray
    2. Open the newly installed barcode scanner app

    3. Scan this barcode

    4. Tap the link in the scanner window

    5. Select to open the link with chrome. Select 'Just Once'

    6. Tap the download button

    7. When asked which app to use, select Drive. Select 'Just Once'

    8. Accept the permissions

    9. Once the app is installed, elect to open it
    10. Tap Check Update

    11. a
    12. a
    13. a

 

 

Updating The Mobile App

In scenarios where a device is not set to auto-update the JDispatch app, the following steps will need to be followed:

  1. From the device's home screen, list all of your apps:
  2. From the listing of apps, scroll down to the Play Store app.

  3. Within the Play store app, select the menu option in the top left

  4. Select 'My Apps & Games'

  5. All of your apps should now list. Under the 'Updates' heading, you may find JDispatch

  6. Click the 'Update All' button to update all apps, or the 'Update' button next to JDispatch to update just the JDispatch app.

 

 

How to Find Your Android Version Number and Security Patch Level

This information is available in Android’s system-wide Settings screen. Whatever version of Android you’re using and whatever customizations your device’s version of Android has, you should be able to get to it in the same way.

Open the “app drawer” — the entire list of apps installed on your phone. It’s almost always a button at the bottom of your home screen, in the center.

Scroll through the list of installed apps and look for an app named “Settings”. Tap the Settings icon to enter Android’s system-wide Settings app.

Scroll down on the Settings screen and look for an “About phone”, “About tablet”, or “System” option. You’ll usually find this at the very bottom of the main Settings screen, under System, but depending on your phone it could be different. If you do find a specific option for System, you can usually find the “About Phone” underneath that.

Couldn’t find it? Depending on your phone, here are some places that you can find the Android version:

On the resulting screen, look for “Android version” to find the version of Android installed on your device, like this:

It just displays the version number, not the code name — for example, it says “Android 6.0” instead of “Android 6.0 Marshmallow”. You’ll have to perform a web search or look up a list of Android codenames if you want to know the code name associated with the version. Here’s a current list:

Other fields here are also relevant. The “Model number” field tells you the name of your device, for example.

Confirming App Permissions

These instructions are based on an Android P device. Your device screens may appear slightly different, but the menu options should still be available on your device.

Direct method when app is open

  1. Open up the app on your device. You should have a badge in the top banner of your screen. 
  2. Swipe your screen down from the top to get your notifications and menu. You should see a "JDispatch is running" or "AAG Dispatch is running" message. 

    *** Also confirm that the Location icon is enabled in this screen

  3. Tap the "JDispatch is running" / "AAGDispatch is running" message
  4. You will be presented with the app options
  5. Tap the 'Permissions' option
  6. Ensure that all of the permissions are 'Allowed all the time'

When unavailable from top bar

  1. Go into your device Settings by swiping down from the top of the screen
  2. Go into the Apps section
  3. Find the JDispatch app
  4. Select the Permissions option
  5. Ensure that Location permissions are 'Allowed all the time'

Joining JDispatch Beta

JDispatch beta is an early release app. Please be aware that there may be minor bugs or changes that are undocumented. All bugs or problems should be reported to support@amscomp.com

To join the JDispatch beta can be done via the google play app. Simply follow these steps to update your version of JDispatch to the beta test version.

Please note that it can take up to an hour for the beta signup process to be complete. Once you have been added to the beta program, you can update the JDispatch app.