O feed de produtos do PrestaShop é o que leva o seu catálogo até ao Google Merchant Center. Cada título, preço, imagem e código de barras que o Google mostra no Shopping vem da ficha de produto. Se a origem tiver falhas, os produtos ficam limitados ou reprovados.
Este artigo explica de onde sai cada dado no PrestaShop, como tratar as combinações e que opções existem para gerar o feed. Segue a especificação de dados de produto da ajuda do Merchant Center e a documentação oficial do PrestaShop, consultadas em outubro de 2026.
Quando falamos de bloqueios, falamos de produtos reprovados ou com visibilidade limitada.
O que o Merchant Center espera receber
Desde julho de 2026, o Google deixou de usar o nome Merchant Center Next. A plataforma chama-se apenas Google Merchant Center. Na mesma interface, os antigos feeds passaram a chamar-se fontes de dados.
A especificação de dados de produto define sete atributos obrigatórios para todos os produtos:
- id: identificador único, até 50 caracteres.
- title: o título, até 150 caracteres.
- description: a descrição, até 5.000 caracteres.
- link: o URL da página do produto.
- image_link: o URL da imagem principal.
- availability: in_stock, out_of_stock, preorder ou backorder.
- price: o valor com o código de moeda, por exemplo 49.90 EUR.
Outros dependem do produto. A marca é obrigatória em todos os produtos novos, exceto filmes, livros e gravações musicais. O MPN passa a obrigatório quando o produto não tem GTIN atribuído pelo fabricante. O estado (condition) é obrigatório nos produtos usados ou recondicionados.
O GTIN não é obrigatório, mas a especificação recomenda-o com força sempre que exista. Em Portugal, os custos de envio também são exigidos, tanto nos anúncios do Shopping como nas fichas gratuitas.
De onde vem cada dado do feed de produtos do PrestaShop
Na documentação do PrestaShop 8, a ficha de produto organiza a informação em separadores. As definições básicas reúnem o nome, as imagens, a descrição, a marca, as categorias, a quantidade e o preço. Os códigos de referência e o estado do produto ficam num separador próprio.
A tabela resume onde está cada atributo que o Google pede:
| Atributo do feed | Onde está no PrestaShop |
|---|---|
| id | ID do produto ou referência, mais o ID da combinação nas variantes. |
| title e description | Nome, resumo e descrição da ficha, em cada idioma ativo. |
| link | URL amigável definido no separador SEO. |
| image_link | Imagem de capa do produto ou imagens associadas à combinação. |
| price | Preço de retalho sem impostos, mais a regra de impostos. |
| availability | Quantidade em stock e comportamento quando o produto esgota. |
| brand | Campo Marca, ligado à lista de marcas do catálogo. |
| gtin e mpn | Campos EAN-13 ou JAN, UPC, ISBN e MPN da ficha e de cada combinação. |
| condition | Campo Estado da ficha de produto. |
| product_type | Categoria predefinida e árvore de categorias da loja. |
Preço com IVA incluído
No PrestaShop, o preço introduz-se sem impostos. Depois escolhe-se a regra de impostos, e o preço com impostos é calculado automaticamente. O feed tem de enviar o preço com IVA, porque a ajuda do Merchant Center inclui Portugal entre os países onde o imposto entra no atributo price.
O valor tem de coincidir com o da página e do checkout. Não pode variar consoante a localização do visitante. Se mostra preços sem IVA a algum grupo de clientes, confirme que o feed usa o preço do consumidor final.
Quanto ao formato, a especificação usa o ponto decimal e o código ISO da moeda, como 159.99 EUR.
EAN-13, MPN e marca
O PrestaShop aceita um EAN-13 com até 13 dígitos por produto e por combinação. Na Europa, o GTIN mais comum é precisamente o EAN de 13 dígitos. A ajuda do Google pede que só envie o código se tiver a certeza de que está correto.
Os erros mais frequentes são previsíveis:
- Copiar o EAN do produto principal para todas as combinações.
- Usar códigos internos ou inventados no campo EAN-13.
- Deixar a marca vazia em produtos que têm fabricante.
Nos produtos de marca própria ou feitos à medida, é normal não haver GTIN. Nesse caso, a ajuda indica que se use a marca e o MPN. O atributo identifier_exists com o valor no serve apenas para produtos sem nenhum identificador atribuído.
Stock e disponibilidade
A disponibilidade sai da quantidade em stock de cada produto ou combinação. O feed tem de traduzir esse estado para um dos quatro valores aceites. Textos como “Em stock” ou “Disponível” não são válidos no atributo availability.
Se a loja aceita encomendas de produtos esgotados, o valor certo pode ser backorder. Nas pré-encomendas (preorder), a especificação exige também availability_date. Para pausar um produto, a ajuda desaconselha usar out_of_stock e prevê um atributo próprio para isso.
Combinações: como enviar as variantes
No PrestaShop, tamanhos e cores criam-se como combinações. Cada combinação pode ter a sua referência, o seu EAN-13, o seu MPN, o seu impacto no preço e a sua quantidade. Para o Google, cada uma é um produto separado.
A especificação do atributo item_group_id resume as regras:
- Cada variante tem um id próprio e único.
- Todas as variantes do mesmo produto partilham o mesmo item_group_id.
- O item_group_id não muda depois de atribuído.
- O produto principal não é enviado como produto à parte.
- Cada variante leva color, size, material, pattern, gender ou age_group, quando se aplicam.
O item_group_id é obrigatório para variantes nas fichas gratuitas. Nos anúncios do Shopping, é obrigatório em países como França, Alemanha e Reino Unido.
A especificação inclui agora dois atributos opcionais para variantes. O item_group_title dá um título comum a todo o grupo. O variant_option descreve as propriedades que distinguem cada variante, com pares de nome e valor.
Cada variante precisa de um URL que mostre essa combinação. A página tem de apresentar o preço, a disponibilidade, a imagem e a cor da variante enviada. Se abre sempre a combinação predefinida, surgem diferenças face ao feed.
Módulo oficial ou ficheiro de feed
Há três formas habituais de levar o catálogo do PrestaShop ao Merchant Center. A escolha depende do catálogo, dos mercados e de onde vivem os preços e o stock.
O módulo PrestaShop Marketing with Google
É o módulo oficial, criado pela PrestaShop em colaboração com a Google. Sincroniza o catálogo com o Merchant Center, ativa as fichas gratuitas e permite criar campanhas de Performance Max a partir do back office. A página da PrestaShop indica compatibilidade a partir da versão 1.7.1, e a central de ajuda recomenda a 1.7.8 ou superior.
Quando foi lançado, em 2021, era gratuito. Hoje, a página oficial da PrestaShop apresenta-o como uma subscrição de 14,99 euros por mês mais IVA, sem compromisso e com 14 dias de teste.
O guia de configuração da PrestaShop pede um catálogo completo, com imagens de qualidade e identificadores. No módulo definem-se o idioma, a moeda e os países de destino, e atributos como marca, cor, tamanho e material. Segundo a PrestaShop, pode escolher que produtos sincronizar por marca, categoria, ID ou preço. O processo de ligação está explicado no nosso artigo sobre como ligar a loja PrestaShop ao Google Merchant Center.
Um módulo que gera um ficheiro
Outra via é um módulo que gera um ficheiro XML, TXT ou TSV num URL. No Merchant Center, cria-se uma fonte de dados com obtenção programada. Por predefinição, o Google vai buscar o ficheiro a cada 24 horas, e esse intervalo pode ser ajustado.
Esta via dá mais controlo sobre títulos, etiquetas personalizadas e regras por mercado, mas a qualidade depende do módulo. Se algum módulo ainda usava a Content API for Shopping, tenha em conta que o Google a encerrou a 18 de agosto de 2026.
Integração com ERP ou PIM
Quando o preço e o stock vêm de um ERP, o feed deve ler a mesma fonte que a loja, ou surgem diferenças face à página. É o caso de lojas que integram o Odoo com o PrestaShop para gerir catálogo e encomendas.
Nestes projetos, a Merchant API dá controlo sobre o momento de cada atualização de preço e stock. O desenho da integração faz parte do nosso serviço de integrações de catálogos com ERP e PIM.
Erros típicos que levam a produtos reprovados
A maioria dos problemas nasce em poucos pontos da loja.
Preço ou stock diferentes da página
Acontece quando o feed não acompanha as alterações da loja. Também surge com preços específicos ou regras de preço do catálogo que não chegam ao ficheiro. Se a loja aplica um desconto, o feed deve enviá-lo em sale_price, com as datas em que vigora.
As atualizações automáticas de artigos do Merchant Center, ativas por predefinição, corrigem o preço e a disponibilidade a partir dos dados estruturados da página. Ajudam, mas não substituem um feed atualizado.
Descrições com texto promocional
As descrições do PrestaShop são guardadas em HTML e podem incluir portes grátis, prazos de entrega ou o nome da loja. A ajuda do Google pede que a descrição fale só do produto. Preços, saldos, envios e ligações para outros sites ficam de fora.
O título também não deve ter texto promocional, maiúsculas para dar ênfase nem símbolos chamativos.
Imagens recusadas
O PrestaShop gera automaticamente vários tamanhos de cada imagem, incluindo miniaturas. O feed deve apontar para a versão grande, e não para a miniatura. A especificação já indica 500 x 500 píxeis como mínimo, com aplicação em todas as categorias a partir de 31 de janeiro de 2027.
O Google recomenda cerca de 1.500 x 1.500 píxeis. As imagens não podem ter marcas de água, preços, textos promocionais nem logótipos acrescentados.
Produtos esquecidos
Os produtos entram no estado de atualização necessária 30 dias depois da última atualização. Desativar um produto no PrestaShop também deve retirá-lo do feed.
Se os produtos aprovados estiverem prontos, as fichas gratuitas são o passo seguinte. O guia para ativar as fichas gratuitas no Google Merchant explica como.
Lista de verificação antes de enviar o feed
- Cada produto e cada combinação têm um id único que não muda.
- Títulos e descrições em português europeu, sem HTML promocional nem portes.
- Preço com IVA, no formato 49.90 EUR, igual ao da página e do checkout.
- Disponibilidade com um dos quatro valores aceites.
- EAN-13 verdadeiro em cada combinação ou, na falta dele, marca e MPN.
- Marca preenchida em todos os produtos novos com fabricante.
- item_group_id partilhado pelas variantes e URL próprio para cada combinação.
- Imagens grandes, sem texto promocional e com pelo menos 500 x 500 píxeis.
- Custos de envio para Portugal configurados no Merchant Center.
- Revisão semanal dos produtos limitados e reprovados.
Se prefere delegar esta revisão, a nossa agência especializada em Google Merchant Center audita o feed e corrige os erros na origem, dentro do PrestaShop.
Perguntas frequentes
O módulo oficial do PrestaShop para o Google é gratuito?
Já foi. Quando foi lançado, em 2021, o PrestaShop Marketing with Google não tinha custo. A página oficial da PrestaShop apresenta-o agora como uma subscrição mensal de 14,99 euros mais IVA, sem compromisso e com 14 dias de teste. O orçamento das campanhas de Performance Max é definido à parte, por si.
Cada combinação do PrestaShop tem de ir como um produto separado?
Sim. Para o Google, cada combinação é um produto com id próprio, preço, disponibilidade e imagem. As variantes do mesmo artigo partilham o mesmo item_group_id. Este atributo é obrigatório para variantes nas fichas gratuitas e, nos anúncios, em mercados como França, Alemanha ou Reino Unido.
O que faço se os meus produtos não têm EAN?
Se são de marca própria, feitos à medida ou vendidos só pela sua loja, é normal não terem EAN. Nesse caso, deixe o campo vazio e envie a marca e o MPN. A ajuda do Google proíbe inventar códigos, e um GTIN errado pode levar à reprovação do produto.
Que preço devo enviar: com ou sem IVA?
Com IVA. O PrestaShop guarda o preço sem impostos e calcula o valor final com a regra de impostos. A ajuda do Merchant Center inclui Portugal entre os países onde o preço enviado tem de incluir o imposto. Esse valor tem de coincidir com o que o cliente vê na página e no checkout.