What is the current status of my reference?

Here you will find definitions for each possible last update status message received when using the Get Reference Info endpoint.

You may check on the update status of a shipment by using the Get Reference Info endpoint.

The different messages you can expect to receive when checking the last status update are defined in the table below.

Message Definition What happens next
Data Received Data received and payload generated. Payload available at GET Reference Update endpoint. Payload sent to webhook successfully if using webhook.  Vizion will check for new or updated data for your shipment in 12 hours.
No Data No data is available from the carrier. Tracking could be too early or too late, or the identifier could be incorrect. Vizion will check for new or updated data for your shipment in 12 hours.
Carrier Not Responding Vizion is unable to get a response from the carrier. Connection is either degraded or down. Vizion will check for new or updated data for your shipment in 12 hours.
Extraction failed An error has occurred during processing for this attempt and Vizion did not receive any data. Errors can be both carrier side or Vizion side if any of our services are down. Vizion will check for new or updated data for your shipment in 12 hours.
Webhook failed Vizion received data, built a payload but received an error response from the customer application URL. Vizion will check for new or updated data for your shipment in 12 hours and attempt to send you a payload regardless of new or updated data.
Duplicate payload Vizion received data but there is no update to the shipment. Vizion did not generate a new payload as there was no new or updated data for your shipment. Vizion will check for new or updated data for your shipment in 12 hours.
Auto Carrier Not Found No supported carrier returned data for your shipment when using the auto carrier identification feature. Vizion will mark your reference as inactive. We will not continue to try and find the appropriate carrier.
Auto Carrier Failed An error occurred while identifying the carrier for your shipment. Vizion will mark your reference as inactive. We will not continue to try and find the appropriate carrier.

 

When using Get Reference Info you will receive the response below. The last_update_status (in bold) will provide the most recent status for your shipment information.

{

"id": "77ca0b50-f2bd-4b5c-9270-72245b6b899f",

"container_id": "TCLU1791408",

"bill_of_lading": "ONEYSINA68242400",

"carrier_scac": "ONEY",

"callback_url": "https://webhook.site/39d4933d-b0bd-4c49-92ba-621ea282773e",

"organization_id": "29c0635d-efb1-4871-b173-b3022a13d1c1",

"parent_reference_id": "4957db10-203c-4607-aff9-13e40d023972",

"active": true,

"last_update_status": "data_received",

"created_at": "2020-12-16T14:54:44.359Z",

"updated_at": "2020-12-23T16:21:02.807Z",

"last_update_attempted_at": "2020-12-23T16:21:02.764Z",

"retry_count": 14,

"organization": {

"id": "29c06a5d-efb1-4871-b173-b3022113d1c1",

"name": "Vizion",

"active": true,

"created_at": "2020-01-17T01:35:25.139Z",

"updated_at": "2020-01-17T01:35:25.139Z"

}

}