Pular para o conteúdo
Documentação API Reference
SEO e Pesquisa Magento 2 Adobe Commerce

Política de Devolução no Schema do Produto (Merchant Listings)

PDF

Configure a política de devolução dos seus produtos no schema do Google (hasMerchantReturnPolicy), melhorando a exibição nos resultados de busca.

O Otávio Augusto Moraes 02/07/2026 Atualizado 12/10/2026 8 min de leitura
  • Adiciona a política de devolução dos seus produtos aos dados estruturados (schema.org) que o Google lê na página de produto.
  • Ajuda os produtos a aparecerem com informações de devolução nos resultados de compras do Google (Merchant Listings / listagens gratuitas), o que aumenta a confiança do cliente.
  • Você define regras com prazo, país, forma de devolução, taxas, tipo de reembolso e etiqueta — e pode aplicar regras diferentes para produtos diferentes.
  • Disponível para lojas Magento 2.

Passo a Passo por Escrito

1. Acesse as configurações de Dados Estruturados

No painel administrativo, vá em Lojas → Configuração → Catálogo → Dados Estruturados.

Na tela de configuração, localize e abra o grupo Política de Devolução (Merchant Listings).

A política de devolução é inserida dentro do schema do produto. Por isso, o schema de produto dos Dados Estruturados precisa estar ativado para que ela apareça — confira essa opção na mesma tela de configuração.

Resultado esperado: O grupo Política de Devolução (Merchant Listings) é exibido com os campos de configuração disponíveis.


2. Ative a política de devolução

No campo Ativar política de devolução (hasMerchantReturnPolicy), selecione Sim.

Por padrão, o recurso vem desativado (marcado como Não): selecione Sim para ativá-lo. O módulo já traz uma regra de exemplo pré-configurada (7 dias, Brasil, devolução por postagem, reembolso integral) — ajuste-a para refletir a política real da sua loja antes de ativar.

Resultado esperado: Os campos Código do atributo e Regras ficam visíveis logo abaixo.


3. Confira o código do atributo seletor de regra

No campo Código do atributo (seletor de regra), mantenha o valor padrão return_policy_rule, a menos que você use outro atributo do produto para escolher a regra.

Esse campo indica qual informação do produto o módulo lê para decidir qual regra aplicar. Cada produto guarda um número de regra; o módulo usa esse número para encontrar a regra correspondente.

Se o produto não tiver nenhum valor definido, o módulo usa a regra padrão (a regra cujo Valor do atributo é 0).

Resultado esperado: O campo exibe return_policy_rule (ou o atributo que você escolheu).


4. Configure as regras de devolução

No campo Regras, cada cartão representa uma política de devolução. Clique em + Adicionar regra para criar novas.

Preencha os campos de cada regra:

  1. Valor do atributo — o número que liga esta regra ao produto. Use 0 para a regra padrão (aplicada a todos os produtos que não têm outra regra).
  2. Categoria — o tipo de política: Prazo de devolução definido (N dias), Não aceita devolução, Devolução sem prazo limite ou Não especificado.
  3. Prazo de devolução (dias) — número de dias (ex: 7, 30). Usado apenas quando a categoria é Prazo de devolução definido.
  4. País (ISO) — código do país em duas letras (ex: BR). Para mais de um país, separe por vírgula (ex: BR,PT).
  5. Forma de devolução — Por postagem, Na loja ou Em quiosque.
  6. Taxas de devolução — Devolução gratuita, Por conta do cliente ou Custo do frete de retorno.
  7. Tipo de reembolso — Reembolso integral, Troca ou Crédito na loja.
  8. Etiqueta de devolução — Por conta do cliente, Baixar e imprimir ou Na loja.

Campos deixados em branco (com a opção —) simplesmente não entram no schema. Preencha apenas o que fizer parte da sua política.

Se a categoria for Não aceita devolução, o módulo publica apenas essa informação (e o país). Prazo, taxas e reembolso são ignorados, pois não fazem sentido nesse caso.

Resultado esperado: Cada regra aparece como um cartão preenchido com os dados da sua política de devolução.


5. Defina a regra por produto (opcional)

Se você quer políticas diferentes para produtos diferentes, edite o produto e vá até a aba Otimização para mecanismos de busca (SEO).

