Publicações obrigatórias no catálogo

Um anúncio de marketplace é requerido para catálogo quando é elegível, por isso o Mercado livre modera o anúncio solicitando que publique e/ou aassocie no catálogo pelo optin para continuar vendendo este item.
Para alguns domínios é permitido publicar apenas produtos pelo catálogo, ou seja, se o item de marketplace já tem seu anúncio correspondente de catálogo associado, o item base de marketplace será inativado pelo Mercado Livre.
Antes de saber se um produto faz parte do catálogo, recomendamos consultar o recurso /products/search e identificar se tem que anunciá-lo no catálogo. Caso não possa anunciar ou associar ao catálogo, terá que marcar o anúncio ou variação para informar que não o encontrou no nosso catálogo, para isso, use o recurso /catalog_listing_eligibility/moderation_buybox/evaluate.

Reconhecer produtos antes da publicação

Antes de criar novas publicações, você deve reconhecer se o produto existe e está ativo no catálogo. Para isso, execute um GET no recurso /products/search com o filtro status e verifique a listing_strategy: catalog_required se o produto deve ser publicado no catálogo. Nesse caso, você pode:

Nota:
O vendedor poderá reconhecer as publicações necessárias no catálogo por família de produtos, ou seja, se ele decidir vender um “Apple iPhone 3G 8 GB Preto 128 MB RAM”, ele deverá associá-lo a uma publicação de catálogo, porque a família desse produto (iPhone 3) é ativo no catálogo. Caso o produto ou variação esteja dentro de uma família de produtos exigida no catálogo, mas suas características específicas não estejam no catálogo, você deve marcá-lo para evitar moderação.

Exemplo de produto necessário para catálogo:

