Welcome to the JAS Connect Forwarding Booking Status API. This service provides a direct, real-time connection to our Transportation Management System (TMS) to retrieve the latest status and tracking updates for your forwarding bookings.

By integrating this API, your internal systems (such as an ERP, customer service portal, or visibility dashboard) can automatically query and display the status and milestones of any forwarding booking, providing up-to-the-minute visibility for your team and customers.

Key Capabilities & Features

Our Booking Status API is a REST-based service designed for flexibility, security, and accuracy.

• Real-Time Tracking: Provides live tracking and status updates for forwarding bookings managed within the JAS TMS.
• Flexible Querying: Retrieve booking data using either:
  • JAS Booking Number (e.g., S505185992)
  • House Bill Number (e.g., PAR45176295)
• Choice of Formats: Responses available in application/json or application/xml.
• Secure & Encrypted: OAuth 2.0 authentication and HTTPS ensure secure data transmission.
• Rich Data Response: Returns detailed data including ETD/ETA, milestones, and transport legs.

Getting Started: Authentication & Endpoints

All API requests must be securely authenticated using a two-step process.

Step 1: Generate an Access Token

Before you can request a shipment's status, you must get a bearer token using the OAuth 2.0 client_credentials grant type.

• Method: POST
• Endpoint: https://<<URL_PROVIDED _IN_THE_PORTAL/oauth2/token
• Headers: Content-Type: application/x-www-form-urlencoded

• Body parameters	Values
  grant_type	client_credentials
  client_id	<YOUR_CLIENT_ID>
  client_secret	<YOUR_CLIENT_SECRET>

Step 2: Call the Shipment Status API

Once you have your access token, you can call the Status API. You must include the token to every request/call .

• Method: POST
• Required Headers:

  Required Headers:
  Authorization	Bearer <<ACCESS_TOKEN>>
  Content-Type	application/json or application/xml

• API Endpoints:
  • Test: https://<<TEST_INSTANCE_URL_IN_PORTAL>>
  • Production: https://<<PROD_INSTANCE_URL_IN_PORTAL>>
• Resources:
  • JSON: /v1/Booking/{ShipmentorHouseBillNumber}/statusjson
  • XML: /v1/Bookings/{ShipmentorHouseBillNumber}/statusxml

Understanding the Request

You must include the identifier in the URL path using the {ShipmentorHouseBillNumber} parameter.

• Identifier Logic:
  1. If value starts with ‘S’ followed by 9 digits → treated as a Booking Number.
  2. Otherwise → treated as a House Bill Number.
  3. If a House Bill Number is sent, the system first looks up the corresponding Booking Number.
  4. If no booking is found, a 400 Bad Request is returned.

Understanding the Response

The API returns detailed booking information in JSON or XML depending on your Content-Type header.

• BookingUniqueNumber: The official JAS Booking ID (e.g., S505185992).
• HouseBillNumber: The House Bill number for the booking.
• GoodsDescription: Description of the cargo.
• ServiceLevel: The service code (e.g., STD).
• ETD / ETA: Estimated departure and arrival times.
• Milestones: List of all tracking events.
  • MilestoneCode (e.g., ARV, DEP, PCF)
  • MilestoneDescription (e.g., "Arrival at Final Discharge Port")
  • LocalEstimatedDate / LocalActualDate

  Event Code	Milestone Name	Milestone Description	Current Status Shown at Event Completion
  Add	Shipment Added	Shipment Data has been received/entered into JAS system	Shipment Created
  	Shipment Created
  PCF	Picked Up	Shipment has been picked up, and the Pickup date has been entered into the JAS system.  This is applicable when JAS controls the Pickup.	Pickup Complete
  	Origin Pickup
  	Pick Up Complete (Actual Pick Up Date)
  	Pickup Cartage Complete/Finalised
  IRP	Cargo Received At CFS	Shipment has been dropped at the interim facility before departure.	Received At Interim Facility
  	Cargo Received At CFS (Interim Receipt Date)
  ATC	Booked with Carrier	A booking has been made for the shipment with the carrier, and the details of the transport have been entered into the JAS system.	Booked With Carrier
  	Booked With Carrier
  	Booking Confirmed
  	Attached Shipment to Consol
  	Attached Shipment To Consol
  DEP	Departure From First Load Port	The Shipment has departed first port under JAS control.	Departed
  	Departure from Origin Port/Terminal
  	Departure From Origin Port/Terminal
  ARV	Arrival at Dischard Port	The shipment has Arrived at last port under JAS Control.	Arrived
  	Arrival at Last Discharge Port
  	Arrival at Final Discharge Port
  	Arrival at Destination Port/Terminal
  	Arrival at Destination
  DLV	Delivered	The Shipment has been delivered to the delivery location.  This is applicable when JAS controls the delivery.	Delivered
  	Delivery Cartage Complete/Finalised
  	Delivery Cartage Complete/Finalised (FCL)
  	Delivery(FCL)
  DCF	Delivery
  	Delivery (LCL)
  	Delivery Complete (Actual Delivery Date)

  
  
• Transports: Details of all transport legs.
  • Mode (e.g., Air, Sea)
  • Voyage_Flight or Vessel
  • LoadingPort / DischargePort
  • EstimatedDeparture / EstimatedArrival
• Containers: List of container numbers (if applicable).
• Consols: List of consolidation numbers (if applicable).