Documentação FlowDino
Descubra como usar todas as funcionalidades do FlowDino
📚 Menu Documentation
📊 Sistema de importação
Sistema de Importação
Descubra como importar facilmente seus produtos em massa via arquivos CSV com o FlowDino
Navegação rápida
Visão geral do sistema de importação
O sistema de importação FlowDino permite importar rapidamente e facilmente centenas ou milhares de produtos via arquivos CSV. Projetado para ser flexível e robusto, ele se adapta a diferentes formatos de dados, mantendo a qualidade e a coerência do seu catálogo.
✅ Vantagens da importação CSV
- Importação em massa : Importe milhares de produtos de uma só vez
- Dados estruturados : Mantenha a coerência dos seus dados
- Mapeamento flexível : Adapte qualquer formato CSV ao FlowDino
- Processamento assíncrono : Continue trabalhando durante a importação
- Acompanhamento em tempo real : Monitore o progresso das suas importações
🔧 Funcionalidades avançadas
- Mapeamento inteligente das colunas com detecção automática
- Mapeamento dos valores para harmonizar seus dados
- Validação em tempo real dos dados antes da importação
- Pré-visualização dos dados antes do processamento
- Processamento em lote para otimizar o desempenho
Formato de arquivo requerido
📋 Exigências do arquivo CSV
- Formato: Arquivo CSV (Comma Separated Values) com extensão .csv
- Codificação: UTF-8 com BOM recomendado para caracteres especiais
- Separador: Ponto e vírgula (;) ou vírgula (,) de acordo com suas preferências
- Cabeçalhos: Primeira linha obrigatória contendo os nomes das colunas
📝 Exemplo de arquivo CSV
Aqui está um exemplo de arquivo CSV corretamente formatado :
titulo;description;preco;marca;cor;tamanho;estado
"Camiseta Vermelha";"Camiseta 100% algodão";"15.99";"Nike";"Vermelho";"M";"Muito bom estado"
"Jeans Azul";"Jeans slim fit";"39.99";"Levi's";"Azul";"42";"Novo com etiquetas"
"Tênis Esportivos";"Tênis de corrida";"89.99";"Adidas";"Preto|Branco";"43";"Bom estado"🎯 Campos suportados
Campos básicos
- titulo / title
- description
- preco / price
- marca / brand
- referência / sku
- peso / weight
Atributos do produto
- cor / color
- tamanho / size
- material / material
- estado / condition
- categoria / category
- imagens / pictures
Guia passo a passo
🎯 Processo em 4 etapas: A importação ocorre em 4 etapas distintas, cada uma com seu papel específico para garantir uma importação otimizada dos seus dados.
Seleção do arquivo
Primeira etapa : escolha e faça o upload do seu arquivo CSV, depois defina sua fonte.
📍 Localização: Menu principal → Artigos → Importar CSV
- Arraste e solte seu arquivo CSV na área prevista
- Ou clique para selecionar a partir do seu computador
- Selecione a fonte do arquivo (site de venda de origem)
- O sistema analisa automaticamente o arquivo e detecta suas colunas
Interface de seleção de arquivo com escolha da fonte
Mapeamento das colunas
Associe cada coluna do seu CSV aos campos correspondentes no FlowDino e visualize uma prévia dos seus dados.
✅ O que essa etapa faz
- • Mapeamento automático inteligente baseado nos nomes das colunas
- • Possibilidade de ajustar manualmente as correspondências
- • Pré-visualização dos dados mapeados com as 5 primeiras linhas
Interface de mapeamento das colunas com correspondências e prévia dos dados
Mapeamento dos valores
Harmonize os valores do seu CSV com os padrões FlowDino para garantir a coerência dos dados.
🔄 Exemplos de correspondências
"Rouge" → "red"
"Bleu" → "blue"
"Très bon état" → "tresbonetat"
"Neuf" → "neufavecetiquettes"
💡 Dica
Use os valores padrão para gerenciar dados ausentes ou não reconhecidos
Configuração do mapeamento dos valores e dos valores padrão
Seleção dos valores padrão
Defina os valores padrão para os campos ausentes e visualize um resumo da importação.
⚙ Valores padrão
- • Marca padrão se coluna ausente ou vazia
- • Estado padrão se coluna ausente ou vazia
- • Cor padrão se coluna ausente ou vazia
- • Materiais padrão se coluna ausente ou vazia
📋 Resumo da importação
Visualize uma prévia completa da sua importação antes do lançamento
Configuração dos valores padrão e resumo da importação
Lançamento da importação
O FlowDino realiza os controles finais e inicia a importação dos seus dados.
🔍 Controles de validação
- • Verificação se as colunas obrigatórias possuem dados
- • Geração de um relatório de erro se necessário
- • Bloqueio da importação se os dados estiverem incompletos
⚡ Processo de importação
- • Importação dos dados com acompanhamento em tempo real
- • Visualização do progresso e das estatísticas
- • Consulta do histórico em Artigos → Histórico das importações
Validação final e acompanhamento da importação em tempo real
Compreendendo o mapeamento das colunas
O mapeamento das colunas é a etapa que permite associar cada coluna do seu arquivo CSV aos campos correspondentes no FlowDino. Essa etapa garante que seus dados sejam importados corretamente.
🔄 Como funciona
- O FlowDino analisa seu arquivo CSV e detecta todas as colunas
- O sistema propõe um mapeamento automático baseado nos nomes comuns
- Você pode ajustar e personalizar o mapeamento conforme suas necessidades
- Os valores também podem ser mapeados para harmonizar os dados
📊 Exemplo de mapeamento
| Coluna CSV | Campo FlowDino | Descrição |
|---|---|---|
| titulo | Title | Nome ou título do produto |
| description | Description | Descrição detalhada do produto |
| preco | Price | Preço de venda (formato numérico ou com moeda) |
🎨 Mapeamento dos valores
Além do mapeamento das colunas, você também pode mapear os valores para harmonizar seus dados com os padrões FlowDino :
Exemplos de mapeamento de valores :
CSV: "Muito bom estado" → "muitobomestado"
CSV: "Vermelho" → "red"
CSV: "M" → "medium"
Correspondência dos valores e valores padrão
A correspondência dos valores permite harmonizar seus dados CSV com os padrões FlowDino. Essa etapa crucial garante que seus valores sejam corretamente interpretados e integrados no sistema.
🔄 Como funciona
1. Detecção automática
O FlowDino analisa seus valores e propõe correspondências automáticas baseadas em padrões comuns.
2. Mapeamento personalizado
Você pode definir suas próprias correspondências para adaptar seus dados específicos.
3. Valores padrão
Defina valores padrão para os campos ausentes ou inválidos.
4. Validação
O sistema valida as correspondências antes da importação para evitar erros.
📋 Exemplos de correspondências comuns
🏷️ Estados/Condições
🎨 Cores
📏 Tamanhos
📂 Categorias
⚙️ Valores padrão
Os valores padrão são aplicados automaticamente quando campos estão vazios, ausentes ou contêm valores não reconhecidos. Eles garantem a coerência do seu catálogo.
📋 Quando são usados?
- Campos vazios no seu CSV
- Valores não reconhecidos ou inválidos
- Colunas ausentes no seu arquivo
- Para manter a coerência dos dados
✅ Exemplos de valores padrão
💡 Dicas práticas
- Verifique as correspondências automáticas antes da importação
- Use valores padrão coerentes com seu catálogo
- Teste com uma amostra antes da importação completa
- Documente suas correspondências personalizadas para futuras importações
- Priorize valores padronizados para facilitar as correspondências
- Use a pré-visualização para validar os resultados
Solução de problemas
❌ Problemas comuns e soluções
Arquivo não reconhecido
O sistema não reconhece seu arquivo como um CSV válido.
Solução: Verifique a extensão (.csv) e o formato. Tente re-salvar pelo Excel com 'CSV UTF-8'.
Caracteres especiais mal exibidos
Os acentos e caracteres especiais não estão sendo exibidos corretamente.
Solução: Use a codificação UTF-8 com BOM ao exportar seu arquivo.
Campos obrigatórios ausentes
Alguns produtos não estão sendo importados devido a campos ausentes.
Solução: Verifique se os campos título e preço estão preenchidos para todos os produtos.
💡 Dicas para uma importação bem-sucedida
- Teste primeiro com um pequeno lote (10-20 produtos)
- Monitore o progresso da importação na interface dedicada
- Valide seus dados antes da importação final
- Use a pré-visualização para verificar o mapeamento