{
    "keywords": " Apple iphone 3g",
    "domain_id": "MLA-CELLPHONES",
    "paging": {
        "total": 3,
        "limit": 10,
        "offset": 0
    },
    "results": [
        {
            "id": "MLA6005934",
            "status": "active",
            "domain_id": "MLA-CELLPHONES",
            "settings": {
                "listing_strategy": "catalog_required"
            },
            "name": "Apple iPhone iPhone 3G 8 GB Negro 128 MB RAM",
            "attributes": [
                {
                    "id": "BRAND",
                    "name": "Marca",
                    "value_id": "9344",
                    "value_name": "Apple"
                },
                {
                    "id": "LINE",
                    "name": "Línea",
                    "value_id": "58993",
                    "value_name": "iPhone"
                },
                {
                    "id": "MODEL",
                    "name": "Modelo",
                    "value_id": "14605",
                    "value_name": "iPhone 3G"
                },
                {
                    "id": "IS_DUAL_SIM",
                    "name": "Es Dual SIM",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "COLOR",
                    "name": "Color",
                    "value_id": "52049",
                    "value_name": "Negro"
                },
                {
                    "id": "INTERNAL_MEMORY",
                    "name": "Memoria interna",
                    "value_id": "59566",
                    "value_name": "8 GB"
                },
                {
                    "id": "RAM",
                    "name": "Memoria RAM",
                    "value_id": "579543",
                    "value_name": "128 MB"
                },
                {
                    "id": "MAIN_COLOR",
                    "name": "Color principal",
                    "value_id": "2450295",
                    "value_name": "Negro"
                },
                {
                    "id": "OPERATING_SYSTEM_NAME",
                    "name": "Nombre del sistema operativo",
                    "value_id": "7404961",
                    "value_name": "iOS"
                }
            ],
            "pictures": [
                {
                    "id": "675782-MLA31138875214_062019",
                    "url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-F.jpg"
                },
                {
                    "id": "915001-MLA31138546867_062019",
                    "url": "https://mla-s1-p.mlstatic.com/915001-MLA31138546867_062019-F.jpg"
                },
                {
                    "id": "881441-MLA31138332972_062019",
                    "url": "https://mla-s1-p.mlstatic.com/881441-MLA31138332972_062019-F.jpg"
                },
                {
                    "id": "804666-MLA31139286536_062019",
                    "url": "https://mla-s2-p.mlstatic.com/804666-MLA31139286536_062019-F.jpg"
                }
            ]
        },
        {
            "id": "MLA6007403",
            "status": "active",
            "domain_id": "MLA-CELLPHONES",
            "settings": {
                "listing_strategy": "catalog_required"
            },
            "name": "Apple iPhone iPhone 3G 16 GB Negro 128 MB RAM",
            "attributes": [
                {
                    "id": "BRAND",
                    "name": "Marca",
                    "value_id": "9344",
                    "value_name": "Apple"
                },
                {
                    "id": "LINE",
                    "name": "Línea",
                    "value_id": "58993",
                    "value_name": "iPhone"
                },
                {
                    "id": "MODEL",
                    "name": "Modelo",
                    "value_id": "14605",
                    "value_name": "iPhone 3G"
                },
                {
                    "id": "IS_DUAL_SIM",
                    "name": "Es Dual SIM",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "COLOR",
                    "name": "Color",
                    "value_id": "52049",
                    "value_name": "Negro"
                },
                {
                    "id": "INTERNAL_MEMORY",
                    "name": "Memoria interna",
                    "value_id": "59561",
                    "value_name": "16 GB"
                },
                {
                    "id": "RAM",
                    "name": "Memoria RAM",
                    "value_id": "579543",
                    "value_name": "128 MB"
                },
                {
                    "id": "MAIN_COLOR",
                    "name": "Color principal",
                    "value_id": "2450295",
                    "value_name": "Negro"
                },
                {
                    "id": "OPERATING_SYSTEM_NAME",
                    "name": "Nombre del sistema operativo",
                    "value_id": "7404961",
                    "value_name": "iOS"
                }
            ],
            "pictures": [
                {
                    "id": "675782-MLA31138875214_062019",
                    "url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-F.jpg"
                },
                {
                    "id": "915001-MLA31138546867_062019",
                    "url": "https://mla-s1-p.mlstatic.com/915001-MLA31138546867_062019-F.jpg"
                },
                {
                    "id": "881441-MLA31138332972_062019",
                    "url": "https://mla-s1-p.mlstatic.com/881441-MLA31138332972_062019-F.jpg"
                },
                {
                    "id": "804666-MLA31139286536_062019",
                    "url": "https://mla-s2-p.mlstatic.com/804666-MLA31139286536_062019-F.jpg"
                }
            ]
        },
        {
            "id": "MLA6007404",
            "status": "active",
            "domain_id": "MLA-CELLPHONES",
            "settings": {
                "listing_strategy": "catalog_required"
            },
            "name": "Apple iPhone iPhone 3G 16 GB Blanco 128 MB RAM",
            "attributes": [
                {
                    "id": "BRAND",
                    "name": "Marca",
                    "value_id": "9344",
                    "value_name": "Apple"
                },
                {
                    "id": "LINE",
                    "name": "Línea",
                    "value_id": "58993",
                    "value_name": "iPhone"
                },
                {
                    "id": "MODEL",
                    "name": "Modelo",
                    "value_id": "14605",
                    "value_name": "iPhone 3G"
                },
                {
                    "id": "IS_DUAL_SIM",
                    "name": "Es Dual SIM",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "COLOR",
                    "name": "Color",
                    "value_id": "52055",
                    "value_name": "Blanco"
                },
                {
                    "id": "INTERNAL_MEMORY",
                    "name": "Memoria interna",
                    "value_id": "59561",
                    "value_name": "16 GB"
                },
                {
                    "id": "RAM",
                    "name": "Memoria RAM",
                    "value_id": "579543",
                    "value_name": "128 MB"
                },
                {
                    "id": "MAIN_COLOR",
                    "name": "Color principal",
                    "value_id": "2450308",
                    "value_name": "Blanco"
                },
                {
                    "id": "OPERATING_SYSTEM_NAME",
                    "name": "Nombre del sistema operativo",
                    "value_id": "7404961",
                    "value_name": "iOS"
                }
            ],
            "pictures": [
                {
                    "id": "675782-MLA31138875214_062019",
                    "url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-F.jpg"
                },
                {
                    "id": "915001-MLA31138546867_062019",
                    "url": "https://mla-s1-p.mlstatic.com/915001-MLA31138546867_062019-F.jpg"
                },
                {
                    "id": "881441-MLA31138332972_062019",
                    "url": "https://mla-s1-p.mlstatic.com/881441-MLA31138332972_062019-F.jpg"
                },
                {
                    "id": "804666-MLA31139286536_062019",
                    "url": "https://mla-s2-p.mlstatic.com/804666-MLA31139286536_062019-F.jpg"
                }
            ]
        }
    ]
}

