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

Все про интеграцию МойСклад и 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, с правой статусы заказов в МойСклад. Вы можете создавать статусы какие хотите, здесь нет жестких правил и требований.

Изменить можно следующие статусы:
  1. Подтверждение заказа
  2. Выдача товара покупателю
  3. Отмена с причиной отказа
  4. Товар прибыл в региональную точку продаж
  5. Товар прибыл в магазин по ранее отмененному заказу до магазина
  6. Заказ скомплектован
  7. Частичная отмена заказа (СКОРО)
Важно! Начать Возврат можно только в кабинете партнера 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, и их значения SKU (код товара) совпадают, то создавать Шаблоны не нужно. Вам нужна функция Экспорт цен и остатков.

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

Изображения товара из МойСклад также выгружаются и в Kaspi. Вам не нужно свои изображения отдельно загружать в Kaspi.

Все обязательные поля должны быть заполнены, без них товар не будет создан. Необязательные поля носят информативный характер.
Товары - Экспорт товаров
Функция нужна только для выгрузки нового товара из МойСклад в Kaspi.
Если товар есть и в МойСклад и в Kaspi, и их значения SKU (код товара) совпадают, то выгружать ничего не нужно. Сразу переходите к функции Товары - Экспорт цен и остатков

Данный раздел работает в паре с функцией Шаблоны. Сначала вы настраиваете Шаблоны по категориям товаров, а после в разделе Товары - Экспорт товаров запускаете выгрузку и товар выгружается по шаблонам.
Кнопка запускает выгрузку товаров в Kaspi Магазин

Нажимайте на нее после настройки шаблонов и когда требуется выгрузить в Kaspi новый товар или обновить информацию в уже опубликованных позициях.

Важно!
После успешной выгрузки, начнется обработка товаров в Kaspi. Она занимает до 10 рабочих дней.

Изображение товара в сервисе МойСклад выгружаются и в Kaspi Магазин. Заранее позаботьтесь о качестве изображений. Более подробно с правилами можете ознакомиться на сайте Kaspi.
Счетчик демонстрирующий общее кол-во успешных и проблемных выгрузок.

Специальный счетчик над таблице, отображает общую информацию по выгрузке товара. Если что-то пойдет не по плану, вы сразу об этом узнаете.
Кнопка, которая обновляет информацию о статусе выгрузки товара в таблице.
Иконка-кнопка

Нажатие на иконку вызовет всплывающее окно, которое покажет полную информацию о выгружаемом товаре и его статусе, детальное описание ошибки.

Посмотреть пример
Получи ответ наведя мышкой на знак вопроса
Статусы выгружаемых товаров

Проверка (желтый) - файл находится в очереди на обработку.
Ошибка (красный) - была допущена ошибка при заполнении шаблона.
Обработан (зеленый) - загрузка и проверка прошла успешно.
Дополнительная информация
Все инструкции

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

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