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

Na seguinte endpoint:

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

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) DISPONIVEL NO LINK ABAIXO:

https://skyhub.gelato.io/docs/versions/1.0/resources/postagem-plp

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:

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

Segue a baixo exemplo de etiqueta no formato PDF:

É obrigatorio que os campos destacados em vermelho estejam na etiqueta,para que evite o risco de recusa por parte dos correios. Os campos destacados são:

· Chancela
· Código de rastreio
· PLP
· Número do pedido
· Código de barra centralizado
· Dados de endereço

Modelos B2W Entregas by Direct

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

Segue a baixo exemplo de etiqueta no formato Json:

Segue a baixo exemplo de etiqueta no formato PDF:

É obrigatorio que os campos destacados em vermelho estejam na etiqueta,para que evite o risco de recusa por parte dos correios. Os campos destacados são:

· Número do pedido e nota fiscal.
· Código de rastreio
· Número da PL
· Rota
· Código de barra centralizado
· Mega rota
· Dados de endereço

Reforço 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 metodo de envio do pedido, basta verificar o campo: "calculation_type". Caso o campo esteja "b2wentregacorreios" ou "b2wentregadirect". Ao identificar o "calculation_type" 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 Mercados 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 casos de duvidas envie um email para: api@skyhub.com.br