Recursos Cross

Confira os principais recursos das nossas APIs
circulos azuis em degrade

Documentação do

Você pode usar esta documentação para as seguintes unidades de negócio:

Última atualização em 14/05/2024

Moderações com pausa

Diferente das moderações com status under_review, no Mercado Livre também pausamos publicações por diferentes motivos, como:

  • Alteração incomum de preço: quando o vendedor modifica por erro o preço.
  • Itens sem vendas ou abandonados: quando o vendedor tem itens sem vendas.
  • Carregar imagens por URL: quando o vendedor publica imagens por URL e estas ainda não são processadas.

Para estes casos, o vendedor poderá revisar e ativar o item.


Fluxo recomendado


Consultar moderações com itens pausados

Realize uma busca de publicações com status: paused e a tag moderation_penalty. Para ativá-la, devemos realizar um PUT a /items com status: active, já que este tipo de moderação preventiva apenas pausa a publicação.


Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/0123456789/items/search?tags=moderation_penalty&status=paused

Resposta:

{
   "seller_id": "0123456789",
   "paging": {...},
   "results": [
       "MLA1147839589",
       "MLA1148439168",
       "MLA1149506534",
       "MLA1157034561",
       "MLA1164314507",
       "MLA1173423437"
   ],
   "orders": [...],
   "available_orders": [...]
}

Quando identificar estes itens, você deve consultar suas moderações. Por exemplo:


Moderação por alteração incomum de preço

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/$USER_ID?related_item_id=$ITEM_ID

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/223456789?related_item_id=MLA135232000

Resposta:

{
  "infractions": [
      {
          "id": "1378710000",
          "date_created": "2023-09-11T10:37:45.107-0400",
          "user_id": "223456789",
          "related_item_id": "MLA135232000",
          "element_id": "MLA135232000",
          "element_type": "ITM",
          "site_id": "MLA",
          "filter_subgroup": "DESC",
          "reason": "La pausamos porque detectamos un cambio inusual en su precio. Verifica el valor antes de reactivarla. Una vez que lo hagas, quedará activa en unos minutos.",
          "remedy": "Inactiva para revisar
La pausamos porque detectamos un cambio inusual en su precio. Verificá el valor antes de reactivarla. Una vez que lo hagas, quedará activa en unos minutos." } ], "paging": { "offset": 0, "limit": 1, "total": 1 }, "sorting_type": "date_created_desc" }

Neste caso, recomendamos dar o acionável ao vendedor para ele corrigir preço e ativar o item.


Moderação de itens sem vendas

Os itens sem vendas e/ou sem visitas também podem ser pausados pelo Mercado Livre para evitar impactar a reputação do vendedor. Executando a mesma chamada anterior, obterá informação sobre este tipo de moderação. Conheçacomo gerenciar as publicações que não tiveram vendas em um período.


Examplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/453616000?related_item_id=MLA1363212345

Resposta:

{
  "infractions": [
      {
          "id": "1399670000",
          "date_created": "2023-09-20T09:32:57.409-0400",
          "user_id": "453616000",
          "related_item_id": "MLA1363212345",
          "element_id": "MLA1363212345",
          "element_type": "ITM",
          "site_id": "MLA",
          "filter_subgroup": "PP",
          "reason": "La pausamos porque no tuvo ventas durante un largo periodo de tiempo. Lo hicimos para ayudarte en la gestión y evitarte cancelaciones.",
          "remedy": "Inactiva para revisar
Si todavía querés vender tu publicación, revisala para verificar que esté actualizada y reactivala para que vuelva a estar a la venta, o podés eliminarla si ya no vendés." } ], "paging": { "offset": 0, "limit": 20, "total": 1 }, "sorting_type": "date_created_desc" }

Neste caso recomendamos dar o acionável ao vendedor para que ele revise a publicação e verifique se está atualizada, e assim possa reativá-la para voltar a vender ou a exclua se já não vende esse produto.


Carregar imagens por URL

Nota VIS:
A partir do dia 27 de maio (em MCO, MLM e MLA) e do dia 04 de junho (em MLC e MLB), quando o vendedor realizar o upload de imagens por URL, a publicação ficará com o status "not_yet_active" e substatus: "picture_downloading_pending" enquanto o Mercado Livre processa e valida o download de todas as imagens.

Na criação de um novo item, se as imagens são do tipo source (URL), o item ficará com o status "paused" (para itens de Marketplace) ou status: "not_yet_active" (para itens de VIS) pausado, e com o sub_status: picture_downloading_pending para indicar ao vendedor que ainda não foram baixadas. Quando as imagens são baixadas corretamente, o item terá status active automaticamente.
Lembre-se que cada imagem será válida sempre que a sua dimensão seja no mínimo 250px em ambos lados (width y height) e ao menos um lado com mais de 500px.


Resposta:

{
    "infractions": [
        
        {
            "id": "1467440394",
            "date_created": "2023-10-10T19:01:02.73-0400",
            "user_id": "453616456",
            "related_item_id": "MLA1373668879",
            "element_id": "MLA1373668879",
            "element_type": "ITM",
            "site_id": "MLA",
            "filter_subgroup": "FOTOS",
            "reason": "La pausamos temporalmente porque estamos verificando que tu foto se haya cargado correctamente.",
            "remedy": "

La pausamos temporalmente porque estamos verificando que tu foto se haya cargado correctamente.

" }

Se a imagem não pode ser baixada após um período definido, o item ficará moderado com status: under_review, sub_status: picture_downloading_pending.



Resposta:

        {
            "id": "1467963806",
            "date_created": "2023-10-10T20:13:18.009-0400",
            "user_id": "453616456",
            "related_item_id": "MLA1373668879",
            "element_id": "MLA1373668879",
            "element_type": "ITM",
            "site_id": "MLA",
            "filter_subgroup": "FOTOS",
            "reason": "La foto no se cargó correctamente. Corregila para reactivar tu publicación.",
            "remedy": "

La foto no se cargó correctamente. Corrígela para reactivar tu publicación.

" },

Neste caso recomendamos dar o acionável ao vendedor para ele carregar novamente a imagem já que ela não pode ser processada (link inválido de imagem).



Próxima: Moderações de Imagens.