OptiSellerDM

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

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

В OptiSellerDM всё настраивается через справочники: основные токены и поля интеграций — в карточке организации (Справочники → Организации, внизу формы блок интеграций; обычно берите организацию по умолчанию, например «Организация #1»). Остальное — в других справочниках (например Справочники → Склады — код склада Kaspi, город для Яндекса). На этой странице только инструкции. Открыть справочник организаций (после входа в личный кабинет тенанта).

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

Kaspi.kz

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

API‑токен продавца (поле «Kaspi1 API токен» / «Токен»):
В личном кабинете продавца Kaspi.kz → Настройки → Интеграция / API — создайте или скопируйте токен. Этот токен даёт доступ к заказам, товарам и настройкам магазина. Внесите его в карточке организации OptiSellerDM: Справочники → Организации → откройте организацию → внизу формы блок интеграций, поле Kaspi1 API токен / «Токен».
ID партнёра (поле «Kaspi ID партнёра» / «ID партнёра»):
В ЛК Kaspi: Настройки → Общая информация найдите значение «ID партнёра» и скопируйте его. Это идентификатор продавца (может отличаться от номера магазина). Внесите в карточке организации в поле «Kaspi ID партнёра» / «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) система отличает ваши предложения от конкурентов, если в ответе API нет отдельного id продавца. После смены названия магазина в Kaspi обязательно обновите поле в карточке организации OptiSellerDM — иначе старое имя перестанет совпадать с витриной, ваши офферы могут считаться «чужими», и цена будет подстраиваться под них (риск демпинга «сам с собой»).
Флаги доставки для расчёта минимальной цены (поля «Доставка: Экспресс / Kaspi / Своя»):
В карточке организации OptiSellerDM есть три чекбокса: Доставка: Экспресс, Доставка: Kaspi и Доставка: Своя.
Эти флаги используются скриптом calculate_prices.py для выбора сценария доставки при расчёте минимальной продажной цены для Kaspi.
Для каждого тенанта отметьте варианты доставки, которые реально доступны вашему магазину — скрипт будет учитывать только отмеченные способы.
Тарифы доставки рассчитываются по таблице Kaspi (сумма заказа + вес товара). Для расчёта используется поле товара Вес Kaspi.
Важно: специальные тарифы для шин в автоматическом расчёте минималок сейчас не применяются.
Налог (% от выручки) (поле «Налог (% от выручки)» в организации):
Это эффективная налоговая нагрузка с каждой продажи на Kaspi — доля выручки, которая уходит на НДС, корпоративный налог и т.п.
Укажите приблизительный процент (например, 3 или 5). Скрипт calculate_prices.py будет вычитать этот процент из цены при расчёте минимальной допустимой цены продажи.
Ожидаемая маржа после всех расходов (поле «Kaspi: ожидаемая маржа (% после всех расходов)»):
Здесь задаётся минимально допустимая маржа от продажи товара на Kaspi после вычета комиссии маркетплейса, налогов и доставки.
Например, если вы хотите, чтобы после всех расходов оставалось не меньше 10% от цены продажи, укажите 10 — скрипт calculate_prices.py не будет опускать минимальную цену ниже этого уровня маржи.

Итого по Kaspi: токен, ID партнёра, логин/пароль ЛК, название магазина и флаги минимальной цены — в карточке организации; код склада PP1/PP2 — в справочнике складов для соответствующего склада.

Webkassa

Что понадобится: логин, пароль и ЗНК (UniqueNumber) вашей кассы в кабинете Webkassa.

Логин и пароль (поля «Webkassa Login» и «Webkassa Password»):
Откройте кабинет https://my.webkassa.kz и используйте логин/пароль от вашей учетной записи. Эти данные внесите в карточке организации OptiSellerDM в блоке интеграций.
ЗНК кассы (поле «Webkassa ЗНК (UniqueNumber)»):
В кабинете Webkassa откройте карточку кассы и скопируйте заводской номер кассы вида SWK.... Вставьте его в поле Webkassa ЗНК (UniqueNumber) в карточке организации.

После сохранения настроек система сможет формировать чеки через подключенную кассу Webkassa.

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

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

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

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

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