Mercado Envios 1

Este guia explica como trabalhar com todos os recursos oferecidos por nossa API para publicar e gerenciar publicações com sucesso usando a modalidade de envio me1. Ele também explica como publicar números de rastreamento para apresentar informações de rastreamento aos compradores.

Conteúdos

→Opção pelo Mercado Envios 1
→Oferecer Mercado Envios 1 em seus produtos
→Dimensões
→Conhecer as dimensões padrão de uma determinada categoria
→Adicionar dimensões
→Frete grátis
→Calcular o custo do envio
→Descrição de atributos
→Convivência ME1/ME2


Opção pelo Mercado Envíos 1

Para começar a utilizar o Mercado Envios modo 1, você deve entrar em contato com seu consultor comercial do Mercado Livre, pois esse modo só é disponibilizado para usuários VIP e é ativado por nossa equipe de desenvolvedores da área Envio para cada caso individual.


Oferecer Mercado Envios 1 em seus produtos

Publicar um anúnco com o me1 é bem fácil. Publique opções de frete grátis e as dimensões do pacote, quando estiverem disponíveis. Caso os vendedores não tenham incluído as dimensões do pacote na publicação, as dimensões padrão da categoria serão usadas.
URL para POST:

 https://api.mercadolibre.com/items?access_token=

JSON para o corpo:

 {
   "title":"Item de teste",
   "category_id":"MLA48786",
   "price":1200,
   "currency_id":"ARS",
   "available_quantity":2,
   "buying_mode":"buy_it_now",
   "listing_type_id":"bronze",
   "condition":"new",
   "description":"test",
   "pictures":[
  	{
         "source":"http://upload.wikimedia.org/wikipedia/commons/f/fd/Ray_Ban_Original_Wayfarer.jpg"
  	},
  	{
         "source":"http://en.wikipedia.org/wiki/File:Teashades.gif"
  	}
   ],
   "shipping":{
  	"local_pick_up":false,
  	"mode": "me1",
      "dimensions":"10x10x20,700"
   }
}

Dimensões

Depois de ter colocado a identificação do modo me1, você pode adicionar dimensões em suas publicações existentes. A alteração das dimensões de um produto não afeta sua relevância nos resultados de busca, e não há nenhuma restrição para alterar as dimensões se o produto tiver vendas. Apesar de cada categoria ter suas próprias dimensões padrão, você poderá acrescentar os valores que quiser, desde que se encontrem dentro da faixa de valores permitidos. Consulte a tabela para saber os valores autorizados para cada site.


Conhecer as dimensões padrão de uma determinada categoria

Exemplo:

 curl -X GET https://api.mercadolibre.com/categories/MLA9558/shipping_preferences

Adicionar dimensões

 curl -X PUT -H "Content-Type: application/json" -d ‘{
   "shipping":{
  	"dimensions":"10x10x20,700",
  	"mode": "me1"
   }
}’ https://api.mercadolibre.com/items/:item_id?access_token=

Frete grátis

Os vendedores podem optar pela publicação de produtos oferecendo um dos modos de frete grátis. Consulte essa entrada para obter mais detalhes e para saber publicar com frete grátis.


Calcular o custo do envio

Nossa API tem um recurso para calcular o custo do frete para uma dimensão, categoria e CEP determinados. A calculadora de fretes pode escolher entre dois recursos para melhor se adaptar as seus parâmetros disponíveis; ambos vão retornar o mesmo resultado. URL:

https://api.mercadolibre.com/users/:user_id/shipping_options?category_id=:category_id&dimensions=:dim&zip_code=13565905
https://api.mercadolibre.com/items/:item_id/shipping_options?zip_code=13565905

Resposta:

{
  "destination": - {
	"zip_code": "01001000",
	"city": - {
  	"id": "BR-SP-44",
  	"name": "São Paulo",
    },
	"state": - {
  	"id": "BR-SP",
  	"name": "São Paulo",
	},
	"country": - {
  	"id": "BR",
  	"name": "Brasil",
	},
	"extended_attributes": - {
  	"address": "Praça da Sé",
  	"owner_name": null,
  	"zip_code_type": - {
    	"type": "LO",
    	"description": "Logradouro",
  	},
  	"city_type": "CP",
  	"city_name": "São Paulo",
  	"version": 6,
	},
  },
  "options": - [
	- {
  	"id": 18310062,
  	"name": "Normal",
  	"currency_id": "BRL",
  	"list_cost": 13.86,
  	"cost": 13.86,
      "tracks_shipments_status": "not_verified",
  	"display": "recommended",
  	"speed": - {
    	"shipping": 72,
    	"handling": 24,
  	},
	},
	- {
  	"id": 18310061,
  	"name": "Expresso",
  	"currency_id": "BRL",
  	"list_cost": 14.88,
  	"cost": 14.88,
      "tracks_shipments_status": "not_verified",
  	"display": "always",
  	"speed": - {
    	"shipping": 24,
    	"handling": 24,
  	},
	},
  ],
}


Descrição de atributos

currency_id:  moeda na qual o preço é cobrado.
list cost: custo para essa opção de frete.
cost: custo real a ser pago; o custo do "frete grátis" é 0.
tracks_shipments_status: indica como poderá ser feito o rastreamento desse modo.
tracks_shipments_status.verified: é possível realizar o rastreamento internamente.
tracks_shipments_status.not_verified: as informações de rastreamento devem ser fornecidas pelo vendedor.
tracks_shipments_status.no: não pode ser rastreado.
speed.shipping: promessa de tempo de entrega, expressa em horas.
speed.handling: romessa de tempo de processamento, expressa em horas.



Convivência ME1/ME2

Se você ativou o trabalho com os dois modos de envio, para migrar de uma opção para outra, você deve fazer o seguinte PUT.

curl -X PUT -H "Content-Type: application/json" -d ‘{
   "shipping":{
      "mode" : "me2", "free_methods": {"id": 500345, "rule":{"free_mode":"country","value": null
   }
}’ https://api.mercadolibre.com/items/:item_id?access_token=
Nota:
Você pode fazer isso mesmo quando as publicações estão ativas.

Próximo: Status de pedidos ME1.

ou registre-se para receber as últimas notícias sobre nossa API