Как синхронизировать остатки поставщиков с OpenCart

Синхронизация остатков поставщиков с OpenCart — задача, которая критична для магазинов с несколькими поставщиками. Товар мог закончиться у поставщика, но на сайте он всё ещё «В наличии». Покупатель оплачивает, а отгрузить нечего — возврат, негатив, потерянный клиент. Автоматизация решает эту проблему: скрипт проверяет остатки по расписанию и скрывает/показывает товары на сайте.

За 17 лет работы с OpenCart я настраивал синхронизацию остатков для десятков магазинов — от небольших одно-поставщических до сетей с пятью оптовиками и 1С. В этой статье три способа синхронизации: через прайс-листы, API поставщика и парсинг сайта, с конкретными инструментами и настройками.

Откуда брать данные об остатках

Способ 1. Импорт из прайс-листов

Самый распространённый вариант. Поставщик выгружает файл с колонками: артикул, наименование, цена, количество. Ваш скрипт скачивает файл по расписанию и обновляет остатки.

Что нужно учесть

• Разная структура файлов. У каждого поставщика свой формат: разные названия колонок, разный разделитель, разная кодировка. Модуль импорта должен.allow настраивать сопоставление.
• Кодировка. Прайсы часто в win-1251, а OpenCart работает в UTF-8. Модуль должен конвертировать автоматически.
• Артикулы. У разных поставщиков могут быть разные артикулы на один товар. Нужна таблица соответствия (артикул_поставщика → артикул_OpenCart).
• Нулевые остатки. Если товар закончился у поставщика, скрипт должен установить остаток = 0, а не удалить товар.

Настройка cron

На хостинге создайте задачу, которая запускает импорт раз в день в нерабочее время:

0 3 * * * curl -s https://ваш-сайт.ru/admin/import-stock.php?token=XXX > /dev/null

Важно (из опыта): запускайте импорт ночью, когда на сайте мало посетителей — обновление остатков нагружает базу данных.

Способ 2. API поставщика

Надёжнее прайсов — данные в реальном времени, меньше ошибок. Но дороже в настройке.

Преимущества API

• Данные в реальном времени. Остатки обновляются сразу после изменения у поставщика.
• Нет проблем с форматом. API возвращает структурированные данные (JSON/XML), не нужно парсить файлы.
• Автоматическая синхронизация. Можно настроить вебхук — поставщик уведомляет ваш сайт об изменении остатков.

Нюансы

• API может быть недокументированным или менять формат.
• Ограничения по количеству запросов — не все API позволяют запрашивать остатки по каждому товару.
• Нужна разработка интеграции под конкретного поставщика.

Способ 3. Парсинг сайта поставщика

Если поставщик не даёт ни прайсов, ни API — парсинг. Скрипт заходит на сайт поставщика, скачивает страницы с товарами и извлекает остатки.

Когда это оправдано

• Поставщик — крупный маркетплейс или дистрибьютор без API.
• Объём товаров небольшой (до 500 позиций).
• Других вариантов получения данных нет.

Риски

• Структура сайта поставщика может измениться — парсер перестанет работать.
• Поставщик может заблокировать парсинг (по IP, по частоте запросов).
• Юридические риски — парсинг может нарушать условия использования сайта.

Какой способ выбрать

Типичные ошибки

Чек-лист проверки

• Остатки обновляются по расписанию (проверьте cron-журнал)
• Артикулы сопоставляются корректно
• Товары с нулевым остатком скрыты или помечены «нет в наличии»
• При ошибке импорта магазин продолжает работать
• Нет дублирования товаров
• Логи импорта доступны для проверки
• Остатки отображаются корректно на сайте (проверьте на тестовых товарах)

Рекомендации из практики

Как лучше: Начните с интеграции через API поставщика — это самый надёжный способ. Если API нет, используйте импорт из прайс-листов (CSV/XML) с автоматизацией через cron. По практике, API предпочтительнее даже если требует единоразовой настройки.

Не парсите сайт поставщика как основной источник остатков — сайт может изменить вёрстку, и парсинг сломается. Используйте парсинг только как временное решение, пока не настроите API или выгрузку прайсов.

Кейс из практики: Магазин автозапчастей полгода парсил остатки с сайта поставщика. Поставщик обновил сайт — структура HTML изменилась, парсер перестал работать. Два дня магазин продавал товары, которых нет в наличии. Перешли на выгрузку прайс-листов по FTP — проблема больше не возникала.

Нужна помощь — закажите доработку OpenCart: проверим и настроим.

Частые вопросы

Как часто нужно обновлять остатки?

Для большинства магазинов — раз в день. Если товары расходятся быстро (акции, сезон) — можно чаще (каждые 4–6 часов). В реальном времени — только через API поставщика или вебхук.

Что делать, если у разных поставщиков разные артикулы на один товар?

Создайте таблицу соответствия: артикул_поставщика → артикул_OpenCart. Это делается один раз при настройке импорта. Если поставщиков много — используйте модуль с поддержкой маппинга артикулов.

Можно ли настроить синхронизацию без программиста?

Для базового импорта CSV — да, если есть готовый модуль. Для API-интеграции или парсинга — нужен разработчик. Стоимость настройки импорта от 5 000 ₽, API-интеграции — от 15 000 ₽.

Что будет, если импорт остановится на несколько дней?

Покупатели увидят товары, которых нет в наличии. По практике, это одна из самых частых причин негативных отзывов. Поэтому параллельно с импортом настройте уведомления: скрипт должен писать в Telegram или на почту, если последний успешный импорт был больше 24 часов назад.

Как проверить, что импорт работает корректно?

Зайдите в логи импорта — там должны быть записи о каждом запуске с количеством обработанных товаров и ошибок. Проверьте 3–5 товаров вручную: сверьте остаток на сайте с данными у поставщика. Если расхождения — проблема в маппинге артикулов.

Связанные темы

• Автоматизация обновления цен в OpenCart — как обновлять цены вместе с остатками
• Интеграция 1С с OpenCart — полная синхронизация товаров, цен и остатков
• WMS и маркировка — автоматизация склада

Синхронизация остатков — задача, которая экономит время менеджерам и защищает от продажи отсутствующих товаров. Если нужна помощь с настройкой — доработка OpenCart под автоматизацию это наш профиль.