Подключение интеграции МойСклад и Kaspi Магазин

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

Интеграция синхронизирует заказы, остатки и цены, а также выгружать новый товар из сервиса МойСклад в Kaspi Магазин. Автоматизируйте учет правильно!

Попробовать бесплатно

Установка приложения

В сервисе МойСклад зайдите в раздел приложений и найдите поле поиска.
Введите "Fixcom" в поисковую строку.
Когда приложение появится в списке результатов, кликните на него.
После открытия карточки приложения, пролистните её вниз и нажмите кнопку "Установить", чтобы начать 14-дневный бесплатный тестовый период. После окончания тестового периода, вы сможете перейти на любой другой без лишних трат.
Когда приложение успешно установлено, нажмите на кнопку "Перейти в приложение", чтобы начать настройку.

Важно

Приложение не работает на бесплатном тарифе МойСклад. Нужно приобрести базовый тариф или выше.

Подключение

После установки виджета необходимо его активировать, указав API-токен, Название магазина и ID партнера.

Получить токен и ID партнера Kaspi можно в партнерском кабинете Kaspi Магазина. Детальная инструкция по генерации API-токена доступна на сайте Kaspi.kz по этой ссылке. После ввода ключа нажмите кнопку "Сохранить".

Заказы

В параметрах укажите Организацию, Контрагента и Договор комиссии. Если вы хотите, чтобы в Заказах покупателя автоматически подставлялся клиент из Kaspi, включите опцию “Использовать клиента из Kaspi в заказах”.

Тогда в Заказах покупателя контрагентом будет клиент из Kaspi.
В остальных документах будет использоваться обычный (по умолчанию) контрагент, если он выбран.

Расширенные настройки заказов

Расширенные настройки помогают упростить работу:

можно включить автоматические действия (резерв, комплектацию или подтверждение заказов)
можно добавить больше данных в Заказ покупателя (например, детали из Kaspi).
можно заполнять системные поля Заказа покупателя (например проект или канал продаж)

Хотите понять, что делает каждая настройка — жми на ссылку и смотри подробнее.

Статусы

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

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

Важная информация про работу статусов

Иногда Kaspi передаем нам информацию, что заказ доставлен, хотя на самом деле он ждёт решения по возврату. Статус изменится при одобрении возврата.

Документы

Включите все опции интеграции. Это автоматически учтёт всё: и товар, и деньги. Документы будут создаваться сами, и вы сразу получите статистику и нужные показатели.

Что делает интеграция:

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

Важно знать:

Если включена автоматическая отмена отгрузки, то при отмене заказа товар сразу вернётся в остатки — даже если он ещё едет обратно. Kaspi не показывает, где именно товар: он может быть уже в пути, а может — ещё нет.
Иногда Kaspi переводит возвращённый товар в статус “Архив - Возврат” до того, как вы его получите.
Проверьте статусы! Они должны точно совпадать с теми, что указаны в разделе “Статусы”, иначе документы создаваться не будут

Обязательные доп поля

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

Обязательные дополнительные поля заполняются только при создании заказа покупателя. Если в уже созданных заказах эти поля пустые, то интеграция не сможет их обработать. В таком случае обязательные поля нужно заполнить вручную.

Включение синхронизации

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

При включении синхронизации в МойСклад загрузятся текущие активные заказы из Kaspi. Загрузка старых заказов пока не доступна.

Важно

Если изменить статус заказа на нестандартный, который не распознаётся нашей интеграцией. Такие заказы не обрабатываются системой. Необходимо вернуть заказ в поддерживаемый статус — после этого интеграция продолжит его синхронизацию.
Обновление информации обычно занимает 5–10 минут, но иногда может потребоваться больше времени — это зависит от количества заказов.
Если новый заказ сразу переходит в статус "Выдан" и не успевает попасть в МойСклад — он туда, к сожалению, не добавляется.

Товары

Перенос товаров в МойСклад из Kaspi Магазина

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

Инструкция по созданию учетной записи в кабинете партнера Kaspi

Важно

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

Настройка остатков

Бренд

Создайте дополнительное поле в карточке товара. Назовите его Бренд. Тип создаваемого поля может быть Строка или Справочник. Данное поле является обязательным только при выгрузке товара, цен и остатков через XML.

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

