+7 (700) 357-30-73
Руководство по настройке интеграции
МойСклад и Kaspi
Интеграция синхронизирует заказы, остатки и цены, а также выгружать новый товар из сервиса МойСклад в Kaspi Магазин.
Попробовать бесплатно
Не используете МойСклад?
Попробуйте лучшую в СНГ систему для торгового учета бесплатно.
Зарегистрироваться
Базовая настройка
Токен
После установки виджета необходимо его активировать, указав API-токен. Получить токен можно в партнерском кабинете Kaspi Магазина. Детальная инструкция по генерации API-токена доступна на сайте Kaspi.kz по этой ссылке. После ввода ключа нажмите кнопку "Сохранить".

Название компании и ID партнера
Интеграция не будет работать без заполнения полей "Название компании" и "ID партнера". Всю необходимую информацию можно найти в личном кабинете партнера Kaspi. После того как все поля заполнены и изменения сохранены, переходите к следующему этапу настройки.
Заказы
Загрузить архивные заказы за последние
С помощью нашего приложения вы можете перенести архивные заказы за последние 10 дней из Kaspi в МойСклад. Вы можете изменить этот срок в настройках приложения. Однако стоит учитывать, что из-за ограничений со стороны Kaspi, скачать более старые заказы не получится. Рекомендую указать 10 дней
Организация
В выпадающем списке вам необходимо выбрать организацию из вашего кабинета МойСклад на который будут создаваться заказы. (не из Kaspi, а именно организацию из МойСклад)
Создание контрагента
Включив функцию, информация о клиентах (ФИО и телефон) будет копироваться из Kaspi в базу контрагентов в МойСклад. Если же настройка выключена, заказы будут привязаны к выбранному вами контрагенту. Рекомендуем включить.
Документы
✋ если вы не опытный пользователи МойСклад, то настроить создание документов лучше немного позже, когда вы разберетесь в функционале сервиса. Данный этап можно пропустить при базовой настройке.

Приложение способно создавать такие документы, как входящий платеж, отгрузка, возврат и исходящий платеж. Чтобы настроить автоматическое создание документов при определенном статусе заказа, выберите нужный статус из выпадающего списка.

Обратите внимание на то, что статусы должны совпадать с теми, которые указаны в разделе "Статусы" (1) ниже, иначе документы не будут создаваться.

Для документа отгрузки возможно выбрать несколько статусов. При этом, если документ уже был создан, он не будет создаваться повторно, что поможет избежать дублирования отгрузок.

Также имеются две полезные функции: автоматическое удаление документов при отмене заказа и автоматическое создание исходящего платежа при возврате заказа.
Статусы
Для успешной синхронизации заказов необходимо провести сопоставление статусов заказов в МойСклад и Kaspi Магазине. Этот шаг является обязательным. Перед настройкой функции необходимо создать статусы заказов в МойСклад как в Kaspi.

Не оставляйте этапы без выбора статуса. Например, даже если вы не используете тип доставки "самовывоз", выбрать статус при этому нужно.

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

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

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

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

Рекомендуется использовать код товара, так как он уникален и существует у всех модификаций товаров.

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

Кроме того, поле артикул может иметь одинаковые значения в нескольких товарах, в отличие от поля "Код товара".
Тип остатка
При генерации прайс-листа (XML) можно выбрать, какой тип остатков использовать. Доступны три варианта:
  1. "Доступно + Ожидание" - учитываются доступные и ожидаемые товары без учета резерва;
  2. "Остаток - Резерв" - учитывается остаток с учетом резерва;
  3. "Остаток" - учитывается только остаток без учета резерва.
Предзаказ
Эта функция передает товар в Kaspi, который продается по предзаказу. Для ее активации необходимо создать дополнительное поле "Предзаказ" в карточке товара, используя тип данных "целое число". Если у вас разное количество дней предзаказа для разных городов, то необходимо создать дополнительное поле для каждого города. После включения функции, в списке складов появится колонка "Поле предзаказа" (изображение 3). Необходимо выбрать созданное вами дополнительное поле из выпадающего списка. Есть три сценария работы предзаказ:

