← Qyran

Эта инструкция доступна без регистрации. Чтобы сохранить ключи в Qyran — войдите в кабинет.

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

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

После сохранения ключа нажмите «Проверить API» — так вы увидите, что подключение работает.

Kaspi.kz — Merchant API Открыть

Заказы, отзывы, каталог и связь с Kaspi-фидом (цены, демпинг).

  1. 1 Войдите в кабинет продавца: kaspi.kz → Мой магазин → Партнёру → Настройки.
  2. 2 В разделе «API» / «Интеграция» создайте или скопируйте X-Auth-Token (Merchant API).
  3. 3 Токен часто показывается один раз — сохраните в надёжном месте.
  4. 4 Qyran → Настройки → поле «Kaspi Merchant API token» → вставьте → Сохранить.
  5. 5 Нажмите «Проверить Kaspi API» — должны пройти проверки заказов и категорий.

Куда вставить в Qyran: Настройки → Kaspi Merchant API token (/app/settings)

Официальная документация Kaspi Merchant API ↗
Для NTIN/НКТ нужен отдельный ключ с nationalcatalog.kz — см. раздел НКТ ниже.
Wildberries — Seller API Открыть

Карточки товаров, остатки, заказы.

  1. 1 seller.wildberries.ru → Настройки → Доступ к API.
  2. 2 Создайте токен с правами «Контент» и «Маркетплейс» (оба обязательны).
  3. 3 Скопируйте JWT-токен целиком.
  4. 4 Qyran → Настройки → Wildberries API token → Сохранить.
  5. 5 Укажите ID склада WB (для остатков) → «Проверить WB API».

Куда вставить в Qyran: Настройки (/app/settings)

Документация Wildberries Open API ↗
Без «Контент» карточки не выгрузятся; без «Маркетплейс» — заказы и остатки.
Ozon — Seller API Открыть

Карточки, цены, остатки, заказы.

  1. 1 seller.ozon.ru → Настройки → Seller API → Сгенерировать ключ.
  2. 2 Client-Id и Api-Key — два разных значения, скопируйте оба.
  3. 3 Qyran → Настройки → поля Ozon Client-Id и Api-Key.
  4. 4 Укажите Ozon склад ID (кабинет → Склады) для синхронизации остатков.
  5. 5 Сохраните → «Проверить Ozon API».

Куда вставить в Qyran: Настройки (/app/settings)

Документация Ozon Seller API ↗
Для создания API-ключа может понадобиться роль Admin в кабинете Ozon.
Halyk Market — OAuth API Открыть

Получение и принятие заказов Halyk Market.

  1. 1 halykmarket.kz — войдите как продавец, раздел API / интеграции.
  2. 2 Получите client_id и client_secret (OAuth 2.0) по официальной инструкции.
  3. 3 Qyran → Halyk Market (/app/halyk) → ⚙️ Настройки → client_id и secret.
  4. 4 После сохранения Qyran автоматически получит access token.
  5. 5 Принимайте заказы из раздела Halyk в Qyran.

Куда вставить в Qyran: Halyk Market → Настройки (/app/halyk) — не в общих API-ключах

Документация Halyk Market API (авторизация) ↗
Accept заказов идёт через api.halykmarket.com; credentials — с halykmarket.kz/gw.
Forte Market — Seller API v3 Открыть

Заказы и товары Forte Market.

  1. 1 Кабинет продавца Forte Market (marketforte.kz).
  2. 2 Раздел API / интеграции — Bearer-токен или ключ по инструкции Forte.
  3. 3 Qyran → Forte Market (/app/forte) → ⚙️ Настройки → вставьте токен.
  4. 4 Сохраните → обновите список заказов.

Куда вставить в Qyran: Forte Market (/app/forte)

Техническая документация Forte Seller API ↗
Базовый URL API: marketapi.forte.kz/v3/
Satu.kz — Company API Открыть

Каталог и заказы Satu.kz.

  1. 1 Кабинет продавца Satu → Настройки → API.
  2. 2 Создайте или скопируйте API-токен (Bearer).
  3. 3 Qyran → Настройки → Satu API token → Сохранить.
  4. 4 «Проверить Satu API» — проверка товаров и заказов.
  5. 5 При ошибке 401 — перевыпустите токен в кабинете Satu.

Куда вставить в Qyran: Настройки (/app/settings)

Кабинет Satu.kz ↗
Формат заголовка: Authorization: Bearer <token>
NTIN / НКТ — nationalcatalog.kz Открыть

Регистрация товаров в Национальном каталоге (NTIN для Kaspi и других площадок).

  1. 1 Регистрация на nationalcatalog.kz → API-ключ в личном кабинете.
  2. 2 Qyran → Kaspi NTIN (/app/kaspi/nkt) → поле NKT API key.
  3. 3 Это не Kaspi merchant token — отдельный ключ НКТ.
  4. 4 Подробная пошаговая инструкция — на странице NTIN/НКТ.

Куда вставить в Qyran: Kaspi NTIN (/app/kaspi/nkt)

Документация НКТ API ↗
Для многих категорий Kaspi NTIN обязателен — регистрация на nationalcatalog.kz.
Если что-то не получается — напишите через /contacts. Подробная инструкция по NTIN/НКТ: Инструкция NTIN / НКТ →
Начать бесплатно Вход