Serviço de Etiqueta de Frete

Como obter a minha etiqueta de frete?

A Skyhub disponibiliza um endpoint para consumir o serviço de obter a etiqueta de frete para os serviços B2W Entrega e Mercados Envios 2 do Mercado Livre.

Para a sua plataforma usufruir desta integração é necessário seguir os passos abaixo:

Utilizar o método GET no seguinte endpoint:

https://api.skyhub.com.br/orders/{code}/shipment_labels

Atenção: Essa funcionalidade acima é válida somente para parceiros que integram pedidos e produtos via nova API SkyHub, caso contrário utilize o método PLP (agrupamento) disponível no link abaixo:

{COLOCAR O LINK DO SWAGGER COM A DOCUMENTAÇÃO DA POSTAGEM]

Existem duas formas de obter a etiqueta do serviço B2W Entrega que deve ser configurado no header da requisição, para obter a etiqueta em JSON, ou em PDF o header accept precisa ter um dos seguintes valores:

Application/json – Para obter a etiqueta em formato Json

Segue a baixo exemplo de etiqueta no formato Json:

exemplo de etiqueta no formato Json

Application/pdf – Para obter a etiqueta em formato PDF

Segue a baixo exemplo de etiqueta no formato PDF:

Atenção: É obrigatório que os campos destacados em vermelho estejam na etiqueta,para que evite o risco de recusa por parte dos Correios. Eles são:

  • Chancela

  • Código de rastreio

  • PLP

  • Número do pedido

  • Dados de endereço

Modelos B2W Entregas by Direct

Caso utilize a estratégia de frete By Direct, é obrigatório que a informação do campo "megaRota" esteja identificado na etiqueta.

Etiqueta no formato Json

exemplo de etiqueta no formato Json

Etiqueta no formato PDF

Atenção: É obrigatório que os campos destacados em vermelho estejam na etiqueta,para que evite o risco de recusa por parte da Transportadora. Os campos destacados são:

  • Número do pedido e nota fiscal

  • Código de rastreio

  • Número da PL

  • Base

  • Mega rota

  • Dados de endereço

Reforçamos que a informação "megaRota" deve estar identificado na etiqueta, conforme marcação em vermelho no exemplo acima

Lembrando que caso queira imprimir em sua impressora térmica é necessário que o mesmo desenvolva internamente para compilar as informações retornadas no Json do método B2W Entrega.

Para identificar o método de envio do pedido, basta verificar o campo: "calculation_type". Caso o campo possua o valor "b2wentregacorreios" ou "b2wentregadirect" a atualização deve ser feita até o status faturado. A partir de faturado toda tratativa é feita via B2W.

Existem duas formas de obter a etiqueta do serviço Mercado de Envios 2 que deve ser configurado no header da requisição. Para obter a etiqueta em PDF, ou em ZIP o header accept precisa ter um dos seguintes valores:

  • Application/pdf - Para obter a etiqueta em formato PDF

  • Application/zip - Para obter a etiqueta em formato ZIP

Para as opções em Pdf e Zip será disponibilizado um arquivo no formado solicitado.

Em caso de duvidas envie um e-mail para api@skyhub.com.br