> For the complete documentation index, see [llms.txt](https://skyhub-english.gitbook.io/skyhub-api-english/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://skyhub-english.gitbook.io/skyhub-api-english/skyhub-api-guides/servico-de-etiqueta-de-frete.md).

# Shipping Label Service

## How do I get my Shipping label?

Skyhub provides an endpoint to consume the service to obtain the shipping label for the services ***B2W Entrega*** and ***Mercado Envios 2*** of Mercado Livre.

For your platform take advantage of this integration is necessary to follow the steps below:

Use the `GET` method at the following endpoint:

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

{% hint style="danger" %}
**Warning:** The functionality above is applicable only for those who integrate orders and products via the new SkyHub API, otherwise use the PLP (clustering) method available at the link below:
{% endhint %}

[Check in our API explorer](http://api-docs.skyhub.com.br/#/shipments)

There are two ways to get the **B2W Entrega** service tag that must be configured in the request header, to get the tag in **JSON**, or in **PDF** the header accept must have one of the following values:

#### Application/json - To get the label in Json format

![Label example in JSON format ](https://2606423342-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWLii0XmQdjJQQG6m8e%2F-LWkInqM45h4a9ziAdAv%2F-LWkPhOo2AR1ZYId-Odu%2Fimage.png?alt=media\&token=e1e54f5c-bcf4-4d06-9320-b0d81533628c)

#### Application/pdf - To get the label in PDF format

![Label example in PDF](https://2606423342-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWLii0XmQdjJQQG6m8e%2F-LWkInqM45h4a9ziAdAv%2F-LWkQsuMMiKZDmp9-y6M%2Fimage.png?alt=media\&token=6eb5f26f-f1aa-4017-afc7-5798228461c1)

{% hint style="danger" %}
**Warning:** It is mandatory that the fields highlighted in red are on the label to avoid the risk of refusal by Correios. They are:

* Seal of approval
* Tracking number
* PLP
* Order number
* Shipping address
  {% endhint %}

## B2W Entregas by Direct models

If you use the By Direct freight strategy, it is mandatory that the information in the "megaRota" field is identified on the label.

#### Label in JSON format

![](https://2606423342-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWLii0XmQdjJQQG6m8e%2F-LWkWVunl1SOj97zAFFo%2F-LWkZQHcodxfU6OUJBtt%2Fimage.png?alt=media\&token=e1b6b73e-a300-45ba-8375-b0aa591a13e0)

#### Label in PDF format

![](https://2606423342-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWLii0XmQdjJQQG6m8e%2F-LWkWVunl1SOj97zAFFo%2F-LWkZhG27jJ6LM1PCoou%2Fimage.png?alt=media\&token=37744fe9-b166-462e-8dd8-c284f2a51812)

{% hint style="danger" %}
**Warning:** It is mandatory that the fields highlighted in red are on the label to avoid the risk of refusal by Correios. They are:

* Order number and invoice number
* Tracking number
* PL number
* Base
* "Mega rota"
* Shipping address

We reinforce that the information "megaRota" must be identified on the label, as marked in red in the above example.
{% endhint %}

{% hint style="warning" %}
Remember that if you want to print on your thermal printer, it needs to be developed internally to compile the information returned in JSON from B2W Entrega method.
{% endhint %}

To identify the order shipping method, just check the field: **"calculation\_type"**. If the field has the value **"b2wentregacorreios"** or **"b2wentregadirect"** the update must be made until the billed status. From billed all dealings are done via B2W.

There are two ways to get the Mercado de Envios 2 label that must be configures in the request header. To get the label in PDF format or in ZIP, the header accept must have one of the following values:

* Application/pdf - To get the label in PDF format
* Application/zip - To get the label in ZIP format

For options in PDF and Zip will be available a file in the format requested.

{% hint style="info" %}
If there is any question send an e-mail to <api@skyhub.com.br>
{% endhint %}
