Сопоставление данных

Ваш магазин называет колонку article; другой — sku. Scalarcut не требует ни того, ни другого. Вы один раз сопоставляете каждую колонку файла с полем Scalarcut, и сопоставление запоминается.

Как работает сопоставление

Когда вы загружаете файл, Scalarcut читает строку заголовка и снимает с неё отпечаток. Если вы уже импортировали такой макет заголовка, сохранённое сопоставление применяется автоматически — новую раскладку колонок вы сопоставляете только один раз.

Каждая сопоставленная колонка несёт преобразование, которое подсказывает импортёру, как читать значение:

Преобразование	Для чего	Поведение
trim	SKU, название, коллекция, id	Обрезаются пробелы.
integer	Ширина, высота, толщина, упаковка	Парсится как целое число.
parse_size_pair	Объединённый размер	Принимает 600×300, 600x300, 600*300, с mm, cm или m.
url	URL изображения	Должен быть публичным HTTPS, иначе отбрасывается с предупреждением.
enum_map	Тип материала	Сопоставляет значения вроде porcelain, gres или керамогранит с известным типом.

Процесс импорта

1. Загрузите файл и выберите режим (ниже).
2. Сопоставьте колонки — или пусть сохранённый профиль применится автоматически.
3. Проверьте — каждая строка проверяется; ошибки и предупреждения выводятся.
4. Подтвердите — вы просматриваете счётчики созданных / обновлённых / отклонённых до публикации.
5. Зафиксируйте — строки записываются в каталог, ревизия увеличивается.

Если какая-то строка не проходит, вы можете скачать CSV с ошибками, где указаны номер строки, SKU и причина, исправить исходный файл и загрузить заново.

Правила валидации

• Строке нужны SKU и размер. Без любого из них она отклоняется.
• Размер плитки меньше 10 мм отклоняется.
• Отсутствующий или не-HTTPS URL изображения — это предупреждение, а не ошибка: плитка всё равно импортируется.

Поддержание каталога в актуальном состоянии

Ваш каталог меняется постоянно. Вам не нужно перевстраивать виджет или трогать сниппет — виджет всегда отдаёт последнюю зафиксированную ревизию при каждой загрузке. Повседневный процесс изменений:

Добавление новых товаров

Добавьте новые строки в обычный экспорт и загрузите заново. Те же заголовки распознаются автоматически, поэтому новые SKU добавляются, а существующие не трогаются.

Редактирование товара

Обновите строку этого товара (новый размер, исправленное количество в упаковке, новый URL изображения) и импортируйте заново. Существующий SKU обновляется на месте; остальные строки не меняются.

Удаление товаров

Удаление — явное действие, чтобы ничего не исчезало случайно. Выберите подходящий режим:

Режим	Что делает
Upsert	Добавляет или обновляет строки из файла и не трогает остальное. Для добавления и редактирования.
Заменить коллекцию	Полностью заменяет одну коллекцию — любой SKU коллекции, которого больше нет в файле, удаляется.
Полная синхронизация каталога	Приводит каталог ровно к файлу — любой SKU плитки, отсутствующий в файле, удаляется.

Для разового товара, которого нет в наличии или который снят с производства, отредактируйте файл и импортируйте заново, а не оставляйте устаревший SKU в планировщике.

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

Сопоставление лишь фиксирует, откуда что берётся. Изображения остаются на ваших серверах (по ссылке), а цены в виджете только для показа — источником истины остаётся оформление заказа.

Дальнейшие шаги

• Структура CSV — колонки и форматы файлов.
• Каталог — что хранит каталог и как виджет его использует.