Количество товара в XML (stockCount)

При включении данной функции в XML будет передаваться остаток по товару в количественном виде (параметр stockCount).

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

Важно!

Передача количества товара в XML (параметр stockCount) не работает, если Тип остатка выбран как "Всегда доступно".

P.S. выгрузка остатков в количественном виде пока доступна не всем продавцам — Kaspi внедряет её поэтапно.

Цены

Тип цены

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

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

Цены по городам

Наша функция позволяет настроить уникальные цены для каждого города. Процесс настройки прост:

Включите опцию "Цены по Городам".
Добавьте новое дополнительное поле с типом "Флажок" в карточке товара и назовите его "Цены по Городам".
Свяжите вновь созданное поле с разделом "Поле признак".
Для каждого склада выберите соответствующий город (1) и укажите, какой тип цены из карточки товара следует использовать для данного города (2).
Если цена у товара различается в зависимости от города, установите флажок в поле "Цены по Городам".
Чтобы обновить информацию, нажмите кнопку "Выгрузить" в разделе "Обновление файла XML".

Как это работает: Наше приложение действует следующим образом. Если флажок в поле "Цены по Городам" активирован, цена товара будет автоматически разбита по городам. В противном случае будет использована цена по умолчанию, заданная в разделе "Тип цены".

Склады

Настройки складов

Данный пункт позволяет связать склады/магазины Kaspi Магазина со складами в сервисе МойСклад (МС).

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

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

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

XML

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

Важно

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

FastXML (NEW)

Ускоренная синхронизация остатков и цен в Kaspi Магазине — обновление каждые 15 минут, в 4 раза быстрее!

Перед подключением функции, сначала убедитесь что вы уже выгружаете текущие данные через XML в кабинете продавца. Если вы не испльзуете выгрузку XML, то и FastXML использовать не нужно.

Чтобы начать работу, войдите в приложение с учетной записью продавца Kaspi.

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

Инструкция по созданию учетной записи в кабинете партнера Kaspi

Важно:

Тестовый период: 14 дней
Стоимость: 10 000 тг в месяц за один кабинет Kaspi.

Вопрос - Ответ
Вопрос: Прошло больше 15 минут, а в логах Kaspi нет новых загрузок.
Ответ: Загрузка происходит только при изменении остатков или цен в МойСклад. Если изменений нет, загрузка не выполняется.

Загрузка товаров в Kaspi

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

⚠️ Важно

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

Предзаказ

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

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

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

Включать предзаказ при нулевом остатке

Предзаказ включается только при отсутствии товара/комплекта на всех складах.

Подробную информацию о работе предзаказа вы можете получить на сайте Kaspi.

Дополнительные артикулы

Данная функция необходима, если продаете один товар под несколькими карточками в Kaspi Магазине. Она позволяет присвоить одному товару несколько артикулов, для этого:

Создайте в карточке товара доп. поле по типу текст.
Через запятую пропишите все артикулы с Kaspi
Выберите созданное поле в настройках нашего приложения.

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

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

Учёт неснижаемого остатка

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

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

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

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

Разное

Заполнить форму

Репрайсер

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

Заполнить форму

Изучить инструкцию

Управление заказом Kaspi из МойСклад

Что умеют кнопки

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

Объединение и скачивание накладных Kaspi

Вы можете скачать накладные как из карточки отдельного заказа Kaspi, так и из общего списка заказов покупателей. Для этого выберите нужные заказы вручную или примените фильтры. В одну выгрузку можно объединить до 100 заказов. Все накладные автоматически объединятся в один PDF-файл. Сформированные накладные сохраняются до момента создания новой накладной.

Тарифы

Синхронизация заказов

Создание карточек товаров в Kaspi из МойСклад

Перенос товаров из Kaspi в МойСклад

Выгрузка остатков и цен в XML

до 2500 товаров

до 5000 товаров

Репрайсер

не включен

FastXML

не включен

15000 тг / мес

20000 тг / мес

25000 тг / мес

Как оплатить приложение

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

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

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

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

Ответы на вопросы

Можно. Свяжитесь с нами.