Синхронизация каталога с интернет-магазином

Как это работает

Sklads остаётся главным источником товаров, вариантов, цен, остатков, маркировки и фотографий. Интернет-магазин получает от Sklads полную выгрузку каталога и хранит у себя её копию. К базе Sklads магазин не подключается.

Выгрузка собирается автоматически каждые несколько минут. Новая версия каталога, или ревизия, создаётся только при изменении данных: названия, описания, цены, остатка, маркировки, фотографий или состава товаров. Каждая выгрузка подписывается секретным ключом и отправляется повторно, если магазин временно недоступен.

Подготовьте каталог

В выгрузку попадают только активные товары, у которых есть хотя бы один активный вариант. Черновики и архивные записи не передаются.

У каждого активного варианта должна быть розничная цена в рублях. Если цены нет, выгрузка блокируется целиком, пока данные не будут исправлены. Чтобы передавать только готовую часть каталога, ограничьте витрину категориями, брендами или группами товаров.

Описание товара передаётся всегда. Полное описание варианта передаётся, если в настройках витрины выбрана версия контракта «Каталог v1.1 с описаниями вариантов». Сайт должен поддерживать эту версию, поэтому выбирайте её только после подтверждения от разработчиков сайта. Если вернуть версию «Каталог v1», следующая выгрузка уйдёт без описаний вариантов.

Фотографии передаются в порядке отображения, основное изображение идёт первым. Технические фотографии варианта в выгрузку не попадают.

Укажите маркировку

В карточке варианта откройте раздел «Идентификаторы и штрихкоды» и заполните поле «Маркировка»:

• «Не определено» — значение по умолчанию. Товар показывается на витрине, но онлайн-продажа для него заблокирована на стороне магазина.
• «Требуется» или «Не требуется» — для этих значений обязательны «Код ТН ВЭД ЕАЭС», «Код ОКПД2» и «Основание классификации», например решение и дата проверки.

Коды маркировки отдельных единиц «Честного знака» в выгрузку не попадают.

Подключите витрину

1. Откройте «Экспорт / Импорт» → «Витрины».
2. В форме «Новая витрина» укажите название и адрес приёма каталога, который сообщил разработчик магазина. Адрес должен начинаться с https://. Внутренние и локальные адреса запрещены.
3. При необходимости выберите категории, бренды и группы товаров и проверьте список разрешённых доменов изображений.
4. Нажмите «Создать интеграцию». Витрина создаётся выключенной, и открывается её страница.

Задайте секрет подписи

Этим секретом Sklads подписывает каждую отправку каталога, и у сайта должно быть такое же значение. На странице витрины, в блоке «Подключение сайта», выберите один из способов:

• «Сгенерировать секрет». Sklads создаст секрет и покажет его один раз. Скопируйте его и передайте разработчикам сайта защищённым способом.
• «Ввести секрет, полученный от сайта», если сайт выдал секрет сам.

После сохранения Sklads показывает только отпечаток секрета, например 1a2b3c4d. По нему можно сверить секрет с сайтом, не раскрывая его. Если секрет нужно заменить, сгенерируйте новый. Пока сайт не получит новое значение, отправки будут отклоняться.

Если в блоке написано, что хранение секретов не настроено, обратитесь к администратору сервера. Это настраивается один раз для всего Sklads.

Проверьте и включите

1. Нажмите «Проверить соединение». Sklads проверит адрес и наличие секрета и отправит пустой запрос без данных. Подпись проверяется первой настоящей отправкой.
2. Откройте «Предпросмотр выгрузки». Вы увидите число товаров и вариантов, размер выгрузки и список ошибок. У каждой ошибки указан точный путь, например products.17.variants.2.price.currency, а также SKU и ссылка на товар. Предпросмотр ничего не отправляет.
3. Исправьте ошибки в каталоге и снова откройте предпросмотр.
4. Нажмите «Включить». Первая выгрузка будет собрана и отправлена в течение нескольких минут.

Следите за доставками

На странице витрины показаны состояние, последняя сборка, последняя успешная доставка и журнал событий.

• «Собрать и отправить сейчас» запускает сборку без ожидания расписания. Если каталог не изменился, новая отправка не создаётся.
• Ошибки сети и временная недоступность магазина повторяются автоматически с увеличивающимися паузами.
• Если магазин отклонил выгрузку, например из-за неверной подписи или несоответствия формату, доставка получает статус «Ошибка» и не повторяется сама. Исправьте причину и нажмите «Повторить доставку».
• «Отправить последнюю ревизию повторно» заново отправляет последнюю ревизию, например после восстановления данных на стороне магазина.
• Метка «Устарела» означает, что за заданное в настройках время не было успешной синхронизации.

Если на странице появилось предупреждение о том, что обработчик синхронизации не запущен, обратитесь к администратору сервера. Без обработчика выгрузки не собираются и не отправляются.

Автоматическая сверка сайта

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

1. В блоке «Подключение сайта» нажмите «Выпустить ключ». Sklads покажет ключ один раз.
2. Передайте разработчикам сайта защищённым способом сам ключ, а также «ID витрины» и «Адрес API сверки» из того же блока. У этих полей есть кнопка «Копировать».

В списке ключей видно, когда ключ выпущен и когда сайт последний раз им пользовался. Одновременно может действовать два ключа. Чтобы сменить ключ без перерыва в работе, выпустите новый, дождитесь, пока сайт перейдёт на него, и нажмите «Отозвать» у старого.

Отключение и архив

«Выключить» приостанавливает сборку и отправку. Ожидающие доставки продолжатся после повторного включения. «Архивировать» полностью останавливает синхронизацию. История ревизий и доставок при этом сохраняется.