Find what you are looking for:
What is the allotment feature?
The allotment feature lets you upload and manage all your block space agreement (BSA) shipments in one place. Upload a single file covering your full allotment, and CargoMART handles routing to every airline automatically.
Every booking takes one of two paths:
API path
For API-connected airlines. Bookings are submitted and confirmed automatically. If the airline's booking window hasn't opened yet, CargoMART holds the request and sends it at the right time. | Manual path
For all other airlines. CargoMART sends a structured booking request to the airline by email and monitors the AWB automatically — updating the status as soon as the airline confirms. |
No shipment is ever unsupported. If an API attempt fails, CargoMART falls back to the manual path automatically.
How to book
1. Download the CargoMART template. On the Allotment page, click Download template. Use this file — do not change the column headers.
2. Fill in your shipments. Each row is one shipment. See Template requirements below for field rules.
3. Upload and review. Click Upload file. CargoMART validates each row — fix any errors flagged before submitting.
4. Submit. Click Request booking for individual rows, or Request all to submit everything at once.
5. Track on the History page. All submitted bookings move to the Allotment History page. Statuses update automatically — no manual follow-up needed.
Booking windows: If a departure date falls outside an airline's booking window (e.g. Air France/KLM: 13 days, Qatar Airways: 28 days), CargoMART will hold the booking and submit it automatically on the correct date. The status will show as Pending booking window. |
Template requirements
Each row represents one shipment. Fields marked Mandatory must be filled for the booking to be accepted.
Field | Format | Required |
Airline | 2–3 letter code (e.g. AF, QR, EK) | Mandatory |
Origin | 3-letter IATA code (e.g. SIN) | Mandatory |
Destination | 3-letter IATA code (e.g. CDG) | Mandatory |
Dep — first leg | DD/MM/YY | Mandatory |
Dep — additional legs | DD/MM/YY | If applicable |
Flight number | Letters + numbers (e.g. AF272) | Recommended |
Commodity | General Cargo or Perishable | Mandatory |
SHC | 3-letter codes, comma-separated (e.g. COL, PER) | Optional |
Pieces | Whole number | Mandatory |
Weight (kg) | Number, up to 4 decimal places | Mandatory |
Volume (m³) | Number, up to 4 decimal places | Mandatory |
AWB prefix | 3-digit number | Mandatory |
AWB number | 8-digit number | Mandatory |
Always include the flight number where possible. Without it, bookings may be created as "Flight TBC", which can delay confirmation. |
Understanding the Booking Statuses
Statuses update automatically on the History page. Here's what each one means and whether any action is needed from you.
Status | What it means |
Booking confirmed | The airline has confirmed the booking. No action needed. |
Pending booking window | Uploaded before the airline's booking window opened. CargoMART will submit automatically — no action needed. |
Queued in airline system | The API request was received, but the airline needs to manually accept it in their system. Common for special cargo products. No action needed from you. |
Fix and retry (Coming soon) | A technical error was returned by the airline (e.g. weight or SHC mismatch).
Please note that any corrections should be made via the Retry feature. Uploading a new file will create duplicate bookings. |
Pending airline creation | A booking request has been sent to the airline. CargoMART is monitoring the AWB and will update the status automatically when the BKD signal is received. |
Booking rejected | The airline rejected the booking. Please contact the airline or reach out to your CargoMART account manager. Action needed — contact airline |
Cancelled | The booking was cancelled. Manual-path bookings with no AWB tracking activity 7 days after departure are cancelled automatically. |
Notifications
Notification | When | Default | Details |
Allotment summary email | 15 min after upload | Always on | Sent to the airline (To:) and you (CC:). Covers all bookings from the upload, with an Excel attachment. |
Weekly status update | Every Monday | Opt out | Summary of all bookings in an attention-needed status. |
Office CC | Each colleague upload | Opt in | Copies you on summary emails sent by others in your office. |
The 15-minute wait before the summary email allows time for API responses to settle and for you to act on any Fix and retry items before the airline is notified.
Notification settings
Go to Personal settings > Notifications to manage your preferences for the weekly update and office CC toggle.
FAQs
My airline isn't API-connected. Will it still work?
Yes. CargoMART sends a structured booking request to the airline by email and monitors the AWB automatically. The status will show as Pending airline creation until confirmed.
I uploaded a booking far in advance and nothing happened.
If the departure date is outside the airline's booking window, the booking will sit at Pending booking window. CargoMART will submit it automatically when the window opens — no action needed.
A booking has been at "Pending airline creation" for a while. Is that normal?
It depends on the airline's processing time. CargoMART is monitoring the AWB and will update the status as soon as the BKD signal is received. If you're concerned, contact the airline directly. Note that if there's no tracking activity within 7 days after the planned departure date, the booking will be automatically cancelled.
Can I see allotment bookings uploaded by my colleagues?
You can opt in to receive copies of summary emails from your office. Go to Personal settings > Notifications and enable the office CC toggle.
My file upload failed validation. What should I check?
Common causes:
• Incorrect Allotment Code
• Date format not DD/MM/YY
• AWB number not exactly 8 digits
• AWB prefix not exactly 3 digits
• Commodity not entered as "General Cargo" or "Perishable"
• SHC codes not using the 3-letter format
Review the flagged rows and correct before resubmitting.
Still need help?
Reach out to your CargoMART account manager or contact support via the chat in the bottom right corner of the platform.