Mercado Envíos modo 2
Conteúdos
→Opção pelo ME2 →Oferecer ME2 em seus produtos →Frete grátis →Calculadora de frete e tempo de processamento →Verifique a data de envio do produto →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 'Authorization: Bearer $ACCESS_TOKEN' -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
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 -H 'Authorization: Bearer $ACCESS_TOKEN' 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)
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 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
}
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.
Verifique a data de envio do produto
Para não ultrapassar a capacidade das transportadoras e que os compradores recebam os produtos em dia, é necessário que você verifique a data de envio desses. Identifique os envios desse tipo realizando um GET para /shipments, incorporando o header 'X-Format-New: true' verificando o nó “buffering”.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'X-Format-New: true' https://api.mercadolibre.com/shipments/$SHIPMENT_ID
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'X-Format-New: true' https://api.mercadolibre.com/shipments/40173236996
Resposta:
{
"id":40173236996,
"external_reference":null,
"status":"pending",
"substatus":"buffered",
"date_created":"2020-10-20T10:08:30.000-04:00",
"last_updated":"2020-10-20T15:09:22.000-04:00",
"declared_value":7000,
"dimensions":{
"height":14,
"width":19,
"length":38,
"weight":950
},
"logistic":{
"direction":"forward",
"mode":"me2",
"type":"xd_drop_off"
},
[]
"lead_time":{
"option_id":3628548109,
"shipping_method":{
"id":510545,
"name":"Express a domicilio",
"type":"two_days",
"deliver_to":"address"
},
"currency_id":"ARS",
"cost":0,
"list_cost":504.99,
"cost_type":"free",
"service_id":831,
"delivery_type":"estimated",
"estimated_schedule_limit":{
"date":null
},
"buffering":{
"date":"2020-10-21T20:18:26.000Z" ---> Data que você pode enviar
},
"estimated_delivery_time":{
"type":"known",
"date":"2020-10-22T00:00:00.000-03:00",
"unit":"hour",
"offset":{
"date":null,
"shipping":null
},
"time_frame":{
"from":null,
"to":null
},
"pay_before":"2020-10-21T00:00:00.000-03:00",
"shipping":24,
"handling":24,
"schedule":null
},
"estimated_delivery_limit":{
"date":null,
"offset":null
},
"estimated_delivery_final":{
"date":null,
"offset":null
},
"estimated_delivery_extended":{
"date":null,
"offset":null
},
"estimated_handling_limit":{
"date":"2020-10-21T00:00:00.000-03:00"
}
},
"tags":[
"test_shipment"
]
}
No campo "date" do buffering do nó "buffering" estará a data correspondente que o produto deve ser despachado e nesse mesmo dia disponibilizaremos a etiqueta para impressão.
Impressão de etiquetas de envio
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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipment_labels?shipment_ids=$SHIPPING_ID1,$SHIPPING_ID2&response_type=pdf
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipment_labels?shipment_ids=20178600648,20182100995&response_type=pdf
Se você deseja as etiquetas no formato ZPL, altere response_type=pdf pelo response_type=zpl2:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipment_labels?shipment_ids=$SHIPPING_ID&response_type=zpl2
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipment_labels?shipment_ids=20178600648&response_type=zpl2
Este recurso retorna um arquivo ZIP que inclui um PDF com o PLP e um arquivo TXT da Zebra Printer.
Considerações sobre os tipos de etiquetas por local
Tipo de impressão | Impressora | Locais disponíveis | Tipo de resposta | Saída |
---|---|---|---|---|
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. |