Airport HUB to Airport HUB - MELI OFF#

Introduction#

This is an air transport leg between two airport hubs, but in this case MELI is not directly managing the operation. The carrier — typically the airline itself — is fully responsible for the movement from origin to destination airport, with less operational granularity required.

The package is received at the origin airport, the flight takes place, and the package is delivered at the destination airport.

What the carrier needs to know:

• The carrier manages the full origin-to-destination flow without MELI's direct operational involvement.
• Incidents must still be reported if the package is permanently lost, damaged, or confiscated.

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
AP-0201	HU received at origin airport	The handling unit has been received and is at the disposal of the origin airport operation.
AL-0277	Flight initiated	The airplane has started pushback and the flight has begun.
AL-0278	Flight departure	The airplane has taken off and is on its way to the destination airport.
AL-0279	Flight arrival	The airplane has landed at the destination airport.
AL-0280	Flight stop	The airplane has arrived at the gate and engines are off.
AP-0401	HU delivered at destination airport	The handling unit has been delivered at the destination airport. Considered handed over to the party responsible for the last mile step.

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.