Identifique as publicações existentes a serem associadas

Para reconhecer as publicações atuais do marketplace que devem ser publicadas em um catálogo, consulte o recurso de search com o parâmetro catalog_forewarning e filtre esse tipo de publicação. Depois de identificado, recomendamos que você associe cada publicação a um catálogo (optin) e evite moderação.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?tags=catalog_forewarning

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/123456987/items/search?tags=catalog_forewarning

Resposta curta:

{
    "seller_id": "123456987",
    "query": null,
    "paging": {
        "limit": 50,
        "offset": 0,
        "total": 1
    },
    "results": [
        "MLA123456789"
    ],
    "filters": [],
    "available_filters": [
            ]
}
Nota:
A resposta do search mostrará nos resultados todos os itens do vendedor marcados com a tag catalog_forewarning.

Reconhecendo essas publicações, verifique o prazo que você terá para publicar o produto em um catálogo, consultando o recurso /catalog_forewarning/date.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/catalog_forewarning/date

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA123456789/catalog_forewarning/date

Resposta da publicação com data atribuída:

{
   "status":"date_defined",
   "moderation_date":"2020-08-20T13:00:00Z"
}

Resposta da publicação que não tem a tag catalog_forewarning:

{
   "status":"date_not_defined",
   "moderation_date": null
}

Resposta da publicação com data expirada:

{
   "status":"date_expired",
   "moderation_date":"2020-06-10T13:00:00Z"
}
Nota:
Lembre-se de filtrar e notificar os prazos de publicação do catálogo para seus vendedores para evitar pausar suas publicações e melhorar a experiência de venda.

Caso você envie um item que não esteja marcado com a tag catalog_forewarning, você receberá um 404: Para impedir que as postagens existentes sejam moderadas (pausadas) porque não foram publicadas no catálogo a tempo, você pode:

  • Associar a publicação a um produto existente: para isso, você deve primeiro confirmar que o produto do catálogo corresponde ao da sua publicação e depois associá-lo (optin).
  • Informar publicação ou variação obrigatória sem catalog_product_id: essa solução está disponível apenas se o seu produto não existir no catálogo e, portanto, você não pode associá-lo (optin), por exemplo, devido à cor do produto que você vende. Veja como sinalizar essas postagens ou variações.

Informar publicação ou variação obrigatória sem catalog_product_id

Antes de reportar uma publicação ou variação para não ser moderada, certifique-se de que seu produto seja obrigatório no catálogo e tenha pesquisado, através do recurso /product_search, o produto ativo para associá-lo. Se o seu produto for necessário para o catálogo e você não conseguir encontrar um produto ativo para associar a sua publicação, você deve marcar o item ou variação da seguinte forma.

Nota:
As publicações marcadas com /catalog_listing_eligibility/moderation_buybox/evaluate serão revisados ​​internamente para validar se o está correto. Caso contrário, eles serão moderados pelo OPT_OBEY.

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d 
{...} 
https://api.mercadolibre.com/catalog_listing_eligibility/moderation_buybox/evaluate

Exemplo com variação:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d 
{
     "item_id": "MLA3434544"
     "variations": [{
           "id": 3434343
        }]
}
https://api.mercadolibre.com/catalog_listing_eligibility/moderation_buybox/evaluate

Resposta:

{
     "item_id": "MLA3434544"
     "variations": [{
           "id": 3434343
        }]
     "activation_date": "2021-09-03T13:00:00.000Z"
}

