Recursos Cross
Confira os principais recursos das nossas APIs
Documentação do
Você pode usar esta documentação para as seguintes unidades de negócio:
Moderações com pausa
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=pausedResposta:
{
"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_IDExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/223456789?related_item_id=MLA135232000Resposta:
{
"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=MLA1363212345Resposta:
{
"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
Ao criar um novo item, quando o carregamento das imagens for do tipo source (via URL), enquanto o Mercado Livre processa e valida o download de todas as imagens, o estado e subestado das publicações ficarão:
- Para publicações em marketplace:
• com “status”: "paused" e “substatus”: “picture_download_pending”. - Para publicações de imóveis e veículos:
• comn “status”: "paused" e “substatus”: “picture_download_pending” para vendedores com "user_type": "normal".
• com “status”: "not_yet_active"e “substatus”: “picture_download_pending” para vendedores com "user_type": "real_estate_agency" ou "user_type": "car_dealer".
Quando as imagens forem baixadas corretamente, o item terá “status”: “active” automaticamente. Nos casos em que as imagens não puderem ser baixadas dentro de um período de tempo definido ou se a imagem baixada estiver abaixo das dimensões mínimas esperadas, o item será moderado com “status”: “under_review” e “sub_status”: “picture_download_pending”.
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.