Widget de tienda online

Estructura del CSV

Cómo formar el CSV del catálogo: columnas obligatorias y opcionales, formatos de tamaño, URLs de imagen y los tipos de archivo admitidos.

Tu catálogo es una única hoja de cálculo de SKU. La exportas desde tu tienda o ERP, la subes una vez, mapeas las columnas una vez, y el widget fija cada página de producto a las medidas reales del SKU que se está viendo.

Archivos admitidos

  • CSV y TXT — delimitados por coma o punto y coma. El delimitador se detecta automáticamente desde la primera línea.
  • XLSX y XLS — hojas de cálculo estándar.
  • Hasta 20 MB por subida.

La primera fila es el encabezado. Cada fila siguiente es un SKU.

Cómo formar el CSV

No necesitas renombrar las columnas de tu tienda para que coincidan con las nuestras. Exporta los encabezados que ya produce tu sistema — article, sku, size, boxes per pack, etc. — y mapéalos a campos de Scalarcut en el siguiente paso (mira Mapeo de datos). El requisito esencial es simplemente que los datos que necesitas estén presentes en algún lugar del archivo:

  • un código SKU único para cada fila, y
  • el tamaño del azulejo en milímetros.

Todo lo demás es opcional y enriquece el widget.

Columnas obligatorias

Campo Notas
Código SKU El identificador que ya usa tu tienda. Las líneas de carrito devuelven exactamente este valor, así que debe coincidir con lo que reconoce tu checkout.
Tamaño Uno de los dos formatos de abajo.

Tamaño

El tamaño puede darse de dos formas:

  • Una columna combinada — por ejemplo 600×300, 600x300 o 600*300. Se aceptan milímetros, centímetros y metros cuando la unidad va escrita (por ejemplo 60×30 cm).
  • Dos columnas separadas — una columna width y una columna height, cada una en milímetros.

Una única columna combinada es lo más común, ya que la mayoría de ERP y tiendas ya guardan el tamaño como un solo campo.

Columnas opcionales

Campo Notas
Nombre Mostrado en el desplegable de materiales del widget. Si está vacío, se usa el código SKU.
Grosor En milímetros.
Unidades por caja Azulejos por caja, para expresar el pedido como cajas. Por defecto 1 si falta.
URL de imagen URL HTTPS pública a la imagen del producto. Mira abajo.
Tipo de material ceramic, porcelain, lvt, wood u other. Los valores no reconocidos se mapean a other.
Colección Agrupa productos en el selector de colecciones del widget.
Id de ERP / 1C Tu identificador interno, llevado para tu propio reporting.
Código de barras Llevado para tus propios sistemas.
Precio Precio de lista opcional para el presupuesto en pantalla, solo informativo.

Las imágenes se quedan en tus servidores

Scalarcut no aloja las imágenes de tus productos. El CSV guarda una URL HTTPS pública a cada imagen, y el widget la carga desde tu CDN o tienda en el momento del renderizado — el archivo se referencia, nunca se copia. La licencia, la caché y el almacenamiento se quedan contigo.

  • La URL debe ser HTTPS pública. Una URL http:// o no pública se omite con un aviso, así que la fila se importa igual y el azulejo solo se renderiza sin foto.
  • Actualiza la imagen en tu lado y el widget recoge el cambio en la siguiente carga — sin necesidad de volver a subir.

Los precios son solo informativos

Si incluyes precios, el widget los muestra en el presupuesto a modo de contexto. El precio final lo aplica siempre tu checkout cuando se añaden las líneas del carrito. El widget nunca cobra a un comprador.

Un ejemplo trabajado

Un archivo mínimo pero 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

El mismo catálogo usando una única columna de tamaño:

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 un archivo trabajado completo, descarga el CSV de catálogo de ejemplo — una gama pequeña y realista de azulejos y suelos en unas cuantas colecciones, exactamente con la forma que espera el importador.

Qué pasa después

Sube el archivo en tu panel de Scalarcut y mapea las columnas una vez. A partir de ahí, los mismos encabezados se reconocen automáticamente en cada nueva subida. Para el paso de mapeo y el proceso del día a día de añadir, editar y eliminar productos, mira Mapeo de datos.