KKeyAutoFlow
Яндекс Маркет · Быстрый запуск

Подключение магазина к KeyAutoFlow

Настройте Campaign ID, API‑токен, уведомления и точное соответствие SKU. После тестового заказа KeyAutoFlow сможет автоматически находить товар, резервировать свободный цифровой ключ и сохранять результат выдачи.

Создать аккаунтПолная документация
  1. 01Найдите Campaign ID магазина
  2. 02Создайте API‑токен
  3. 03Добавьте URL уведомлений
  4. 04Сопоставьте SKU и ключи
  5. 05Проверьте один заказ

1Найдите Campaign ID

Campaign ID — идентификатор конкретного магазина, через который Partner API понимает, с какой кампанией выполнять операции. Откройте настройки API в кабинете продавца либо страницу магазина и найдите параметр campaignId в адресной строке.

…?campaignId=149000000
Важно: Business ID и Campaign ID — разные значения. Номер после /business/ может быть Business ID; не переносите его в поле Campaign ID без проверки.

2Создайте API‑токен Маркета

В кабинете продавца откройте раздел API и модулей, создайте отдельный токен для KeyAutoFlow и предоставьте права, необходимые для работы с заказами, товарами и остатками. Названия пунктов меню могут меняться — ориентируйтесь на раздел управления API.

  • Скопируйте токен сразу после создания.
  • Не отправляйте токен в переписке и не размещайте на скриншотах.
  • Если токен отозван или истёк, создайте новый и сохраните его в Профиле.

В KeyAutoFlow откройте Профиль → Яндекс Маркет, укажите Campaign ID и API‑токен, затем сохраните настройки.

3Настройте API‑уведомления

Чтобы новые заказы поступали без ручного обновления, добавьте в настройках API‑уведомлений Яндекс Маркета адрес:

https://keyautoflow.ru/market/notification

Включите события об изменении заказа. После сохранения выполните проверку URL в кабинете Маркета. Успешный тест означает, что endpoint доступен; обработка реального заказа дополнительно зависит от Campaign ID, токена, статуса оплаты, SKU и наличия свободного ключа.

4Сопоставьте товар по SKU

SKU товара в KeyAutoFlow должен полностью совпадать с offerId предложения на Маркете. Учитываются буквы, цифры, регистр, пробелы и дефисы.

Маркет: MRKT-KG7754HHG
KeyAutoFlow: MRKT-KG7754HHG

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

5Проверьте тестовый заказ

Начните с одного товара и одного заказа. Проверьте всю цепочку: заказ получил нужный статус, SKU найден, ключ зарезервирован один раз, Маркет принял цифровой товар, а запись появилась в истории KeyAutoFlow.

  • Если заказ не найден — проверьте Campaign ID и уведомления.
  • Если товар не найден — сравните SKU и offerId символ в символ.
  • Если нечего выдать — пополните пул свободных ключей.
  • Если Маркет уже принял выдачу, не запускайте её повторно вручную.
Официальные методы, статусы и требования Partner API могут обновляться. Для спорных случаев сверяйтесь с документацией Яндекс Маркета.

Частые вопросы о подключении

Campaign ID и Business ID — это одно и то же?

Нет. Для подключения нужен Campaign ID конкретного магазина. Найдите его в настройках API или в параметре campaignId адреса страницы магазина.

Какой SKU указывать в KeyAutoFlow?

Укажите offerId предложения на Маркете без изменений. Регистр, пробелы и дефисы должны совпадать полностью.

Куда вставлять URL API‑уведомлений?

В настройках API‑уведомлений магазина укажите https://keyautoflow.ru/market/notification и включите уведомления об изменениях заказов.