Extended Air Visibility
project44's Extended Air Visibility converges data from multiple sources to give you visibility into tracking milestones for pre- and post-carriage shipments.
Overview of Workflow
The workflows to create, get updates, update, and delete air shipments with extended visibility are similar to the workflows for Air Visibility. This documentation provides information on how to use the create a shipment and get milestone updates specifically for Door to Door shipments.
Create a Shipment with the necessary identifier information to add the shipment to the project44 system and discover other identifiers including Master Air Waybill (MAWB).
View Extended Visibility Events by making a GET request to the Get Event History endpoint or by inspecting the Get Full Tracking History response. If you have created a webhook, you will receive push tracking notifications for extended visibility events.
Create a Shipment
Create a shipment to be tracked in project44's network. This step is necessary to receive extended visibility milestone updates. The response to the request to create a shipment will include identifiers for the shipment.
Requirements
- Freight Forwarder SCAC (
CARRIER_SCAC
) - House Air Waybill (
HOUSE_AIR_WAYBILL
) - Do not provide more than one
HOUSE_AIR_WAYBILL
in the request for creating air shipment. - Any event older than 30 days from the shipment creation date will not be tracked.
Workflow
- Prepare a
POST
request to /api/v4/shipments/tracking. - Add the HAWB and FFW SCAC. For example
{ "identifiers": [ { "type": "HOUSE_AIR_WAYBILL", "value": "string" }, { "type": "CARRIER_SCAC", "value": "string" } ] }
- Send the request.
You have successfully submitted the response when you receive a 200 OK
response.
Expected System Response
Here is an sample of the minimum response schema:
{ "id": "string", "createdDateTime": "string", "identifiers": [ { "type": "HOUSE_AIR_WAYBILL", "value": "string" }, { "type": "CARRIER_SCAC", "value": "string" } ], "shipmentShareLink": "string", "lastModifiedDateTime": "string" }
id
). Fields and Objects
Element | Description | Type | Notes |
---|---|---|---|
id | The shipment's unique Master Shipment ID generated by project44. | string | Store the Master Shipment ID to get tracking updates or delete a shipment. |
identifiers | A list of identifying information for the shipment. | array of identifiers | This is different from the Master Shipment ID (id ). |
identifiers.type | The identifier type. | string | The only valid values for Extended Air Visibility are HOUSE_AIR_WAYBILL , and CARRIER_SCAC . |
identifiers.value | The value of the shipment identifier. | string |
Get Shipment Updates for Extended Visibility Events
Follow the Get Event History or Get Full Tracking History workflows to return extended air visibility events.
Requirements
- Shipment ID (The
id
returned in the Create a Shipment response.)
Workflow
PULL Request Workflow
Use the endpoint in either the Get Event History workflow or the Get Full Tracking History workflow.
Send the request.
Expected System Response
View the full sample responses for either the Get Event History endpoint or the Get Full Tracking History endpoint in Get Tracking Updates page.