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

Importante:
Recomendamos consultar até 50 (cinquenta) shipment_ids. A partir de 4 de agosto de 2020, se você exceder o valor máximo permitido, receberá um erro de 400.

No processo de venda, quando o comprador concluir sua compra (checkout), o vendedor deverá imprimir a etiqueta pré-paga para fazer o envio. Essa tag pode ser um arquivo PDF ou ZPL e pode ser obtida consultando o recurso shipment_labels.
Faça a seguinte chamada GET com a lista de IDs de envios (shipping_id) e um access token. Quando o status dos envios seja ready_to_ship você saberá que o pagamento foi processado e a etiqueta pré-paga está disponível.

Para obter etiquetas em formato PDF, faça 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

Se você deseja as etiquetas no formato ZPL, altere response_type=pdf pelo response_type=zpl2:

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

Este recurso retorna um arquivo ZIP que inclui um PDF com o PLP e um arquivo TXT da Zebra Printer.

Nota:
Para reimprimir a etiqueta, execute 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