V1_2__05.02.2025

How do I activate and set up Air Freight Booking Portal in Scope?

After you have contacted our sales team, the general activation is done by Riege Service Team while user permissions and EDI mapping can also be configured by you.

For the usage of the feature in Scope we have provided another knowledge base article: How do I use Air Freight Booking Portal in Scope?

Order this feature

This feature is subject to a charge. Please contact sales@riege.com for an inquiry.

Activation

To use this feature, module activation is required. Activation is performed on the partner level and access to the functionality is controlled through user permissions.

User Permissions

User permissions can be added by your Scope Administrator or by the Riege Service Team.

1. Assign Roles to the Partner

For each participating branch, the Air Freight Booking Portal User profile must be created in the partner. To enable this, users require the following permission:

  • Partner: Edit Role Air Freight Booking Portal User

2. View Roles on the Partner

Users who need to view roles require the following permission:

  • Partner: View Role Air Freight Booking Portal User

3. Use the Functionality

Additional authorization is required for using the feature. Since searching for rate offers incurs costs, the search and booking functionalities can only be activated for users with the following permissions:

  • Air: Export Editor Actions Extras Air Freight Booking Portal Requests
  • Air: Export Shipments Editor Actions Extras Airline Booking

Create and Request a new Air Freight Booking Portal User (CargoAi User)

The Air Freight Booking Portal User profile must be created in the branch-partner. This can be done by the user with the permission: Partner: Edit Role Air Freight Booking Portal User. 

Partner > Roles > Air Freight Booking Portal User


Email Address Requirements for Branches

For branches assigned different IATA/CASS numbers, unique email addresses must be specified for each branch. Creating a new branch generates a one-time setup fee.
Please contact sales@riege.com for more information.

  • Ensure the email address used is unique and not linked to any existing CargoAi account.
  • If the same IATA/CASS number is used across multiple branches, the same CargoAi account (identified by the email address) should also be used in those branches.

Important Note:
CargoAi validates account registrations and may use the provided email address for clarification purposes. Therefore, it is essential that the email address is valid functional, and monitored.

Once all the required data has been entered, click Register in the Airfreight Booking Portal. Then, follow the link provided to complete the setup in the CargoAi portal.

Create EDI profile

For other charges, CargoAi transmits codes used by individual airlines. These codes do not always align with the known IATA Other Charge Codes. A (potentially incomplete) list of the currently known codes is provided in the appendix and can also be found here: https://riegesoftware.atlassian.net/wiki/download/attachments/652247047/cai_surcharges.ods?api=v2

CargoAi Code

Original CargoAi Name (description)

FSC

fuel_surcharge

SSC

security_surcharge

MYC

fuel_surcharge/data transfer_surcharge

XBC

security_surcharge/xray_surcharge

ISC

surface_surcharge/security_surcharge

IRC

security_surcharge

MCC

airfreight_surcharge

LAD

locAddon_surcharge

SHS

shc_surcharge

AWC

awb_surcharge

XDC

covid_surcharge

ASC

other_surcharge/airfreight_surcharge

MSC

mine_surcharge/miscellaneous_surcharge

NSC

canada nav_surcharge

SCC

security_surcharge

SPX

screening_surcharge

MPC

weighting_surcharge

CSC

customs_surcharge

ACS

airfreight_surcharge

AFC

airfreight_surcharge

AFS

airfreight_surcharge

CGC

electronic_surcharge

CHC

handling_surcharge

FEC

handling_surcharge

FEE

other_surcharge

HLC

handling_surcharge

MRC

airfreight_surcharge

PSC

peak season_surcharge

RAC

dangerous goods_surcharge

SCF

screening_surcharge

SUC

surface_surcharge

WAR

war_surcharge

WHC

warehouse_surcharge

XXC

various_surcharge

XXX

over pivot_surcharge

 

Codes for other charges can be mapped to Scope's internal cost types using an EDI profile of the type 'Cargo AI'. This profile should be created by the administrator and populated with the relevant cost type codes.

The EDI profile for the booking portal only requires incoming mappings, not outgoing mappings.

Mapping Multiple CargoAi Codes to a Single Scope Charge Type

To map multiple CargoAi codes to a single Scope charge type, follow these steps:

  1. Set the Scope charge type to which the codes should be mapped.
  2. Assign one of the CargoAi codes as the external ID.
  3. Uncheck the outbound option.
  4. Add the other CargoAi codes as additional IDs, listing one code per line.


If previously unknown codes are encountered during a booking, they are saved in the EDI profile as 'missing mappings'. These codes are then replaced, whenever possible, with the additional cost item 'Miscellaneous' based on the cost element profile AWB Other Charges (IATA Other Charges Code).