Create reference via Auto Carrier Identification

Create Reference via ACI is designed for scenarios where you have very limited shipment details, such as when you only have a container number or bill of lading and no carrier information. It leverages Automatic Carrier Identification (ACI) to attempt to find the correct steamship line and begin tracking updates.

• If a carrier is found: The reference will be updated with the carrier code (carrier_code) and tracking will begin.
• If a carrier is not found: The reference's last_update_status will be set to auto_carrier_not_found, indicating that ACI could not find a matching carrier.

This option should be used as a last resort when the carrier code is unknown. Using it may result in a large number of tracking failures and we ultimately recommend that you provide the carrier code whenever possible.

Expected behavior for ACI using bill of lading or booking number

If the request body includes a bill of lading or booking number without a container_id value, the system will identify all containers associated with the provided bill of lading or booking number. It will then create a reference for each container found. Each container reference will have the parent_reference_id set to the reference ID of the parent bill of lading or booking number reference.

📘

See Create reference via ACI API reference documentation

//Example request body
{
  "container_id": "MRKU0090522",
  "callback_url": "https://yourdomain.com/webhook"
}

⚠️

Please note that if you create a reference using Auto Carrier Identification and we cannot match the container to a carrier with a auto_carrier_not_found status returned, it will be considered a billable reference as we have already processed the container and searched each carrier.