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.