Включать предзаказ при остатке
Если есть положительный остаток по товару или комплекту, то включается предзаказ.

Включать предзаказ без учета остатка
Принцип работы сценария: сначала учитываем предзаказ, потом остаток.
Объясняем. Предзаказ активен для товаров/комплектов, где заполнено доп. поле предзаказа. Если поле предзаказа не заполнено/пустое, то в XML передается информация об реальном остатке товара на сладах.

Включать предзаказ при нулевом остатке
Принцип работы сценария: Сначала остаток, потом предзаказ.
Предзаказ включается только при отсутствии товара/комплекта на всех складах. При реализации функции мы руководствовались следующим правилом "быстрее доставить товар из другого города, чем делать предзаказ для Алматы, находясь в Алматы".
Учёт неснижаемого остатка
Если количество товара на складе достигнет неснижаемого остатка, то товар автоматически снимется с продажи в Kaspi. Можно указать неснижаемый остаток для всех товаров на определенном складе, так и для каждого товара.

Брать из карточки товара
Функция "Неснижаемый остаток" в данный момент доступна только для опции "В сумме на всех складах". Пункты "Одинаковый на всех складах" или "Задать для каждого" не поддерживают данную функцию. (Изображение 2)

Важно про модификации

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

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

Теперь товар в заказах синхронизируется не только по полю Код, но и Доп. артикул. Информация о товаре также добавляется в XML (смотрите последнее изображения).


В данном функционале есть недостаток. Если вы используете наш XML, то нельзя назначить разную стоимость для товаров с доп. артикулом. Но это легко решить с помощью комплектов! Для вас мы записали инструкцию по ссылке.

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

Подробнее об этом можно узнать, перейдя по ссылке "Как редактировать Типы Цен в МойСклад".
Цены по городам
Наша функция позволяет настроить уникальные цены для каждого города. Процесс настройки прост:

  1. Включите опцию "Цены по Городам".
  2. Добавьте новое дополнительное поле с типом "Флажок" в карточке товара и назовите его "Цены по Городам".
  3. Свяжите вновь созданное поле с разделом "Поле признак".
  4. Для каждого склада выберите соответствующий город (1) и укажите, какой тип цены из карточки товара следует использовать для данного города (2).
  5. Если цена у товара различается в зависимости от города, установите флажок в поле "Цены по Городам".
  6. Чтобы обновить информацию, нажмите кнопку "Выгрузить" в разделе "Обновление файла XML".
Как это работает: Наше приложение действует следующим образом. Если флажок в поле "Цены по Городам" активирован, цена товара будет автоматически разбита по городам. В противном случае будет использована цена по умолчанию, заданная в разделе "Тип цены".
Настройки складов
Данный пункт позволяет связать склады/магазины Kaspi Магазина со складами в сервисе МойСклад (МС).

Вы можете выбрать несколько складов МС для одного ID склада Kaspi. Тогда все остатки по складам МС буду суммироваться.

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

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

Примечания
  • Вы можете запускать и приостанавливать обновление остатков и цены в XML.
  • При первом старте надо нажать кнопку "Выгрузить" для создания XML-файла.
  • Обновление остатков и цен в файле XML зависит от кол-ва товаров и обычно выполняется каждые 20 минут.
  • Приложение Fixcom проверяет остатки и цены товаров, модификаций и даже комплектов.
Дополнительные функции по заказам

Дополнительные функции по заказам
Для настройки дополнительных функций по заказам зайдите в раздел "Заказы" и нажмите кнопку "Настройка". В выпадающем меню выберите нужные вам функции, которые можно включить или выключить. Обратите внимание, что настройка дополнительных функций производится в разделе "Синхронизация заказов", а не в разделе "Настройка".
Резервирование товаров

Функция автоматически резервирует товар при поступлении нового заказа из Kaspi.

Авто комплектация заказов