Exemplo sem variação:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d 
{
     "item_id": "MLA3434544"
}
https://api.mercadolibre.com/catalog_listing_eligibility/moderation_buybox/evaluate
Nota:
Ativaremos progressivamente os domínios de venda exclusiva por catálogo, começando ELECTRIC_SHOWER_HEADS em 20 de junho e CELLPHONES em 27 de junho.

Alguns domínios são de venda exclusiva por catálogo, isso significa que, podem ser anunciados e vendidos apenas pela página de produto de catálogo e não de marketplace. Por isso, ao fazer optin de um item, o anúncio de marketplace será moderado com "status": "under_review" e o produto poderá ser vendido e gerenciado apenas pelo catálogo.

Se criar um anúncio de marketplace em algum dos domínios de venda exclusiva este será moderado com a seguinte tag: “catalog_only_restricted”

 "status": "under_review",
   "sub_status": [
       "forbidden"
   ],
   "tags": [
       "catalog_only_restricted",
       "poor_quality_picture",
       "test_item",
       "immediate_payment",
       "cart_eligible"
   ],

Para considerar:

  • Os itens com múltiplas variações são inativados apenas depois do optin de todas suas variações em catálogo. Caso contrário permanecerá ativo.
  • O fluxo de domínios de venda exclusiva está disponível apenas para publicação de novos anúncios e ao fazer optin. Aqueles itens que já estão ativos dentro destes domínios, por enquanto, não serão impactados.

Consultar moderações

Você pode saber se uma publicação foi moderada (pausada) por não associá-la a uma do catálogo a tempo, validando seu reason e remedy (acionável). Lembre-se de que qualquer alteração ou modificação que altere a qualidade da publicação, pode gerar sua moderação.

Chamada:

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

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/1234567

Resposta para um produto moderado que não pertence a um domínio de venda exclusiva por catálogo::

{
   "infractions": [
       {
           "id": "594794188",
           "date_created": "2020-10-28T01:43:32.414-0400",
           "user_id": "1234567",
           "related_item_id": "MLA1692147078",
           "element_id": "MLA1692147078",
           "element_type": "ITM",
           "site_id": "MLA",
           "reason": "La pausamos porque no ofreces el producto también en catálogo.",
           "remedy": "Publica tu producto en catálogo para seguir vendiéndolo. Cuando lo hagas, tu publicación original se reactivará automáticamente."
       }
   ],
   "paging": {
       "offset": 0,
       "limit": 2,
       "total": 20671
   },
   "sorting_type": "date_created_desc"
}

Para reativar sua publicação, você deve associar a publicação a um catálogo (optin) ou marcar o item/variação para mencionar que não foi encontrado um produto para associá-la.


Resposta para um produto moderado que pertence a um domínio de venda exclusiva, este produto não poderá ser ativado novamente:

{
   "infractions": [
       {
           "id": "943314941",
           "date_created": "2022-05-23T16:52:14.387-0400",
           "user_id": "1005109061",
           "related_item_id": "MLA1138520248",
           "element_id": "MLA1138520248",
           "element_type": "ITM",
           "site_id": "MLA",
           "filter_subgroup": "AP",
           "reason": "La anulamos porque este producto solo puedes venderlo con tu publicación de catálogo.",
           "remedy": "La anulamos porque este producto solo puedes venderlo con tu publicación de catálogo."
       }
   ],
   "paging": {
       "offset": 0,
       "limit": 20,
       "total": 2
   },
   "sorting_type": "date_created_desc"
}


Adicionar tag de pré-aviso em item de teste

Para testar a funcionalidade de pré-aviso, deverá:

  • O Item de Marketplace seja elegível para um Catálogo existente.
  • O item não pode ser de um catálogo/produto já requerido, que, caso contrário, ao publicar o Item já cairá em moderação.

Após cumprir com estes requisitos, carregue os dados no formulário para inclusão da tag catalog_forewarning.



Seguinte: Concorrência no catálogo.

banner footer

Inscreva-se em nosso Newsletter

ou registre-se para receber as últimas notícias sobre nossa API