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.

Importante:
Para seguridad se utilizará OAuth

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:

NombreTipo de datoDescripción
idStringNúmero de HU
date_shippedDate (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
channelStringCanalización
facility_idStringIdentificador de centro logístico
detailsArrayArray que contiene el detalle de los envíos incluídos en el pallet.
details.shipment_idNumericIdentificador único de envíos de Mercado Libre
details.weightNumericPeso en gramos
details.statusStringValores 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 HTTPResponse bodyDescripció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"
   ]
}