Logistics Center to Buyer Address#

Introduction#

This is a last mile leg in which the package originates from a MELI distribution center rather than from the carrier's own branch. This typically happens when the seller ships inventory in advance to MELI's warehouse (fulfillment model), and MELI manages the storage until a purchase is made — at which point the carrier picks up the package from the MELI center and delivers it directly to the buyer.

The delivery dynamics consists of multiple attempts that may be needed, and the carrier must handle address issues, absent recipients, and potential returns.

What the carrier needs to know:

• The carrier picks up the package at a MELI-operated logistics center, not at a carrier branch.
• From the moment of pickup at MELI's center, the carrier is fully responsible for last mile delivery.
• Returns go back to MELI's logistics center, not to the seller's address.

The shipment notifications must be sent to this endpoint:

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

Notifications#

Code	Description	Comments
0204	Package picked up at Mercado Libre logistics center	First event code to be sent by the carrier when the package is picked up at a Mercado Libre logistics center.
0271	Entry into carrier logistics center	The package has arrived and been checked into a carrier logistics center for processing.
0273	Exit from carrier logistics center	The package has departed from the carrier logistics center heading to the next destination in the route.
0211	In transit	The package is in transit between logistics centers or on route to its destination.
0227	Out for delivery	The package has left the carrier's facility and is on its way to the buyer's address for last mile delivery.
0233	Next to deliver	This event must be notified when the shipment in question is next in line to be delivered.
0401	Delivered	The package was successfully delivered to the recipient. Releases money to the seller.
0215	Ready for pickup at branch	The package is available for the recipient to collect at a carrier branch or post office.
0229	Arrived at address — package rejected	The delivery was attempted but the recipient refused to accept the package at the address.

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
0209	Inaccessible area	The route or location is inaccessible (e.g. flooded road, blocked access), preventing the carrier from transporting the package via the normal route.
0231	Delayed shipment	The shipment has been delayed and will not arrive within the originally estimated timeframe.
0255	Under review due to incident	The type of incident the shipment had is not yet known. The carrier is investigating before sending a more specific event.
0243	Documentation issue	Lack of documentation prevents the package from proceeding on its way.
0245	Held for inspection	The inspection authority holds the package for inspection. Example: smuggling inspection.
0248	Missing tax/fee payment	Some tax/fee needs to be paid for the package to continue its journey.

Delivery Problems#

Most commonly occur while the package is in transit to the buyer's address. Not final events; can be reported multiple times as the carrier makes new delivery attempts.

Code	Description	Comments
0210	Dangerous delivery zone	The delivery area is classified as dangerous, preventing normal delivery operations at that location.
0223	Recipient absent	Delivery was attempted but the recipient was not present at the address at the time of delivery.
0235	Incorrect delivery address	The address on file is incorrect or incomplete, preventing the carrier from completing the delivery.
0241	Person not authorized to receive package	The person present at the delivery address is not authorized to receive the package on behalf of the recipient.
0253	Did not arrive at address in time	The carrier was unable to reach the delivery address within the agreed time window for that day.
0247	Consultation with carrier required	An issue requires the carrier to be contacted directly for clarification or resolution before delivery can proceed.

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
0607	Held by authority	Held by fiscal authority due to lack of documentation. Returns money to the buyer; case reviewed with seller.
0617	Theft	The package was stolen during transport. Returns money to the buyer and pays insurance to the seller.
0619	Total damage	The package was completely damaged and cannot be delivered. Returns money to the buyer and pays insurance to the seller.
0623	Total loss	The package was totally lost and cannot be located. Returns money to the buyer and pays insurance to the seller.
0631	Confiscated	Confiscated because the sender shipped a dangerous and/or prohibited substance. Returns money to the buyer.