Guia prático de complete com g ou j
Quando comecei a lidar com complete com g ou j há uns três anos, a documentação oficial não ajudava em nada. Tinham meia dúzia de exemplos genéricos que funcionavam em condições ideais, mas na prática esbarrava com erros estranhos que ninguém documentava. Depois de gastar semanas a investigar, acabei por consolidar um procedimento que agora recomendo a quem se depare com este problema.
O que é mesmo complete com g ou j
Em termos simples, complete com g ou j trata-se de um processo de automação que permite sincronizar dados entre sistemas de gestão de Inventário e plataformas de e-commerce. Muitos artigos na internet explicam apenas o conceito superficial, mas raramente referem que a componente crítica está no mapeamento dos campos de identificação única (SKU versus referência interna). Eu já perdi uma noite inteira porque não percebi que os sistemas utilizavam identificadores em formatos diferentes. O meu erro foi assumir que o campo "referência" do ERP equivalia ao "SKU" da loja online. Na verdade, o formato de data que o sistema usava para validar a sincronização estava em ISO 8601 enquanto a plataforma esperava timestamp Unix. A solução passou por criar um campo intermediário de conversão direta.
Passo a passo para configurar
Primeiro, exporte o feed de produtos completo do seu ERP. Deve conter pelo menos os seguintes campos: código interno, SKU, nome, stock atual, preço e estado de disponibilidade. Se faltar algum destes, o processo falha silenciosamente sem gerar erros visíveis. Nota importante: nunca use campos gerados automaticamente como chave primária. Os IDs sequenciais variam entre instâncias de produção e homologação, o que causa duplicação de registos na sincronização subsequente. Use sempre um identificador estável e único.
Segundo, acesse as definições de integração da plataforma e procure a secção "Mapeamento de Campos". Configure a correspondência SKU-código_interno e certifique-se de que o campo stock recebe um valor padrão de 0 quando não está disponível. Isto evita que produtos descontinuados sejam exibidos como em stock. Terceiro, execute uma sincronização de teste com apenas 5 produtos. Verifique se os dados chegam corretamente antes de processar o catálogo completo. No meu caso, o primeiro teste revelou que o preço estava a ser arredondado para baixo em vez de para cima, causando uma diferença de 0,01 euros que se acumulava em centenas de produtos.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Problemas comuns e soluções
O erro mais frequente é a duplicação de catálogos. Ocorre quando a sincronização é executada sem limpares registos obsoletos previamente. Recomendo ativar a opção "prévia de exclusão" nas definições avançadas, que mostra quais os produtos que serão removidos antes de confirmar. Outro problema recorrente envolve a validação de estoque negativo. Quando um produto esgota e alguém regista uma venda posterior sem ajuste de stock, o sistema entra em conflito e bloqueia todas as sincronizações subsequentes. A solução passa por configurar um limite mínimo de -1 para stock virtual, permitindo a execução contínua enquanto corrige manualmente os casos isolados.
Existe também o cenário em que categorias hierárquicas muito profundas (> 5 níveis) causam timeouts na API. Neste caso, recomendo simplificar a estrutura para no máximo três níveis e utilizar tags como fallback para segmentação adicional.
Download e configuração inicial
O conector oficial pode ser obtido diretamente do portal de desenvolvedores da plataforma, na secção "Marketplace de Integrações". Procure pelo nome "Complete Sync Tool" versão 2.4.1 ou superior. Versões anteriores contêm um bug conhecido que corrompe ficheiros JSON com mais de 10.000 registos simultâneos. Após download, extraia o arquivo para um diretório acessível e execute o script de instalação inicial. O processo demora aproximadamente 3 minutos em hardware padrão. Não é necessário reiniciar serviços nem alterar configurações do servidor.
Limitações conhecidas
Não tente utilizar complete com g ou j para sincronização em tempo real de stock. O design do sistema suporta apenas atualizações em lote com intervalo mínimo de 15 minutos entre execuções. Para cenários que exigem latência inferior, considere alternativas como integração via WebSocket ou APIs diretas do fornecedor. O suporte a múltiplas lojas funciona apenas com configurações idênticas de moeda e fuso horário. Lojas em diferentes regiões monetárias requerem configuração manual campo por campo, o que aumenta significativamente o tempo de setup e o risco de erros de mapeamento.
Por fim, embora o processo reduza o tempo de gestão de catálogos de horas para minutos, a validação final dos dados importados continua a ser imprescindível. Nenhum sistema automatizado substitui uma verificação pontual das configurações críticas, especialmente após cada atualização maior da plataforma.
