Pular para o conteúdo
Documentação API Reference FAQ Changelog Status
Produtos 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 02/07/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çãoPor postagem, Na loja ou Em quiosque.
  6. Taxas de devoluçãoDevolução gratuita, Por conta do cliente ou Custo do frete de retorno.
  7. Tipo de reembolsoReembolso integral, Troca ou Crédito na loja.
  8. Etiqueta de devoluçãoPor 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?

Obrigado pelo seu feedback!