• A Guarda de Tipo de Produto protege os produtos da sua loja contra mudanças de tipo feitas por engano.
• Resolve um problema comum em integrações: um produto configurável que "vira" simples sozinho depois que um sistema externo (como um ERP) atualiza o cadastro — fazendo o produto perder suas variações.
• Funciona em segundo plano: quando um sistema externo tenta mudar o tipo de um produto que já existe, a alteração é recusada e o produto é preservado.
• Disponível para lojas Magento 2.

#Passo a Passo por Escrito

#1. Acesse as configurações do recurso

Acesse o painel administrativo da sua loja e vá em Lojas → Configuração → Serviços → Magento Web API.

Na tela de configuração, localize o grupo Guarda de Tipo de Produto.

#2. Ative a proteção

No campo Ativar Guarda de Tipo, selecione Sim.

#3. Salve a configuração

Clique em Salvar configuração, no canto superior direito da tela.

#4. Limpe o cache da loja

Vá em Sistema → Gerenciamento de Cache e clique em Liberar Cache de Armazenamento do Magento.

#Validação e Testes

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

Teste 1 — Confirme que a proteção está ativada

Ação: volte em Lojas → Configuração → Serviços → Magento Web API → Guarda de Tipo de Produto e verifique o valor do campo Ativar Guarda de Tipo.

Teste 2 — Confirme que cadastros e atualizações normais continuam funcionando

Ação: cadastre um produto novo e atualize um produto já existente (pelo seu sistema externo ou manualmente), mantendo o mesmo tipo do produto.

Teste 3 — Confirme que a conversão indevida é bloqueada

Ação: peça ao responsável pela integração que reenvie, pelo sistema externo, um produto configurável já existente como se fosse de outro tipo (por exemplo, simples).

Se não funcionar, verifique:

• O campo Ativar Guarda de Tipo está em Sim.
• O cache da loja foi limpo depois de salvar a configuração.
• A sua integração realmente atualiza os produtos pela conexão com a loja (a proteção atua sobre atualizações automáticas vindas de sistemas externos).

#Observações Importantes

• A proteção vale para a loja inteira. Ela não é configurada por produto nem por visão de loja — uma vez ativada, protege todos os produtos.
• Vem desativada por padrão. Depois de instalada, é preciso ativá-la (passo 2) para que a proteção funcione. Instalado não significa ativo.
• Atua sobre atualizações automáticas (integrações). Pela tela de produtos do admin, o tipo de um produto já criado não pode ser trocado — por isso a proteção foca nas atualizações que chegam de sistemas externos, como um ERP.
• Produtos configuráveis e suas variações têm códigos (SKU) próprios. O produto pai e cada variação devem ter códigos distintos. A proteção garante que o tipo de cada um não seja trocado por engano quando o mesmo código é reenviado.
• Quando algo é bloqueado, o sistema externo recebe um aviso explicando o motivo: qual produto, o tipo atual e o tipo que se tentou aplicar. Esse aviso ajuda quem cuida da integração a corrigir o envio.

#Referências e Relacionados

• Configuração de cache da loja: após ativar ou alterar esta proteção, é necessário atualizar o cache para que a mudança entre em vigor na loja.
• Importação e exportação de dados: se você atualiza produtos em massa, entenda como as importações lidam com os produtos já cadastrados.
• Integrações com sistemas externos: este recurso protege as atualizações que chegam de sistemas externos (como um ERP); entenda como funcionam as integrações com a sua loja.