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.

Assuntos

Opção pelo ME1

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 ME1 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/MLM165702/shipping

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: promessa de tempo de processamento, expressa em horas.

Status do envio

Algumas configurações do modo ME1 aceitam rastreamento automático, por isso, atualizaremos o status do envio. Se esse for o caso, você será responsável por enviar um número de rastreamento e atualizar o status do envio. Apesar de não ser obrigatório, sugerimos fazer isso para melhorar suas possibilidades de receber um melhor feedback dos compradores.
Status:
pending
O envio é criado com esse status.
handling
O pagamento para o envio foi recebido.
shipped
A transportadora informou que o envio foi despachado.

Adicionar um número de rastreamento

É fundamental que os vendedores forneçam o número de rastreamento de seus envios para que os compradores possam saber o status de seus pacotes e o tempo de entrega estimado.
Você só deve realizar uma solicitação PUT ao envio com os atributos service_id e tracking_number.

 curl -X PUT -H "Content-Type: application/json" -d  ‘{
  "tracking_number": "TR1234567891",
  "service_id": 1
}’  https://api.mercadolibre.com/shipments/:shipment_id?access_token=&ACCESS_TOKEN

Atualizar o status do envio

Para atualizar o status do envio no pedido, é preciso fazer uma solicitação PUT ao envio.
Para conhecer o shipment_id, você pode fazer uma chamada para pedidos deste modo:

Exemplo

 curl -X GET https://api.mercadolibre.com/orders/{Order_id}/shipments

O status inicial do envio é “pending”. Assim que for identificado o shipping_id, ele poderá ser atualizado para outro status.

Atualizar o status para handling

Exemplo

 curl -X PUT -H "Content-Type: application/json" -d '{"status": "handling"}' https://api.mercadolibre.com/shipments/{Shipment_id}

Atualizar o estado para shipped

Exemplo

 curl -X PUT -H "Content-Type: application/json" -d '{shipping_option: {id:27569508},receiver_address: {"contact":"Roberto Gomez Bolaño","phone":"12345", address_line:"Avenida siempre viva updated", comment:"Casa azul.",zip_code:"90040060", "city": {"id": "TUxCQ1BPUjgwZTJl","name": "Porto Alegre"}, "state": {"id": "BR-RS","name": "Rio Grande do Sul"}, country: {id:"BR", name:"Argentina"}}}' https://api.mercadolibre.com/shipments/{Shipment_id}

Please rate this