Руководство по настройке интеграции

Все про интеграцию МойСклад и Kaspi.kz
Схема работы интеграции
Не используете МойСклад?
Попробуйте лучшую в СНГ систему для торгового учета бесплатно.
Видеоинструкция по настройке приложения
Интеграция позволяет напрямую выгружать товар из сервиса МойСклад в Kaspi Магазин, включая изображение и другую информацию о товаре, при этом соблюдая все стандарты маркетплейса. Реализована синхронизация по остаткам и ценам, а также заказам. Изменять статус заказа можно из интерфейса МойСклад.
Главная
Токен
После установки виджета, вам требуется его активировать, указав API токен. Взять его можно в партнерском кабинете в Kaspi Магазине. Подробная инструкция по генерации API-токена доступная на сайте Kaspi.kz вот тут. После ввода ключа нажмите на кнопку сохранить.
Поле выгрузки товара
Создайте дополнительное поле "Товар Kaspi" в карточке товара с типом "Флажок". Товар с установленной галочкой в данном поле будет выгружаться в Kaspi Магазин.

Инструкции:

Тип выгрузки товара

Данная функция связана с настройкой "Поле выгрузки товара". Она позволяет вам выбрать, какой товар выгружать в Kaspi и в прайс-лист XML. По умолчанию установлено значение "Выгружать только отмеченный товар". Т.е товар у которого установлена галочка в "Поле выгрузки товара". Но есть возможность выгружать весь товар, кроме исключений ( товара с галочкой в доп.поле).
Название компании и ID партнера
Без заполнения полей Название компании и ID партнера интеграция работать не будет. Всю необходимую информацию найдете в личном кабинете партнера Kaspi. После заполнения всех полей и сохранения изменений, следует приступить к следующему шагу настройки.
Заказы
Синхронизация заказов
После включения синхронизации в МойСклад начнут передаваться заявки из Kaspi, а также их статус. Обновление информации происходит каждые 15 минут. Синхронизация заказов двухсторонняя. Это значить, что изменение некоторых статусов заказов в одной из систем, отобразиться и в другой. Более подробно смотрите пункте Сопоставление статусов.

В МойСклад попадают только те заявки, по которым банк одобрил покупку/кредит покупателю.
Организация
Выбранная вами организация будет автоматически указываться в заказах из Kaspi и документах.

Инструкция
Как создать организацию
Создание контрагента
Данная настройка отвечает за контрагента в новых заказах Kaspi. Включая ее, из Kaspi будет передаваться информация о клиенте/контрагенте в новые заказы и базу МойСклад. Выключенная функция новых контрагентов создавать не будет, а заказы будут фиксироваться за выбранным вами контрагентом.
Нумерация заказов
Настройте отображение номера заказа Kaspi в МойСклад. Если выключено, то номер заказа будет проставляться в дополнительном поле, которое вы выберите. Если включено, тогда информация будет передаваться в стандартное поле нумерации заказов в МойСклад.
Способ оплаты
Функция передает информацию о способе оплате заказа из Kaspi Магазина в МойСклад. Способ оплаты можно включить в разделе Заказы в настройках приложения. Обязательно создайте доп. поле в заказах в сервисе МойСклад по типу строка и выберите его в настройках приложения Fixcom.
Экспресс доставка
Экспресс заказы из Kaspi Магазина можно легко выделить из общей массы заказов в МойСклад. Создайте поле по типу Флажок и выберите его в настройках нашего приложения в соответствующем поле. Все экспресс заказы буду создаваться в МойСклад с галочкой.
Проект
Функция позволяет все создаваемые заказы из Kaspi прикреплять к проекту в МойСклад.
Сотрудник и Отдел
Ответственный сотрудник и отдел, который будет автоматически назначаться на заказ и документы к заказу.
Учитывать комиссию по товарам

У Kaspi есть комиссия за продажи. Она разная и зависит от категории товара. Вы можете указать дополнительное поле в заказе, где будет отображаться общая сумма комиссии Kaspi.

Тип комиссии
Процент комиссии Kaspi можно настроить. Либо использовать процент в зависимости от категории товара (Тарифы по категориям), либо указать вручную фиксированную комиссию. Она будет учитываться по всем заказам, не зависимо от категории товара.
Учитывать в накладных расходах
При включении данной опции, комиссия Kaspi будет отображаться в накладных расходах в документе Отгрузка. Такие образом отчет по себестоимости будет строиться правильно.
Резервирование товаров
При включении функции, товар в МойСклад автоматически будет резервировать при поступлении нового заказа из Kaspi.
Канал продаж
Создайте и выберите необходимый канал продаж. Новые заказы из Kaspi Магазина будут с выбранным вами каналом продаж.

Инструкция
Как создать канал продаж
Документы
В выпадающем списке выберите статус заказа при котором приложение автоматически будет создавать документ в сервисе Мой Склад, например отгрузка или платеж. Вы можете не создавать документы вовсе, выбрав соответствующий пункт в выпадающем списке.
Изменение статусов заказа
Подтверждение заказа
Выдача заказа
Нажимая на кнопку выдать заказ, отправиться запрос на получение кода у клиента.
После нажатия кнопки появится всплывающее окно, где требуется внести код, который был отправлен по СМС клиенту.