Функция автоматически комплектует заказ. Есть три сценария работы:


1. По количеству товаров в заказе
Это означает, что мы смотрим, сколько различных наименований товаров содержится в одном заказе. Например, если в заказе есть 5 разных товаров (например, яблоки, груши, бананы, апельсины и персики), то количество наименований товаров в этом заказе равно 5.

2. По сумме количества товара в заказе
Это означает, что мы считаем общее количество всех товаров в одном заказе. Например, если в заказе есть 5 яблок, 3 груши и 2 банана, то сумма количества товара в этом заказе равна 10 (5 + 3 + 2).

3. Вручную
Это означает, что мы не зависимо от кол-ва товаров и наименований отправляем в комплектацию указанную вами цифру.


Авто подтверждение заказов

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

Счет организации

Функция позволяет выбрать счет организации, на которую будут создаваться заказы.

Валюта

Функция позволяет выбрать валюту документов в МойСклад при копировании заказов Kaspi.

Канал продаж
Создайте и выберите необходимый канал продаж. Новые заказы из Kaspi Магазина будут с выбранным вами каналом продаж.

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

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

Рекомендуем включать функцию.
Способ оплаты
Функция передает информацию о способе оплате заказа из Kaspi Магазина в МойСклад. Способ оплаты можно включить в разделе Заказы в настройках приложения. Обязательно создайте доп. поле в заказах в сервисе МойСклад по типу строка и выберите его в настройках приложения Fixcom.
Экспресс доставка
Экспресс заказы из Kaspi Магазина можно легко выделить из общей массы заказов в МойСклад. Создайте поле в заказах покупателей по типу Флажок и выберите его в настройках нашего приложения в соответствующем поле.

Все экспресс заказы буду создаваться в МойСклад с галочкой.

Накладная Kaspi

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


В заказе покупателя в МойСклад создайте доп. поле по типу "ссылка".

Стоимость доставки

Функция позволяет копировать общую сумму доставки по заказу из Kaspi в МойСклад.


Автоматически копировать информацию можно в дополнительное поле по типу "число дробное" в заказе покупателя.


Более подробно о стоимости доставки можно ознакомиться на сайте Kaspi.kz по ссылке.

Комиссия за доставку

Данная функция предоставляет возможность копировать сумму доставки для продавца из Kaspi в МойСклад.


Автоматически копировать информацию можно в дополнительное поле по типу "число дробное" в заказе покупателя.


Учитывать в накладных расходах

Комиссия за доставку будет учитываться в накладных расходах в документе Отгрузка или суммироваться с комиссией по товару.

Учитывать комиссию по товарам
В пункте "Учитываться комиссию по товарам" можно выбрать доп. поле из карточки Заказа, в котором будет отображена комиссия по товарам.

Тип комиссии. Есть два варианта настройки комиссии по товару:
  1. Указать общий процент комиссии на все заказы. Комиссия будет рассчитываться на основе ваших параметров, а не данных заказа из Каспия.
  2. Комиссия назначается автоматически в зависимости от категории товара, но возможно не для всех категорий будет применяться процент комиссии. В таком случае, просим сообщать нам о заказах, в которых нет комиссии, и мы внесем изменения в функционал приложения.
Важно. Интеграция Fixcom пока не умеет автоматически учитывать в комиссии акции Kaspi и тип оплаты Kaspi (мы над этим еще работаем). Поэтому рекомендуется использовать первый вариант и указывать комиссию вручную для всех заказов (обычно это 12%).

Учитывать в накладных расходах.
Комиссия по товару будет учитываться в накладных расходах в документе Отгрузка или суммироваться с комиссией за доставку.
Причина и комментарий при отмене заказа

Это две функции позволяют копировать причину и комментарий при отмене заказа из Kaspi в МойСклад.


Автоматически синхронизировать информацию по двум функциям можно в два дополнительных поля по типу "текст" в заказе покупателя.

Планируемая дата передачи заказа курьеру

Данная функция предоставляет возможность копировать информации о планируемой дате передачи заказа курьеру из Kaspi в МойСклад.


