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:
bash1POST '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. |