Mercado Envíos 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
→Oferecer ME2 em seus produtos
→Frete grátis
→Calculadora de frete e tempo de processamento
→Impressão de etiquetas de envio
→Considerações sobre os tipos de etiquetas por local
→Status do envio
→Como gerar a nota fiscal de venda
→Como obter o CT-e


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/

Colombia: 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.
Importante:
Para um uso correto do recurso, sugerimos fazer a chamada com um limite de 50 shipping IDs para não receber error 400 (Bad request).

Para obter a etiqueta de envio no formato PDF, execute a seguinte chamada:

curl -X GET https://api.mercadolibre.com/shipment_labels?shipment_ids=$SHIPPING_ID1,$SHIPPING_ID2&response_type=pdf&access_token=$ACCESS_TOKEN

Exemplo

curl -X GET https://api.mercadolibre.com/shipment_labels?shipment_ids=20178600648,20182100995&response_type=pdf&access_token=$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. Chamada:

curl -X GET https://api.mercadolibre.com/shipment_labels?shipment_ids=$SHIPPING_ID&response_type=zpl2&access_token=$ACCESS_TOKEN
Exemplo:

curl -X GET https://api.mercadolibre.com/shipment_labels?shipment_ids=20178600648&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.

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) y Uruguay (MLU). response_type=pdf Etiqueta PDF
ZPL2 Impressora térmica. Argentina (MLA), México (MLM), Brasil (MLB), Chile (MLC), Uruguay (MLU), Colombia (MCO). response_type=pdf 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 (pendiente): O envio é criado com esse status.

handling (en manejo): O pagamento do frete foi recebido.

ready_to_ship (listo para envío): O código de autorização da transportadora foi recebido.

shipped (enviado): A transportadora informou o encaminhamento do envio.

delivered (entregado): O envio foi informado pela transportadora.

not_delivered (no entregado): A transportadora não conseguiu entregar o pacote.

cancelled (cancelado): 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”.

Nota:
- 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

Seguinte: Convivência ME1/ME2