Skip to main content

Reason codes

What are reason codes, how to create them and where to apply them?

Gert Nuyts avatar
Written by Gert Nuyts
Updated over 10 months ago

What are reason codes?

Reason codes can be used to force users to provide an explanation in case of certain events, such as Order Cancellation or Schedule Revision.

Control Tower comes with the predefined 28 most common Reason Codes, however additional codes can be added via the Reasons Masterdata.

Creating a custom reason code

You can easily create your own, custom Reason Codes. Here is how:

This action will open the Reasons Masterdata where you can see the overview of all the already existing Reason codes.

In the first section you can name your Reason Code as well as select which Division, Customers or Suppliers will be able to use it.


In this section you define the availability of the Reason Code, meaning on which platforms will your users be able to select them.


You can select for which events throughout the platform should the Reason be available. Only checkbox is selected for a given Reason Code will it appear in the dropdown when the user wants to apply that Reason Code.


These fields define whether this Reason Code can be uploaded via external integrations from either the Customer or any other Third Party


Saving the Reason Code will add it to the Reasons Masterdata, from where it can be Edited at any time.

Applying Reason Codes

Reason Codes can be applied in many events across the platform depending on which Availability you picked for it. Providing a RC can be required for example from a driver who arrived late at a destination. In that case the App will require a Reason Code from the driver.

Regardless of how the Reason Code was inserted, the reason, and an optional comment, will be shown in the Events history.

Reason Codes - Translations

Creating Reason Codes' Translations is a very straightforward process. You can access the table by selecting Admin > Masterdata > Reason - Translations. To create a new translation, you simply have to select the Division and the Reason you want to translate. Then select the Language you want to translate it to and Type in your translation.

As Control Tower is offered exclusively in English, these translations will only be applied according to the user's language on the Mobile App, Customer Portal and Carrier Portal.

Did this answer your question?