Quote & Book API
Rate queries booking via API AWB handling and error codes
31 articles
4 Best practices to implement CargoAi's Quote & Book API
The Search Rates and Flights/POST endpoint replicates CargoAi marketplace search results and retrieves airline flights and routes, including…
Common Scenarios and Explanations for Quote & Book API
"Null" Response in "Charges," "OCDC," and "Handling Codes" Fields When the Schedule & Rate API response displays "null" under the "charges,"…
For the shipment volume field, should we provide the volumetric volume or the volume in cubic meters?
All volumes are in cubic meter. The volume in Shipment is the total volume of the shipment. The volume in dimension is the piece group volum…
GetAWBFailed, CheckAWBFailed & AgentStockFailed Errors
Are you getting the error message "GetAWBFailed", "CheckAWBFailed" or "AgentStockFailed" trying to perform a booking? All these errors are r…
How does the async flow work in CargoAi Schedules & Rate API?
Whether you use basic or advanced mode, the async flow will be triggered. To make use of it, you will find an id in your Search response: On…
How to calculate the net rate, total amount & display only totals of a shipment?
In traditional airfreight nomenclature: netRate is the rate per kilo without any surcharge (e.g. fuel and security surcharges). allInRate is…
How to ensure the offer received by API is ebookable?
Q: Which information does the available field in the flight object provide? A: This field is here to let you know if your option (flight + r…
I already made a booking, but I chose incorrectly. How can I inform the airline that I want to cancel it?
You can cancel all bookings via the API, there is a dedicated endpoint for that in our Quote & Book API.
I am getting an error informing me that my AWB number is wrong or not in my stock, but the AWB was provided by the airline itself. How can I fix this?
Unfortunately, these errors are only returned if the Airline API reject your booking with similar error. The best is to check with the airli…
I am trying to figure out if a rate comes from a co-loader. Is that possible?
Q: I am trying to figure out if a rate comes from a co-loader. Is that possible? A: At this time, there is no way to identify whether a disp…
I can see that over 100 airlines are available in the Quote & Book API, however I am not receiving results from over 100 airlines when I perform a search via the API. Why is that?
Please be aware that the list indicates all airlines which we are connected with, however all of them may either not be flying to your reque…
I have a direct API connection and I want to have access to FlyWindow, how does it work?
To have access to FlyWindow, you can use the User Provisioning API to set up users and allow them get this external link. Documentation abou…
I have a direct API integration for rates and I want to have access to FlyWindow. How do I get started?
Q: I have a direct API integration for rates and I want to have access to FlyWindow. How do I get started? A: You can get started by using t…
I made a booking via the Quote & Book API. Can I retrieve and manage it from CargoMART?
Whilst you can now retrieve CargoMART bookings in your TMS via our CargoBRIDGE function, the other way around is not yet possible. In other…
I performed a search via the Quote & Book API, but the rate returned via API is different from the rate returned on the CargoMART portal. Is this an issue?
If the search parameters are identical, you should be receiving the exact same results on CargoMART and CargoCONNECT. Please check your Char…
I put the airline prefix in the AWB field of my booking request, why was my booking rejected?
Please make sure the flight option you chose is eligible for Auto AWB, the feature that fetches an AWB from the airline stock when the AWB i…
I uploaded market rate sheets for a specific route, but no rates are showing. What’s missing?
In order to display rates from market rate sheets, we need to have both the rate sheet and the corresponding route schedule . If the route s…
I want to avoid seeing co-loader rates in search results. How can I do that?
To exclude co-loader rates, make sure to provide your IATA CASS number and ensure that the origin airport country matches the user office co…
I'm testing the Quote & Book API, can I obtain rates when submitting only the accurate chargeable weight, and not necessarily all dimensions or random dimensions? Does it affect the API behavior?
Q: I'm testing the Quote & Book API, can I obtain rates when submitting only the accurate chargeable weight, and not necessarily all dimensi…
I'm testing the Quote & Book API, can I obtain rates when submitting only the accurate chargeable weight, and not necessarily all dimensions or random dimensions? Does it affect the API behavior?
Only the number of Pieces, Weight and Volume are mandatory and cannot be random, as they will be used to re-calculate the Chargeable Weight.…
I’m trying to figure out if a rate comes from a co-loader. Is that possible?
At this time, there is no way to identify whether a displayed rate is coming from a co-loader or directly from the airline. All rates appear…
Master list of airline charges & their charge basis
We are always here to support your internal mapping process in the best possible way. However, a master list with all airline charges and th…
The Quote & Book API is returning rates for oversized shipment without any remarks. Can you please confirm that the rates can be used for my oversize cargo?
The offered rates mainly depend on the type of rate you are receiving for your shipment. If you receive live rates (type "live"), this means…
What are the different values for loadType and what do they mean ?
LoadType can accept bellow values for the moment: DIMENSIONS → to indicate that your shipment is coming with dimensions information TOTAL →…
What are the different values for weightType and what do they mean?
WeightType can accept bellow values for the moment: PER_ITEM → to indicate that your piece group weight is for one piece TOTAL → to indicate…
What does "AWBOptional" field in "features" of the flight object mean?
It means you can book the returned flight option without providing an AWB number.
What is the difference between Shipment and Piece for dimensions, weight and volume?
‘Pieces’, ‘weight’ and volume under shipment are the total values for the shipment. Under Piece they are the values for a piece group. For e…
What is the meaning of each SHC (Special Handling Code)?
SHCs (Special Handling Codes) are standardized for the industry and can be found here: SHC meanings .
What rate types are available in the CargoCONNECT Rates API?
Q: What rate types are available in the CargoCONNECT Rates API? A: Here are the different rate types you can get: Promo Rates Contract rates…
What's the difference between eBookable airlines and eBookable origins?
eBookable Airlines is the list of airlines which we are connected to for online bookings. For example we have as eBookable airlines TK (Turk…
Why can the airline change the chargeable weight returned in a rate query?
Q: Why can the airline change the chargeable weight returned in a rate query? A: The recalculation of chargeable weight is not limited to no…