Booking Enums & Constants¶

Reference Booking

This page documents all enumerated values and constants used across the AAJ booking system. Use these values when creating or updating bookings to ensure valid data is passed to the API.

Shipment Rates¶

Defines the pricing tier applied to a shipment.

Code	Description
`SR`	Standard Rate
`CR`	Corporate Rate

Package Insurance Classes¶

Insurance coverage options for packages.

Code	Label	Description
`FR`	Free	No insurance coverage
`SD`	Standard	Basic coverage for general items
`PM`	Premium	Enhanced coverage with higher limits
`EI`	Electronic Insurance	Specialized coverage for electronics
`NE`	Non-Electronic Insurance	Coverage for non-electronic goods
`HI`	Haulage Insurance	Coverage for haulage/freight shipments

Third-Party Logistics (TPL) Services¶

Supported external carrier integrations.

Code	Carrier Name
`UPS`	United Parcel Service
`DHL`	DHL (Dalsey, Hillblom and Lynn)
`FIP`	FedEx International Priority
`FIE`	FedEx International Economy
`RSE`	Red Star Express
`AMX`	Aramex

Carriers¶

All supported carriers (internal and external).

Code	Carrier Name
`AAJ`	AAJ Express (Internal)
`UPS`	United Parcel Service
`DHL`	DHL
`FDX`	FedEx
`RDS`	Red Star Express
`AMX`	Aramex

Order State Options¶

Lifecycle states for orders.

Code	Label	Description
`1`	DUE	Order is due/awaiting action
`2`	ACTIVE	Order is currently active
`3`	FULFILLED	Order has been fulfilled
`4`	VOID	Order has been voided/cancelled
`5`	INCOMPLETE	Order is incomplete
`6`	REPROCESSED	Order has been reprocessed
`7`	PROCESSING	Order is currently being processed
`8`	PROCESSED	Order processing is complete

Booking State Options¶

Lifecycle states for bookings.

Code	Label	Description
`1`	DUE	Booking is due/pending
`2`	BOOKING	Booking is in progress
`3`	BOOKED	Booking has been confirmed

Customer Acceptance States¶

States for customer acceptance workflow (e.g., delivery confirmation).

Code	Label	Description
`0`	UNREVIEWED	Not yet reviewed by customer
`1`	PENDING	Awaiting customer decision
`2`	ACCEPTED	Customer accepted the delivery
`3`	REJECTED	Customer rejected the delivery
`4`	CANCELLED	Delivery was cancelled
`5`	CANCELLED_PICKUP	Cancelled – customer will pickup from hub
`6`	CANCELLED_RETURN	Cancelled – rider will return package

Delivery Types¶

How the package should be delivered.

Value	Description
`DROP_OFF`	Package dropped off at destination
`SIGNATURE_REQUIRED`	Recipient signature required upon delivery

Delivery Modes¶

Delivery destination type.

Value	Description
`DOOR_STEP`	Deliver to recipient's door
`PICKUP`	Recipient picks up from designated point

Collection Modes¶

How the package is collected from the sender.

Value	Description
`PICKUP`	AAJ picks up from sender's location
`DROPOFF`	Sender drops off at an AAJ hub

Pickup Details (when `collectionType` is `PICKUP`)¶

{
  "collectionType": "PICKUP",
  "pickupDetails": {
    "pickupDate": "2025-12-05",
    "pickupTimeRange": {
      "from": "10:00",
      "to": "14:00"
    }
  }
}

Booking Types¶

Type of shipment booking.

Code	Description
`LC`	Local/Domestic shipment within Nigeria
`IN`	International shipment

Service Types¶

Service category for the shipment.

Value	Description
`AIR_EXPORT`	International air export
`SEA_EXPORT`	International sea/ocean export
`AIR_IMPORT`	International air import
`DOMESTIC`	Domestic shipment within country

Note: Always use the exact codes/values shown above when integrating with the AAJ API. Using invalid values will result in validation errors.