Seller to Logistics Center

Introduction

The seller prepares the package and waits for the carrier to collect it at their own address. The carrier is responsible for going to the seller's location, picking up the package, and transporting it to a MELI distribution center.

This is a pickup-driven leg: the carrier schedules and executes the collection directly at the seller's premises. The package has not yet entered any logistics infrastructure — it goes straight from the seller's hands into the carrier's possession and then into MELI's network.

What the carrier needs to know:

  • The carrier must proactively go to the seller's address to collect the package.
  • If the package cannot be picked up (absent, damaged, overweight), this must be reported immediately.
  • The final destination is a MELI logistics center, not the buyer.

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
0219Package pickup at seller's addressFirst status code sent by the carrier when picking up the package at the seller's address.
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. 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.