Яндекс KIT. Возможности интеграции

В этой статье расскажем, какие возможности даёт интеграция SelSup с Яндекс KIT.

Интеграция позволяет импортировать карточки товаров из Яндекс KIT в SelSup, настроить связь со складом, передавать остатки из SelSup в Яндекс KIT и импортировать заказы для дальнейшей работы с ними в SelSup.

Подключение интеграции

Для настройки интеграции перейдите в раздел Настройки → Интеграции → Яндекс.КИТ и заполните данные, необходимые для подключения.

Ключ API необходимо генерировать в личном кабинете Яндекс KIT, раздел Настройки - API - нажмите Сгенерировать токен.

Включите «Работать с Яндекс.Кит», выберите организацию, укажите URL сайта и ключ API, затем нажмите «Сохранить». SelSup проверит токен и загрузит доступные склады. Для каждой организации подключение сохраняется отдельно. После настройки интеграции вы сможете импортировать товары и заказы, связать склад и настроить передачу остатков.

Импорт карточек товаров

Из Яндекс KIT можно импортировать карточки товаров в SelSup в разделе Товары - Импорт товаров - Яндекс.Кит.

После импорта товары появятся в разделе Товары. С ними можно будет работать в SelSup вместе с товарами из других подключённых магазинов и маркетплейсов.

Создавать товары из SelSup в Яндекс KIT по API нельзя. Для создания новых товаров используйте YML-файл.

Настройка связи со складом

Для корректной работы с остатками необходимо настроить связь между складом SelSup и магазином в Яндекс KIT.

Связь со складом указывается в настройках склада:

1. Перейдите в раздел Склад→ Склады
2. Откройте уже созданный склад или создайте новый. Подробней, как создать склад, рассказали в статье.
3. В блоке Связи со складами маркетплейсов выберите Яндекс.Кит - Организацию и нажмите Добавить.
4.   Сохраните настройки.

Как включить передачу остатков через API

Чтобы SelSup передавал остатки напрямую в Яндекс KIT, выберите API источником остатков в настройках интеграции. Отключение фида в Яндекс KIT не переключает этот режим в SelSup.

Перед настройкой сохраните действующий ключ API интеграции, свяжите товары и склад и включите автоматическую синхронизацию остатков для нужной организации.

1. Откройте Настройки → Интеграции → Яндекс.Кит.
2. Выберите нужную организацию.
3. В поле «Источник остатков» вместо «YML-фид» выберите «API Яндекс.Кит».
4. Дождитесь сообщения «Сохранено»: выбор источника сохраняется автоматически. Нижняя кнопка «Сохранить» относится к данным интеграции; для этого селектора отдельно нажимать её не нужно.

Проверьте, что для нужной организации выбран источник «API Яндекс.Кит», затем сверьте остатки товаров на связанном складе SelSup и в Яндекс KIT. Переключение режима само по себе не гарантирует немедленную отправку всех остатков. Кнопка «Импорт товаров» связывает карточки и не заменяет настройку источника остатков.

Создание товаров и передача остатков через YML

Через YML-файл можно создавать новые товары в Яндекс KIT и передавать остатки.

Если выбран источник остатков «YML-фид», Яндекс KIT получает остатки из YML-файла. При выбранном источнике «API Яндекс.Кит» остатки передаются через API, а YML-фид используется как каталог без складских остатков.

Чтобы получить ссылку на YML-файл:

1. Перейдите в раздел Настройки → Интеграции → Яндекс KIT.

2. Откройте настройки интеграции.

3. Прокрутите страницу до самого низа.

4. Скопируйте ссылку на YML-файл.

5. В личном кабинете Яндекс KIT перейдите в раздел Настройки → Товары, цены, остатки → Источники данных, добавьте ссылку на YML-файл и выберите его источником товаров.

6. В настройке Новые товары выберите Создавать и запустите обновление.

После синхронизации новые товары появятся в Яндекс KIT в статусе Скрыт. Проверьте карточки и опубликуйте их.

При выбранном источнике «YML-фид» изменения остатков на связанном складе SelSup отражаются в YML-файле. Для передачи через API используйте настройку источника остатков, описанную выше.

Передача цен

SelSup не передаёт цены в Яндекс KIT по API. Изменение цены товара в SelSup не обновит её в Яндекс KIT.

Импорт заказов

С интеграцией Яндекс.KIT в SelSup можно работать по схеме FBS.

При работе по FBS товары хранятся на вашем складе. После поступления заказа вы собираете товар и передаете его для дальнейшей доставки покупателю.

В SelSup можно импортировать FBS-заказы из Яндекс.KIT и работать с ними в разделе заказов.

Лист сборки заказов KIT. Откройте список FBS-заказов, выберите нужные заказы и нажмите «Лист сборки». Одинаковые позиции внутри одного заказа выводятся общей строкой с суммарным количеством: например, семь одинаковых единиц — как «7 шт.». Разные артикулы остаются отдельными позициями одного заказа. Позиции с различающимися данными, например ценой, сроком годности или упаковкой, могут оставаться отдельными строками.

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

