Q Codes in X Mobile

Drivers can text or email Q codes to the Operations App to update. 

How Q Codes Work

When an order is dispatched to a driver, the Operations App will send an email-to-text to the driver's phone and the driver responds to the text message with a Q code. For example,  the driver would respond "QY" for confirmed or "QP" for picked up. When the Q code is received by the Operations App, the information will be added, and use the timestamp that the email was sent as the time stamp on the order. 

The responses should also include the associated order number. For example "QY 12345".

Q Codes

Q Code

Description

Q Code

Description

QY

Confirmed

QR

Rejected

QRD

Received at Dock

QAP

At Origin

QNP

Next Pickup

QP

Picked Up

QAD

At Destination

QND

Next Delivery

QD

Delivered 

Requires the POD after the code.

Example: QD Ryan R

QZ

Move to Zip

QCI

Driver Check In

QCO

Driver Check Out

QO

Defines Order Number

Back to top.

How to Set Up Q Codes

Inbound Email Settings 

An Inbound Email must be set up on an active profile in the Mail Manager. See Mail Manager.

  1. Go to ActionMail Manager.

  2. Click the Edit Profile icon 

    .

  3. Click Add. To edit a profile, select the mail account you would like to edit by clicking on it, it will be highlighted in blue, then click Properties.

  4. Enter a Profile Name and the number of minutes you would like to check for inbound or outbound email messages in the Frequency field. It is recommended that the Frequency is set between 1-3 minutes.

  5. Check Enable inbound email.

  6. Enter the information for the Inbound Email section. 

    • Enable inbound email - If checked this will receive email through the email server set up in the Inbound Email settings.

    • Inbound mail type - How the incoming email will be accessed. 

      • POP3 - This is recommended when email will only be accessed in the Operations App. The server listens on well-known port 110. Encrypted communication for POP3 is either requested after protocol initiation, using the STLS command, if supported, or by POP3S, which connects to the server using Transport Layer Security (TLS) or Secure Sockets Layer (SSL) on well-known TCP port 995.

      • IMAP - This is recommended when you are accessing an email from multiple devices. The server typically listens on port number 143. IMAP over SSL (IMAPS) is assigned the port number 993.

    • Host - POP3 or IMAP email server. This information would be provided by your email service provider. 

    • Username - Usually your email address.

    • Password - Password used with the username above for your email.

    • Port - Port provided by your email service provider.

    • Secure Connection - This should be checked if your email provider requires SSL/Secure Connection

  7. Click Save.

Back to top.

Setting Up the Message Format

A message format must be set up to send messages. 

  1. Add or edit a message format. See Message Formats (Classic Operations App).

  2. On the General tab set the Message Type to "Driver".

  3. Set the Return Email Name to "[OrderID]" with no quotes.

  4. Set the Return Email Address to the email address that you set up in the Mail Manager above.

  5. Set the Message Subsystem to "Two-way Text Messaging".

  6. Set the TCP Protocol to "0-SMTP". 

  7. Go to the Format tab to set up the message format. When setting up messages for email-to-text note that some carriers auto-truncate text messages.

    Example

    You can customize your message format and use Available Fields on the left to generate order information.

     

  8. Click OK

Back to top.

Setting Up the Driver Record

The driver record must be set up.

  1. Add or edit a driver record. See Drivers (Classic Operations App).

    1. Set the Secondary Format to the message format you added or edited above

    2. Set the Secondary Email to the email-to-text address the driver's cell carrier uses.

Quick Tip

Major Mobile Carrier Email Domains:

Make sure when you want to go back to using Nextstop you switch back to the Primary Email otherwise Nextstop will not function.

Back to top.