Carrier Branch to Buyer Address#

Introduction#

This is a last mile leg. The package is already at the carrier's branch and needs to be delivered to the final recipient. The carrier is responsible for the full last mile operation: loading, routing, attempting delivery, and handling any delivery issues.

Multiple delivery attempts may be needed if the recipient is absent or if there are address issues. The carrier may also make the package available for pickup at a branch if delivery to the address is not possible.

What the carrier needs to know:

• This is the final leg before the package reaches its recipient — getting this right directly impacts the buyer experience.
• Delivery problems (absent recipient, wrong address, unauthorized person) are non-final: the carrier should attempt delivery again.
• If the package cannot be delivered after all attempts, it may enter a return flow back to the seller.
• The carrier must communicate each delivery attempt clearly, whether successful or not.

The shipment notifications must be sent to this endpoint:

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

Notifications#

Transportation Problems#

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

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.

Incidents#

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