OptiSellerDM

Инструкции по модулям интеграции

Как получить токены и данные для подключения Kaspi.kz, Halyk Market, Wappi и Яндекс.Доставка в OptiSellerDM.

Токены и ключи вводите не здесь: на этой странице только подсказки. Сами данные вносите в Настройка интеграций (нужен вход в личный кабинет тенанта).

Быстрые ссылки по полям:

Kaspi.kz

Что понадобится: API‑токен продавца, ID партнёра (в ЛК: Настройки → Общая информация), номер магазина для отчётов (1, 2 и т.д.), логин и пароль личного кабинета.

API‑токен продавца (поле «Kaspi1 API токен» / «Токен»):
В личном кабинете продавца Kaspi.kz → Настройки → Интеграция / API — создайте или скопируйте токен. Этот токен даёт доступ к заказам, товарам и настройкам магазина. Внесите его:
  • в Панели OptiSellerDM: Сервис → Панель управления → Интеграции → Kaspi, поле «Токен»;
  • и/или в карточке организации OptiSellerDM в поле Kaspi1 API токен, если работаете через организации.
ID партнёра (поле «Kaspi ID партнёра» / «ID партнёра»):
В ЛК Kaspi: Настройки → Общая информация найдите значение «ID партнёра» и скопируйте его. Это идентификатор продавца (может отличаться от номера магазина). Внесите его в Панели OptiSellerDM на вкладке Kaspi в поле «ID партнёра».
ID склада в Kaspi (поле склада «ID склада в Каспи (PP1, PP2…)»):
В ЛК Kaspi каждому складу присваивается код вида PP1, PP2 и т.п. В OptiSellerDM откройте Справочники → Склады, выберите нужный склад и в поле ID склада в Каспи (PP1, PP2…) укажите соответствующий код. Это нужно для выгрузки остатков и цен по складам.
Логин и пароль ЛК Kaspi (поля «Kaspi ЛК логин» и «Kaspi ЛК пароль»):
Используйте логин (обычно email) и пароль пользователя, у которого есть доступ к товарам и заказам в ЛК Kaspi. Эти данные нужны только для автоматического импорта номенклатуры/товаров через парсер. Введите их в карточке организации OptiSellerDM в соответствующие поля.
Название магазина (поле «Название магазина (Kaspi)»):
В личном кабинете Kaspi по адресу kaspi.kz/mc откройте раздел «Настройки» → вкладка «Общая информация» и найдите поле «Название магазина».
Скопируйте это название магазина и вставьте его в OptiSellerDM в карточке организации в поле Название магазина (Kaspi).
Это название будет использовано в теге <company> XML‑прайса, чтобы прайс корректно отображался в кабинете Kaspi.
Флаги доставки для расчёта минимальной цены (поля «Доставка: Экспресс / Kaspi / Своя»):
В карточке организации OptiSellerDM есть три чекбокса: Доставка: Экспресс, Доставка: Kaspi и Доставка: Своя.
Эти флаги используются скриптом calculate_prices.py для выбора сценария доставки при расчёте минимальной продажной цены для Kaspi.
Для каждого тенанта отметьте варианты доставки, которые реально доступны вашему магазину — скрипт будет учитывать только отмеченные способы.
Налог (% от выручки) (поле «Налог (% от выручки)» в организации):
Это эффективная налоговая нагрузка с каждой продажи на Kaspi — доля выручки, которая уходит на НДС, корпоративный налог и т.п.
Укажите приблизительный процент (например, 3 или 5). Скрипт calculate_prices.py будет вычитать этот процент из цены при расчёте минимальной допустимой цены продажи.
Ожидаемая маржа после всех расходов (поле «Kaspi: ожидаемая маржа (% после всех расходов)»):
Здесь задаётся минимально допустимая маржа от продажи товара на Kaspi после вычета комиссии маркетплейса, налогов и доставки.
Например, если вы хотите, чтобы после всех расходов оставалось не меньше 10% от цены продажи, укажите 10 — скрипт calculate_prices.py не будет опускать минимальную цену ниже этого уровня маржи.

В панели OptiSellerDM (Сервис → Панель управления → Интеграции) выберите тенанта и вкладку Kaspi, вставьте токен и ID партнёра. Для расширенного импорта заполните логин и пароль ЛК, а также поле «Название магазина (Kaspi)» в карточке организации.

Halyk Market

