The document discusses new MercadoEnvios functionality presented by Bruno Elia at the MercadoLibre Developer Conference. It provides information on MercadoEnvios shipping services including calculating shipping costs, publishing and selling items, mass label printing, and configuring free shipping options. Code examples are given for various MercadoEnvios API endpoints.

1. MercadoEnvios
Novas funcionalidades
Bruno Elia
Engenheiro de Software do MercadoLivre

2. Developer Conference
Overview
O que é MercadoEnvios
Publicando
Vendendo
Impressão massiva
Free shipping

3. O que é MercadoEnvios Developer Conference

4. Developer Conference
Calculador de custos
Custos de envio direto no
MercadoPago
Direção de envio
completa ao pagar
O que é MercadoEnvios

5. Developer Conference
O que é MercadoEnvios
GET
https://api.mercadolibre.com/users/me?access_token=$ACCESS_TOKEN
{
"id": 1234567,
"nickname": "MLB_DEVCONF",
"registration_date": "2009-01-06T16:52:14.000-04:00",
"first_name": "Developer",
"last_name": "Conference",
...
"shipping_modes":[
"custom",
"not_specified",
"me2"
]
...
}

6. Publicando - ME1 Developer Conference
POST
https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN
{
"title":"Item de teste",
"category_id":"MLB74723",
"price":10,
"currency_id":"BRL",
"available_quantity":10,
...
"pictures":[...],
"shipping":{
"local_pick_up":false,
"dimensions":"10x10x20,700"
}
}

7. Publicando - ME2 Developer Conference
POST
https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN
{
"title":"Item de teste",
"category_id":"MLB74723",
"price":10,
"currency_id":"BRL",
"available_quantity":10,
...
"pictures":[...],
"shipping":{
"local_pick_up":false
"dimensions":"10x10x20,700"
}
}

8. Publicando - ME1 Developer Conference
GET
https://api.mercadolibre.com/sites/MLB/shipping_services
[
{
"description": "PAC",
"id": 21,
"name": "PAC",
"shipping_company": {...},
...
"tracks_shipments": true
}, ...
]
POST
https://api.mercadolibre.com/shipments/{shipping_id}?access_token=$ACCESS_TOKEN
{
"tracking_number": "TR1234567891",
"service_id": 21
}

9. Calculo de custo de envio Developer Conference
GET
https://api.mercadolibre.com/users/{user_id}/shipping_options?category_id={category_id}
&dimensions=16x16x16,3000&zip_code={cep}
{
"destination": {
"city": {...},
"country": {...},
"extended_attributes": {
"address": "Rua dos bobos, 0",
"city_name": "São Paulo",
"city_type": "CP",
"owner_name": null,
"version": 7,
"zip_code_type": {...}
},
"state": {...},
"zip_code": "00000000"
},
"options": [
{
"cost": 17.91,
"currency_id": "BRL",
"display": "recommended",
"id": 27568886,
"list_cost": 17.91,
"name": "Expresso",
"speed": {...,
"tracks_shipments_status": "not_verified"
},
...
...
{
"cost": 14.94,
"currency_id": "BRL",
"display": "always",
"id": 27568887,
"list_cost": 14.94,
"name": "Normal",
"speed": {
"handling": 24,
"shipping": 96
},
"tracks_shipments_status":
"not_verified"
}
]
}

10. Calculo de custo de envio Developer Conference
GET
https://api.mercadolibre.com/users/{user_id}/shipping_options?category_id={category_id}
&dimensions=16x16x16,3000&zip_code={cep}
...
{
"cost": 14.94,
"currency_id": "BRL",
"display": "always",
"id": 27568887,
"list_cost": 14.94,
"name": "Normal",
"speed": {
"handling": 24,
"shipping": 96
},
"estimated_delivery": {
"date": "2013-08-10T00:00:00.000-04:00",
"time_from": null,
"time_to": null
},
"tracks_shipments_status": "not_verified"
}
]
}

11. Calculo de custo de envio Developer Conference

12. Calculo de custo de envio Developer Conference

13. Vendendo Developer Conference
APP POST
{
"user_id": 1234,
"resource": "/orders/123456",
"topic": "orders",
"received": "2014-08-06T14:59:15+00:00",
"sent": "2014-08-06T14:59:15+00:00"
}

