Tipos de publicação e atualização de anúncios

Dependendo do nível de exposição que você deseja para seus artigos, você poderá escolher entre diferentes tipos de publicação. Cada tipo de publicação tem suas próprias caraterísticas e feeds. Vejamos como trabalhar corretamente com eles.

Conteúdos

→Tipos de anúncios por site
    ↳Mercado Libre Argentina, Brasil, Chile, México y Colombia
    ↳Mercado Libre Perú, Venezuela y Uruguay
→Especificações do tipo de anuncio
→Tipos de anúncios disponíveis
→Exposições das publicações
→Atualizações disponíveis
→Baixar um anúncio a um tipo de publicação inferior (downgrades)


Tipos de anúncios por site

Você precisa que ter em conta que cada site tem seus próprios tipos de publicação. Para ver todos os tipos de publicação de um site, você deve realizar uma chamada GET aos recursos listing_types com o Site_id:


Exemplo:

https://api.mercadolibre.com/sites/MLC/listing_types

Resposta:

[
  {
    "site_id": "MLC",
    "id": "gold_pro",
    "name": "Premium"
  },
  {
    "site_id": "MLC",
    "id": "gold_premium",
    "name": "Oro Premium"
  },
  {
    "site_id": "MLC",
    "id": "gold_special",
    "name": "Clásica"
  },
  {
    "site_id": "MLC",
    "id": "gold",
    "name": "Oro"
  },
  {
    "site_id": "MLC",
    "id": "silver",
    "name": "Plata"
  },
  {
    "site_id": "MLC",
    "id": "bronze",
    "name": "Bronce"
  },
  {
    "site_id": "MLC",
    "id": "free",
    "name": "Gratuita"
  }
]

Em determinados sites os tipos de anúncios sofreram mudanças, para saber quais são sugerimos revisar a seguinte novidade. Na API ainda pode se ver os anteriores, que serão mapeados automaticamente para que não tenha erros em sua integração. Sugerimos publicar da seguinte forma:


Mercado Libre Argentina, Brasil, Chile, México y Colombia

gold_pro: Premium
gold_special: Clásica
free: Gratuita


Mercado Libre Perú, Venezuela y Uruguay

gold_special: Premium
bronze: Clásica
free: Gratuita

Nota:
Nos outros sites pode se utilizar qualquer dos listings da API.

Especificações do tipo de anuncio

Você precisa que ter em conta que cada site tem seus próprios tipos de publicação. Para ver todos os tipos de publicação de um site, você deve realizar uma chamada GET aos recursos listing_types com o Site_id:


Exemplo:

curl -X GET https://api.mercadolibre.com/sites/MLA/listing_types/bronze

Resposta:

{
  "id": "bronze",
  "not_available_in_categories": [
    "MLA1743",
    "MLA1459"
  ],
  "configuration": {
    "name": "Bronce",
    "listing_exposure": "low",
    "requires_picture": false,
    "max_stock_per_item": 9999,
    "deduction_profile_id": null,
    "differential_pricing_id": null,
    "duration_days": {
      "buy_it_now": 60,
      "auction": 7,
      "classified": null
    },
    "immediate_payment": {
      "buy_it_now": false,
      "auction": false,
      "classified": false
    },
    "mercado_pago": "mandatory",
    "listing_fee_criteria": {
      "min_fee_amount": 0,
      "max_fee_amount": 0,
      "percentage_of_fee_amount": 0,
      "currency": "ARS"
    },
    "sale_fee_criteria": {
      "min_fee_amount": 0,
      "max_fee_amount": 100000000000000000,
      "percentage_of_fee_amount": 11,
      "currency": "ARS"
    }
  },
  "exceptions_by_category": [
    {
      "category_id": "MLA1540",
      "category_name": "Servicios",
      "configuration": {
        "name": "Básico 90",
        "listing_exposure": "mid",
        "requires_picture": false,
        "max_stock_per_item": 999,
        "deduction_profile_id": null,
        "differential_pricing_id": null,
        "duration_days": {
          "buy_it_now": null,
          "auction": null,
          "classified": 90
        },
        "immediate_payment": {
          "buy_it_now": false,
          "auction": false,
          "classified": false
        },
        "mercado_pago": "not_available",
        "listing_fee_criteria": {
          "min_fee_amount": 347,
          "max_fee_amount": 347,
          "percentage_of_fee_amount": 0,
          "currency": "ARS"
        },
        "sale_fee_criteria": {
          "min_fee_amount": 0,
          "max_fee_amount": 0,
          "percentage_of_fee_amount": 0,
          "currency": null
        }
      },
      "exceptions_by_category": [
      ]
    }
  ]
}

Os itens Clássico e Premium terão duração ilimitada; você pode consultar no campo stop_time:

curl -X GET https://api.mercadolibre.com/items/MCO415406202?attributes=stop_time

Além disso, esses anúncios serão pausados caso o estoque for 0 e serão ativados quando uma nova quantidade for adicionada. Você vai visualizar o item assim:

"status": "paused",
  "sub_status": [
    "out_of_stock"
  ]

