Importar dados de Excel e CSV

O QuoteNode inclui um wizard guiado para carregar dados de catalogo a partir de ficheiros Excel (.xlsx) ou CSV (.csv), com templates descarregaveis e exemplos.

Descarregar o template

1. Vai a Products > Import
2. Clica em Download Template
3. Escolhe template com exemplos ou vazio

Colunas do template

Entre as colunas mais comuns estao:

• SKU
• NAME
• UNIT_PRICE
• UNIT_PRICE_GROSS
• VAT_RATE
• UNIT
• GROUP_NAME
• DESCRIPTION_SHORT
• DESCRIPTION_LONG
• WEIGHT_KG
• IMAGE_URL

Workflow de importacao

Passo 1 - Upload do ficheiro

Carrega o ficheiro por drag and drop ou selecao manual.

Passo 2 - Mapping de colunas

O sistema tenta mapear automaticamente as cabecalhos para campos QuoteNode, permitindo guardar templates de mapping para importacoes futuras.

Passo 3 - Dry run

Antes do commit, o sistema valida:

• campos obrigatorios
• formato de precos e URLs
• unidades
• duplicados por SKU
• preview das primeiras linhas

Passo 4 - Executar importacao

No commit:

• produtos novos sao criados
• produtos existentes sao atualizados por SKU
• grupos sao criados automaticamente
• imagens podem ser descarregadas e armazenadas

Importacao de imagens

As imagens podem ser importadas por URL no template ou por ficheiro ZIP com nomes alinhados com os SKU.

Templates de mapping

Se recebes sempre o mesmo formato de fornecedor ou ERP, podes guardar o mapping e reutiliza-lo em futuras importacoes.

Porque a importacao estruturada importa

Uma importacao bem preparada reduz trabalho manual, melhora a consistencia do catalogo e acelera o arranque do workspace em ambientes reais.

Dry run e seguranca operacional

O dry run existe para evitar que formatos errados, URLs invalidos, mappings incompletos ou duplicados por SKU contaminem o catalogo de producao.

Importacao recorrente

Quando a equipa recebe ficheiros no mesmo formato, o uso de templates de mapping reduz trabalho repetitivo e diminui a probabilidade de erro humano.

Preparacao do ficheiro

Antes de importar, e recomendavel:

• confirmar nomes de colunas
• verificar SKU
• limpar linhas irrelevantes
• garantir codificacao correta
• validar links de imagem

Impacto no catalogo

Uma importacao estruturada afeta diretamente catalogo, listas de precos, bundles e velocidade de criacao de propostas, pelo que deve ser tratada como parte do setup operacional e nao apenas como tarefa pontual.

Dicas

• usa sempre dry run
• mantem nomes de grupo consistentes
• confirma codificacao UTF-8
• usa SKU como base de deduplicacao

Importacao de imagens em volume

Para catalogos maiores, tambem podes importar imagens por ZIP:

1. vai a Products > Import > Media Import
2. faz upload de um ficheiro ZIP com as imagens
3. usa nomes de ficheiro alinhados com o SKU, por exemplo PRD-001.jpg
4. valida o preview antes de confirmar

O sistema mostra que ficheiros foram relacionados, quais foram ignorados e onde existem erros de correspondencia.

Resultado final da importacao

Depois de concluida a importacao, o QuoteNode apresenta um resumo com:

• linhas importadas
• linhas atualizadas
• linhas ignoradas
• erros encontrados

Isto facilita confirmar se o catalogo ficou realmente sincronizado com a fonte de origem.