Recursos Cross

Confira os principais recursos das nossas APIs
circulos azuis em degrade

Documentação

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

Última atualização em 19/10/2023

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.

Nota:
Este recurso está disponível en MLA, MLM, MLB, MCO, MLC e MLU.

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á:

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"
}
Nota:
Esta funcionalidade não está disponível no MPE ou MEC. Também não está disponível no Mercado Shops all sites.

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

Nota:
- Esta funcionalidade não está disponível em MPE ou MEC, já que as publicações não estão moderando.
- Para outros países está disponível nos canais de Marktplace e MShops, onde para MShops ainda não estão disponíveis os domínios de venda exclusiva.

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.