Mercado Envios modo 2

Você já conhece algumas das particularidades do modo Mercado Envios 2. Este tutorial ajudará você a publicar um produto usando esse modo e gerenciar o processo de envio usando recursos de nossa API.
Leve em conta que as dimensões dos pacotes são estipuladas por ME2 e não podem ser alteradas pelo usuário.

Assuntos

Opção pelo ME2

Se quiser, você pode optar pelo uso do Mercado Envios no modo 2. Consulte os links abaixo:
Argentina: http://envios.mercadolibre.com.ar/
Brasil: http://envios.mercadolivre.com.br/
Colômbia: http://envios.mercadolibre.com.co/
México: http://envios.mercadolibre.com.mx/
Chile: http://envios.mercadolibre.cl/

Oferecer ME2 em seus produtos

Depois que fizer a opção de trabalhar com o ME, você poderá adicionar essa opção a seus produtos. Quando um comprador adquirir seu produto, ele precisará colocar um endereço ao finalizar e pagar pelo produto, incluindo o custo do envio.
O Mercado Envios realizará o rastreamento do pacote e verificará se chegou ao destino certo.
O dinheiro do pagamento será disponibilizado em sua conta dois dias depois da entrega.
Você poderá adicionar o frete grátis a seus produtos, impulsionando suas publicações na busca.

Publicar um anúncio usando ME2 é muito simples; você só tem de publicar um anúncio na forma habitual, incluindo me2 no conjunto do envio.
Exemplo:

 curl -X POST -H "Content-Type: application/json" -d '{
    "title": "Item de teste",
    "category_id": "MLA91727",
    "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": {
   "mode": "me2",
   "local_pick_up": false,
   "free_shipping": false,
   "free_methods": []
 }
}' https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN

Leve em conta que para anunciar em categorias marcadas como Frágil, o usuário também deverá estar marcado como “frágil”; para tal, deverá ter um acordo comercial.
Nas seguintes chamadas da API você deverá validar os campos como se mostra abaixo:

“trusted_user”: true (API users)

https://api.mercadolibre.com/users/255198776/shipping_preferences
{
  "local_pick_up": false,
  "modes": [
    "custom",
    "not_specified",
    "me2"
  ],
  "free_configurations": [
    {
      "condition": {
        "value": null,
        "type": "all"
      },
      "rule": {
        "default": true,
        "free_mode": "country",
        "value": null
      }
    }
  ],
  "trusted_user": true,
  "mandatory_settings": {
  },
  "custom_calculator": false,
  "picking_type": null,
  "thermal_printer": null,
  "option": "trial",
  "site_id": "MCO",
  "tags": [
  ],
  "carrier_pickup": false,
  "items_combination": "forbidden",
  "logistics": [
    {
      "mode": "me2",
      "types": [
        {
          "type": "drop_off",
          "carrier_pickup": [
          ],
          "services": [
            201
          ],
          "default": true
        }
      ]
    },
    {
      "mode": "custom",
      "types": [
        {
          "type": "custom",
          "carrier_pickup": [
          ],
          "services": null,
          "default": true
        }
      ]
    },
    {
      "mode": "not_specified",
      "types": [
        {
          "type": "not_specified",
          "carrier_pickup": [
          ],
          "services": null,
          "default": true
        }
      ]
    }
  ],
  "services": [
    201
  ]
}

“restricted”: true (API category)

https://api.mercadolibre.com/categories/MCO7159/shipping_preferences
{
  "category_id": "MCO7159",
  "dimensions": {
    "weight": 50000,
    "height": 20,
    "width": 60,
    "length": 130
  },
  "logistics": [
    {
      "types": [
        "default"
      ],
      "mode": "me1"
    },
    {
      "types": [
        "drop_off",
        "xd_drop_off",
        "cross_docking",
        "fulfillment"
      ],
      "mode": "me2"
    },
    {
      "types": [
        "not_specified"
      ],
      "mode": "not_specified"
    },
    {
      "types": [
        "custom"
      ],
      "mode": "custom"
    }
  ],
  "restricted": true
}

Frete grátis

