Gerar etiqueta de envio

Este endpoint permite obter etiquetas de envio para um pacote específico. A etiqueta pode ser retornada em diferentes formatos (".pdf", ".zpl", ".zip" ou ".json") com base no header "X-Content-Type" e conterá todas as informações necessárias para envio incluindo códigos de barras, endereços e números de rastreamento. Em caso de sucesso, a requisição retornará uma resposta com o status 200.

GET

https://api.mercadopago.com/shipping/v1/shipments/{id}/packages/{packageId}/label
Request parameters
Header
Authorization
string

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
X-Content-Type
string

OBRIGATÓRIO

Formato de saída desejado para a etiqueta. Os formatos possíveis são: ".pdf", ".zpl", ".zip" ou ".json".
Path
id
string

OBRIGATÓRIO

Identificador do envio, que pode ser obtido ao consultar as informações do envio ou por meio da notificação Webhook.
packageId
string

OBRIGATÓRIO

Identificador do paquete, que pode ser obtido ao consultar as informações do envio ou por meio da notificação Webhook.
Response parameters
id
integer
Identificador do envio.
label
string
Informações da etiqueta no formato solicitado.
Erros

400Requisição inválida. Os parâmetros enviados não são válidos.

bad_request

Dados inválidos foram enviados no body da requisição. Tente enviar a solicitação novamente, validando todos os campos.

401Não autorizado. Credenciais inválidas ou ausentes.

unauthorized

O valor enviado como Access Token está incorreto. Verifique e tente a enviar requisição novamente com o valor correto.

417Expectativa falhou.

expectation_failed

Não foi possível atender à expectativa especificada no header "Expect". Valide as informações enviadas e tente enviar a requisição novamente.

500Erro interno do servidor.

internal_server_error

Ocorreu um erro inesperado no servidor. Tente enviar a requisição novamente.

Request
curl -X GET \
    'https://api.mercadopago.com/shipping/v1/shipments/{id}/packages/{packageId}/label'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
       -H 'X-Content-Type: pdf' \
    
Response
[
  {
    "id": 43539204818
  }
]