Mapeamento de dados

A sua loja chama article a uma coluna; outra chama-lhe sku. O Scalarcut não exige nenhum. Mapeia cada coluna do seu ficheiro para um campo Scalarcut uma vez, e o mapeamento fica memorizado.

Como funciona o mapeamento

Quando carrega um ficheiro, o Scalarcut lê a linha de cabeçalho e tira-lhe uma impressão digital. Se já importou esta disposição de cabeçalho, o mapeamento guardado é aplicado automaticamente — só mapeia uma nova disposição de colunas uma vez.

Cada coluna mapeada leva uma transformação que diz ao importador como ler o valor:

Transformação	Usada para	Comportamento
trim	SKU, nome, coleção, ids	Espaços removidos.
integer	Largura, altura, espessura, qt por caixa	Analisado como número inteiro.
parse_size_pair	Tamanho combinado	Aceita 600×300, 600x300, 600*300, com mm, cm ou m.
url	URL da imagem	Deve ser HTTPS público, caso contrário é descartado com aviso.
enum_map	Tipo de material	Faz corresponder valores como porcelain, gres ou керамогранит a um tipo conhecido.

O fluxo de importação

1. Carregue o ficheiro e escolha um modo (abaixo).
2. Mapeie as colunas — ou deixe um perfil guardado aplicar-se automaticamente.
3. Valide — cada linha é verificada; erros e avisos são reportados.
4. Confirme — revê os totais criados / atualizados / rejeitados antes de publicar.
5. Grave — as linhas são escritas no catálogo e a revisão avança.

Se alguma linha falhar, pode transferir um CSV de erros com o número da linha, o SKU e o motivo, corrigir o ficheiro de origem e carregar de novo.

Regras de validação

• Uma linha precisa de um SKU e de um tamanho. Sem qualquer um deles, é rejeitada.
• Um tamanho de azulejo abaixo de 10 mm é rejeitado.
• Um URL de imagem ausente ou não-HTTPS é um aviso, não um erro — o azulejo é importado na mesma.

Manter o catálogo atualizado

O seu catálogo muda constantemente. Não precisa de reincorporar o widget nem de tocar no seu trecho — o widget serve sempre a última revisão gravada a cada carregamento. O fluxo para mudanças do dia a dia:

Adicionar novos produtos

Adicione as novas linhas à sua exportação habitual e carregue de novo. Os mesmos cabeçalhos são reconhecidos automaticamente, pelo que os novos SKU são adicionados e os existentes ficam intactos.

Editar um produto

Atualize a linha desse produto (um novo tamanho, uma quantidade por caixa corrigida, um novo URL de imagem) e reimporte. O SKU existente é atualizado no sítio; as outras linhas ficam inalteradas.

Remover produtos

A remoção é uma escolha explícita, para que nada desapareça por acidente. Escolha o modo adequado:

Modo	O que faz
Upsert	Adiciona ou atualiza as linhas do ficheiro e deixa tudo o resto em paz. Para adicionar e editar.
Substituir uma coleção	Substitui uma coleção inteira — qualquer SKU dessa coleção que já não esteja no ficheiro é removido.
Sincronização total do catálogo	Faz o catálogo corresponder exatamente ao ficheiro — qualquer SKU de azulejo em falta no ficheiro é removido.

Para um produto pontual esgotado ou descontinuado, edite o ficheiro e reimporte, em vez de deixar um SKU obsoleto no planificador.

Imagens e preços ficam consigo

O mapeamento apenas regista de onde vêm as coisas. As imagens ficam nos seus servidores (referenciadas por URL), e os preços são apenas informativos no widget — o checkout continua a ser a fonte de verdade.

Passos seguintes

• Estrutura do CSV — as colunas e os formatos de ficheiro.
• Catálogo — o que o catálogo guarda e como o widget o usa.