14. Developer Conference
Vendendo
GET
https://api.mercadolibre.com/orders/{order_id}?access_token=$ACCESS_TOKEN
...
"shipping": {
"status": "shipped"
"cost": 0,
"currency_id": "BRL",
"date_created": "2013-03-20T17:59:55.000-04:00",
"date_first_printed": null,
"id": XXXXXXXXXX,
"receiver_address": {...},
"service_id": 11,
"shipment_type": "shipping",
"shipping_mode": "me1",
},
...

15. Developer Conference
GET
https://api.mercadolibre.com/shipments/{shipping_id}?access_token=$ACCESS_TOKEN
{
"comments": null,
"created_by": "receiver",
"date_created": "2013-03-20T17:59:55.000-04:00",
"date_first_printed": null,
"id": 20671088339,
"last_updated": "2013-06-27T14:27:27.000-04:00",
"mode": "me1",
"order_id": 757199078,
"receiver_address": {
"address_line": "Rua dois, 670",
"street_name": "Rua dois",
"street_number": "670",
"city": {...},
"country": {...},
"id": 99976550,
"neighborhood": {...},
"state": {...},
"types": [...],
"zip_code": "00001001"
},
"receiver_id": 20362027,
...
...
"sender_address": {...},
"sender_id": 20703080,
"service_id": 11,
"shipping_items": [...],
"shipping_option": {
"cost": 0,
"currency_id": "BRL",
"id": 18307474,
"list_cost": 11.07,
"name": "Normal",
"speed": {
"handling": 24,
"shipping": 144
}
...
},
"site_id": "MLB",
"status": "shipped",
"status_history": {...},
"tracking_method": "Otros",
"tracking_number": "0"
}
Vendendo

16. Developer Conference
Vendendo
GET
https://api.mercadolibre.com/shipments/{shipping_id}?access_token=$ACCESS_TOKEN
...
"sender_address": {...},
"sender_id": 20703080,
"service_id": 11,
"shipping_items": [...],
"shipping_option": {
...
"id": 18307474,
"list_cost": 11.07,
"estimated_delivery": {
"date": "2013-08-10T00:00:00.000-04:00",
"time_from": null,
"time_to": null
}
},
"site_id": "MLB",
"status": "shipped",
"status_history": {...},
"tracking_method": "Otros",
"tracking_number": "0"
}

17. Vendendo Developer Conference

18. Developer Conference
Overview
O que é MercadoEnvios
Publicando
Vendendo
Impressão massiva
Free shipping

19. Impressão massiva Developer Conference
GET
https://api.mercadolibre.com/shipment_labels?shipment_ids=20178600648,
20178600648,20178600649&savePdf=Y&access_token=$ACCESS_TOKEN

20. Impressão massiva Developer Conference

21. Developer Conference
Overview
O que é MercadoEnvios
Publicando
Vendendo
Impressão massiva
Free shipping

22. Developer Conference

23. Developer Conference
GET
https://api.mercadolibre.com/sites/MLB/shipping_methods
[
{
"free_options": [
"country"
],
"id": 100009,
"name": "Normal",
"site_id": "MLB",
"status": "active"
},
{
"free_options": [
"country"
],
"id": 182,
"name": "Expresso",
"site_id": "MLB",
"status": "active"
}
]

24. Developer Conference
Shipping preferences
GET
https://api.mercadolibre.com/users/cust_id/shipping_preferences?
access_token=$ACCESS_TOKEN
{
"local_pick_up": false,
"modes": [...],
"services": [...],
"free_configurations": [ {
"condition": {...},
"rule": {
"free_mode": "country",
"value": null,
"default": true
}
}, {
"condition": {...},
"rule": {
"free_mode": "exclude_region",
"value": [
"BR-NO",
"BR-NE"
],
"default": false
}
}
],
...
}

25. Developer Conference
Free shipping
POST
https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN
{
"title": "Titulo del item",
...
"shipping": {
"mode": "me2",
"local_pick_up": false,
"free_methods": [
{
"id": 100009,
"rule": {
"free_mode": "country",
"value": null
}
}
]
}
}

26. Developer Conference
Free shipping
POST
https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN
{
"title": "Titulo del item",
...
"shipping": {
"mode": "me2",
"local_pick_up": false,
"free_methods": [
{
"id": 100009,
"rule": {
"free_mode": "exclude_region",
"value": [ "BR-NO", "BR-NE" ]
}
}
]
}
}

27. Developer Conference
Perguntas?