Os vendedores podem publicar seus produtos oferecendo um dos modos de frete grátis, e o Mercado Livre cobrará do vendedor o custo do frete. Conheça os detalhes e sabia como publicar no modo frete grátis.

Calculadora de frete e tempo de processamento

O ML disponibilizará aos vendedores uma calculadora de fretes na página de descrição dos produtos. Assim, os compradores saberão o custo do frete e o tempo estimado de processamento.
Você pode utilizar nossos recursos para calcular o frete com base nas informações disponíveis.

Impressão de etiquetas de envio

Uma etiqueta de pré-pagamento é um arquivo PDF que pode ser gasto na entrega de seu produto. Ele já foi pago pelo comprador quando ao finalizar a transação. Logo depois do pagamento do pedido, você deverá imprimir a etiqueta de pré-pagamento.
Para obter essa etiqueta, o status dos envios deve ser ready_to_ship (verifique como consultar o status do envio). Isso quer dizer que o pagamento foi processado e a etiqueta de pré-pagamento está disponível para o vendedor.
A API para a obtenção de uma etiqueta, ou uma série de etiquetas, recebe uma lista dos IDs de envio e um token de acesso, retornando as etiquetas no formato de sua preferência. As opções são PDF ou ZPL.
Para obter a etiqueta de envio no formato PDF, execute a seguinte chamada:

 https://api.mercadolibre.com/shipment_labels?shipment_ids=20178600648,20182100995&response_type=pdf&access_token=

A resposta será um arquivo PDF com uma ou mais etiquetas de envio pré-pago prontas para impressão.

Se quiser obter as etiquetas de envio no formato ZPL, você deverá alterar response_type=pdf para response_type=zpl2 na solicitação GET feita à API.

Exemplo:

 https://api.mercadolibre.com/shipment_labels?shipment_ids={shipping_id}&response_type=zpl2&access_token={access_token}

O recurso acima retorna um arquivo ZIP. O ZIP inclui um PDF com o PLP e um arquivo TXT. Agora você pode fazer a impressão do arquivo TXT de sua impressora Zebra.
Nota: se você quiser imprimir novamente a etiqueta, só deverá realizar o mesmo GET.

Impressora térmica Zebra (somente no Mercado Livre da Colômbia)

Se você trabalha no Mercado Livre Colômbia (MCO), existe outro formato de impressão disponível: as impressoras térmicas Zebra. Você poderá realizar a operação com a chamada a seguir:

 /shipment_labels?shipment_ids={shipping_id}&response_type=thermal_pdf&access_token={access_token}

O papel deve ser configurado nas dimensões 100 x 213 milímetros.
Nota:
Se seu sistema operacional for Microsoft Windows, utilize o driver: driver genérico somente texto.
autorizacao

Considerações sobre os tipos de etiquetas por local

Tipo de impressão Impressora Locais disponíveis Tipo de resposta Saída
PDF Impressora normal
  • Argentina (MLA)
  • México (MLM)
  • Brasil (MLB)
  • Colômbia (MCO)
  • Chile (MLC)
response_type=pdf etiqueta pdf
ZPL2 Impresora térmica
  • Argentina (MLA)
  • México (MLM)
  • Brasil (MLB)
  • Chile (MLC)
response_type=zpl2 arquivo zip com etiqueta no formato txt e resumo da impressão no formato pdf
Thermal PDF Impressora térmica
  • Colômbia (MCO)
response_type=thermal_pdf etiqueta PDF

Status do envio

O status do envio pode variar no pedido, dependendo do modo de envio selecionado para o produto. Nos modos que aceitam rastreamento automático e monitoramento dos números de rastreamento, atualizaremos o status do envio, enquanto nos outros modos de envio, você será responsável por enviar um número de rastreamento e pela atualização do status do envio. Embora não seja obrigatório, sugerimos fazer isso para melhorar suas chances de receber um melhor feedback dos compradores.
Status:
pending
O envio é criado com esse status.
handling
O pagamento do frete foi recebido.
ready_to_ship
O código de autorização da transportadora foi recebido .
shipped
A transportadora informou o encaminhamento do envio.
delivered
O envio foi informado pela transportadora.
not_delivered
A transportadora não conseguiu entregar o pacote.
cancelled
O envio foi cancelado.

Please rate this