Notificaciones Push

Contenidos

Cuando un envío tenga un cambio de estado (llegada a la sucursal de destino, intento fallido de entrega), el servicio del correo deberá informar mediante una notificación push.

Formato Request

Se enviará un mensaje con la siguiente estructura:

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

Los atributos del body se explican en la siguiente tabla:

{
  "tracking_number": string,
  "code": string,
  "carrier_code": string,
  "payload": {
    "date": date,
    "reason": string,
    "comment": string,
    "flight": {
      "awb": string
    },
    "declaration_number": string,
    "agency_id": string,
    "agency": {
        "phone_number": string
    },
    "cost": bigdecimal,
    "location": {
        "zip_code": string,
        "country_id": string,
        "state_name": string,
        "city_name": string,
        "neighborhood_name": string,
        "facility": string,
        "geolocation": {
            "geolocation_type": string,
            "latitude": bigdecimal,
            "longitude": bigdecimal
        }
    },
    "dimensions": {
        "height": bigdecimal,
        "width": bigdecimal,
        "length": bigdecimal,
        "weight": bigdecimal
    },
    "redispatch": {
        "tracking_number": string,
        "carrier_id": bigdecimal,
        "tracking_url": string
      },
    "estimated_delivery_date": date,
    "proof_of_delivery": {
        "receiver_document":{
            "type": string,
            "number": string
         },
        "receiver_last_name": string,
        "receiver_name": string,
        "receiver_relationship": string,
        "image": string
    },
    "driver": {
        "id": string,
        "name": string,
        "email": string,
        "phone": string,
        "license_plate": string
    },
    "vehicle": {
        "reference_type": string,
        "reference": string
    },
    "consolidated_packages": {
        "consolidation_id": string
        "tracking_number": string
        "shipments": [integer, integer, integer]
     },
     "details": {
      "transport": {
        "content": {
          "restricted_item_type": string
        }
      }
    }
  }
}

Formato Response

Si la notificación fue recibida correctamente, el POST devuelve status OK.

Ejemplos

Request:

{
  "tracking_number": "1234NLUG123",
  "code": "0201",
  "carrier_code": "a31",
  "payload": {
    "date": "2016-11-16T17:00:00.000-04:00",
    "comment": "Envío despachado"
  }
}

Response:

Satisfactioria

{
    "status": OK
}

Errores

Si ocurre algún error, la API devuelve HTTP status distinto de OK (200) . Si el código de error HTTP es del tipo 4XX no se debe reintentar (ya que hay algún problema con el request). Si por el contrario, es 5XX, se debe reintentar utilizando algún mecanismo de backoff con al menos tres reintentos.

Failed (400 FAILED)

{
  "message": "User must have a valid scope",
  "error": "invalid_scopes",
  "status": 403,
  "cause": null,
  "internal_cause": [ ]
}

Error (500 ERROR)

{
  "message": "Internal error server",
  "error": "internal_error_server",
  "status": 500,
  "cause": null,
  "internal_cause": [ ]
}