Что понадобится: Client ID, Client Secret и ID склада (POS code) для доступа к API маркетплейса.

ID склада (POS code) (поле «ID склада (Halyk POS code)» в карточке организации):
В личном кабинете Halyk Market откройте раздел «Склады». У каждого склада в таблице есть колонка ID склада.
Выберите тот склад, с которого реально отгружаются товары для заказов Halyk, и скопируйте его.
В OptiSellerDM откройте карточку организации и в поле ID склада (Halyk POS code) вставьте скопированный код. По этому значению система понимает, с каким складом Halyk Market работать при импорте заказов и выгрузке остатков.
Client ID (поле «Halyk client_id» / «Client ID (HMM_БИН)»):
Это строка вида HMM_БИН. В личном кабинете Halyk Market найдите БИН магазина (например, 123456789012) и составьте HMM_123456789012. Это значение введите:
  • в Панели OptiSellerDM → вкладка Halyk в поле «Client ID (HMM_БИН)»;
  • и/или в карточке организации в поле Halyk client_id.
Client Secret (поле «Halyk client_secret» / «Client secret»):
Секретный ключ выдаётся по запросу. Напишите в техподдержку Halyk Market и запросите Client Secret для интеграции с системой учёта (OptiSellerDM). Скопируйте присланное значение и введите его в соответствующее поле в Панели/карточке организации. Храните его в секрете и никому не передавайте.

В панели OptiSellerDM (Сервис → Панель управления → Маркетплейсы) выберите тенанта и вкладку Halyk, укажите Client ID и Client Secret — система будет использовать их для получения заказов и обновления статусов.

Wappi (WhatsApp)

Что понадобится: Токен и Profile ID из личного кабинета Wappi.

Зарегистрируйтесь на wappi.pro. В профиле или настройках API скопируйте токен и Profile ID (идентификатор профиля, с которого отправляются сообщения).
Префикс номера: укажите код страны (например, 7 для Казахстана), если номера в базе хранятся без кода.

В панели OptiSellerDM → вкладка Wappi выберите тенанта, вставьте токен и Profile ID. Включите нужные уведомления: новые заказы, доставка, напоминания и т.д.

Яндекс.Доставка и геокодер

Что понадобится: токен из кабинета Яндекс.Доставки и (опционально) API‑ключ геокодера.

Токен доставки (поле «Yandex.Доставка: токен» / «Токен из кабинета Яндекс.Доставки»):
Зайдите в личный кабинет Яндекс.Доставка → Интеграции, нажмите «Получить токен» и скопируйте его. Вставьте токен:
  • на странице Настройка интеграций в поле «Токен из кабинета Яндекс.Доставки»;
  • и/или в карточке организации OptiSellerDM в поле Yandex.Доставка: токен.
API‑ключ геокодера (поле «Yandex.Доставка: токен геокодера» / «API‑ключ геокодера»):
Перейдите по ссылке developer.tech.yandex.ru и авторизуйтесь под своим аккаунтом Яндекса.
Нажмите кнопку «Подключить API», далее выберите сервисы «JavaScript API» и «HTTP Геокодер».
Отметьте, что вы подходите под бесплатное использование, согласитесь с условиями, введите капчу и нажмите «Далее». В новом окне нажмите «Перейти к API» и скопируйте выданный ключ API.
Вставьте этот ключ в поле Yandex.Доставка: токен геокодера в карточке организации. Ключ необходим для правильного определения координат адресов и отрисовки точек на карте в отчёте «Доставка».
Город по умолчанию (поле «Yandex.Доставка: город» в организации):
Это город, который будет подставляться в адрес, если в заказе или по складу город не указан. Укажите основной город магазина (например, «Астана»). Для складов в других городах лучше заполнить отдельное поле на складе (см. ниже).
Город склада (поле склада «Yandex.Доставка: город»):
В OptiSellerDM откройте Справочники → Склады и для каждого склада укажите город в поле Yandex.Доставка: город. При создании заявок в Яндекс.Доставку город будет браться:
  1. из склада документа (это поле), если оно заполнено;
  2. иначе — из поля организации «Yandex.Доставка: город»;
  3. иначе — из базовой настройки интеграции Яндекса.

После настройки интеграций в панели данные автоматически подхватываются OptiSellerDM для выбранного тенанта. Модули доступны только если они входят в ваш тариф.

← Вернуться к тарифам