Материал блога
Импорт товаров в Shop-Script без дублей: порядок проверки
После очередной загрузки прайса один товар появляется в каталоге дважды, а ручное описание исчезает. Для магазина на Webasyst Shop-Script это обычно не задача «удалить копии», а вопрос правил сопоставления: какую строку поставщика считать тем же товаром и какие поля разрешено обновлять. Ниже — порядок подготовки безопасного импорта из CSV, Excel, XML или API.

Сначала определите, что считается одним товаром
Название и адрес карточки не подходят как универсальный ключ: поставщик может изменить название, а несколько поставщиков — назвать одинаковые товары по-разному. Сопоставьте внешний ID, артикул или штрихкод с уже существующим товаром и его вариантами. Один и тот же артикул у разных поставщиков требует отдельного правила: к какому товару относится предложение и какая цена или наличие показывается покупателю. Не переносите в боевой каталог файл, пока это правило не проверено на реальных примерах.
Таблица правил перед первой загрузкой
Для каждого поля укажите источник, действие при обновлении и поведение при пустом значении. Практический минимум:
- Идентификатор и вариант: по чему искать существующую карточку и отдельный SKU; что делать при конфликте ключей.
- Название, описание и фотографии: поступают от поставщика или остаются за редактором магазина; может ли пустое поле стереть подготовленный текст.
- Цена и остаток: какой поставщик и склад являются источником, допустима ли нулевая цена при положительном остатке.
- Категория и характеристики: как сопоставлять структуру поставщика с каталогом, куда попадёт неизвестная категория.
- Пропавшая строка: обнулить остаток, скрыть продажу или сохранить товар без изменения — решение зависит от других поставщиков и собственного склада.
Проведите контрольный импорт, а не сразу массовую загрузку
- Сохраните резервную копию и выгрузите список текущих товаров и артикулов.
- Выберите небольшую группу: существующий товар, новую позицию, товар с вариантами, два совпадающих артикула и позицию, исчезнувшую из прайса.
- Запустите обмен на этой группе и сравните ID карточек, варианты, цену, остаток, описание и URL до и после. Число товаров не должно неожиданно вырасти за счёт дублей.
- Повторите загрузку того же набора без изменений. Если после повторного запуска появляются новые карточки, массовый импорт запускать рано.
- Проверьте карточку, категорию и корзину на витрине. Верные данные в панели сами по себе не подтверждают верное отображение покупателю.
Если обмен прерывается
Сначала выясните, какие строки уже обработаны и не идёт ли прежнее задание. Повторный запуск с начала без контроля может дать дубли или перезаписать ручные изменения. В описании услуги интеграции с поставщиками приведён пример Miximix.ru: там исправляли продолжение обмена после обрыва и отдельно проверяли записи артикулов и нулевые цены. Это опыт конкретного проекта, а не обещание, что причина на другом сайте будет такой же.
Какие данные прислать для диагностики
Достаточно адреса магазина, версии Shop-Script, формата файла или описания API без ключей, нескольких проблемных артикулов и примера результата после двух загрузок. Укажите, какие поля магазин ведёт самостоятельно. По этим данным можно выбрать способ сопоставления и составить тестовую выборку; полный объём и стоимость определяются после изучения источника и действующей интеграции.