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:
- Set the Scope charge type to which the codes should be mapped.
- Assign one of the CargoAi codes as the external ID.
- Uncheck the outbound option.
- 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).