Интеграция
Раздел «Интеграция» отвечает за обмен данными между kvkup и подключённым маркетплейсом.
Чтобы открыть раздел: выберите нужную площадку (Kaspi, Ozon, Wildberries или Teez) → «Интеграция».
Как работает синхронизация
После настройки интеграции kvkup становится главным источником данных для цен и остатков. Все изменения цен и остатков, внесённые вручную в кабинете продавца маркетплейса, будут автоматически перезаписаны данными из kvkup при следующей синхронизации.
Первичное подключение
Если маркетплейс ещё не подключён, начните со страницы «Контракты»:
- В блоке «Подключить» выберите нужную площадку.
- Выполните шаги подключения: привяжите склады, укажите данные авторизации и запустите первичный импорт каталога и заказов.
- По завершении откройте «Интеграция» на странице маркетплейса, чтобы проверить или изменить параметры работы.
Что требуется для подключения
| Маркетплейс | Данные авторизации | Идентификация склада |
|---|---|---|
| Kaspi | API-токен, ID магазина (партнёра), данные входа для импорта | Код склада из кабинета Kaspi |
| Ozon | Client ID и API-ключ | 16-значный ID склада из URL браузера |
| Wildberries | API-ключ (JWT-токен продавца) | ID склада из кабинета Wildberries |
| Teez | API-токен | ID склада из кабинета Teez |
Вкладки страницы «Интеграция»
1. Авторизация
Хранит ключи API и токены для подключения к маркетплейсу.
- Заполненные поля отмечаются статусом «установлено».
- Для смены ключей введите новые значения и сохраните форму.
- Кнопка импорта товаров доступна только после заполнения всех обязательных полей авторизации.
2. Склады
Сопоставляет внутренние склады kvkup со складами и точками отгрузки маркетплейса.
Зачем это нужно: Без привязки складов kvkup не сможет корректно списывать остатки при заказах и передавать актуальные запасы на маркетплейс.
Где взять коды складов:
- Kaspi: Кабинет продавца → Настройки → Склады и магазины.
- Ozon: Кабинет продавца → FBS → Управление логистикой. Откройте нужный склад и скопируйте 16-значный числовой код из адресной строки браузера.
- Wildberries и Teez: Личный кабинет продавца → раздел управления складами.
3. Товары
Показывает товары, привязанные к выбранному маркетплейсу.
Основные возможности:
- Импортировать товары — загрузить каталог из маркетплейса в kvkup (требуются заполненные ключи авторизации).
- Добавить в продажу — опубликовать или связать товары с маркетплейсом.
- Фильтрация и поиск — поиск по названию/артикулу, фильтр по категориям, а также переключение между активными товарами и позициями с ошибками связывания.
SKU должен совпадать на разных маркетплейсах
kvkup связывает товары между маркетплейсами по SKU. Если вы продаёте один и тот же товар на нескольких площадках, используйте одинаковый SKU для этого товара в каждом кабинете продавца. Иначе система может не связать карточки между собой после импорта.
4. Прайс-лист (Только для Kaspi)
Передаёт цены и остатки в Kaspi через XML/URL прайс-листа.
Инструкция по настройке:
- В kvkup перейдите: Kaspi → Интеграция → Прайс-лист и скопируйте ссылку на прайс-лист.
- В кабинете продавца Kaspi перейдите: Товары → Загрузить прайс-лист → Автоматическая загрузка.
- Вставьте ссылку из kvkup, включите автоматическую загрузку и сохраните.
Kaspi обновляет данные по этой ссылке каждые 60 минут.
Внимание перед включением прайс-листа
Убедитесь, что в kvkup указаны актуальные цены и остатки. Как только Kaspi начнёт скачивать прайс-лист, все ручные изменения цен и остатков в кабинете Kaspi будут перезаписываться данными из kvkup.
Проверка работы после настройки
Чек-лист проверки
После изменения настроек убедитесь, что обмен данными работает корректно:
- Авторизация: Рядом с заполненными полями отображается статус «установлено».
- Товары: Каталог импортируется без ошибок, товары привязаны.
- Заказы: Новые заказы с маркетплейса поступают в систему.
- Остатки и цены: Остатки привязаны к верным складам, а цены обновляются без конфликтов.