Master Air Waybill (MAWB) Document
This document explains the business logic and fields on the Master Air Waybill (MAWB) in our freight system. Use it to understand how data is captured, displayed, and printed on the MAWB.
https://drive.google.com/file/d/1sWfUTweTZr9EBa9w3PPUPi-2XJdpMipB/view?usp=sharing
1. Basic Shipment Details
Field | Description |
|---|---|
Job No | Internal shipment number (e.g. AE2311003) used for tracking. |
AWB No | Master Air Waybill number (e.g. MAW9887878). Includes airline prefix and document number. |
IATA Airline Code | The first 3 digits of the AWB No. identifying the airline. |
AWB Serial | The trailing digits of the AWB No. (e.g. last 7 digits). |
Airline Name & Code | Carrier’s name and internal code or vessel code if transported via vessel. |
Date of Issue | The date the job was created or printed. |
2. Parties Involved
Shipper
Field | Description |
|---|---|
Name | Shipper company’s print name. |
Address | Shipper’s full address. |
Account No. | Shipper’s account number with the carrier or forwarder. |
Attn | Name of the primary contact (only printed if flagged as a representative). |
Tel / Fax | Shipper’s contact phone and fax numbers. |
Consignee
For Direct Master shipments, consignee data comes from the partnerConsignee.
For Non-Direct Master, data comes from the partnerOverseasAgent.
Field | Description |
|---|---|
Name | Consignee’s company name. |
Address | Full consignee address. |
Account No. | Consignee’s account number if available. |
Attn | Primary contact person. |
Tel / Fax | Consignee’s contact numbers. |
Issuing Carrier’s Agent
Field | Description |
|---|---|
Name | Name of the carrier’s agent issuing the AWB. |
Address | Agent’s address. |
IATA Code | Agent’s IATA code if available. |
Account No. | Agent’s account number if any. |
3. Routing and Movement
Airports and Ports
Field | Description |
|---|---|
Departure Airport Code | Airport code from the loading port. For codes longer than 3 letters, the last 3 letters are used (e.g. EGTRC → TRC). |
Departure Airport Name | Name of the departure airport. |
Destination Airport Name | Discharge port name from the main carriage. |
Routing Legs
Routing can include:
Pre-Carriage
Main Carriage
Post-Carriage
Additional Routing (Pickup / Delivery legs)
Transit routing is derived from blMainRoutingTransits:
Field | Description |
|---|---|
To | Next airport or final destination. |
By | Flight number or vessel/carrier for that leg. |
Flight No/Date | E.g. 468456246 / 13 Nov. Date is formatted from the ISO date. |
Example Routing:
pgsql
CopyEdit
To By
------ -----------------
TRC 232846767 / 13 Nov
AAH 468456246 / 15 Nov
ABA 23553624 / 17 Nov
4. Charges and Payment
Charge Indicators
Field | Description |
|---|---|
CHGS Code | Indicates how freight is paid:• PP = Prepaid• CL = Collect |
Weight Prepaid/Collect | “X” in the respective box indicating who pays the weight charges. |
Other Prepaid/Collect | Same as above for other charges. |
Declared Values
Field | Description |
|---|---|
Declared Value for Carriage | Printed value for carriage liability. Often shown as “NVD” (No Value Declared). |
Declared Value for Customs | Value declared for customs clearance. Often shown as “NCV” (No Customs Value). |
5. Weight and Cargo
Field | Description |
|---|---|
Gross Weight | The total gross weight of the shipment. |
Weight Unit | Either K for kg or L for lb. |
Volumetric Weight | The dimensional weight converted to kg/lb for billing. |
Chargeable Weight | The weight used for billing. Higher of gross weight or volume weight. |
Cargo Class | Commodity or rate class (e.g. “Q” for Quantitative). |
Number of Pieces | Number of packages (e.g. cartons, barrels). |
Dimensions | Up to 3 cargo items printed as e.g. DIMS WxHxL UOM. |
HS Codes | Prints first 3 HS codes if present. |
6. Pricing
Field | Description |
|---|---|
Buying Rate Amount | The rate you pay to the carrier (e.g. Rp 12,000). |
Buying Total Amount | Buying rate multiplied by the chargeable weight. |
Selling Rate Amount | The rate charged to the customer. |
Selling Total Amount | Selling rate multiplied by chargeable weight. |
Individual Charges
Charges are from the shipmentCargoCharges array.
Field | Description |
|---|---|
Partner Charge | E.g. “Carrier”, “Agent.” |
Charge Type | Prepaid or Collect. |
Charge Description | E.g. “AIR FREIGHT CHARGE.” |
Charge Amount | Amount for that charge. |
Example Charges:
sql
CopyEdit
Carrier - Collect - AIR FREIGHT CHARGE - Rp 1,200
Carrier - Prepaid - ADMIN FEES - Rp 3,300
7. Insurance & Additional Info
Field | Description |
|---|---|
Insurance Amount | If insurance is declared, printed in currency (e.g. Rp 3,500). Otherwise “N.I.L.” |
Handling Information | Special handling instructions. |
SCI | Special Cargo Indicators (e.g. DGR, PER). |
Remarks | Any free-text remarks. |
8. Additional Routing Legs
Extra routing legs (e.g. trucking) are stored under shipmentBLAddRoutings for:
Pickup
Delivery
Printed if configured in the templates.
9. Totals
Printed for summary billing:
Field | Description |
|---|---|
Weight Charge Prepaid/Collect | Weight charges under prepaid or collect. |
Valuation Charge Prepaid/Collect | Charges related to declared value. |
Tax Prepaid/Collect | Applicable taxes. |
Due Agent/Carrier Prepaid/Collect | Amounts due to agents or carriers. |
Total Prepaid/Collect | Sum of all charges under each payment method. |
Calculation:
markdown
CopyEdit
Total = (Weight Charge × Chargeable Weight)
+ (Valuation Charge × Chargeable Weight)
+ (Tax × Chargeable Weight)
+ (Due Agent × Chargeable Weight)
+ (Due Carrier × Chargeable Weight)
10. Business Rules and Special Notes
Direct vs Non-Direct Master
Direct Master: prints data from partnerConsignee.
Non-Direct Master: prints data from partnerOverseasAgent.
Port Code Trimming
Codes longer than 3 letters print last 3 letters only (e.g. EGTRC → TRC).
Currency Formatting
Currency printed with commas as thousands separators, periods as decimals (e.g. 3,500.00).
Cargo Class Values
M = Minimum
N = Normal
Q = Quantitative
C = Commodity
Contacts Printed Only if Representative
Contact persons print only if flagged as “representative.”
Documentation owner: Fr8Labs Customer Success. Formatting reviewed: 21 September 2026; product behaviour not reverified in this formatting pass.