Estrutura do CSV

O seu catálogo é uma única folha de cálculo de SKU. Exporta-a da sua loja ou ERP, carrega-a uma vez, mapeia as colunas uma vez, e o widget fixa cada página de produto nas dimensões reais do SKU em visualização.

Ficheiros suportados

• CSV e TXT — delimitados por vírgula ou ponto e vírgula. O delimitador é detetado automaticamente a partir da primeira linha.
• XLSX e XLS — folhas de cálculo padrão.
• Até 20 MB por carregamento.

A primeira linha é o cabeçalho. Cada linha seguinte é um SKU.

Como formar o CSV

Não precisa de renomear as colunas da sua loja para corresponder às nossas. Exporte os cabeçalhos que o seu sistema já produz — article, sku, size, boxes per pack, etc., todos servem — e mapeie-os para campos Scalarcut no passo seguinte (veja Mapeamento de dados). O requisito essencial é simplesmente que os dados de que precisa estejam presentes em algum lugar do ficheiro:

• um código SKU único para cada linha, e
• o tamanho do azulejo em milímetros.

Tudo o resto é opcional e enriquece o widget.

Colunas obrigatórias

Campo	Notas
Código SKU	O identificador que a sua loja já usa. As linhas de carrinho devolvem exatamente este valor, pelo que deve corresponder ao que o seu checkout reconhece.
Tamanho	Um dos dois formatos abaixo.

Tamanho

O tamanho pode ser fornecido de duas formas:

• Uma coluna combinada — por exemplo 600×300, 600x300 ou 600*300. Milímetros, centímetros e metros são todos aceites quando a unidade está escrita (por exemplo 60×30 cm).
• Duas colunas separadas — uma coluna width e uma coluna height, cada uma em milímetros.

Uma única coluna combinada é a mais comum, uma vez que a maioria dos ERP e lojas já guarda o tamanho num só campo.

Colunas opcionais

Campo	Notas
Nome	Mostrado no menu de materiais do widget. Recai no código SKU quando vazio.
Espessura	Em milímetros.
Qt por caixa	Azulejos por caixa, para que a encomenda possa ser expressa em caixas. Por omissão 1 quando ausente.
URL da imagem	URL HTTPS público para a imagem do produto. Veja abaixo.
Tipo de material	ceramic, porcelain, lvt, wood ou other. Valores não reconhecidos mapeiam para other.
Coleção	Agrupa produtos no seletor de coleções do widget.
Id de ERP / 1C	O seu identificador interno, transportado para o seu próprio reporte.
Código de barras	Transportado para os seus próprios sistemas.
Preço	Preço de tabela opcional para o orçamento no ecrã, apenas informativo.

As imagens ficam nos seus servidores

O Scalarcut não aloja as imagens dos seus produtos. O CSV guarda um URL HTTPS público para cada imagem, e o widget carrega-a do seu CDN ou vitrina no momento da renderização — o ficheiro é referenciado, nunca copiado. Licenciamento, cache e armazenamento ficam inteiramente consigo.

• O URL deve ser HTTPS público. Um URL http:// ou não público é omitido com um aviso, pelo que a linha é importada na mesma e o azulejo apenas renderiza sem foto.
• Atualize a imagem do seu lado e o widget apanha a mudança no próximo carregamento — sem necessidade de recarregar.

Os preços são apenas informativos

Se incluir preços, o widget mostra-os no orçamento como contexto. O preço final é sempre aplicado pelo seu checkout quando as linhas do carrinho são adicionadas. O widget nunca cobra um comprador.

Um exemplo completo

Um ficheiro mínimo mas completo:

sku,name,width_mm,height_mm,pack_qty,texture_url,material_type,collection
CER-600-300,Porcelain Grey,600,300,8,https://cdn.example.com/cer-600-300.jpg,porcelain,Porcelain
LVT-1210-180,Herringbone Oak,1210,180,10,https://cdn.example.com/lvt-1210-180.jpg,lvt,Wood

O mesmo catálogo usando uma única coluna de tamanho:

sku,name,size_mm,pack_qty,texture_url
CER-600-300,Porcelain Grey,600×300,8,https://cdn.example.com/cer-600-300.jpg
LVT-1210-180,Herringbone Oak,1210×180,10,https://cdn.example.com/lvt-1210-180.jpg

Para um ficheiro completo, transfira o CSV de catálogo de exemplo — uma pequena gama realista de azulejos e pavimentos em algumas coleções, exatamente na forma que o importador espera.

O que acontece a seguir

Carregue o ficheiro no painel Scalarcut e mapeie as colunas uma vez. A partir daí, os mesmos cabeçalhos são reconhecidos automaticamente em cada novo carregamento. Para o passo de mapeamento e o processo do dia a dia de adicionar, editar e remover produtos, veja Mapeamento de dados.