Publicações requeridas no catálogo

Uma publicação de marketplace é requerida no catálogo se for elegível com a tag catalog_listing_eligible e se o produto de catálogo ao qual a vai associar conta com o campo listing_strategy: catalog_required, neste caso o Mercado Livre poderá moderar a publicação solicitando que publique no catálogo por optin.
Alguns domínios são permitidos publicar produtos apenas pelo catálogo, isso quer dizer que, se a publicação de marketplace já tem seu produto de catálogo correspondente associado, a publicação original de marketplace será inativada pelo Mercado Livre.

Identificar produtos previamente

Antes de criar produtos no catálogo, identifique se o produto existe e está ativo. Para isso, faça um GET ao recurso /products/search com o filtro status:active e revise usando o recurso listing_strategy: catalog_required se o produto deve estar publicado no catálogo. Nestecaso, poderá:

• Publicar diretamente no catálogo;
• Fazer uma publicação tradicional e associar a uma publicação de catálogo. (optin);
• Marcar uma publicação ou variação (não encontrada no catálogo para associar) evitando sua moderação.

Chamada para identificar produtos requeridos no catálogo onde pode usar o q, product_identifier ou parent_product_id para fazer a busca exata:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/products/search?status=active&site_id=$SITE_ID&listing_strategy=catalog_required&q={q}

Exemplo de chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/products/search?status=active&site_id=MLA&skip_cache=true&listing_strategy=catalog_required&q=Huawei Y6p 64 GB black

Exemplo de resposta curta para um produto requerido no catálogo:

{
    "keywords": "Huawei Y6p 64 GB black",
    "paging": {
        "total": 1,
        "limit": 10,
        "offset": 0
    },
    "results": [
        {
            "id": "MLA15996644",
            "status": "active",
            "domain_id": "MLA-CELLPHONES",
            "settings": {
                "listing_strategy": "catalog_required"
            },
            "name": "Huawei Y6p 64 GB  midnight black 3 GB RAM",
            "main_features": [],
            "attributes": [ ...
            ],
            "pictures": [
                ...
            ],
            "parent_id": "MLA15996641",
            "children_ids": []
        }
    ]
}

Para novos domínios onde as publicações são requeridas no catálogo, implementamos uma forma para identificar a lista de todas as publicações de marketplace que devem ser publicadas no catálogo antes de ser moderadas e, assim, evitar problemas com o vendedor.
Para identificá-las use o recurso GET items/search filtrando pela tag catalog_forewarning, uma vez identificadas, recomendamos associar cada publicação a um produto de catálogo (fazendo optin) e evitar penalizações.

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/123456/items/search?tags=catalog_forewarning

Resposta curta

{
    "seller_id": "123456",
    "query": null,
    "paging": {
        "limit": 50,
        "offset": 0,
        "total": 15
    },
    "results": [
        "MLA887478882",
        "MLA830583442",
        "MLA830570458",
        "MLA835548382",
        "MLA835731852",
        "MLA837273858",
        "MLA833333835",
        "MLA833333341",
        "MLA700204505",
        "MLA703848375",
        "MLA703848388",
        "MLA708343730",
        "MLA703234381",
        "MLA712487522",
        "MLA712883748"
    ],
    "orders": [
      ...
    ],
    "available_orders": [...]
}

Estas publicações de marketplace terão uma data limite para serem associadas a um produto de catálogo, após esta data, se o vendedor não fez o optin (criou a publicação no catálogo), será executado o processo que vai remover a tag de catalog_forewarning e a publicação será moderada pelo filtro OP_OBEY. Consulte esta data limite usando 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/MLA830570458/catalog_forewarning/date

Resposta de uma publicação com data associada:

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

EResposta de publicação que não tem a tag de catalog_forewarning:

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

Resposta de publicação com uma data que já expirou:

{
   "status":"date_expired",
   "moderation_date":"2020-06-10T13:00:00Z"
}

Domínios de venda exclusiva em catálogo

Alguns domínios são de venda exclusiva para catálogo, ou seja, podem ser publicados e vendidos apenas nas páginas de produto de catálogo e não de marketplace, por isso, ao fazer optin de uma publicação de marketplace completa (todas as variações da publicação tem sua associação correspondente a um produto de catálogo), a publicação de marketplace é moderada com status: under_review e só poderá vendê-lo e gestioná-lo através do catálogo.
Para uma publicação de marketplace criada em algum domínio de venda exclusiva de catálogo, poderá identificar que foi moderada usando a tag catalog_only_restricted

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

Considere que:

• As publicações de marketplace com múltiplas variações são inativadas apenas depois do optin completo de todas as variações de catálogo. Caso contrário permanecerão ativas.
• O fluxo de domínios de venda exclusiva estará disponível apenas para novas publicações e ao fazer optin, as publicações de marketplace que já estão nos domínios não serão afetadas.

Moderações

Identifique se uma publicação foi moderada (pausada) por não associá-la a tempo a um produto de catálogo, validando a sua reason (causa) e remedy (acionável). Lembre-se que, qualquer mudança que altere a qualidade da publicação, poderá causar a 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 uma publicação de marketplace moderada que não pertence a um domínio de venda exclusiva em 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 deverá associar ao catálogo (fazer optin) ou marcar a publicação/variação para mencionar que não encontrou um produto para associar.

Resposta para uma publicação de marketplace moderada que pertence a um domínio de venda exclusiva, este produto não pode ser reativado 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"
}

Tag de pré-aviso para teste

Para testar a funcionalidade de pré-aviso em domínios de catálogo requeridos, a publicação:

• Deve ser elegível no catálogo em um produto ativo.
• Não pode ser de um produto de catálogo que já pertence a um domínio requerido. Caso contrário, ao publicar, o item será moderado.

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

Próxima: Competição.