Conteúdos

→Conferir se um anúncio é elegível para o catálogo
→Filtrar de itens por vendedor
→Tag de elegibilidade para itens
→Elegibilidade de um anúncio existente com catalog_product_id associado
→Conferir se vários anúncio são elegíveis para o catálogo com multiget


É importante que, antes de publicar, você reconheça quais publicações criadas são elegíveis ou podem ser publicadas no catálogo. Para isso, você pode usar a tag catalog_listing_eligible e reconhecer facilmente as postagens ou escolher os recursos de elegibilidade de uma publicação ou o multiget para verificar um conjunto de publicações.

Nota:
Neste momento só podem participar de catálogo certos anúncios que atendem alguns requisitos, entre eles: serem novos e do domínio CELLPHONES, os aparelhos devem ser desbloqueados.

Filtrar de itens por vendedor

Esse filtro permite conhecer as publicações que são de catálogo e aquelas que são as tradicionais. Para isso você deverá passar na busca o parâmetro catalog_listing com o valor true ou false, dependendo do que você deseja consultar.
Em primeiro lugar identificamos todos os itens de catálogo de um seller, tenha em conta que você deverá passar o parâmetro de status correspondente caso queira adicionar um filtro como por exemplo status=“active”.

Chamada:

curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?catalog_listing=true&access_token=$ACCESS_TOKEN

Exemplo:

curl -X GET https://api.mercadolibre.com/users/123456789/items/search?catalog_listing=true&access_token=$ACCESS_TOKEN

Resposta resumida de itens que são de catálogo:

{
  "seller_id": "123456789",
  "query": null,
  "paging": {
    "limit": 50,
    "offset": 0,
    "total": 8
  },
  "results": [
    "MLA123456789",
    "MLA234567890",
    "MLA345678912",
    "MLA456789123",
    "MLA567891234",
    "MLA678912345",
    "MLA789123456",
    "MLA891234567"
  ],
  "filters": [
  ],
  "available_filters": [],
  "orders": [],
  "available_orders": []
}

Por outro lado você poderá realizar o mesmo filtro para identificar todos os itens de um seller que não são de catálogo.


Chamada:

curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?catalog_listing=false&access_token=$ACCESS_TOKEN

Exemplo:

curl -X GET https://api.mercadolibre.com/users/123456789/items/search?catalog_listing=false&access_token=$ACCESS_TOKEN

Resposta resumida de itens de marketplace:

{
  "seller_id": "123456789",
  "query": null,
  "paging": {
    "limit": 50,
    "offset": 0,
    "total": 2902
  },
  "results": [
    "MLA987654321",
    "MLA123789456",
    "MLA456789123",
    "MLA132465798",
    "MLA978645312",
    "MLA312645978",
    "MLA654987321",
    "MLA123789654",
      ],
  "filters": [
  ],
  "available_filters": [],
  "orders": [],
  "available_orders": []
}

Tag de elegibilidade para itens

Através do recurso search, poderá identificar todos os itens dos vendedores que são elegíveis para catálogo, que ainda não foram publicados, pela tag catalog_listing_eligible. Para consultá-los realize a seguinte chamada:


Chamada:

curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?tags=catalog_listing_eligible&access_token=$ACCESS_TOKEN

Exemplo:

curl -X GET https://api.mercadolibre.com/users/123456987/items/search?tags=catalog_listing_eligible&access_token=$ACCESS_TOKEN

Resposta curta:

{
    "seller_id": "123456987",
    "query": null,
    "paging": {
        "limit": 50,
        "offset": 0,
        "total": 1
    },
    "results": [
        "MLA123456789"
    ],
    "filters": [],
    "available_filters": [
            ]
}

A resposta do search mostrará todos os itens do vendedor com a tag catalog_listing_eligible.

Exemplo de item elegível:

{
  "id": "MLA123456789",
  "site_id": "MLA",
  "title": "Item De Testeo, Por Favor No Ofertar --kc:off",
  "subtitle": null,
  "seller_id": 123456987,
  "category_id": "MLA3530",
  "official_store_id": null,
  "price": 50,
  "base_price": 50,
  "original_price": null,
  "currency_id": "ARS",
  "initial_quantity": 1,
  "available_quantity": 1,
  "sold_quantity": 0,
  "sale_terms": [
  ],
  "buying_mode": "buy_it_now",
  "listing_type_id": "free",
  "start_time": "2020-02-17T16:30:39.000Z",
  "stop_time": "2020-04-17T04:00:00.000Z",
  "condition": "used",
  "permalink": "https://articulo.mercadolibre.com.ar/MLA-839616438-item-de-testeo-por-favor-no-ofertar-kcoff-_JM",
  "thumbnail": "http://mla-s1-p.mlstatic.com/951410-MLA40807113659_022020-I.jpg",
  "secure_thumbnail": "https://mla-s1-p.mlstatic.com/951410-MLA40807113659_022020-I.jpg",
  "pictures": [],
  "video_id": null,
  "descriptions": [
  ],
  "accepts_mercadopago": true,
  "non_mercado_pago_payment_methods": [
  ],
  "shipping": {},
  "international_delivery_mode": "none",
  "seller_address": {},
  "seller_contact": null,
  "location": {
  },
  "geolocation": {},
  "coverage_areas": [
  ],
  "attributes": [],
  "warnings": [
  ],
  "listing_source": "",
  "variations": [
  ],
  "status": "active",
  "sub_status": [
  ],
  "tags": [
    "catalog_listing_eligible",
    "good_quality_picture",
    "test_item",
    "immediate_payment"
  ],
  "warranty": null,
  "catalog_product_id": null,
  "domain_id": "MLA-UNCLASSIFIED_PRODUCTS",
  "parent_item_id": null,
  "differential_pricing": null,
  "deal_ids": [
  ],
  "automatic_relist": false,
  "date_created": "2020-02-17T16:30:40.000Z",
  "last_updated": "2020-02-17T16:34:12.000Z",
  "health": 0.4,
  "catalog_listing": false
}

