O que é Versionamento de Catálogo?
Versionamento de catálogo permite que você crie cópias de trabalho separadas do seu catálogo. Pense nisso como fazer uma cópia rascunho de um documento importante—você pode editar a cópia sem afetar o original, então mesclar as mudanças de volta quando estiver pronto.
Isso é especialmente útil quando você quer:
- Testar mudanças de produto antes que os clientes as vejam
- Reorganizar a estrutura do seu catálogo
- Trabalhar em atualizações sazonais mantendo o catálogo atual ativo
- Experimentar com diferentes descrições de produto ou preços
- Fazer mudanças em grande escala com uma rede de segurança
Como o Versionamento Funciona: Fork, Editar, Mesclar
1. Fork (Criar uma Versão)
Fork cria uma cópia exata do seu catálogo naquele momento.
- Seu catálogo principal permanece inalterado e continua servindo clientes
- Seu fork é uma cópia de trabalho separada onde você pode fazer quaisquer mudanças que quiser
- Mudanças no fork não afetam o catálogo principal
Exemplo:
Você tem um catálogo publicado chamado “Eletrônicos” com 500 produtos. Você quer atualizar descrições de produtos. Em vez de editar o catálogo ativo diretamente, você primeiro cria um fork.
2. Editar (Fazer Mudanças)
Na sua versão em fork, você pode:
- Adicionar novos produtos
- Editar produtos existentes
- Remover produtos
- Mudar preços
- Atualizar descrições
- Reorganizar tudo
Você pode levar seu tempo testando e refinando. Nada que os clientes veem é afetado.
3. Mesclar (Aplicar Mudanças)
Mesclar traz suas mudanças do fork de volta para o catálogo principal.
Depois que você estiver satisfeito com suas mudanças e tudo parecer bom, você mescla o fork de volta. O catálogo principal é atualizado com suas mudanças e os clientes veem a nova versão.
Quando Usar Versionamento
✓ Use Versionamento Quando:
- Fazer mudanças estruturais (renomear produtos, reorganizar atributos)
- Testar atualizações significativas de preço ou descrição
- Preparar atualizações de catálogo sazonais
- Trabalhar em grandes projetos de reorganização
- Múltiplos membros da equipe trabalhando em diferentes mudanças simultaneamente
✗ Não Precisa de Versionamento Quando:
- Fazer pequenas correções rápidas (apenas edite diretamente)
- Adicionar alguns novos produtos (apenas adicione-os)
- Fazer mudanças pontuais que precisam de lançamento imediato
- Você está confiante no que está mudando
Passo a Passo: Criar e Mesclar uma Versão
Criando um Fork
- Abra o catálogo que você quer versionar
- Clique no botão “Versão” ou “Criar Fork”
- Dê ao seu fork um nome descritivo (ex: “Atualização Verão 2025”, “Teste de Preços”, “Novas Descrições”)
- Clique em “Criar”
Seu fork agora está criado. Você está pronto para fazer mudanças!
Trabalhando no seu Fork
- Mude para o seu fork (você verá em qual versão está no topo)
- Faça todas as suas mudanças—adicione produtos, edite descrições, atualize preços, etc.
- Leve seu tempo. Teste tudo. Não há pressa.
- Quando estiver satisfeito com suas mudanças, você está pronto para mesclar
Revisando Antes de Mesclar
Antes de mesclar de volta ao catálogo principal:
- Compare seu fork com o catálogo principal—a maioria dos sistemas mostra uma comparação lado a lado
- Procure por mudanças inesperadas
- Verifique se preços, descrições e nomes de produtos estão corretos
- Verifique se a estrutura parece boa
- Se encontrar problemas, volte e corrija-os no fork
Mesclando seu Fork de Volta
- Na visualização do seu fork, clique em “Mesclar” ou “Solicitar Mesclagem”
- Confirme em qual versão você está mesclando (geralmente seu catálogo principal)
- Revise o resumo da mesclagem
- Clique em “Confirmar Mesclagem”
Suas mudanças agora estão no catálogo principal! Se o catálogo principal está publicado, os clientes verão as atualizações (geralmente dentro de minutos).
Exemplos do Mundo Real
Exemplo 1: Atualização Sazonal
Exemplo 2: Atacado vs Varejo
Exemplo 3: Mudanças Multi-Equipe
Conceitos Importantes
O que Acontece Quando Você Faz Fork?
- Copiado: Todos os produtos, atributos, descrições, imagens, preços
- Preservado: O estado exato no momento do fork
- Não Copiado: Pedidos de clientes ou status de publicação
O que é Mesclado?
Quando você mescla um fork de volta:
- Todos os novos produtos que você adicionou
- Todas as edições que você fez em produtos existentes
- Todas as exclusões
- Ordem/organização de produtos
- Mas NÃO: Dados de cliente, histórico de pedidos, conexões de integração
Posso Ter Múltiplos Forks?
Sim! Você pode criar múltiplos forks do mesmo catálogo. Isso é útil quando:
- Múltiplos membros da equipe estão trabalhando em diferentes atualizações
- Você quer fazer teste A/B de duas abordagens diferentes
- Você está preparando múltiplas coleções sazonais
Apenas lembre qual fork você quer mesclar quando estiver pronto.
E Se Houver Conflitos?
Um conflito acontece quando:
- Você edita um produto no seu fork
- Alguém mais edita o mesmo produto no catálogo principal enquanto você está trabalhando
- O sistema não sabe qual versão manter
A maioria dos sistemas resolve conflitos automaticamente mostrando ambas as versões para você escolher. Se não tiver certeza, pergunte à sua equipe ou contate o suporte.
Posso Deletar um Fork?
Sim! Se você decidir não mesclar um fork:
- Abra o fork
- Clique em “Deletar Fork” ou “Descartar”
- Confirme
O fork é deletado. O catálogo principal não é afetado.
Quando o Versionamento Salva o Dia
Cenário 1: Ops, Mudanças Erradas
- Você fez mudanças em um fork mas percebeu que estão erradas
- Solução: Delete o fork, comece de novo
- Seu catálogo principal? Perfeitamente bem—intocado o tempo todo!
Cenário 2: Coordenando Mudanças da Equipe
- Você e um colega ambos precisam atualizar o catálogo
- Solução: Cada um cria seu próprio fork, trabalham em paralelo, mesclam separadamente
- Sem pisar no pé um do outro!
Cenário 3: Testando Antes de um Grande Lançamento
- Você está preparando uma grande atualização de catálogo sazonal
- Solução: Crie um fork, faça todas as mudanças, revise cuidadosamente, então mescle quando pronto
- Confiança de que tudo está correto antes que os clientes vejam!
Melhores Práticas para Versionamento
Faça:
- Use nomes descritivos de fork (o que você está mudando?)
- Revise mudanças antes de mesclar
- Mantenha forks focados em um tipo de mudança quando possível
- Delete forks que você não está mais usando
- Comunique-se com sua equipe sobre forks ativos
Não Faça:
- Manter forks antigos para sempre (limpe-os)
- Mesclar de volta sem revisar mudanças
- Criar um fork para cada pequena edição (use edição direta para correções rápidas)
- Esquecer de mesclar quando terminar (atualizações ficam em forks indefinidamente)
Para Usuários Técnicos
Para informações detalhadas sobre arquitetura de versionamento, integração de API e workflows avançados, veja nosso Guia de Gerenciamento de Catálogo e Conceitos de Catálogos.
Próximos Passos
Última modificação em 16 de fevereiro de 2026