После ввода кода в соответствующее поле и нажатии на кнопку "Выдать заказ", ваш заказ будет автоматически завершен в Kaspi. В кабинет заходить не нужно.
Отмена заказа
  • Начать Возврат заказа можно только из кабинета партнера Kaspi.
  • Изменить заказ можно только в версии через браузер, в мобильном приложении это сделать пока не возможно.
Товары - Экспорт цен и остатков
Раздел Экспорт цен и остатков не зависит от функций Шаблоны и Экспорт товаров. Он работать с теми товарами, которые уже есть в Kaspi и МойСклад и если их код товара (SKU) совпадают.
Бренд
Если уже есть доп. поле Бренд, то создавать по новой его не нужно.

Создайте дополнительное поле в карточке товара. Назовите его Бренд. Тип создаваемого поля может быть Строка или Справочник. Данное поле является обязательным для заполнения при выгрузке товара, цен и остатков. Иначе экспорт работать не будет. Выберите нужное значение в выпадающем списке.
Тип артикула
Можно выбрать по какому типу будет работать интеграции при формировании прайс-листа (XML-ссылка). Можно выбрать артикул или код товара в МойСклад. Рекомендуемо использовать Код Товара, так как данное поле является уникальным в МойСклад, и существует у модификаций товаров. Артикула у модификаций товара НЕТ.

При выборе пункта Артикул товара, модификации из МойСклад выгружаться в прайс-лист (XML) не будут, только основной товар с артикулом. Кроме того, поле артикул допускает одинаковые значения в двух и более товарах, нежели Код Товара.
Тип цены
Необходимо если хотите продавать товар на Kaspi по другой цене, нежели указанной стандартной у вас в сервисе МойСклад. Приложению можно указать, откуда брать стоимость товара при формировании прайс-листа XML для Kapsi Магазина.

Инструкция
Как редактировать Типы Цен в МойСклад
Тип остатка
Можно выбрать какой тип остатков учитывать при генерации прайс листа (XML). Всего доступно три значения:
  • доступно (доступный и ожидаемый товар без учета резерва) - Рекомендуем
  • остаток (остаток с учетом резерва)
  • остаток без резерва
Учёт неснижаемого остатка
При включении функции, опубликованный товар в Kaspi будет автоматически снят с продаж, если количество товара в МойСклад достигнет значений неснижаемого остатка.

Функция нужна магазинам с оффлайн точками продаж. Так продавцы указывая неснижаемый остаток, отделяют витринный товар от складского. Отметим, что витринный товар запрещено продавать в Kaspi Магазине.

Важно! Технически МойСклад пока не позволяет посмотреть неснижаемый остаток у модификаций. По этой причине в приложении при создании прайс-листа XML, значение неснижаемого остатка основного товара, распространяется и на модификации.
Ссылка на XML-фид для Kaspi Магазина
МойСклад и Kaspi Магазин общаются между собой по поводу остатков и цен через промежуточный файл XML. По другому Kaspi не умеет. Чтобы механизм заработал, вам необходимо в кабинете партнера Kaspi указать ссылку на XML файл генерируемый виджетом, выбрать автоматическая загрузка прайс-листа в разделе Товары > Загрузить прайс-лист, как показано на изображении ниже.

МойСклад каждые 15 минут отчитывается об остатках и ценах системе XML, а вот Kaspi заглядывает в неё раз в 30-60 минут. Если вам требуется "вот прям щас" выгрузить остатки и цены, то вы можете нажать кнопку Выгрузить, но на скорость обработки со стороны Kaspi это не повлияет.

Важно
  • На текущий момент выгружается общая стоимости товара, без разбивки по городам. Вскоре данный функционал будет реализован.
Настройки складов
Данный пункт позволяет связать склады/магазины Kaspi Магазина со складами в сервисе МойСклад. Если товар кончится на одном из складов в МойСклад, Kaspi Магазин это увидит и автоматически снимет товар с продажи. Также работает и с обновлением стоимости товара. Если цена за товар изменилась в МойСклад, она автоматически измениться и в Kaspi Магазине.
Загрузка товаров в Kaspi Магазин
Модуль Шаблоны автоматизирует загрузку нового товара из МойСклад в Kaspi. Также не требуется ручного сопоставления на уровне Kaspi. Успешно выгруженный товар сразу отправляется на публикацию. Изображения товара из МойСклад также выгружаются в Kaspi.

Важно, чтобы информация о выгружаемом товаре была полная. Если хоть в одной карточке товара будет ошибка или не указано обязательно поле, то товар не выгрузится.
Стоимость виджета
Помесячная оплата
Стоимость за 1 месяц
22 500 ₸
  • 14 дней тестового периода
При покупке на 6 мес
Стоимость за 1 месяц
20 250 ₸
  • Скидка 10%
При покупке на 12 мес
Стоимость за 1 месяц
18 000 ₸
  • Скидка 20%
Дополнительная информация
Все инструкции

Полезные ссылки для всех, кто торгует на Kaspi и использует наш виджет.

Важно
  • Во время проведения акции, Kaspi иногда отключает часть функционала со своей стороны. Например может перестать работать выгрузка товаров на время проведения акции.
Ответы на вопросы
Существует три способа оплаты:
  1. В Fixcom через расчетный счет как юр. лицо, банковской картой, переводом денег, Kaspi Red и даже Kaspi Кредит. Мы предоставляем все необходимые закрывающие документы.
  2. Можно оплатить напрямую в сервисе МойСклад
  3. Можно оплатить через партнеров МойСклад