Pular para o conteúdo
Todos os posts
17 de janeiro de 2025·2 min de leitura·Diogo Hudson

Por que o Quotery tem quatro códigos de produto

Seu SKU é seu. O import_code do fornecedor é dele. O export_code do cliente é dele. E o sistema legado ainda está olhando.

Por que o Quotery tem quatro códigos de produto

A maioria dos catálogos tem um código: o SKU. Funciona até o fornecedor do seu comprador usar o código dele, e o sistema de compras do seu maior cliente esperar um terceiro código, e o ERP interno de vinte anos que você está desativando ainda não ter saído de cena.

Essa é a realidade da distribuição. Produtos se movem entre sistemas, e cada sistema tem sua própria convenção de nomenclatura. A nota do fornecedor diz 'FAN-450-B'. Seu almoxarifado etiqueta 'FAN450'. O portal de compras do cliente espera 'FAN-450-BLACK'. E o ERP legado — aquele que roda desde 2003 e ninguém ousa desligar — ainda chama de 'ELEC-FAN-0450'. Quatro códigos. Um produto. E se sua ferramenta de cotação só entende um deles, você está traduzindo manualmente os outros três todo dia.

As quatro colunas O Product do Quotery tem sku, import_code, internal_code e export_code. Cada um com GIN trigram para busca rápida de substring. Cada um pesquisável separado ou em conjunto.

O índice trigram é o herói invisível aqui. Um índice B-tree padrão responde 'essa string exata existe?' mas não 'essa string aparece em algum lugar nesse campo?' Com GIN trigram, uma busca por 'FAN450' encontra 'FAN-450-B', 'FAN450BLK' e 'ELEC-FAN-0450' — tudo em milissegundos. Isso importa porque documentos de fornecedor raramente usam o formato exato do seu código. Eles adicionam hífens, removem prefixos, concatenam com cores. O índice trigram absorve essa variância sem exigir que o usuário aprenda regex.

Por que a importação com IA se importa Quando o importador com IA processa uma linha, ele checa as quatro colunas antes de pedir para o modelo raciocinar. É a diferença entre importar 99% determinístico e queimar token em problema que você já resolveu.

Cada match determinístico economiza cerca de 200-500 tokens e 500ms de latência. Numa importação de 20 linhas, se 14 batem deterministicamente, o passo de IA só processa 6 linhas em vez de 20 — redução de 70% em custo e latência. E os matches determinísticos são garantidos corretos. Os matches da IA são probabilísticos. Cada linha que você resolve sem o modelo é uma linha que não precisa revisar.

Amigável para migração Um cliente migrando de sistema legado pode jogar os códigos velhos em internal_code, subir SKUs novos, e deixar o importador fazer a ponte até o código antigo sumir.

Migração é a fase de maior risco de qualquer troca de sistema. Os códigos antigos não desaparecem da noite para o dia — fornecedores continuam mandando, clientes continuam pedindo por eles, e catálogos impressos ainda os referenciam. Mantendo os códigos antigos vivos em internal_code enquanto o novo sistema de SKU assume, a transição é gradual e reversível. Quando o último fornecedor trocar para o novo código e o último cliente parar de usar o antigo, você pode parar de popular internal_code. Mas até lá, a ponte fica de pé.

Como o catálogo de produtos cruza códigos de fornecedor.

Todos os posts
Textos curtos sobre cotação, estoque, IA e como distribuidores pequenos despacham muito volume sem frescura.