Recursos Cross
Confira os principais recursos das nossas APIs
Documentação
Você pode usar esta documentação para as seguintes unidades de negócio:
Última atualização em 23/08/2023
O que é Mercado Envios 1
Publicar um item novo com ME1
No momento de realizar o POST, informe o modo de envio e as dimensões. Para isso, você deve incluir os seguintes campos no body da publicação:
[...]
"shipping":{
"local_pick_up":false,
"mode": "me1",
"dimensions":"10x10x20,700"
}
[…]As dimensões são em centímetros e o peso em gramas.
Ative ME1 para um item já publicado
Para um item já publicado, mas como CUSTOM ou Entrega a combinar com o vendedor, deve-se fazer uma PUT informando as dimensões, peso e tipo de envio:
Chamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d '{
"shipping":{
"local_pick_up":false,
"mode":"me1",
"dimensions":"$alturax$anchurax$longitud,$peso"
}
}'
https://api.mercadolibre.com/items/$ITEM_IDExemplo:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d '{
"shipping":{
"local_pick_up":false,
"mode": "me1",
"dimensions":"10x10x20,70"
}
}'
https://api.mercadolibre.com/items/MLA879036495Resposta:
{
"id": "MLA879036495",
"site_id": "MLA",
"title": "Test No Comprar - Aire Acondicionado 3000 Frigorías",
"subtitle": null,
"seller_id": 645417996,
"category_id": "MLA1644",
"official_store_id": null,
"price": 50000,
"base_price": 50000,
"original_price": null,
"inventory_id": null,
"currency_id": "ARS",
"initial_quantity": 15,
"available_quantity": 12,
"sold_quantity": 3,
"sale_terms": [
{
"id": "WARRANTY_TYPE",
"name": "Tipo de garantía",
"value_id": "2230279",
"value_name": "Garantía de fábrica",
"value_struct": null,
"values": [
{
"id": "2230279",
"name": "Garantía de fábrica",
"struct": null
}
]
},
{
"id": "WARRANTY_TIME",
"name": "Tiempo de garantía",
"value_id": null,
"value_name": "6 meses",
"value_struct": {
"unit": "meses",
"number": 6
},
"values": [
{
"id": null,
"name": "6 meses",
"struct": {
"number": 6,
"unit": "meses"
}
}
]
}
],
"buying_mode": "buy_it_now",
"listing_type_id": "gold_special",
"start_time": "2020-09-16T15:06:56.000Z",
"stop_time": "2040-09-11T04:00:00.000Z",
"end_time": "2040-09-11T04:00:00.000Z",
"expiration_time": "2021-01-11T19:28:44.000Z",
"condition": "new",
"permalink": "http://articulo.mercadolibre.com.ar/MLA-879036495-test-no-comprar-aire-acondicionado-3000-frigorias-_JM",
"pictures": [
{
"id": "790234-MLA43483081743_092020",
"url": "http://mla-s2-p.mlstatic.com/790234-MLA43483081743_092020-O.jpg",
"secure_url": "https://mla-s2-p.mlstatic.com/790234-MLA43483081743_092020-O.jpg",
"size": "246x120",
"max_size": "246x120",
"quality": ""
}
],
"video_id": null,
"descriptions": [],
"accepts_mercadopago": true,
"non_mercado_pago_payment_methods": [],
"shipping": {
"mode": "me1",
"local_pick_up": false,
"free_shipping": false,
"methods": [],
"dimensions": "10x10x20,700",
"tags": [
"optional_me1_chosen"
],
"logistic_type": "default",
"store_pick_up": false
},
"international_delivery_mode": "none",
"seller_address": {
"id": 1131257838,
"comment": "",
"address_line": "falsa 123",
"zip_code": "6000",
"city": {
"id": "",
"name": "junin"
},
"state": {
"id": "AR-B",
"name": "Buenos Aires"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": -34.5885499,
"longitude": -60.94955400000001,
"search_location": {
"neighborhood": {
"id": "",
"name": ""
},
"city": {
"id": "TUxBQ0pVTjE5NjM",
"name": "Junín"
},
"state": {
"id": "TUxBUFpPTmFpbnRl",
"name": "Buenos Aires Interior"
}
}
},
"seller_contact": null,
"location": {},
"geolocation": {
"latitude": -34.5885499,
"longitude": -60.94955400000001
},
"coverage_areas": [],
"attributes": [
{
"id": "ENERGY_EFFICIENCY",
"name": "Eficiencia energética",
"value_id": "98473",
"value_name": "A",
"value_struct": null,
"values": [
{
"id": "98473",
"name": "A",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "AIR_CONDITIONER_TYPE",
"name": "Tipo de aire acondicionado",
"value_id": "290203",
"value_name": "Split",
"value_struct": null,
"values": [
{
"id": "290203",
"name": "Split",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "SEER",
"name": "SEER",
"value_id": "-1",
"value_name": null,
"value_struct": null,
"values": [
{
"id": "-1",
"name": null,
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "COLOR",
"name": "Color",
"value_id": "52055",
"value_name": "Blanco",
"value_struct": null,
"values": [
{
"id": "52055",
"name": "Blanco",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "FRIGORIAS",
"name": "Frigorías",
"value_id": null,
"value_name": "3000 fg",
"value_struct": {
"unit": "fg",
"number": 3000
},
"values": [
{
"id": null,
"name": "3000 fg",
"struct": {
"number": 3000,
"unit": "fg"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "ITEM_CONDITION",
"name": "Condición del ítem",
"value_id": "2230284",
"value_name": "Nuevo",
"value_struct": null,
"values": [
{
"id": "2230284",
"name": "Nuevo",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "COOLING_CAPACITY",
"name": "Capacidad de refrigeración",
"value_id": null,
"value_name": "3520 W",
"value_struct": {
"unit": "W",
"number": 3520
},
"values": [
{
"id": null,
"name": "3520 W",
"struct": {
"number": 3520,
"unit": "W"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "INSTALLATION_PLACEMENTS",
"name": "Lugares de colocación",
"value_id": null,
"value_name": "Pared",
"value_struct": null,
"values": [
{
"id": null,
"name": "Pared",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "HEATING_CAPACITY",
"name": "Capacidad de calefacción",
"value_id": null,
"value_name": "3520 W",
"value_struct": {
"unit": "W",
"number": 3520
},
"values": [
{
"id": null,
"name": "3520 W",
"struct": {
"number": 3520,
"unit": "W"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "SELLER_SKU",
"name": "SKU",
"value_id": null,
"value_name": "116078",
"value_struct": null,
"values": [
{
"id": null,
"name": "116078",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "MODEL",
"name": "Modelo",
"value_id": null,
"value_name": "F3000-T",
"value_struct": null,
"values": [
{
"id": null,
"name": "F3000-T",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "BRAND",
"name": "Marca",
"value_id": "8039499",
"value_name": "Tedge",
"value_struct": null,
"values": [
{
"id": "8039499",
"name": "Tedge",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "GTIN",
"name": "Código universal de producto",
"value_id": null,
"value_name": "1234567890418",
"value_struct": null,
"values": [
{
"id": null,
"name": "1234567890418",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "AIR_CONDITIONING_TYPE",
"name": "Tipo de climatización",
"value_id": "83445",
"value_name": "Frío/Calor",
"value_struct": null,
"values": [
{
"id": "83445",
"name": "Frío/Calor",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
}
],
"warnings": [],
"listing_source": "",
"variations": [],
"thumbnail_id": "790234-MLA43483081743_092020",
"thumbnail": "http://mla-s2-p.mlstatic.com/790234-MLA43483081743_092020-I.jpg",
"secure_thumbnail": "https://mla-s2-p.mlstatic.com/790234-MLA43483081743_092020-I.jpg",
"status": "active",
"sub_status": [],
"tags": [
"cart_eligible",
"immediate_payment",
"poor_quality_picture",
"test_item"
],
"warranty": "Garantía de fábrica: 6 meses",
"catalog_product_id": null,
"domain_id": "MLA-AIR_CONDITIONERS",
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2020-09-16T15:06:56.000Z",
"last_updated": "2020-10-28T16:40:58.491Z",
"health": 0.83,
"catalog_listing": false,
"item_relations": []
}Consultar pedidos com ME1
Para identificar pedidos ME1, consulte o campo "modo" com o recurso /shipments/shipment_id/.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_IDExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/40070866801{
"id": 40070866801,
"mode": "me1",
"created_by": "receiver",
"order_id": 4001889439,
"order_cost": 99.9,
"base_cost": 22.07,
"site_id": "MLB",
"status": "shipped",
[…]
}Identifique a transportadora do pedido
Com o recurso anterior também é possível identificar a transportadora da venda:
[…]
{
"shipping_option":{
"id":101757341000001
[…]
}
[…]
}No exemplo, "17" é o código usado na planilha de custos ou enviado pela integração frete dinâmico para identificar a transportadora.
Alterar status e informar tracking number
Para oferecer uma experiência ME1 completa, recomendamos integrar o envio do número de rastreio (tracking number) e as alterações de status. Isso ajuda a reduzir reclamações e contatos do comprador perguntando onde está o pacote.
Alertas de fraude
Os pedidos do ME1 também podem ter alertas de fraude.Verifique se o pedido possui a tag fraud_risk_detected, pois neste caso o pedido não deve ser enviado ao comprador. Quando identificamos uma venda suspeita, alertamos o vendedor por front e por API por meio do feed de orders. Para mais informações, consulte nossa documentação de orders.
Configurar ME1 para usuários teste
Para começar a utilizar o Mercado Envios modo 1 em um usuário real, o vendedor deve contactar seu assessor comercial. Para testar o Mercado Envios modo 1 em um usuário de teste, primeiro insira um endereço válido na conta de seu usuário teste e depois configure no painel de configurações como endereço de venda. Em seguida, carregue os dados do seu usuário de teste no suporte para solicitar esta funcionalidade.
Próximo: Status de pedido e rastreamento.