Widget de tienda online
Mapeo de datos
Mapea tus columnas de CSV a campos de Scalarcut una vez y mantén el catálogo al día — añade, edita y elimina productos sin tocar el embed.
Tu tienda llama a una columna article; otra la llama sku. Scalarcut no exige ninguna. Mapeas cada columna de tu archivo a un campo de Scalarcut una vez, y el mapeo se recuerda.
Cómo funciona el mapeo
Cuando subes un archivo, Scalarcut lee la fila de encabezado y le saca una huella. Si ya habías importado este diseño de encabezado, el mapeo guardado se aplica automáticamente — solo mapeas una vez un diseño de columnas nuevo.
Cada columna mapeada lleva una transformación que le dice al importador cómo leer el valor:
| Transformación | Usada para | Comportamiento |
|---|---|---|
trim |
SKU, nombre, colección, ids | Se recortan los espacios. |
integer |
Ancho, alto, grosor, unidades por caja | Se analiza como número entero. |
parse_size_pair |
Tamaño combinado | Acepta 600×300, 600x300, 600*300, con mm, cm o m. |
url |
URL de imagen | Debe ser HTTPS pública o se descarta con aviso. |
enum_map |
Tipo de material | Asocia valores como porcelain, gres o керамогранит a un tipo conocido. |
El flujo de importación
- Sube el archivo y elige un modo (abajo).
- Mapea las columnas — o deja que se aplique un perfil guardado automáticamente.
- Valida — se revisa cada fila; se informa de errores y avisos.
- Confirma — revisas los conteos de creadas / actualizadas / rechazadas antes de publicar nada.
- Confirma la escritura — las filas se escriben en el catálogo y la revisión avanza.
Si alguna fila falla, puedes descargar un CSV de errores con el número de fila, el SKU y el motivo, corregir el archivo de origen y volver a subirlo.
Reglas de validación
- Una fila necesita un SKU y un tamaño. Sin ninguno de los dos, se rechaza.
- Un tamaño de azulejo por debajo de 10 mm se rechaza.
- Una URL de imagen ausente o no HTTPS es un aviso, no un error: el azulejo se importa igual.
Mantener el catálogo al día
Tu catálogo cambia constantemente. No necesitas volver a integrar el widget ni tocar tu fragmento — el widget siempre sirve la última revisión confirmada en cada carga. El flujo para cambios del día a día:
Añadir productos nuevos
Añade las filas nuevas a tu exportación habitual y vuelve a subir. Los mismos encabezados se reconocen automáticamente, así que los SKU nuevos se añaden y los existentes no se tocan.
Editar un producto
Actualiza la fila de ese producto (un tamaño nuevo, una cantidad por caja corregida, una URL de imagen nueva) y reimporta. El SKU existente se actualiza en su sitio; las demás filas no cambian.
Eliminar productos
La eliminación es una decisión explícita, para que nada desaparezca por accidente. Elige el modo que encaje:
| Modo | Qué hace |
|---|---|
| Upsert | Añade o actualiza las filas del archivo y deja todo lo demás igual. Para añadir y editar. |
| Reemplazar una colección | Reemplaza una colección entera — cualquier SKU de esa colección que ya no esté en el archivo se elimina. |
| Sincronización completa del catálogo | Hace que el catálogo coincida exactamente con el archivo — cualquier SKU de azulejo que falte en el archivo se elimina. |
Para un producto puntual agotado o descatalogado, edita el archivo y reimporta en lugar de dejar un SKU obsoleto en el planificador.
Las imágenes y los precios siguen siendo tuyos
El mapeo solo registra de dónde viene cada cosa. Las imágenes se quedan en tus servidores (referenciadas por URL), y los precios son solo informativos en el widget — el checkout sigue siendo la fuente de verdad.
Siguientes pasos
- Estructura del CSV — las columnas y los formatos de archivo.
- Catálogo — qué guarda el catálogo y cómo lo usa el widget.