Gerenciar Pacotes de Imóveis

Tipos de Pacotes

Na publicação de cada imóvel, o tipo de pacote contratado é identificado por meio do campo listing_type. Para publicar imóveis no Mercado Livre, é fundamental compreender os diferentes tipos de pacotes disponíveis e o impacto deles na gestão e visibilidade das publicações:

• 1. Pacote de Publicação (listing_type: silver)

O pacote de publicação é obrigatório. Sem este pacote, não é possível criar nenhum anúncio na plataforma, pois ele habilita a cota necessária para publicar. Cada vez que você cria uma publicação, é descontada uma cota desse pacote; isso garante que sua conta esteja habilitada para listar imóveis.

• 2. Pacote Destaque (listing_type: gold / gold_premium)

O pacote destaque é opcional e é usado para aumentar a exposição e a prioridade de uma publicação em relação a outras nos resultados de busca. Os pacotes do tipo Ouro (gold) e Ouro Premium (gold_premium) permitem destacar seus anúncios, proporcionando maior visibilidade e atraindo mais potenciais compradores. Isso melhora o posicionamento e a visibilidade de um anúncio publicado.

Cotas e Limite de Publicações

Cada pacote, seja de publicação ou destaque, inclui uma quantidade finita de cotas que determina o número de publicações ou destaques que você pode realizar. Se você esgotar as cotas de algum pacote, não poderá criar (ou destacar) novas publicações até contratar ou ampliar o seu pacote. É importante monitorar regularmente a disponibilidade de cotas para evitar interrupções nas operações.

Considerações Adicionais sobre Pacotes:

• Pacotes Mistos:

É fundamental consultar o pacote de publicação que o usuário possui para verificar o listing_type das cotas disponíveis para publicar. É importante esclarecer que os pacotes MISTOS (com cotas Ouro, Ouro Premium e Prata) não podem ser usados para destacar publicações.

• Atraso na Atualização da API de Pacotes:

As cotas podem demorar alguns minutos para serem liberadas. Se o integrador encerrar itens e reativá-los rapidamente, ou realizar um downgrade e, em seguida, um upgrade em um curto período de tempo, é possível que as cotas não sejam liberadas a tempo, o que pode resultar na perda de cotas.

Dicas Adicionais

• Upgrades e downgrades: Você pode alterar o tipo de pacote de uma publicação existente. Por exemplo, pode “fazer upgrade” de prata para ouro para destacar um imóvel, desde que tenha cotas disponíveis.

1. Consultar quais pacotes de publicação estão disponíveis para contratação:

Lembre-se de que, ao realizar chamadas GET para o recurso /classifieds_promotion_packs, é possível consultar os pacotes disponíveis para uma categoria principal específica com a seguinte chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/$CATEGORY_ID/classifieds_promotion_packs

Estrutura de Resposta Esperada:

Neste exemplo, vamos consultar os pacotes disponíveis para a categoria de imóveis do Chile. Portanto, no curl anterior, substituímos $CATEGORY_ID por MCL1459. O resultado esperado é um array de pacotes de publicação com a seguinte estrutura:

[
  {
    "id": "IP10000P30",
    "category_id": "MLC1459",
    "brand": "PORTALINMOBILIARIO",
    "description": "10000 Publicações Prata",
    "price": 345.1,
    "package_type": "rotary",
    "package_content": "publications",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CREM",
    "max_upgrades": null,
    "quota_type": "reusable",
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 10000
      }
    ],
    "visibility": "public"
  }
]

2. Contratar Pacotes de Publicação

Para contratar os pacotes de publicação que melhor se adequem às suas necessidades, primeiro você deve solicitar a ativação do seu usuário por meio do formulário de contato com o suporte, selecionando a opção de ativação de usuário. Assim que for notificado de que seu usuário está ativo, siga as etapas definidas na guia de contratação de pacotes de publicação e destaques.

3. Consultar quais pacotes estão contratados por usuário

Essa consulta é fundamental para determinar quais pacotes um cliente contratou e a quantidade de anúncios disponíveis em cada um.

Chamada:

-X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/classifieds_promotion_packs?package_content=$PACKAGE_CONTENT&status=$STATUS

Estrutura de resposta esperada:

[
  {
    "id": 754985,
    "user_id": "123456789",
    "promotion_pack_id": "MPAB",
    "category_id": "MLC1743",
    "description": "Pacote 15 Básico",
    "package_type": "rotary",
    "package_content": "publications",
    "status": "active",
    "date_created": "2013-05-23T15:34:48.498-04:00",
    "date_start": "2013-05-23T15:34:47.544-04:00",
    "date_expires": "2013-06-22T15:34:47.544-04:00",
    "date_stopped": null,
    "last_updated": "2013-05-23T15:35:48.211-04:00",
    "engagement_type": "none",
    "charge_id": 822129921,
    "remaining_listings": 15,
    "used_listings": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 15,
        "used_listings": 0,
        "remaining_listings": 15
      }
    ]
  }
]

3.1 Consultar quais pacotes estão contratados por usuário e tipo de pacote

Você pode consultar se um usuário possui contratado um tipo específico de pacote (listing_type) por meio do seguinte comando curl:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/classifieds_promotion_packs/$LISTING_TYPE?categoryId=$CATEGORY_ID

Próximos Passos

• Publicar imóveis.
• Publicações de lojas oficiais

Atualizações de Versão

Esta seção fornece informações sobre as atualizações da API, incluindo:

Histórico de alterações