Obtención de Handling Unit (HU)
Contenido
Introducción
Desde los galpones de Mercado Libre realizamos operaciones como la agrupación de paquetes en pallets. Estos pallets son los que luego recogen los distintos correos para su posterior distribución. El correo puede solicitar información sobre estos paquetes previo a recogerlos, luego revisar los mismos e informar de alguna divergencia.
Formato Request
GET 'https://api.mercadolibre.com/handling_units/122555'
\ --header 'Authorization: Bearer {accessToken}'Formato Response
Dentro del body, devolverá todos los datos resultantes de recibir la notificación, listados a continuación:
| Nombre | Tipo de dato | Descripción |
|---|---|---|
| id | String | Número de HU |
| date_shipped | Date (ISO 8601) | Fecha de envío. Valores válidos: en UTC 2001-07-04T12:08:56.235Z o en hora local relativa 2001-07-04T12:08:56.235-07:00 |
| channel | String | Canalización |
| facility_id | String | Identificador de centro logístico |
| details | Array | Array que contiene el detalle de los envíos incluídos en el pallet. |
| details.shipment_id | Numeric | Identificador único de envíos de Mercado Libre |
| details.weight | Numeric | Peso en gramos |
| details.status | String | Valores válidos: “FORWARD” en caso de que el paquete se encuentre activo. “CANCELLED” en caso de que el paquete deba ser devuelto al hub. |
Ejemplos
Request:
GET 'https://api.mercadolibre.com/handling_units/123123123'
\ --header 'Authorization: Bearer {accessToken}'Response:
Successful
{
"id": "123123123",
"date": "2001-07-04T12:08:56.235-07:00",
"channel": "t",
"facility_id": "ARBA01",
"details": [
{
"shipment_id": 123456,
"weight": 400,
"status": "FORWARD"
},
{
"shipment_id": 123457,
"weight": 800,
"status": "CANCELLED"
}
]
}Failed (Error HTTP 4XX)
{
"message": "invalid_body",
"error": "invalid_data",
"status": 400,
"cause": [
"invalid_handling_unit"
]
}{
"message": "Outbound 123123123 doesn't belong to carrier",
"error": "invalid_carrier",
"status": 403,
"cause": []
}Errores 4XX conocidos por el carrier
| Código HTTP | Response body | Descripción |
|---|---|---|
| 403 | {“message”:”Outbound 123123123 doesn't belong to carrier”,…} | HU no pertenece al carrier. |
| 404 | {“message”:”"Outbound not found, outbound_id: 123123123”,…} | HU no se encontrado. |
Error (Error HTTP 5XX)
{
"message": "internal server error",
"error": "internal_server_error",
"status": 500,
"cause": [
"npe"
]
}