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

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

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

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

Попробуйте новую функцию FastXML

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

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

Важно

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

Подключение

Токен

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

Заказы

Организация

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

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

Резервирование товаров

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

Статусы

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

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

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

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

Документы

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

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

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

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

Рекомендуем включить все опции

Важно!

Когда у вас включено автоматическое удаление отгрузки при отмене заказа, то при отмене заказа клиентом до Postomat, товар сразу возвращается в наличие, даже если он еще в пути на склад. API Kaspi не показывает, где находится отмененный товар: на складе или в пути.
Иногда клиент возвращает товар через Каспи доставку, но до того как товар поступит продавцу, Каспи уже переводит его в статус "Архив - Возврат".

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

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

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

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

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

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

Важно

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

Товары

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

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

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

Важно

Учетная запись должна быть подключена только к 1-му 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, не покидая МойСклад. Просто разверните виджет и нажмите на иконку, как показано на изображении, чтобы открыть нужный заказ в новой вкладке.