Tracking Notifications

Contents

When a shipment’s status changes, the carrier must inform Mercado Libre of this transition by sending a corresponding event notification. There are two ways to report the event recorded for a shipment:

• PUSH: The carrier sends the corresponding event notification to our tracking endpoint.
• PULL: The carrier exposes all notifications already recorded for the shipment via API.

In all cases, the objective is to ensure alignment with the carrier on the shipment’s current status and the events already recorded.

The notifications must reflect the actual transportation sequence and arrive in chronological order. Mercado Libre uses notification codes (code) associated with carrier event codes (carrier_code) to receive and validate each event.

It is critical to respect the notification flow and the order in which events occur, because some status codes are considered final. Once a notification for a final state is received, any subsequent events after that status will be disregarded.

Notification Payload

Notification Fields

The fields that can be included in the notification payload are:

Payload Example

{
  "tracking_number":string,
  "code":string,
  "carrier_code":string,
  "payload":{
    "date":string (ISO8601),
    "reason":string,
    "comment":string,
    "flight":{
      "awb":string
    },
    "declaration_number":string,
    "agency_id":string,
    "agency":{
      "phone_number":string
    },
    "cost":number,
    "location":{
      "zip_code":string,
      "country_id":string,
      "state_name":string,
      "city_name":string,
      "neighborhood_name":string,
      "facility":string,
      "geolocation":{
        "geolocation_type":string,
        "latitude":number,
        "longitude":number
      }
    },
    "dimensions":{
      "height":number,
      "width":number,
      "length":number,
      "weight":number
    },
    "redispatch":{
      "tracking_number":string,
      "carrier_id":number,
      "tracking_url":string
    },
    "estimated_delivery_date":string (ISO8601),
    "estimated_pickup_date":string (ISO8601),
    "proof_of_delivery":{
      "receiver_document":{
        "type":string,
        "number":string
      },
      "receiver_last_name":string,
      "receiver_name":string,
      "receiver_relationship":string,
      "image":string
    },
    "driver":{
      "id":string,
      "name":string,
      "email":string,
      "phone":string,
      "license_plate":string
    },
    "vehicle":{
      "reference_type":string,
      "reference":string
    },
    "consolidated_packages":{
      "consolidation_id":string,
      "tracking_number":string,
      "shipments":array
    },
    "details":{
      "transport":{
        "content":{
          "restricted_item_type":string
        }
      }
    }
  }
}