- Платформа PARTS SOFT /
- Возможности /
- Интеграция с маркетплейсом Kaspi.kz
Интеграция с маркетплейсом Kaspi.kz
Система PARTS SOFT позволяет интегрировать между собой ваш сайт на платформе и ваш магазин на Kaspi.kz. После настройки интеграции вам будет доступен функционал выгрузки ваших товаров для последующей их загрузки в ваш магазин на Kaspi.kz.
Выгрузка товаров
Товары на маркетплейс загружаются с помощью файла, который необходимо сформировать и выгрузить из системы. С помощью этого файла вы позже загрузите товары на маркетплейс.
Сформируйте выгрузку с типом Kaspi.kz. Обязательно настройте блок Дельта выгрузки (модуль расширения).
После завершения всех настроек скачайте сформированный файл на свой компьютер.
Настройка на Kaspi.kz
ШАГ 1. Войдите в свой личный кабинет Kaspi.kz и перейдите в раздел Настройки → Токен API.
ШАГ 2. На открывшейся странице нажмите кнопку Сформировать.
Скопируйте полученный токен в надежном месте, он понадобится вам при настройке интеграции на стороне PARTS SOFT.

Получение API-токена
ШАГ 3. Отправьте тестовый API-запрос.
Можно использовать любой сервис, например, Postman, Insomnia, Paw, Swagger, SoapUI.
Полученный ответ должен быть в статусе 200.
Настройка на стороне PARTS SOFT
ШАГ 1. В панели администрирования перейдите в раздел Справочники → Маркетплейсы и в списке доступных сервисов выберите логотип Kaspi.kz. Нажмите кнопку ОК в окошке подтверждения.

Подключение к Kaspi.kz
ШАГ 2. На открывшейся странице выполните следующие действия:
| № | Настройка | Описание |
|---|---|---|
| 1 |
Название |
Укажите название интеграции. Указанное название будет отображаться в общем списке интеграций в разделе Справочники → Маркетплейсы. |
| 2 |
Аккаунт активен |
Активируйте опцию, чтобы включить интеграцию. |
| 3 |
Регион подключения |
Выберите регион подсключения маркетплейса. По умолчанию выбран основной регион сайта. |
| 4 |
Токен Kaspi API |
Укажите ваш API-токен, скопированный ранее в вашем личном кабинете на Kaspi.kz. |
| 5 |
Связанный контрагент |
Выберите клиента, на которого будут оформляться заказы, полученные в разделе Заказы клиента → Все. Выбранный клиент должен быть прикреплен к той группе скидок, которая указана во вкладке Цена продажи, т.е. используется для расчета цены в данной выгрузке. Если группа скидок клиента отличается от указанной на вкладке Цена продажи, будут расхождения в цене при оформлении заказа. |
| 6 |
Статус позиции заказа, когда заказ маркетплейса отменен |
Выберите статус, который будет устанавливаться для заказ, если заказ был отменен на стороне маркетплейса. |
| 7 | Выберите выгрузку |
Выберите созданную ранее выгрузку товаров. Вы также можете выбрать несколько выгрузок. |
Сохраните изменения.

Настройки интеграции
ШАГ 3. После сохранения настроек станет доступен блок Настройка автоматической обработки заказа. Для настройки автоматической обработки заказов, поступающих с маркетплейса, воспользуйтесь инструкцией Автоматическая обработка заказов.
Список обработанных и распределенных позиций из заказов, загруженных с Kaspi.kz, будет доступен в разделе Заказы клиента → Все. Они будут закреплены за клиентом, которого вы указали при настройке интеграции.
Загрузка товаров на маркетплейс
Загрузка товаров на Kaspi.kz во многом зависит от собственного каталога товаров маркетплейса.
Каталог товаров в Kaspi.kz является единым для всех продавцов.
-
Если товара еще нет в каталоге Kaspi
Загрузите Excel-файл с вашими товарами, ранее выгруженный вами из системы PARTS SOFT. Для этого:
ШАГ 1. В личном кабинете продавца Kаspi.kz cкачайте Excel-шаблон нужной категории товаров.
ШАГ 2. Добавьте в шаблон данные о товарах и сохраните изменения.
ШАГ 3. Загрузите подготовленный файл в кабинете продавца.
Таким способом можно загрузить сразу большое количество новых товаров.
-
Если товар уже есть в каталоге Kaspi
В этом случае необходимо загрузить файл с товарами и после этого вручную привязать товар к существующей карточке каталога Kaspi.kz.
Массовая загрузка для привязки недоступна.
Чтобы привязать товары к существующим карточкам каталога, выполните следующие действия:
ШАГ 1. В вашем кабинете продавца перейдите в раздел Управление товарами → Добавить новый товар.
ШАГ 2. Найдите нужный товар и перейдите в его карточку.
После этого ваш товар будет привязан к существующей карточке Kaspi.kz.
SKU продавца и код товара Kaspi
- SKU — внутренний артикул, который продавец задает самостоятельно. У разных продавцов одного товара SKU может отличаться;
- Код товара Kaspi — единый идентификатор карточки товара, одинаковый для всех продавцов.
В выгрузках Excel и XML содержатся только SKU продавца. Код товара Kaspi в них не отображается.
Узнать код товара Kaspi можно:
- на сайте Kaspi;
- в Кабинете продавца: Управление товарами → (выбрать нужный товар) → Редактировать карточку товара.