Отдельная настройка «Объединять товары в листе сборки» объединяет товары из разных заказов. Для сборки отдельно по каждому заказу оставьте её отключённой.

Лист сборки не меняет состав заказа и количество грузомест в KIT. Упаковывайте товары по созданным в KIT отправлениям. Если в KIT включена настройка «Разделять товары по коробкам», для одного заказа могут потребоваться несколько коробок с отдельными ярлыками. Подробности — в правилах доставки Яндекс KIT.

Этикетки заказов

SelSup получает готовые ярлыки доставки Яндекс KIT и позволяет распечатать их для импортированных FBS-заказов.

1. Откройте список FBS-заказов и выберите нужные заказы KIT.
2. Нажмите кнопку со всплывающей подсказкой «Загрузить этикетки у заказов, где их нет» и дождитесь завершения загрузки.
3. Распечатайте загруженные этикетки кнопкой печати у заказа или общей командой печати этикеток для выбранных заказов.

Для заказа из нескольких частей доставки загружаются все доступные ярлыки, включая все страницы документов. Проверьте комплект и наклейте отдельный ярлык на каждое соответствующее грузоместо. Загрузка ярлыков использует уже оформленную доставку KIT и не создаёт повторную заявку перевозчику.

Если доставка ещё не создана в KIT или служба доставки временно не отдала ярлык, повторите загрузку позже. При временной ошибке хотя бы по одной части доставки неполный комплект не сохраняется как готовый. Для самовывоза и частей заказа, для которых служба доставки не предоставляет ярлыки, этикетка из KIT не формируется.

Соответствие статусов FBS-заказов

В Яндекс KIT статусы заказа, оплаты и доставки показываются отдельно. При импорте SelSup сопоставляет статус заказа из Яндекс KIT с одним из названий ниже.

Статус в SelSup	Соответствующий статус или этап в Яндекс KIT
Новый	«Новый» или «Ожидает подтверждение». Если Яндекс KIT передаст статус, который SelSup не распознаёт, заказ также попадёт в «Новые».
Ожидает оплаты	«Ожидает оплату».
Отменяется	Промежуточный этап отмены. Отдельного пользовательского названия этого этапа в справке Яндекс KIT нет.
Отмена покупателем	«Отменён» или «Доставка отменена».
Возврат	Полный или частичный возврат.
Доставляется	«Ожидает доставку».
Завершен	«Доставлен» или «Завершён».
На сборке	Технические этапы оформления чеков и настройки доставки. Отдельных пользовательских названий этих этапов в справке Яндекс KIT нет.

Прямого входящего соответствия для статусов SelSup «Собран», «Отправлен» и «Отменен» нет.

Если перевести заказ в SelSup в статус «Собран», «На сборке» или «Отправлен», SelSup подтвердит заказ в Яндекс KIT, только когда в Яндекс KIT указан статус «Ожидает подтверждение». При переводе заказа в статус «Отменен» или «Отмена покупателем» SelSup отправит в Яндекс KIT команду отмены.

Данный функционал реализован в модуле Умный склад. Он обеспечивает синхронизацию, сборку и маршрутизацию товаров, интеграцию со службами доставки, видеофиксацию для защиты от потребительского терроризма и адресное хранение остатков. Подробнее о возможностях модуля читайте здесь.

Ограничение частоты запросов при обновлении остатков

Если Яндекс KIT временно ограничивает частоту запросов, SelSup завершает текущую попытку обмена этой интеграции с ошибкой ограничения запросов и продолжает импорт для остальных организаций и площадок. Уже подтверждённые обновления сохраняются; позиции без подтверждения не считаются успешно обновлёнными. Подробности доступны в результате импорта, уведомлениях и истории обмена остатками.

Повторные обращения той же интеграции временно приостанавливаются на срок, указанный Яндекс KIT, либо примерно на минуту, если срок не передан. Это не отключает интеграцию и не меняет настройки синхронизации. После окончания паузы остатки можно обновить следующим импортом; автоматический повтор конкретной неуспешной задачи не гарантируется. Запускать несколько импортов одновременно для обхода ограничения не нужно.

Примерный прогресс импорта FBS

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

100% означает окончание обработки задачи. Проверяйте также её статус и результат: завершённая обработка может содержать ошибки отдельных площадок, даже если остальные организации обновились успешно. При выборе одной организации импорт сохраняет это ограничение; отключённая синхронизация остатков не включается.

Остатки архивных товаров

Настройка «Отправлять нулевой остаток у удаленных товаров» находится в разделе Настройки → Остатки и действует на весь кабинет SelSup. Если она выключена, полный обмен остатков через API Яндекс KIT пропускает архивные товары, в том числе товары со складской историей. При включённой настройке SelSup передаёт по архивным товарам нулевой остаток на связанные склады.

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