- Blog da Bruxel.AI
- Caso de uso: quando o ERP, a loja e a ficha técnica dizem coisas diferentes
Caso de uso: quando o ERP, a loja e a ficha técnica dizem coisas diferentes
Por Manuel Mattar3 min de leitura
Em resumo
Neste exemplo, o fabricante conecta o ERP, o sistema de engenharia e a loja ao Bruxel, cada um com sua própria chave. Cada sistema informa o que diz sobre um atributo sem sobrescrever o valor mestre, a equipe vê onde não coincidem em uma fila e decide qual passa para o mestre, com histórico.
Este é um cenário de exemplo, não um cliente. Os sistemas, os produtos e os números são hipotéticos.
A situação
Um fabricante de bombas d'água tem uns 2.000 produtos e três lugares onde a informação vive:
- O ERP, com o peso e as medidas de embarque que a logística usa.
- O sistema de engenharia, de onde saem as fichas técnicas em PDF, com potência, vazão e voltagem.
- A loja on-line, onde alguém corrigiu alguns dados à mão ao longo dos anos.
Um cliente reclama que a bomba pesa diferente do que diz a loja. Ao conferir, o ERP diz 12,5 kg, a ficha técnica 12,8 kg e a loja 12 kg. Ninguém sabe qual é o certo, e cada sistema sobrescreve o outro quando sincroniza.
O que a equipe faz no Bruxel, passo a passo
1. Uma chave por sistema
Em Canais → Sistemas conectados, a equipe cadastra os três sistemas, e em Canais → Chaves de API emite uma chave para cada um, com permissão para escrever atributos. Cada sistema usa a sua: assim o Bruxel sabe quem disse o quê.
2. Cada sistema informa o seu, sem sobrescrever ninguém
Cada integração manda pela API pública o que o seu sistema diz sobre um atributo. O Bruxel valida o valor como o do mestre (uma medida é convertida para a unidade do atributo) e guarda como a versão daquele sistema. O valor mestre —o que sai nos downloads e nos canais— não muda.
3. Ver as diferenças na ficha
Abaixo de cada atributo informado, a ficha do produto diz quantas fontes há e se coincidem com o mestre, por exemplo «3 fontes · não coincidem», com o valor de cada sistema e quando foi visto. Se a engenharia confirma que o peso real é o da sua ficha, alguém clica em «Usar este» e esse valor passa para o mestre. No histórico, fica como «Conciliação».
4. Resolver em bloco
Com 2.000 produtos, revisar ficha por ficha não escala. Em Catálogo → Conciliação por fonte estão todos os produtos cujos sistemas não coincidem, com filtros por família, atributo e fonte. No exemplo, a equipe decide que para o peso vale o ERP e para a potência vale a engenharia: filtra por atributo, marca as linhas, escolhe «Usar o valor de» o sistema certo e clica em «Enviar ao mestre». O que não deu para fazer, o Bruxel explica: essa fonte não informou o atributo, o atributo é protegido ou uma regra o define.
5. Os PDFs, junto ao produto
As fichas técnicas são enviadas na ficha do produto, aba Arquivos, com o tipo «Ficha técnica». São privadas, baixadas com um link que dura 5 minutos e só depois de passar pela verificação de vírus. Para os certificados, em Mídia → Tipos de arquivo a equipe cria um tipo com validade, e a aba diz se está «Vigente», «A vencer» ou «Vencido».
6. Avisar os sistemas quando o mestre muda
Em Canais → Webhooks, a equipe cadastra o endereço do ERP e o da loja e escuta o aviso de produto atualizado. Cada vez que o mestre muda, o aviso diz o que mudou (campos e códigos, nunca valores) e o sistema relê a ficha. Os avisos vão assinados, e «Ver entregas» mostra cada tentativa e o que o sistema respondeu.
7. Saber quanto falta
Em Relatórios, «Divergências entre fontes» baixa a lista completa, e o relatório de qualidade em PDF diz quantas faltam resolver.
O que fica resolvido
- Nenhum sistema sobrescreve o outro: cada um diz o seu e o mestre é uma decisão, não a última sincronização.
- Cada diferença aparece com sua fonte e sua data, e cada resolução fica no histórico.
- Os sistemas ficam sabendo da mudança sem que ninguém precise avisar.
O que não fica resolvido
- O Bruxel não lê os PDFs. O que a ficha técnica diz só entra na conciliação se um sistema o informar pela API.
- O Bruxel não escreve no seu ERP nem na sua loja. Ele avisa; atualizar é trabalho de cada integração.
- Não se aplica a atributos de seleção múltipla, e a comparação é exata: 12,5 e 12,8 não coincidem, mesmo que a diferença seja pequena.
- Decidir qual sistema tem razão continua sendo trabalho da equipe. O Bruxel mostra a diferença; não sabe qual balança está bem calibrada.
- As integrações são construídas pela sua equipe ou pelo seu integrador, com a documentação do portal para desenvolvedores.
Para se aprofundar, leia os guias de conciliação por fonte, documentos técnicos e webhooks, ou as páginas de Conciliação, Integrações e Arquivos.
Perguntas frequentes
O que um sistema informa muda o valor do produto?
Não. O que um sistema informa é guardado à parte e não muda o mestre, nem o histórico, nem a completude. O mestre muda quando alguém com papel de Editor ou superior escolhe Usar este ou resolve em bloco a partir da fila.
O Bruxel lê os valores das minhas fichas técnicas em PDF?
Não. Os PDFs ficam guardados junto ao produto, privados e verificados contra vírus, mas o Bruxel não extrai seus valores. O que a ficha técnica diz entra na conciliação quando um sistema o informa pela API.
Por que 285 e 285,4 aparecem como divergência?
Porque a comparação é exata, depois de converter unidades. O Bruxel não arredonda por conta própria: se dois sistemas dão números diferentes, ele mostra para você decidir qual está certo.
Fontes
Sobre o autor
Manuel Mattar
Fundador da Bruxel.AI
Fundou em 2014 a Wolf Sellers, agência de comércio eletrônico na Cidade do México, e depois a Bruxel.AI, o PIM com IA.
Ver todos os artigos de Manuel MattarExperimente com o seu catálogo
Crie sua conta grátis e experimente a Bruxel com seus próprios produtos usando os créditos de boas-vindas.
Continue lendo
· 4 min de leitura
Caso de uso: levar a completude do catálogo de 30% a 90% em um mês
Um exemplo semana a semana: um catálogo mede sua completude, ataca o que mais pontua, gera, revisa e volta a medir com os relatórios da Bruxel.
· 4 min de leitura
O catálogo na Bruxel: atributos, famílias, categorias e variantes
Como a Bruxel organiza um catálogo: atributos tipados com regras, famílias que mostram o que falta, uma árvore de categorias, a grade e variantes.
· 4 min de leitura
Importar e vincular produtos na Bruxel: do arquivo ao catálogo
Como a Bruxel importa seu catálogo de CSV ou Excel, o que faz com cada coluna, como monta relacionados, venda cruzada e kits, e para que servem as visões.