Каталог интернет-магазина
Интеграция Каталог интернет-магазина поддерживает актуальность номенклатуры, характеристик, цен и остатков по товарному фиду сайта. Она не заменяет каталог SNABZHENETS+: сайт остаётся источником только для тех полей, которые вы разрешили обновлять.
Поддерживаемые форматы: YML, CommerceML, произвольный XML, JSON, CSV и TSV. Система не сканирует HTML-страницы магазина: для стабильного обмена нужен опубликованный файл или API-совместимый URL фида.
Что понадобится
- право на управление интеграциями и изменение каталога;
- URL фида по HTTPS или HTTP;
- для закрытого фида — данные Basic Auth, Bearer token или API key;
- при передаче остатков — склад, на который их нужно записывать;
- при передаче цены сайта — прайс-лист, в котором её нужно хранить.
Данные доступа шифруются. В интерфейсе после сохранения они показываются только как признак настроенной авторизации, а не в открытом виде.
Подключение
- Откройте Настройки → Интеграции и установите карточку Каталог интернет-магазина.
- Добавьте источник: название, URL, формат и, при необходимости, путь к повторяющейся товарной записи в XML или JSON.
- Выберите способ авторизации, склад для остатков и прайс-лист для цены сайта. Если для цены или остатков не выбран объект, система предложит создать отдельный технический прайс-лист или склад для этого источника.
- Нажмите Проверить образец. Система скачает ограниченный по размеру образец, определит доступные поля и покажет первые позиции.
- Сопоставьте поля, проверьте предпросмотр и подтвердите первый запуск.
- После первого успешного применения включите расписание: вручную, каждые 15 минут, час, 6 часов или сутки.
До подтверждения первого запуска данные каталога не меняются.
Сопоставление полей
| Данные фида | Куда записываются | Важное правило |
|---|---|---|
| Внешний ID предложения | Постоянная связь источника с товаром | Обязателен для надёжного последующего обновления |
| SKU / артикул | Артикул товара | Используется только при точном совпадении |
| GTIN, MPN | Идентификаторы товара | Дополнительные точные ключи сопоставления |
| Наименование, категория, единица | Карточка товара | Для каждого поля выбирается политика обновления |
| Бренд, производитель, описание | Карточка товара | Можно обновлять, только если поле пустое |
Параметры <param> и произвольные свойства | Характеристики товара | Каждому параметру можно назначить имя поля |
| Цена сайта и валюта | Отдельный прайс-лист | Не записывается в закупочную себестоимость |
| Остаток, доступность | Выбранный склад | Передаются как снимок, а не движение товара |
| URL товара | Ссылка на источник | Нужна для перехода к карточке сайта |
Для каждого правила доступны три политики:
- Источник всегда обновляет — значение из фида заменяет прежнее;
- Заполнить, только если пусто — фид дополняет карточку, но не затирает данные команды;
- Не изменять вручную заполненное — сохраняет значение, введённое пользователем.
Безопасное сопоставление
Система сначала использует уже сохранённую связь «источник + внешний ID → товар». Если её нет, допустимо только точное совпадение по SKU, GTIN или MPN. Похожее название служит подсказкой в предпросмотре, но не приводит к автоматическому обновлению.
Товар, которого нет в полном фиде, не удаляется автоматически. Он отмечается как не встретившийся в источнике; обнуление остатка или деактивация возможны только при отдельно включённом правиле после успешного полного запуска. Для частичного фида отсутствие товара никогда не означает нулевой остаток.
Если в новом фиде резко уменьшается количество позиций, появляется необычно много нулевых остатков или сильно меняются цены, запуск переводится на проверку вместо массового применения.
Цены и остатки
Цена интернет-магазина — это розничная или клиентская цена, а не закупочная себестоимость. Поэтому интеграция обновляет только выбранный прайс-лист и не меняет текущую закупочную цену товара без отдельной, явной настройки.
Остатки сайта по умолчанию лучше передавать на отдельный склад, например Сайт — основной. Это защищает физический склад от случайного перезаписывания данными витрины.
Подробнее о закупочных ценах — в разделе Прайс-листы, о товарах — Товары и услуги.
Статусы и журнал
У источника отображаются последний успешный запуск, следующий запуск, количество обработанных товаров и безопасное сообщение об ошибке. Доступны статусы:
- Черновик — источник создан, но первый запуск ещё не подтверждён;
- Активен — выполняется по расписанию;
- Приостановлен — сохранён, но не запускается;
- Требует проверки — обнаружено аномальное массовое изменение;
- Ошибка — фид недоступен или не проходит проверку.
В журнале остаются результаты предпросмотров и запусков: новые, обновлённые, без изменений, конфликтные и ошибочные записи. Секреты, заголовки авторизации и полное содержимое ответа сайта в журнал не попадают.
Ограничения загрузки URL
Для защиты портала источник должен использовать HTTP(S). Сервис блокирует localhost, частные сети, cloud metadata endpoints, опасные redirect-цепочки, слишком большие ответы и XML с внешними сущностями. При повторной синхронизации используются ETag и Last-Modified, если сайт их отдаёт, чтобы не скачивать неизменившийся фид.