Elegibilidade de um anúncio existente com catalog_product_id associado

Os exemplos a seguir mostram como validar a elegibilidade de uma publicação existente para vincular uma nova publicação de catálogo ao estoque sincronizado que possui um catalog_product_id associado.

Chamada:

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/catalog_listing_eligibility?access_token=$ACCESS_TOKEN

Exemplo com variações:

curl -X GET https://api.mercadolibre.com/items/MLA123456789/catalog_listing_eligibility?access_token=$ACCESS_TOKEN

Resposta:

{
    "id": "MLA123456789",
    "site_id": "MLA",
    "domain_id": "MLA-CELLPHONES",
    "status": null,
    "buy_box_eligible": null,
    "variations": [
        {
            "id": 1312323,
            "status": "READY_FOR_OPTIN",
            "buy_box_eligible": true
        },
        {
            "id": 1312444,
            "status": "READY_FOR_OPTIN",
            "buy_box_eligible": true
        }
    ]
}

Exemplo sem variações:

curl -X GET https://api.mercadolibre.com/items/MLB1234/catalog_listing_eligibility?access_token=$ACCESS_TOKEN

Resposta:

{
    "id": "MLB1234",
    "site_id": "MLB",
    "domain_id": "MLB-MICROWAVES",
    "status": "READY_FOR_OPTIN",
    "buy_box_eligible": true,
    "variations": []
}


Considerações

  • Se o item não possuir variações, a elegibilidade será expressada no campo buy_box_eligible de primeiro nível no JSON de resposta e a seção variations estará vazia.
  • Se o item possuir variações, a elegibilidade de cada uma delas será expressada na seção variations, que conterá um array por variação com um campo buy_box_eligible para cada uma delas.

Descrição dos campos:

  • id: ID do anúncio que estamos consultando.
  • site_id: ID do país ao qual o item corresponde.
  • domain_id: ID do domínio ao qual o item corresponde.
  • buy_box_eligible: indica se o item/variação é elegível ou não para participar de catálogo.
  • variations: são todas as variações de um item. Cada uma terá um status associado e um valor para o campo buy_box_eligible.
  • status: define a situação do item tradicional com relação ao catálogo. Os diferentes status podem ser:

Elegível:

  • READY_FOR_OPTIN: o item pode ser anunciado no catálogo.

Não elegíveis:

  • ALREADY_OPTED_IN: o item tradicional consultado já possui um item de catálogo associado.
  • CLOSED: o item encontra-se em um status que não pode mais ser vendido.
  • PRODUCT_INACTIVE: o item está associado a um produto que ainda não foi habilitado para o catálogo ou o item ainda não possui um catalog_product_id associado.
  • NOT_ELIGIBLE: existe uma regra de negócio que impede que o item seja elegível para o catálogo.
  • Por exemplo, celular usado, celular bloqueado. Lembre-se de que, se você consultar um item de catálogo que estiver competindo, o status será COMPETING.


    Conferir se vários anúncio são elegíveis para o catálogo com multiget

    Para verificar se várias publicações são elegíveis para o catálogo fazendo uma única chamada, você deve incorporá-las ao parâmetro ids, bem como efetuar a chamada multiget, da seguinte maneira:


    Chamada:

    curl -X GET https://api.mercadolibre.com/multiget/catalog_listing_eligibility?ids=$ITEM_ID,$ITEM_ID&access_token=$ACCESS_TOKEN

    Exemplo:

    curl -X GET https://api.mercadolibre.com/multiget/catalog_listing_eligibility?ids=MLA818878419,MLA820167922&access_token=$ACCESS_TOKEN

    Resposta:

    [
        {
            "code": 200,
            "body": {
                "buy_box_eligible": null,
                "domain_id": "MLA-CELLPHONES",
                "id": "MLA818878419",
                "site_id": "MLA",
                "status": null,
                "variations": [
                    {
                        "buy_box_eligible": true,
                        "id": 44612657634,
                        "status": "READY_FOR_OPTIN"
                    },
                    {
                        "buy_box_eligible": false,
                        "id": 44890704657,
                        "status": "ALREADY_OPTED_IN"
                    }
                ]
            }
        },
        {
            "code": 200,
            "body": {
                "buy_box_eligible": null,
                "domain_id": "MLA-CELLPHONES",
                "id": "MLA820167922",
                "site_id": "MLA",
                "status": null,
                "variations": [
                    {
                        "buy_box_eligible": true,
                        "id": 44931385066,
                        "status": "READY_FOR_OPTIN"
                    },
                    {
                        "buy_box_eligible": true,
                        "id": 44931385069,
                        "status": "READY_FOR_OPTIN"
                    }
                ]
            }
        }
    ]

    Descrição dos campos

    • code: é o código de status HTTP que retorna a consulta com cada item_id; se não houver erro, ele deve ser 200.
    • body: corpo da mensagem que retorna essa consulta à API de elegibilidade.

    Seguinte: Buscador de productos.

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