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
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
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”
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”
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
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
Posso Deletar um Fork?
Sim! Se você decidir não mesclar um fork:- Abra o fork
- Clique em “Deletar Fork” ou “Descartar”
- Confirme
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!
- 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!
- 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
- 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
- Publicando seu catálogo — Torne suas mudanças ativas para clientes
- Adicionando produtos — Adicione itens às suas versões
- Importando produtos — Upload em massa de produtos para suas versões