Pular para o conteúdo principal
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

  1. Abra o catálogo que você quer versionar
  2. Clique no botão “Versão” ou “Criar Fork”
  3. Dê ao seu fork um nome descritivo (ex: “Atualização Verão 2025”, “Teste de Preços”, “Novas Descrições”)
  4. Clique em “Criar”
Seu fork agora está criado. Você está pronto para fazer mudanças!

Trabalhando no seu Fork

  1. Mude para o seu fork (você verá em qual versão está no topo)
  2. Faça todas as suas mudanças—adicione produtos, edite descrições, atualize preços, etc.
  3. Leve seu tempo. Teste tudo. Não há pressa.
  4. 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:
  1. Compare seu fork com o catálogo principal—a maioria dos sistemas mostra uma comparação lado a lado
  2. Procure por mudanças inesperadas
  3. Verifique se preços, descrições e nomes de produtos estão corretos
  4. Verifique se a estrutura parece boa
  5. Se encontrar problemas, volte e corrija-os no fork

Mesclando seu Fork de Volta

  1. Na visualização do seu fork, clique em “Mesclar” ou “Solicitar Mesclagem”
  2. Confirme em qual versão você está mesclando (geralmente seu catálogo principal)
  3. Revise o resumo da mesclagem
  4. 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

Semana 1:
  - Fork do catálogo "Eletrônicos" atual
  - Renomeie para "Eletrônicos - Preparação Inverno 2025"
  - Adicione 50 produtos de inverno
  - Teste tudo

Semana 2:
  - Revise todos os produtos
  - Ajuste alguns preços
  - Atualize descrições

Semana 3:
  - Mescle de volta ao catálogo principal
  - Produtos de inverno agora estão ativos

Exemplo 2: Atacado vs Varejo

Cenário: Você quer preços diferentes para clientes atacado vs varejo

- Fork do seu catálogo "Vestuário" principal
- Crie uma versão "Vestuário - Atacado"
- Atualize preços para descontos de atacado
- Mantenha as versões separadas e mescle conforme necessário

Exemplo 3: Mudanças Multi-Equipe

Cenário: Sua equipe de produto e equipe de marketing precisam trabalhar no catálogo simultaneamente

- Crie dois forks: um para equipe de produto, um para equipe de marketing
- Cada equipe faz suas mudanças no próprio fork (sem conflitos!)
- Quando terminado, mescle o fork de produto primeiro
- Então mescle o fork de marketing (sistema lida com quaisquer sobreposições)

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:
  1. Abra o fork
  2. Clique em “Deletar Fork” ou “Descartar”
  3. 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

Last modified on February 16, 2026