Se você quiser adicionar estoque e ativar novamente o item, deverá fazer o seguinte:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "available_quantity": 1
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Lembre que o tipo de anúncio Gratuito vai manter o fluxo atual. O vendedor poderá trocar entre os tipos de anúncio Clássico e Premium toda vez que desejar sem custo algum, e poderá pausar e finalizar os itens da mesma maneira em que funciona agora.
Se você quiser trocar de Premium para Clássico, deverá seguir estes passos:

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "id": "gold"
}
https://api.mercadolibre.com/items/{Item_id}/listing_type?access_token=$ACCESS_TOKEN


Tipos de anúncios disponíveis

Você pode consultar os tipos de publicação disponíveis por usuário e para um category_id determinado.


Exemplo:

https://api.mercadolibre.com/users/{Cust_id}/available_listing_types?category_id={Category_id}&access_token=$ACCESS_TOKEN

Resposta:

{
  "category_id": "MLC3530",
  "available": [
  {
    "site_id": "MLC",
    "id": "gold_premium",
    "name": "Oro Premium",
    "remaining_listings": null
  },
  {
    "site_id": "MLC",
    "id": "gold",
    "name": "Oro",
    "remaining_listings": null
  },
  {
    "site_id": "MLC",
    "id": "silver",
    "name": "Plata",
    "remaining_listings": null
  },
  {
    "site_id": "MLC",
    "id": "bronze",
    "name": "Bronce",
    "remaining_listings": null
  },
  {
    "site_id": "MLC",
    "id": "free",
    "name": "Gratuita",
    "remaining_listings": null
  }
  ]
}

Se você não consegue publicar em certos tipo de anúncio e quer saber porque não consegue, você pode realizar uma chamada GET para verificar o motivo.


Exemplo:

https://api.mercadolibre.com/users/{Cust_id}/available_listing_type/free?category_id={Category_id}&access_token=$ACCESS_TOKEN

Resposta:

{
  "available": false,
  "cause": "You have more than 5 transactions in the last year.",
  "code": "list.transactions.exceeded"
}


Exposições das publicações

Este recurso da nossa API devolve informação sobre os níveis de exposição associados a todos os tipos de publicações no Mercado Livre. Você pode consultar todas as exposições disponíveis para as publicações por site, com uma chamada GET simples.


Exemplo:

https://api.mercadolibre.com/sites/MLA/listing_exposures

Resposta:

{[
  {
  "id": "lowest",
  "name": "Última",
  "home_page": false,
  "category_home_page": false,
    "advertising_on_listing_page": true,
  "priority_in_search": 4
  },
  {
  "id": "low",
  "name": "Inferior",
  "home_page": false,
  "category_home_page": false,
    "advertising_on_listing_page": false,
  "priority_in_search": 3
  },
  {
  "id": "mid",
  "name": "Media",
  "home_page": false,
  "category_home_page": true,
  "advertising_on_listing_page": false,
  "priority_in_search": 2
  },
  {
  "id": "high",
  "name": "Alta",
  "home_page": false,
  "category_home_page": true,
    "advertising_on_listing_page": false,
  "priority_in_search": 1
  },
  {
  "id": "highest",
  "name": "Superior",
  "home_page": true,
  "category_home_page": true,
    "advertising_on_listing_page": false,
  "priority_in_search": 0
  }
]

E fazer uma consulta por seu ID:


Exemplo:

https://api.mercadolibre.com/sites/MLA/listing_exposures/high

Resposta:

{
  "id": "high",
  "name": "Alta",
  "home_page": false,
  "category_home_page": true,
  "advertising_on_listing_page": false,
  "priority_in_search": 1
}


Atualizações disponíveis

Você pode atualizar seu anúncio para uma exposição maior apenas uma vez. Se precisa realizar outras atualizações, você pode ver que tipos de exposição estão disponíveis para seu anúncio.


Exemplo:

https://api.mercadolibre.com/items/{Item_id}/available_upgrades?access_token=$ACCESS_TOKEN

Resposta:

[
  {
  "site_id": "MLC",
  "id": "gold_premium",
  "name": "Oro Premium"
  },
  {
  "site_id": "MLC",
  "id": "gold",
  "name": "Oro"
  },
  {
  "site_id": "MLC",
  "id": "silver",
  "name": "Plata"
  }
]

Muito bem! Agora você está pronto para acessar a exposições corretas para seus produtos e realizar atualizações. Como sabemos que às vezes você precisa mais de uma tentativa para realizar sua publicação, te oferecemos a possibilidade de validar o seu artigo antes de tentar uma publicação. Por favor, leia este artigo para mais informações sobre o nosso validador de publicações.


Baixar um anúncio a um tipo de publicação inferior (downgrades)

Downgrade é reduzir a exposição de um anúncio ao atualizá-lo em um tipo de publicação inferior. Está disponível para alguns casos particulares:

  • Está permitido realizar downgrades nos anúncios entre gold_pro a gold_special.
  • Antes de começar, você pode realizar downgrades para as publicações em payment_required.
  • Não está permitido realizar downgrade de um anúncio gratuito.
ou registre-se para receber as últimas notícias sobre nossa API