Структура CSV

Ваш каталог — это одна таблица SKU. Вы экспортируете её из магазина или ERP, загружаете один раз, один раз сопоставляете колонки, и виджет привязывает каждую страницу товара к реальным размерам просматриваемого SKU.

Поддерживаемые файлы

• CSV и TXT — с разделителем запятой или точкой с запятой. Разделитель определяется автоматически по первой строке.
• XLSX и XLS — стандартные таблицы.
• До 20 МБ на загрузку.

Первая строка — заголовок. Каждая следующая строка — один SKU.

Как формировать CSV

Вам не нужно переименовывать колонки своего магазина под наши. Экспортируйте те заголовки, которые уже выдаёт ваша система — article, sku, size, boxes per pack и так далее — и сопоставьте их с полями Scalarcut на следующем шаге (см. Сопоставление данных). Главное требование — чтобы нужные данные просто присутствовали где-то в файле:

• уникальный код SKU для каждой строки, и
• размер плитки в миллиметрах.

Всё остальное опционально и обогащает виджет.

Обязательные колонки

Поле	Примечания
Код SKU	Идентификатор, который уже использует ваш магазин. Строки корзины возвращают именно это значение, поэтому он должен совпадать с тем, что распознаёт ваше оформление заказа.
Размер	Один из двух форматов ниже.

Размер

Размер можно указать одним из двух способов:

• Одна объединённая колонка — например 600×300, 600x300 или 600*300. Миллиметры, сантиметры и метры принимаются, когда единица прописана (например 60×30 cm).
• Две отдельные колонки — колонка width и колонка height, каждая в миллиметрах.

Одна объединённая колонка — самый частый случай, так как большинство ERP и магазинов уже хранят размер одним полем.

Опциональные колонки

Поле	Примечания
Название	Показывается в выпадающем списке материалов виджета. Если пусто — используется код SKU.
Толщина	В миллиметрах.
Упаковка	Плиток в коробке, чтобы заказ можно было выразить в коробках. По умолчанию 1, если не указано.
URL изображения	Публичный HTTPS-адрес изображения товара. См. ниже.
Тип материала	ceramic, porcelain, lvt, wood или other. Неизвестные значения приводятся к other.
Коллекция	Группирует товары в переключатель коллекций виджета.
ERP / 1C id	Ваш внутренний идентификатор, передаётся дальше для вашей отчётности.
Штрихкод	Передаётся дальше для ваших систем.
Цена	Опциональная прайсовая цена для сметы на экране, только для показа.

Изображения остаются на ваших серверах

Scalarcut не хостит изображения ваших товаров. CSV хранит публичный HTTPS-адрес каждого изображения, а виджет загружает его с вашего CDN или витрины в момент рендера — файл берётся по ссылке, а не копируется. Лицензирование, кэширование и хранение полностью остаются у вас.

• URL должен быть публичным HTTPS. http:// или непубличный URL отбрасывается с предупреждением, поэтому строка всё равно импортируется, а плитка просто отображается без фото.
• Обновите изображение у себя — и виджет подхватит изменение при следующей загрузке, без повторной загрузки.

Цены — только для показа

Если вы укажете цены, виджет показывает их в смете для контекста. Финальную цену всегда применяет ваше оформление заказа при добавлении строк. Виджет никогда не списывает деньги с покупателя.

Готовый пример

Минимальный, но полный файл:

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

Тот же каталог с одной колонкой размера:

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

Для полного готового файла скачайте образец CSV каталога — небольшой реалистичный ассортимент плитки и напольных покрытий в нескольких коллекциях, ровно в той форме, которую ожидает импортёр.

Что происходит дальше

Загрузите файл в панели Scalarcut и один раз сопоставьте колонки. С этого момента те же заголовки распознаются автоматически при каждой повторной загрузке. О шаге сопоставления и повседневном процессе добавления, редактирования и удаления товаров см. Сопоставление данных.