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

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

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

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

Откройте МойСклад → Приложения, в поиске введите «Fixcom».
Выберите приложение и нажмите Установить — действует 14-дневный тест.
После установки кликните Перейти в приложение для первичных настроек.

⚠️ Важно: на бесплатном тарифе МойСклад приложение не работает — нужен «Базовый» или выше.

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

Откройте МойСклад → Приложения, в поиске введите «Fixcom».
Выберите приложение и нажмите Установить — действует 14-дневный тест.
После установки кликните Перейти в приложение для первичных настроек.

⚠️ Важно: на бесплатном тарифе МойСклад приложение не работает — нужен «Базовый» или выше.

Авторизация Kaspi

В кабинете продавца Kaspi сгенерируйте API-токен: Настройки → Токен API (инструкция Kaspi)
Скопируйте также ID партнёра и Название магазина.
В приложении Fixcom вставьте токен, ID и название, нажмите Сохранить.

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

Создайте дополнительные поля

Создайте дополнительные поля в разделе товары.

Создайте доп. поле «Бренд» с типом строка. Требуется при XML-выгрузке, иначе подставится «Fixcom». (не обязательно)
Создайте доп. поле "Поле выгрузки товара" с типом флажок, которым помечаете, что выгружать. Позволяет фильтровать ассортимент при XML-выгрузке.

Типы выгрузки

Настройка позволяет выбрать, какие товары вы хотите выгружать в XML с помощью функции "Поле выгрузки товара". Вы можете выбрать:

Все товары, кроме снятых флажком — по умолчанию.
Только отмеченные — если нужно выборочно.

Тип артикула

Зачем это нужно?
Когда Fixcom получает заказ из Kaspi, ему нужно «узнать» каждый товар в каталоге МойСклад. Для этого вы указываете, по какому полю искать совпадение.

⚠️ Важно: если у вас задействованы модификации (размер, цвет и т. д.), выбирайте Код товара — иначе заказы с вариациями не свяжутся, и в МойСклад появятся «нераспознанные позиции».

Тип остатка

Выбирайте тип остатка «Остаток − Резерв».
Если включена опция Показывать количество товара в XML, точное количество передаётся в XML; она не работает при типе остатка «Всегда доступно».

Цены

Тип цены

В разделе Тип цены укажите, из поля в карточке товара в МойСклад брать или передавать стоимость товара.
При необходимости заведите новые типы цен: Настройки → Цены в МойСклад.

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

Чтобы задать уникальные цены по городам, выполните три шага:

1. Подготовка поля

Включите опцию «Цены по Городам».
В карточке товара создайте дополнительное поле типа «Флажок», назовите его «Цены по Городам» и свяжите с разделом «Поле признак».

2. Настройка для складов
Для каждого склада укажите:

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

3. Присвоение городских цен и выгрузка

Если цена товара зависит от города, установите флажок «Цены по Городам» в его карточке.
Чтобы обновить данные в XML-файле, нажмите «Выгрузить» в разделе «Обновление файла XML».

Принцип работы:

Флажок включён. При выгрузке приложение автоматически подставит цену, настроенную для конкретного города.
Флажок выключен. Будет использоваться цена по умолчанию из раздела «Тип цены».

Склады

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

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

Дополнительные варианты:
Несколько МС-складов → один Kaspi-склад
Выберите несколько складов МойСклад для одного ID склада Kaspi — их остатки будут автоматически суммироваться. В Заказе покупателя будет проставляться первый выбранный склад.

Один МС-склад → несколько Kaspi-складов
Привяжите один склад МойСклад к нескольким ID складов Kaspi — удобно для организации предзаказов.

XML

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

Если товара нет в наличии на складе, он будет перемещен в архив, а когда товар будет вновь в наличии, он автоматически публикуется на Kaspi.

Важно

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

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

Авторизируйтесь под учётной записью Kaspi внутри модуля импорта.
Настройте поля:

Цена — выберите тип цены, куда передавать цену.
Артикул — рекомендуем «Код товара».
Изображения — не переносить / первое / все.

3. Нажмите Запуск переноса. Прогресс и ошибки смотрите в «Журнале событий».

💡 Совет: архивные товары в МойСклад тоже учитываются при импорте; если коды конфликтуют, удалите архивный дубликат.

Дополнительные функции

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

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

⚠️ Важно

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

Предзаказ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Заказы

Сначала создайте Контрагента и Договор комиссии. Затем в параметрах выберите организацию, контрагента и договор комиссии.

Включите опцию «Использовать клиента из Kaspi в заказах» — и все Заказы покупателя будут автоматически оформляться на клиента из Kaspi. В остальных документах по-прежнему будет применяться выбранный по умолчанию контрагент.

Статусы

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

Документы

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

Что делает каждая опция:

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

Важно знать:

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

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

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

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

Запуск синхронизации

Включите интеграцию — и заказы из Kaspi автоматически попадут в «Заказы покупателей» МойСклад. При первом запуске подтянутся только активные заказы; архивные при этом не загружаются.

⚠️ Важно:

Нестандартные статусы. Если вы вручную назначите заказу статус, не выбранный в настройках интеграции, он перестанет обрабатываться, пока не перейдет в архивный статус (выдан, отменен, возвращен). Чтобы возобновить синхронизацию, верните ему один из поддерживаемых статусов.
Задержки обновлений. Синхронизация обычно занимает 5–10 минут, но при большом количестве заказов — особенно с доставкой Kaspi — интервал может быть больше.
«Выдан» до импорта. Заказы, которые в Kaspi сразу переходят в статус «Выдан» до момента обработки, не попадут в МойСклад.
Ложный «Доставлен». Иногда Kaspi присылает статус «Выдан» для заказов, находящихся в процессе возврата. В МойСклад правильный статус придёт после одобрения возврата.
Повторное включение. Если вы временно отключите интеграцию и потом снова её запустите, система распознает ранее загруженные заказы и обновит их статусы.
Статус "Упаковка" для предзаказов не работает. Это ограничение в API Kaspi.

Дополнительные функции

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

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

Посмотрите подробнее о каждой функции

Дополнительные возможности

Репрайсер

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

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

FastXML

Ускоренная синхронизация остатков и цен.

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

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

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

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

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

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

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

Разное

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

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

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

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

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

FAQ и устранение неполадок

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

Контакты нашей подержки

Время работы
Пн-Пт с 9:00 до 18:00, Сб-Вс выходной по времени Алматы (+5)

Сотовый/WhatsApp: +7 (708) 821 02 92 (Казахстан)
Telegram: @fixcom_support_bot
Email: hd@fixcom.kz

Наши контакты также есть в разделе "Помощь" в нашем приложении.