No campo Regra de política de devolução (Schema), informe o número da regra desejada (o mesmo Valor do atributo configurado no passo 4). Deixe 0 ou em branco para usar a regra padrão.

Não é obrigatório configurar produto a produto. Se você só tem uma política para a loja inteira, basta manter a regra 0 e todos os produtos a utilizarão.

Resultado esperado: O produto passa a usar a regra correspondente ao número informado.


6. Salve e limpe o cache

Clique em Salvar configuração no topo da tela.

Em seguida, vá em Sistema → Gerenciamento de Cache e limpe o cache da loja para que as alterações apareçam no frontend.

Sem limpar o cache, as mudanças podem demorar a aparecer no código da página de produto.

Resultado esperado: Uma mensagem de "A configuração foi salva" é exibida no topo da tela.


Validação e Testes

Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.

Teste 1 — Verificar o schema na página de produto

Ação: Abra uma página de produto na sua loja. Clique com o botão direito e escolha Exibir código-fonte da página. Procure (Ctrl+F) por hasMerchantReturnPolicy.

Resultado esperado: O bloco de dados estruturados do produto contém hasMerchantReturnPolicy com as informações da regra que você configurou (categoria, prazo, país, etc.).


Teste 2 — Validar no Teste de Resultados Aprimorados do Google

Ação: Acesse o Teste de Resultados Aprimorados do Google, cole a URL de um produto e execute o teste.

Resultado esperado: O produto é reconhecido e a política de devolução aparece entre as propriedades detectadas, sem erros críticos.


Teste 3 — Testar uma regra específica por produto

Ação: Em um produto, defina o campo Regra de política de devolução (Schema) com o número de uma regra diferente da padrão (ex: uma regra Não aceita devolução). Salve, limpe o cache e reabra a página de produto.

Resultado esperado: O schema desse produto reflete a regra escolhida (ex: apenas a categoria de "não aceita devolução"), enquanto os demais produtos continuam com a regra padrão.


Se não funcionar, verifique:

  • Se o campo Ativar política de devolução está como Sim.
  • Se o módulo de Dados Estruturados está habilitado para a página de produto (o schema do produto precisa existir para receber a política).
  • Se você limpou o cache após salvar.
  • Se a regra padrão (Valor do atributo 0) está preenchida, ou se o produto aponta para um número de regra que realmente existe.
  • Se a Categoria da regra foi selecionada (uma regra sem categoria não é publicada).

Pronto! Dessa forma realizamos a configuração da Política de Devolução no Schema do Produto em sua loja virtual Magento 2.


Observações Importantes

  • Onde a política aparece: ela entra nos dados estruturados da página de produto, dentro das ofertas do produto. É essa informação que o Google lê — ela não muda visualmente a sua loja, apenas o que os buscadores enxergam.
  • Produtos configuráveis, agrupados e bundle: a política é aplicada a cada oferta do produto, inclusive nas variações. Não é necessária nenhuma configuração extra para esses tipos.
  • Regra padrão e reserva: a regra com Valor do atributo 0 funciona como padrão. Sempre que um produto não tiver uma regra específica (ou apontar para um número inexistente), essa regra padrão é usada.
  • Campos vazios são omitidos: só entram no schema os campos que você preencher. Isso evita publicar informação incompleta ou incorreta.
  • Categoria "Não aceita devolução": publica apenas a categoria e o país; os demais campos são ignorados de propósito.
  • O campo por produto fica na aba SEO: o campo Regra de política de devolução (Schema) aparece no cadastro do produto, dentro do grupo de otimização para buscadores.

Referências e Relacionados

  • Configuração de Dados Estruturados (schema de produto): este recurso depende do schema de produto estar ativo. Entenda como habilitar e configurar os dados estruturados da loja.
  • Atributos de produto: o recurso usa um campo do produto para escolher a regra. Veja como funcionam os atributos personalizados no cadastro de produtos.
  • Limpeza de cache da loja: após qualquer alteração, é preciso limpar o cache para que o schema atualizado apareça no frontend.
  • SEO e resultados aprimorados no Google: contexto sobre como os dados estruturados influenciam a exibição dos produtos nas buscas.

Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!