Копировать информацию о дате из Kaspi можно в несколько мест. Либо в дополнительное поле по типу дата в заказе покупателя, либо в системное поле МойСклад - "План. дата отгрузки".


Рекомендуем в "План. дата отгрузки".

Дата доставки

Данная функция предоставляет возможность передачи информации о дате доставки товара из Kaspi в МойСклад.


Копировать информацию о дате доставке из Kaspi можно в два места. Либо в дополнительное поле по типу дата в заказе покупателя, либо в системное поле МойСклад - "План. дата отгрузки".


Рекомендуем в доп. поле.

Рэйтинг и отзыв

Данная функция позволяет передавать отзыв и оценку клиента из Kaspi в МойСклад. Для её активации необходимо в разделе Заказ покупателей создать два дополнительных поля: по типу "строка" и "целое число". Далее выберите их в настройках приложения.

Тип доставки
Данная функция предоставляет возможность передачи информации о типе доставки (самовывоз, постомат и д.р.) из Kaspi в МойСклад. Для её использования необходимо в разделе Заказ покупателей создать дополнительное поле по типу "строка" и выбрать в настройка приложения.
Ссылка на заказ
Вы можете легко открыть страницу заказа в Kaspi, не покидая МойСклад. Просто разверните виджет и нажмите на иконку, как показано на изображении, чтобы открыть нужный заказ в новой вкладке.
Загрузка товаров в Kaspi
Модуль Шаблоны автоматизирует загрузку нового товара из МойСклад в Kaspi. Также не требуется ручного сопоставления на уровне Kaspi. Успешно выгруженный товар сразу отправляется на публикацию. Изображения товара из МойСклад также выгружаются в Kaspi.

Важно, чтобы информация о выгружаемом товаре была полная. Если хоть в одной карточке товара будет ошибка или не указано обязательно поле, то товар не выгрузится.
Разное
Массовая печать накладных Kaspi
С помощью этой функции вы можете легко массово скачивать накладные для заказов, находящихся на этапе "Ожидают передачи курьеру".

Нажимая на кнопку "Скачать накладные" вы получаете только новые накладные, которые еще не были скачены. Ранее скаченные накладные будут автоматически перемещены в "Журнал накладных".
Изменение статусов заказа Kaspi из МойСклад
  • Подтверждение заказа (изображение 1)

  • Комплектация заказа

  • Подтверждение прибытия товара на склад/магазин

  • Выдача заказа (изображение 2,3)
Когда вы нажмете на кнопку "выдать заказ", вам нужно будет ввести код, отправленный покупателю по СМС. Когда вы введете код и нажмете на "выдать заказ", ваш заказ будет завершен в Kaspi.

  • Отмена заказа (изображение 4)
При отмене заказа можно выбрать причину отказа и написать комментарий, все как в Kaspi.

  • Возврат
Начать Возврат заказа можно только из кабинета партнера Kaspi. Таковы правила Kaspi.

Примечания
  1. Изменить статус заказ можно только в версии через браузер, в мобильном приложении это сделать пока не возможно.
  2. Иногда нужно обновить страницу заказа после изменения статуса, чтобы увидеть актуальную информацию
Схема работы интеграции
Функции приложения можно разделить на 3 независимых модуля:
  • Синхронизация заказов
  • Выгрузка остатков и цен
  • Загрузка товара
  • Бот понижения цены
Стоимость виджета
Помесячная оплата
15 000 ₸
  • 14 дней тестового периода
Как оплатить приложение

Оплата приложения осуществляется через МойСклад.


  1. Зайдите в карточку приложения
  2. Нажмите на кнопку "оплатить/оплатить сейчас"
  3. Нажмите на кнопку "выбрать способ оплаты"
  4. В открывшимся окне выберите "Robokassa"
  5. Произведите оплату

Приостановка приложения за неуплату

Если вы не оплачиваете приложение, оно приостанавливается на вашем аккаунте до момента оплаты.

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