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

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

Инструкции:
Название компании и ID партнера
Без заполнения полей Название компании и ID партнера интеграция работать не будет. Всю необходимую информацию найдете в личном кабинете партнера Kaspi. После заполнения всех полей и сохранения изменений, следует приступить к следующему шагу настройки.
Заказы
Синхронизация заказов
Синхронизация заказов двухсторонняя. Изменение некоторых статусов в одной из систем, отобразиться и в другой. Включайте синхронизацию в последнюю очередь, когда укажите все остальные поля и сопоставите статусы заказов. МойСклад будет заходить в Kaspi каждые 15 минут, чтобы получить актуальную информацию по заказам.

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

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

Инструкция
Как создать канал продаж
Сопоставление статусов

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

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

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

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

Данную функцию просили магазины с оффлайн точками продаж. Указывая неснижаемый остаток продавцы отделяют витринный товар от складского. Витринный товар запрещено продавать в Kaspi.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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