Integration Guide
You accessed this documentation through the integration guide. Click "Back" to track your progress.

Logistics Center to Logistics Center

Introduction

This is an internal MELI transfer leg. The package is already inside MELI's logistics network and needs to be moved from one distribution center to another — typically because the destination region is served by a different hub.

The carrier picks up the package at a MELI facility and delivers it to another MELI facility. There is no seller or buyer involved in this movement.

What the carrier needs to know:

  • Both origin and destination are MELI-operated logistics centers.
  • The carrier is acting as a linehaul operator between MELI's own infrastructure.
  • This leg is often part of a longer shipment journey — the package will continue its route after arriving at the destination center.

The shipment notifications must be sent to this endpoint:

bash
1POST 'https://api.mercadolibre.com/shipments/{shipmentId}/notifications' 2--header 'Authorization: Bearer {accessToken}'

Notifications

Code
Description
Comments
0204Package picked up at Mercado Libre logistics centerFirst event code to be sent by the carrier when the package is picked up at a Mercado Libre logistics center.
0271Entry into carrier logistics centerThe package has arrived and been checked into a carrier logistics center for processing.
0273Exit from carrier logistics centerThe package has departed from the carrier logistics center heading to the next destination in the route.
0211In transitThe package is in transit between logistics centers or on route to its destination.
0401DeliveredThe package was successfully delivered to the destination MELI logistics center. Releases money to the seller.

Pick Up Problems

Reported when the carrier identifies an impediment upon arriving to collect the package. Not final events; must be communicated within the contractually agreed SLA.

Code
Description
Comments
0212Package not picked upAfter the carrier's check, the package that was supposed to be in its possession is marked as not picked up.
0630Rejected due to damaged packageThe shipment arrived at the carrier's logistics center but was rejected due to defective packaging, breakage, or damage. Must be sent within 24 hours after pickup at Mercado Libre's logistics center. Returns money to the buyer and pays insurance to the seller.
0232Rejected due to excess weight or dimensionsThe shipment arrived at the carrier's logistics center correctly, but due to excess weight or size, it was rejected by the operation.

Transportation Problems

Events that may occur while the package is in transit. Not final events; once resolved, the package resumes its normal flow.

Code
Description
Comments
0209Inaccessible areaThe route or location is inaccessible (e.g. flooded road, blocked access), preventing the carrier from transporting the package via the normal route.
0231Delayed shipmentThe shipment has been delayed and will not arrive within the originally estimated timeframe.
0255Under review due to incidentThe type of incident the shipment had is not yet known. The carrier is investigating before sending a more specific event.
0243Documentation issueLack of documentation prevents the package from proceeding on its way.
0245Held for inspectionThe inspection authority holds the package for inspection. Example: smuggling inspection.
0248Missing tax/fee paymentSome tax/fee needs to be paid for the package to continue its journey.

Incidents

Issues that permanently prevent delivery. Once received, the shipment lifecycle ends and no further notifications should be sent. Triggers immediate financial actions.

Code
Description
Comments
0607Held by authorityHeld by fiscal authority due to lack of documentation. Returns money to the buyer; case reviewed with seller.
0617TheftThe package was stolen during transport. Returns money to the buyer and pays insurance to the seller.
0619Total damageThe package was completely damaged and cannot be delivered. Returns money to the buyer and pays insurance to the seller.
0623Total lossThe package was totally lost and cannot be located. Returns money to the buyer and pays insurance to the seller.
0631ConfiscatedConfiscated because the sender shipped a dangerous and/or prohibited substance. Returns money to the buyer.