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
Please contact sales@riege.com for an inquiry.
Required user permissions
User permissions can be added by your Scope Administrator or by the Riege Service Team.
1. To edit the "Air Freight Booking Portal User" role on the branch-partner
For each participating branch, the Air Freight Booking Portal User role must be created in the branch-partner. To add and edit this role, users require the following user permission:
Partner: Edit Role Air Freight Booking Portal User
2. To view the "Air Freight Booking Portal User" role on the branch-partner
Users who need to view this role require the following permission:
Partner: View Role Air Freight Booking Portal User3. To use the "Air Freight Booking Portal" 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 RequestsAir: Export Shipments Editor Actions Extras Airline Booking
Activation of the functionality
To use this feature, module activation is required. Activation is performed on the branch-partner level and access to the functionality is controlled through user permissions as described above.
1. Create and request a new "Air Freight Booking Portal User"
The Air Freight Booking Portal User role must be created in the branch-partner.
This can be done by the user with the permission as described above.
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.
Above fields are mandatory as per CargoAi for the registration. While nearly all fields are self-explanatory, the fields 'Country' and 'Nearest UN/Locode' refer to the country and code of the 'office airport code or closest airport' (as per official CargoAi documentation).
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.
2. 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.
3. 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).