Como as miniaturas de SKU mudam quando o material delas é editado

Saiba por que a imagem de exibição de um SKU é substituída automaticamente sempre que seu material é salvo ou vinculado, e como evitar que atualizações de material apaguem configurações.

1. Um SKU com um material vinculado não mantém uma miniatura independente. Duas regras de sincronização causam isso. Primeiro, sempre que um material é salvo com uma nova textura ou uma nova cor, todo SKU que usa esse material tem sua imagem de exibição substituída na mesma operação: materiais com textura usam a imagem da textura, materiais de cor lisa recebem uma amostra de cor sólida gerada automaticamente. Segundo, sempre que um material é vinculado a um SKU pela edição em massa do catálogo, a imagem de exibição do SKU é definida como a amostra do material, sobrescrevendo qualquer miniatura personalizada que o cliente tenha enviado. Portanto, quando um cliente perguntar por que as imagens do SKU mudaram após editar um acabamento, ou por que uma foto personalizada do produto desapareceu após atribuir um material, esse é o comportamento esperado, não corrupção. Ele pode enviar novamente uma imagem personalizada depois, mas a próxima edição do material a sobrescreverá de novo. Mais um caso limite: um material salvo sem textura e sem cor não recebe amostra alguma, então o material (e qualquer SKU a ele vinculado durante a edição em massa) aparece com miniatura em branco nos seletores.

2. As imagens de perfil do catálogo não são independentes: quando o proprietário do catálogo edita o material do item (uma nova textura ou cor), a imagem exibida do perfil é substituída automaticamente, então uma imagem que parecia diferente antes pode mudar após a atualização.

3. A miniatura exibida de uma unidade é uma imagem de exibição derivada, então ela pode ficar desatualizada em relação ao desenho ou à configuração real da unidade.

4. O comportamento real da unidade é definido pelas propriedades e pelo desenho do SKU, não pela imagem da miniatura.

5. O endpoint de atualização de material exige id, name, material_template_id e properties em toda chamada; omitir qualquer um deles falha com MATERIAL_UPDATE_FAILURE. Não há atualização parcial: você não pode 'just rename' um material sem reenviar o id do template e as properties completas, e qualquer objeto properties enviado substitui inteiramente o armazenado. Combinado com a regra de validação de que apenas chaves desconhecidas são rejeitadas enquanto chaves ausentes passam silenciosamente, isso cria o clássico cenário de perda de dados: um cliente atualiza um material 'to change roughness' com um payload reduzido contendo apenas a chave roughness, o salvamento é bem-sucedido e todas as outras configurações (cor, mapas de textura, opacidade, metalness...) se perdem. O fluxo seguro para orientar os clientes: buscar o material atual, modificar os valores específicos no objeto properties retornado e reenviar o todo. Lembre também que toda atualização bem-sucedida deriva novamente a amostra de exibição do material e reescreve as miniaturas de todos os SKUs que usam esse material, então uma atualização ruim fica visível em todo o catálogo imediatamente — o que também significa que um novo salvamento correto com o payload completo repara tanto o material quanto as miniaturas dos SKUs de uma só vez.

6. Após atualizar a cor de um material do catálogo, atualize o cache a partir da primeira linha da aba Production Settings para que a nova cor apareça no design.

7. A opção Refresh Cache é o primeiro item da aba Production Settings.

   ✓ Verificado no produto em 16 de outubro de 2026

8. Refresh Cache aplica-se não apenas a cores e acabamentos de material editados, mas também a outras propriedades editadas de itens do catálogo, como detalhes de compras, para que esses valores atualizados cheguem ao design após a atualização do cache a partir das configurações.