Label

Contenidos

¿Cómo conseguir mi Access Token?

Para generar su token de acceso, siga los pasos que se muestran en cómo conseguir mi Access Token

Formato Request

Se enviará una petición con el siguiente formato:

GET https://api.mercadolibre.com/shipments/{shipment_id}/documents/cbt_label?response_type={responseType}&label_type={labelType} 

--header 'Authorization: Bearer {accessToken}'

El parámetro label_type es opcional y permite solicitar explícitamente el tipo de etiqueta:

• first_mile | last_mile
• Si se omite (o no se reconoce), se mantiene el comportamiento legacy y Labels decide el valor por defecto.

Formato Response

Se espera un cuerpo vacío, y el formato del documento descargado será determinado por el valor en la clave "response_type".

• Si se especifica "pdf", el documento se descargará en PDF.
• Si se especifica "zpl" y la ruta es USA-México, el documento se descargará en formato ZIP.
• Si se deja en blanco "response_type", el documento se descargará en formato PDF.

Status Codes

Ejemplos

Request:

GET https://api.mercadolibre.com/shipments/123132434/documents/cbt_label?response_type=pdf&label_type=last_mile 

--header 'Authorization: Bearer xxxxxxxxx'

Response:

Successful (200 OK)

{

}

Failed (Error HTTP 4XX)

{
    "error": "error_get_document",
    "message": "Shipment status is 'delivered'",
    "status": 400 
}

{
    "error": "bad_request",
    "message": "Invalid response type",
    "status": 400
}

{
    "error": "shipment_not_found",
    "message": "Shipment: 3002444733251",
    "status": 404  
}

Error (Error HTTP 5XX)

{
    "error": "internal_error",
    "message": "Internal Server Error",
    "status": 500  
}