Прайс поставщика лучше воспринимать не как готовую базу товаров, а как входящее письмо неизвестного формата. Даже знакомый CSV завтра может получить новую колонку, другой разделитель или артикул без ведущего нуля. Поэтому первая загрузка ничего не меняет на витрине: она создаёт пробный расчёт и показывает, какие именно строки будут добавлены, обновлены, пропущены и отправлены на проверку.
Самая дорогая ошибка — связать строку с товаром по названию. Названия редактируются, сокращаются и повторяются. Нужен стабильный внешний ключ: идентификатор поставщика плюс его артикул. Внутренний SKU магазина остаётся отдельным. Если соответствия нет, система предлагает новую карточку, но не угадывает связь по похожему тексту.
Сначала фиксируем договор о файле
| Свойство | Что принять явно | Что считать ошибкой |
|---|---|---|
| кодировка | UTF-8 либо заранее заданная | неопределимые символы и смешанные кодировки |
| разделитель | запятая, точка с запятой или табуляция | случайный выбор по одной строке |
| артикул | строка без автоматического округления | пустое значение или потерянный ведущий ноль |
| цена | десятичное число в одной валюте | текст, отрицательное значение, чужая валюта |
| остаток | целое число либо согласованный статус | неизвестное слово или отрицательный остаток |
| дата файла | метка формирования поставщиком | файл старше уже применённого |
RFC 4180 описывает распространённую форму CSV, но реальные прайсы часто от неё отклоняются. В PHP файл следует разбирать CSV-парсером, а не explode: fgetcsv учитывает кавычки и разделители. В PHP 8.4 параметр escape стоит задавать явно; документация предупреждает, что нестандартный escape способен испортить совместимость при обратном чтении.
Пробный импорт отвечает на вопрос «что изменится»
import_id: supplier-17-20261010-1540
rows_total: 18432
matched: 17990
new: 124
price_changed: 286
stock_changed: 901
missing_from_file: 42
rejected: 31
max_price_jump: 64%
publish: blockedТакой отчёт полезнее сообщения «импорт выполнен». Он позволяет поставить автоматические стоп-условия: например, не публиковать файл, если исчезло больше согласованной доли ассортимента, валюта сменилась или цена одной позиции выросла в несколько раз. Порог выбирают по истории конкретного поставщика, а не один на весь магазин.
В diff нужно вывести примеры строк до и после, но не ограничиваться первыми десятью. Отдельно выбирайте самые большие изменения, случайную выборку и строки каждой категории результата. Тогда пользователь увидит как массовый сдвиг, так и редкое несоответствие артикула.
Промежуточная таблица отделяет чтение от публикации
- Сохранить хеш файла, поставщика, время получения и параметры разбора.
- Прочитать строки в staging и присвоить каждой номер исходной строки.
- Нормализовать только согласованные поля: пробелы, валюту, числа и статусы.
- Сопоставить внешний артикул с внутренним товаром и сформировать diff.
- Отправить неоднозначные и неверные строки в карантин с понятной причиной.
- После подтверждения применить допустимые изменения одной контролируемой операцией.
Upsert удобен для повторяемого импорта: MySQL позволяет обновить строку при конфликте уникального ключа через INSERT ... ON DUPLICATE KEY UPDATE. Но уникальный индекс должен отражать настоящий ключ поставщика. Документация MySQL отдельно советует осторожность при нескольких уникальных индексах: конфликт может обновить не ту запись, которую ожидал разработчик.
Исчезновение из прайса не равно удалению товара
Позиция могла исчезнуть из-за неполной выгрузки, ошибки фильтра или временного сбоя. Не обнуляйте весь отсутствующий ассортимент сразу. Помечайте такие строки как missing, сравнивайте с предыдущим успешным файлом и применяйте согласованное правило: например, снять с продажи только после двух последовательных полных прайсов или явного статуса поставщика.
- новые карточки не публикуются без категории, названия, изображения и правил наценки;
- цена хранится вместе с валютой и временем получения;
- остаток поставщика не подменяет резервы и фактический остаток магазина;
- ручная правка должна иметь приоритет или явно отмеченный срок действия;
- повторный запуск одного import_id не создаёт повторных товаров;
- откат опирается на журнал изменений, а не на копию текущего прайса.
Экспорт ошибок тоже считается недоверенным файлом
Если ошибочные строки выгружаются в CSV для проверки, значения поставщика могут начинаться со знака формулы. OWASP описывает CSV Injection: табличный редактор способен интерпретировать такое значение как формулу. При формировании отчёта экранируйте потенциально опасные ячейки по выбранной политике и не предлагайте оператору отключать предупреждения Excel.
Перед первым боевым запуском подготовьте два реальных прайса подряд, таблицу соответствий внешних артикулов, правила наценки, пороги блокировки и сценарий исчезнувших строк. Хороший импорт можно прогнать повторно с тем же результатом, объяснить по каждой строке и отменить без ручного восстановления каталога из памяти.