MercadoLivre Envios - MeliDevConf 2013 - SP

MercadoLivre Developers Conference
MercadoLivre Envios

Bruno Elia
Software Engineer
@brunoelia

MercadoLivre Developers Conference
Overview
ME1
Cálculo de custo de envio
Como publicar?
Capturar dados de entrega
Código de rastreamento
ME2
Cálculo de custo de envio
Como publicar?
Capturar dados de entrega
Etiquetas
MercadoLivre Envios

MercadoLivre Developers Conference MercadoLivre Envios

Calculador de custos
Custos de envio direto no
MercadoPago
Direção de envio completa
ao pagar

ME 2

!=
ME1
ME2

{
"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"
]
...
}
GET
https://api.mercadolibre.com/users/me?access_token=$ACCESS_TOKEN

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

{
"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": {
"handling": 24,
"shipping": 24
},
"tracks_shipments_status": "not_verified"
},
...
GET
https://api.mercadolibre.com/users/{user_id}/shipping_options?category_id={category_id}
&dimensions=16x16x16,3000&zip_code={cep}
...
{
"cost": 14.94,
"display": "always",
"id": 27568887,
"list_cost": 14.94,
"name": "Normal",
"speed": {
"handling": 24,
"shipping": 96
},
"tracks_shipments_status":
"not_verified"
}
]
}

{
"title":"Item de teste" ,
"category_id":"MLB74723",
"price":10,
"currency_id":"BRL",
"available_quantity" :10,
"buying_mode":"buy_it_now",
"listing_type_id" :"bronze",
"condition":"new",
"description":"Item: <strong>teste</strong>" ,
"pictures":[
{
"source":"http://mercadolivre.com/Ray_Ban_Original_Wayfarer.jpg"
}
],
"shipping":{
"local_pick_up":false,
"dimensions":"10x10x20,700"
}
}
POST
https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN

{
"price":10,
"condition":"new",
"pictures":[...],
"shipping":{
"local_pick_up" :false,
"dimensions":"10x10x20,700" ,
"methods": [ {
"id": 100009,
"free": "country",
} ]
}
}
POST

{
"buyer": {...},
"date_closed": "2013-03-20T18:02:
52.000-04:00",
"date_created": "2013-03-20T17:57:
54.000-04:00",
"feedback": {...},
"id": XXXXXXXX,
"order_items": [...],
"seller": {...},
"shipping": {...},
"status": "paid",
"status_detail": null,
"tags": [...],
"total_amount": 799
}
GET
https://api.mercadolibre.com/orders/{order_id}?access_token=$ACCESS_TOKEN
...
"shipping": {
"cost": 0,
"date_created": "2013-03-20T17:59:55.000-
00",
"date_first_printed": null,
"id": XXXXXXXXXX,
"receiver_address": {...},
"service_id": 11,
"shipment_type": "shipping",
"shipping_mode": "me1",
"status": "shipped"
},
...

{
"comments": null,
"created_by": "receiver",
"date_created": "2013-03-20T17:59:55.000-04:00",
"id": 20671088339,
"last_updated": "2013-06-27T14:27:27.000-04:00",
"mode": "me1",
"order_id": 757199078,
"receiver_address": {
"address_line": "Rua dos bobos, 0",
"city": {...},
"comment": "Prox a padaria",
"country": {...},
"id": 99976550,
"neighborhood": {...},
"state": {...},
"types": [
"default_buying_address"
],
"zip_code": "00001001"
},
"receiver_id": 20362027,
...
GET
https://api.mercadolibre.com/shipments/{shipping_id}?access_token=$ACCESS_TOKEN
...
"sender_address": {...},
"sender_id": 20703080,
"service_id": 11,
"shipping_items": [
{
"description": "Description",
"dimensions": "11.0x16.0x16.0,300.0",
"id": "MLB471264432",
"quantity": 1
}
],
"shipping_option": {
"cost": 0,
"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"
}

[
{
"description": "PAC",
"id": 1,
"name": "PAC",
"shipping_company": {...},
...
"tracks_shipments": true
}, ...
]
GET
https://api.mercadolibre.com/sites/MLB/shipping_services
{
"tracking_number" : "TR1234567891" ,
"service_id": 1
}
POST

GET
https://api.mercadolibre.com/items/{item_id}/shipping_options?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,
"display": "recommended",
"id": 27568886,
"list_cost": 17.91,
"name": "Expresso",
"speed": {
"handling": 24,
"shipping": 24
},
"tracks_shipments_status": "not_verified"
},
...
...
{
"cost": 14.94,
"display": "always",
"id": 27568887,
"list_cost": 14.94,
"name": "Normal",
"speed": {
"handling": 24,
"shipping": 96
},
"tracks_shipments_status":
"not_verified"
}
]
}

POST
{
"price":10,
"condition":"new",
"pictures":[
{
"source":"http://mercadolivre.com/Ray_Ban_Original_Wayfarer.jpg"
}
],
"shipping":{
"local_pick_up":false,
"dimensions":"10x10x20,700"
}
}

POST
{
"price":10,
"condition":"new",
"pictures":[...],
"shipping":{
"local_pick_up" :false,
"methods": [{
"id": 100009,
"free": "country",
} ]
}
}

{
"comments": null,
"created_by": "receiver",
"date_created": "2013-03-20T17:59:55.000-04:00",
"id": 20671088339,
"last_updated": "2013-06-27T14:27:27.000-04:00",
"mode": "me1",
"order_id": 757199078,
"receiver_address": {
"address_line": "Rua dos bobos, 0",
"city": {...},
"comment": "Prox a padaria",
"country": {...},
"id": 99976550,
"neighborhood": {...},
"state": {...},
"types": [
"default_buying_address"
],
"zip_code": "89473632"
},
"receiver_id": 20362027,
...
GET
...
"sender_address": {...},
"sender_id": 20703080,
"service_id": 11,
"shipping_items": [
{
"description": "Description",
"dimensions": "11.0x16.0x16.0,300.0",
"id": "MLB471264432",
"quantity": 1
}
],
"shipping_option": {
"cost": 0,
"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"
}

GET
https://api.mercadolibre.com/shipment_labels?
shipment_ids=20178600648&savePdf=Y&access_token=$ACCESS_TOKEN

Perguntas?
Bruno Elia
@brunoelia

MercadoLivre Envios - MeliDevConf 2013 - SP

Recommended

Recommended

More Related Content

Viewers also liked

Viewers also liked (20)

Similar to MercadoLivre Envios - MeliDevConf 2013 - SP

Similar to MercadoLivre Envios - MeliDevConf 2013 - SP (20)

More from melidevelopers

More from melidevelopers (20)

MercadoLivre Envios - MeliDevConf 2013 - SP