O problema
Cadastrar coleção nova (200-2000 SKUs) é a tarefa mais tediosa do e-commerce. Time gasta 3-5 dias copiando do CSV/XLSX do fornecedor para o admin do Shopify/VTEX:
- Mapear categorias do fornecedor para taxonomia da loja
- Escrever descrição decente (a do fornecedor é seca e cheia de erro)
- Subir 8-15 fotos por SKU
- Configurar variações (tamanho/cor) com SKUs únicos
- Gerar SEO meta tags para cada produto
- Aplicar regras de preço (markup, desconto promocional)
Resultado: lançamentos atrasados, descrições copy-pasted, SEO sofrível.
A solução
Importador inteligente que processa o CSV/XLSX/Google Sheet do fornecedor e:
- Mapeia categorias automaticamente (LLM compara com sua árvore atual)
- Reescreve descrições seguindo o tom de voz da marca (você fornece 5-10 exemplos, ele aprende)
- Faz upload das imagens otimizadas (WebP, multi-resolution, CDN)
- Cria variações com SKUs únicos seguindo padrão da marca
- Gera SEO meta tags (title, description, OG image, schema markup) para cada SKU
- Aplica pricing rules configuráveis (margem por categoria, desconto promocional)
- Cria no Shopify/VTEX/Magento via API com rollback se algo falhar
Métricas em produção
| Cliente | Volume | Antes | Depois | Headcount |
|---|---|---|---|---|
| Fashion 4 marcas | 1.247 SKUs (PV 26) | 3 dias | 22 min | 0.5 → 0 FTE |
| Beauty | 487 SKUs/mês | 8 dias/mês | 1h/mês | 1 → 0.1 FTE |
| Esportes | 312 SKUs (verão) | 2 dias | 18 min | reduziu freelancer mensal |
O que vem incluso
- Conector universal (CSV, XLSX, Google Sheets, FTP, S3, API do fornecedor)
- AI writer treinado no tom de voz da marca
- Image pipeline (Sharp): WebP, AVIF, lazy load, srcset
- SEO generator: title, description, OG image, JSON-LD schema
- Painel admin com preview antes de publicar + bulk edit
- Rollback se algum SKU falha (transactional batch)
- Audit log completo (quem importou, quando, do quê)
Compatibilidade
- Plataformas destino: Shopify (Hydrogen ou Liquid), VTEX, Magento 2, Magento Adobe, WooCommerce, BigCommerce
- Formatos fonte: CSV, XLSX, Google Sheets, JSON, XML (NF-e style), API REST do fornecedor
Stack
- Python 3.13 + FastAPI + Pydantic v2
- OpenAI GPT-4o para descrições
- Sharp (Node.js subprocess) para image processing
- Supabase Storage para CDN
- Next.js para painel
Tempo de implementação
2-3 semanas:
- Sprint 1: conector + parser + image pipeline
- Sprint 2: AI writer com fine-tuning de tom de voz + SEO
- Sprint 3: painel + integração com plataforma destino + rollback
FAQ
E se o fornecedor manda dados ruins (com typo, faltando campos)? Validação por SKU. Os com problema vão para fila de revisão humana (~5-10% dos casos). O restante é publicado automaticamente. Painel mostra cada problema com sugestão de correção.
O AI writer respeita o nosso tom de voz? Você fornece 5-10 descrições da sua loja. O sistema aprende o estilo (formal/casual, técnico/aspiracional) e replica. Pode também aprovar/rejeitar exemplos durante o fine-tuning.
Funciona com fotos do fornecedor (que costumam ser ruins)? Detectamos qualidade baixa e flagamos para refoto manual. Para fotos OK: otimização automática (crop, watermark da marca, fundo branco padronizado, WebP, AVIF, multi-resolução).
Quanto custa rodar? LLM para descrições: ~R$ 0,08 por SKU. Para 1K SKUs/mês: R$ 80. Image pipeline: incluído. Setup: R$ 18K-35K. Licença: R$ 12K-24K/ano.
Qual o limite de SKUs por importação? Testamos com 10K SKUs por importação. Tipicamente 1K-3K SKUs por coleção é o sweet spot. Acima disso, recomendamos batches de 2K para facilitar revisão.
Quais plataformas destino são suportadas? Shopify (Hydrogen ou Liquid), VTEX, Magento 2, Magento Adobe Commerce, WooCommerce, BigCommerce, Linx Commerce, Bling Loja. Custom: 3-5 dias de integração.
Tem rollback se algo dá errado? Sim. Cada importação é uma transação. Se algum SKU falha no meio, podemos reverter tudo ou só os SKUs problemáticos (à escolha). Audit log mostra cada decisão.
Funciona com Google Sheets ou só CSV? Suporta CSV, XLSX, Google Sheets (sync ao vivo), FTP, S3, e API REST do fornecedor. Pode ser scheduled (toda segunda-feira) ou on-demand.