+7 (700) 357-30-73
Руководство по настройке интеграции
МойСклад и Kaspi
Интеграция синхронизирует заказы, остатки и цены, а также выгружать новый товар из сервиса МойСклад в Kaspi Магазин.
Попробовать бесплатно
Не используете МойСклад?
Попробуйте лучшую в СНГ систему для торгового учета бесплатно.
Зарегистрироваться
Установка приложения
  1. В сервисе МойСклад зайдите в раздел приложений и найдите поле поиска.
  2. Введите "Fixcom" в поисковую строку.
  3. Когда приложение появится в списке результатов, кликните на него.
  4. После открытия карточки приложения, пролистните её вниз и нажмите кнопку "Установить" в тарифе Безлимитище (5000 р.), чтобы начать 14-дневный бесплатный тестовый период. После окончания тестового периода, вы сможете перейти на любой другой без лишних трат.
  5. Когда приложение успешно установлено, нажмите на кнопку "Перейти в приложение", чтобы начать настройку.
Подключение
Токен
После установки виджета необходимо его активировать, указав API-токен. Получить токен можно в партнерском кабинете Kaspi Магазина. Детальная инструкция по генерации API-токена доступна на сайте Kaspi.kz по этой ссылке. После ввода ключа нажмите кнопку "Сохранить".
Заказы
Организация
В выпадающем списке вам необходимо выбрать организацию из вашего кабинета МойСклад на который будут создаваться заказы. (не из Kaspi, а именно организацию из МойСклад)
Создание контрагента
Включив функцию, информация о клиентах (ФИО и телефон) будет копироваться из Kaspi в базу контрагентов в МойСклад. Если же настройка выключена, заказы будут привязаны к выбранному вами контрагенту.

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

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

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

Также имеются две полезные функции: автоматическое удаление документов при отмене заказа и автоматическое создание исходящего платежа при возврате заказа.

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

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

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

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

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

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

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

Скоро данную настройку уберем и в качестве остатка всегда будет передаваться остаток на складах за вычетом резерва.
Предзаказ
Эта функция передает товар в 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 проверяет остатки и цены товаров, модификаций и комплектов.
  • Более детальная информация о синхронизации по XML доступна на сайте Kaspi.
Дополнительные функции по заказам

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

Функция автоматически резервирует товар при поступлении нового заказа из 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. В накладных расходах (Рекомендуем): Комиссия показывается и в заказе, и в документе "Отгрузка" в разделе "Накладные расходы", если документ создан нашей интеграцией.
  3. В отгрузке и вх. платеже: Комиссия видна в заказе, отгрузке, и входящем платеже. Созданные документы учитывают комиссию. Комиссия за доставку распределяется пропорционально стоимости каждого товара в общей сумме заказа.
Учитывать комиссию по товарам
Функция интеграции между Kaspi Магазином и МойСклад автоматически переносит сумму комиссии продавцов в заказе покупателя, записывая её в специальное поле "число дробное". Существует два способа настройки комиссии:
  1. Тарифы по категориям: Автоматическое назначение комиссии в зависимости от категории товара, включая повышенную комиссию Kaspi в период акций.
  2. Указать вручную: Возможность задать общий процент комиссии для всех заказов.
Функция предлагает три варианта учета комиссии в документах:
  1. Не учитывать: Комиссия отображается только в заказе.
  2. В накладных расходах (Рекомендуем): Комиссия указывается в заказе и в документе "Отгрузка" в разделе "Накладные расходы" (если документ создан через нашу интеграцию).
  3. В отгрузке и вх. платеже: Комиссия фигурирует в заказе, отгрузке и входящем платеже, при этом создаваемые документы учитывают размер комиссии.
Причина и комментарий при отмене заказа

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


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

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

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


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


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

Планируемая дата доставки

Данная функция предоставляет возможность передачи информации о дате доставки товара из 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. Можно оплатить через партнеров МойСклад