Publicações de Lojas Oficiais para Imóveis

A publicação de um item em uma Loja Oficial segue o mesmo processo que a publicação de qualquer outro item, com a adição do atributo official_store_id no corpo da requisição, conforme mostrado em Publicar Imóveis.

O campo official_store_id é obrigatório para todas as publicações de usuários vinculados a uma Loja Oficial. Se o vendedor não possuir uma Loja Oficial associada, o campo official_store_id deve ser enviado como nulo (null).

A omissão desse campo para vendedores com Loja Oficial resultará em um erro como o seguinte:

{
  "message": "Validation error",
  "error": "validation_error",
  "status": 400,
  "cause": [
    {
      "department": "items",
      "cause_id": 144,
      "type": "error",
      "code": "item.official_store_id.invalid",
      "references": [
        "item.official_store_id",
        "item.seller_id"
      ],
      "message": "Users type brand have to provide a official store id"
    }
  ]
}

O campo official_store_id vincula um item à Loja Oficial correspondente ao ID fornecido. Para obter mais informações sobre Lojas Oficiais, consulte a documentação de Lojas Oficiais.

Verificação de Loja Oficial do Vendedor

Para determinar se um vendedor possui uma Loja Oficial, siga este guia para obter o ID e detalhes adicionais da marca.

Inclusão do official_store_id

Ao criar uma nova publicação, inclua o ID da loja no campo official_store_id no momento de Publicar seu Item.

Exemplo:

curl -X POST 
-H 'Authorization: Bearer $ACCESS_TOKEN' 
"Content-Type: application/json" -d
'{
  "title":"Item de Teste - Não Ofertar",
  "category_id":"MLA401686",
  "price":137000,
  "official_store_id": 3121,
  "currency_id":"USD",
  "available_quantity":1,
  "buying_mode":"classified",
  "listing_type_id":"silver",
  "condition":"new",
  "description": "Item: Apto 2 Ambientes com Varanda Frontal!",
  "video_id": "YOUTUBE_ID_AQUI",
  "pictures":[
    {"source":"http://upload.wikimedia.org/wikipedia/commons/f/fd/ap.jpg"},
    {"source":"http://en.wikipedia.org/wiki/File:Teashades.gif"}
  ]
}'
https://api.mercadolibre.com/items

Nas atualizações do seu imóvel, inclua o official_store_id apenas se for necessário modificar a Loja Oficial associada ao item.

Erros Comuns ao Publicar em Lojas Oficiais

A seguir, estão listados os erros 400 mais comuns recebidos por usuários associados a Lojas Oficiais que não enviam o atributo official_store_id:

• Erro 400:
  • Código: item.official_store_id.invalid
  • Mensagem: Users type brand have to provide a official store id

{
  "message": "Validation error",
  "error": "validation_error",
  "status": 400,
  "cause": [
    {
      "code": "item.official_store_id.invalid",
      "message": "Users type brand have to provide a official store id"
    }
  ]
}

Se você não enviar o official_store_id do item em uma Loja Oficial multimarca, receberá como resposta os possíveis IDs que podem ser utilizados com seu usuário.

• Erro 403:
  • Código: body.invalid_official_store_id
  • Mensagem: O vendedor 148829068 não tem permissão para usar official_store_id 315 no site MLA.

Se você enviar um official_store_id inválido para uma Loja Oficial multimarca, receberá este erro:

{
  "message": "body.invalid_official_store_id",
  "error": "O vendedor 148829068 não tem permissão para usar official_store_id 315 no site MLA.",
  "status": 403,
  "cause": []
}

Leituras Recomendadas

• Ciclo de vida das publicações
• Atualize seu imóvel
• Qualidade das publicações

Atualizações de versão

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

Histórico de mudanças

Data	Versão	Descrição
06/11/2025	1.0	Publicação inicial