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.

Conteúdos

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/

Uruguay:  https://envios.mercadolibre.com.uy/


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)

curl -X GET https://api.mercadolibre.com/users/user_id/shipping_preferences

{
  "local_pick_up": false,
  "modes": [
    "custom",
    "not_specified",
    "me1",
    "me2"
  ],
  "trusted_user": true,
  "custom_calculator": false,
  "picking_type": "cross_docking",
  "thermal_printer": null,
  "option": "in",
  "tags": [
  ],
  "carrier_pickup": false,
  "items_combination": "enabled",
  "services": [
    311,
    591,
    671,
    801,
    881,
    1181,
    1191,
    136261
  ],
  "logistics": [
    { 
      "mode": "me1",
      "types": [
        {
          "type": "default",
          "carrier_pickup": [],
          "services": [
            21,
            23,
            22,
            11
          ],
          "default": true
        }
      ]
    },

      {"mode": "me2",
      "types": [
        {
          "type": "cross_docking",
          "carrier_pickup": [
            17501840
          ],
          "services": [
            311,
            591,
            671,
            801,
            881,
            1181,
            1191
          ],
          "default": false
        },
        {
          "type": "self_service",
          "carrier_pickup": [
          ],
          "services": [
            136261
          ],
          "default": false
        }
      ]
    },
    {
      "mode": "custom",
      "types": [
        {
          "type": "custom",
          "carrier_pickup": [
          ],
          "services": null,
          "default": true
        }
      ]
    },
    {
      "mode": "not_specified",
      "types": [
        {
          "type": "not_specified",
          "carrier_pickup": [
          ],
          "services": null,
          "default": true
        }
      ]
    }
  ],
  "content_declaration_disabled": false,
  "conciliation": {
    "type": null
  },
  "mandatory_invoice_data": false,
  "site_id": "MLA",
  "free_configurations": [
    {
      "condition": {
        "value": null,
        "type": "all"
      },
      "rule": {
        "default": true,
        "free_mode": "country",
        "value": null
      }
    }
  ],
  "mandatory_settings": {
  }
}

"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
}

Importante Atualmente, temos regras que avaliam as dimensões do produtos, despachados; uma vez que o anúncio não cumpra as dimensões do anúncio, o mesmo ganhará uma tag "dimensions_exceeded", repercutindo na eliminação da opção de Mercado Envios deste anúncio.
Lembramos, que esta tag é incluída a partir de reportes recebidos dos correios. E os Correios, atualmente trabalham com o cálculo de metros cúbicos, por isso essa informação é tão importante.
Caso o vendedor queira validar alguma tratativa para estes ítems terá que entrar em contato via Portal de ajuda e verificar o tema diretamente com a equipe de atendimento de ME.


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.

Para produtos a partir de R$120,00, é aplicado frete grátis devido ao benefício do Mercado Pontos. Este é aplicado automaticamente pelo Mercado Livre. Na alteração do preço de um produto para valores abaixo de R$120,00, o vendedor deve verificar se quer permanecer com frete grátis ou retirá-lo. Esta opção não será retirada automaticamente pelo Mercado Livre.


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.


Nota
: Recomendamos não interferir no formato padrão da sua etiqueta, pois isso pode afetar no reconhecimento do envio pelo transportador e isso acarretará em uma série de problemas ao seller, devido aos possíveis atrasos de entrega, que afetam na reputação.


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.
Notas:

  • se você quiser imprimir novamente a etiqueta, só deverá realizar o mesmo GET.

  • Para um uso correto do recurso, sugerimos fazer a chamada com um limite de 40 shipping Ids.


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)
  • Uruguay (MLU)
response_type=pdf etiqueta pdf
ZPL2 Impresora térmica
  • Argentina (MLA)
  • México (MLM)
  • Brasil (MLB)
  • Chile (MLC)
  • Uruguay (MLU)
response_type=zpl2 arquivo zip com etiqueta no formato txt e resumo da impressão no formato 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.


Como gerar a nota fiscal de venda

Para conhecer como gerar a nota fiscal de venda pode acceder à seguinte documentação.


Como obter o CT-e

O CT-e é um conhecimento de transporte eletrônico, para controle fiscal de envios entre cidades e estados que serve para vendedores de XD e FBM em vendas fechadas “Delivered” e abertas “Shipped”. Aclarações:

  • Entregas na mesma cidade não necessitam.

  • Em caso de dúvidas sobre cómo utilizar o CT-e, o sellers deve procurar seu contador.

Para baixar o CTe de três maneiras pode fazê-lo da seguinte maneira: Em XML:

curl - X GET https://api.mercadolibre.com/shipments/{shipmentId}/cte?doctype=xml&access_token={token}

Em PDF:

curl - X GET https://api.mercadolibre.com/shipments/{shipmentId}/cte?doctype=pdf&access_token={token}

Ou ambos:

curl - X GET https://api.mercadolibre.com/shipments/{shipmentId}/cte?access_token={token}

Exemplo (CTe em XML)

curl - X GET https://api.mercadolibre.com/shipments/123456789/cte?doctype=xml&access_token=APP_USR-XXXXXXXXXXXX-12345-3be6abe9f76e4b1b10860aeb345aeb21-12345678

Faça parte da nossa comunidade