Notifications Mapping

Contents

IntroductionInvalid Mapping ImpactsHow to create or change a mapping

The mappings link the event codes used by carriers (carrier_code) with Mercado Libre's standardized internal codes (code). They are essential for validating, standardizing, and correctly processing received tracking notifications, ensuring that the shipment status is updated.

Definitions

  • carrier_code: event code as sent by the carrier.
  • code: standardized notification code of Mercado Libre.
Note:
  • A notification may be related to several event codes from a carrier, just as a carrier event code may be related to more than one MELI notification, according to the rules and events that may be reported by the carrier (e.g., variations by flow, delivery problems, incidents, etc.).

Invalid Mappings Impact

If a notification is received with incorrect mapping, the corresponding event will be ignored and the delivery status will not be updated. It is necessary to communicate code changes in advance to avoid discarding important notifications and to ensure there are no inconsistencies in the package lifecycle.

How to create or change a mapping

The Tracking Core team is responsible for managing and maintaining the internal mapping database and ensuring that received updates are consistent with the actual movement of the package.

To create, adjust, or disregard a mapping, send an email to: shipping_tracking_it@mercadolivre.com following these guidelines:

Subject: [MercadoLibre][carrier-name] Mapping Adjustment/Creation

In the body of the email, be sure to include:

  • Carrier name and country;
  • Carrier event code and corresponding MELI update code;
  • Justification for the mapping change or creation;
  • Expected start date for sending updates after the adjustment.