Руководство по настройке интеграции
МойСклад и Kaspi
Потратьте всего 10 минут, чтобы подключить Kaspi Магазин к учёту в МойСклад и заказы, остатки, цены и номенклатура будут синхронизироваться автоматически. Инструкция для продавцов Kaspi без опытa в МойСклад.
  1. Откройте МойСклад → Приложения, в поиске введите «Fixcom».
  2. Выберите приложение и нажмите Установить — действует 14-дневный тест.
  3. После установки кликните Перейти в приложение для первичных настроек.
⚠️ Важно: на бесплатном тарифе МойСклад приложение не работает — нужен «Базовый» или выше.
Установка приложения
  1. Откройте МойСклад → Приложения, в поиске введите «Fixcom».
  2. Выберите приложение и нажмите Установить — действует 14-дневный тест.
  3. После установки кликните Перейти в приложение для первичных настроек.
⚠️ Важно: на бесплатном тарифе МойСклад приложение не работает — нужен «Базовый» или выше.
Авторизация Kaspi
  1. В кабинете продавца Kaspi сгенерируйте API-токен: Настройки → Токен API (инструкция Kaspi)
  2. Скопируйте также ID партнёра и Название магазина.
  3. В приложении Fixcom вставьте токен, ID и название, нажмите Сохранить.
Настройка остатков
Создайте дополнительные поля
Создайте дополнительные поля в разделе товары.
  1. Создайте доп. поле «Бренд» с типом строка. Требуется при XML-выгрузке, иначе подставится «Fixcom». (не обязательно)
  2. Создайте доп. поле "Поле выгрузки товара" с типом флажок, которым помечаете, что выгружать. Позволяет фильтровать ассортимент при XML-выгрузке.
Типы выгрузки
Настройка позволяет выбрать, какие товары вы хотите выгружать в XML с помощью функции "Поле выгрузки товара". Вы можете выбрать:
  • Все товары, кроме снятых флажком — по умолчанию.
  • Только отмеченные — если нужно выборочно.
Тип артикула
Зачем это нужно?
Когда Fixcom получает заказ из Kaspi, ему нужно «узнать» каждый товар в каталоге МойСклад. Для этого вы указываете, по какому полю искать совпадение.

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


Тип остатка
  • Выбирайте тип остатка «Остаток − Резерв».
  • Если включена опция Показывать количество товара в XML, точное количество передаётся в XML; она не работает при типе остатка «Всегда доступно».
Цены
Тип цены
  • В разделе Тип цены укажите, из поля в карточке товара в МойСклад брать или передавать стоимость товара.
  • При необходимости заведите новые типы цен: Настройки → Цены в МойСклад.
Цены по городам
Чтобы задать уникальные цены по городам, выполните три шага:

1. Подготовка поля
  • Включите опцию «Цены по Городам».
  • В карточке товара создайте дополнительное поле типа «Флажок», назовите его «Цены по Городам» и свяжите с разделом «Поле признак».
2. Настройка для складов
Для каждого склада укажите:
  1. Соответствующий город.
  2. Тип цены из карточки товара, который будет применяться для этого города.
3. Присвоение городских цен и выгрузка
  • Если цена товара зависит от города, установите флажок «Цены по Городам» в его карточке.
  • Чтобы обновить данные в XML-файле, нажмите «Выгрузить» в разделе «Обновление файла XML».

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

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

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


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

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

Важно
  • Обязательно ознакомьтесь с информация о синхронизации по XML на сайте Kaspi.
  • Вы можете запускать и приостанавливать обновление остатков и цены в XML.
  • При первом старте надо нажать кнопку "Выгрузить" для создания XML-файла.
  • Обновление остатков и цен в файле XML зависит от кол-ва товаров и обычно выполняется каждые 20 минут.
  • Приложение Fixcom проверяет остатки и цены товаров, модификаций и комплектов.
  • Если товар имеет серию, то его остаток не выгружается в XML.
Перенос товаров в МойСклад из Kaspi Магазина
  1. Авторизируйтесь под учётной записью Kaspi внутри модуля импорта.
  2. Настройте поля:
  • Цена — выберите тип цены, куда передавать цену.
  • Артикул — рекомендуем «Код товара».
  • Изображения — не переносить / первое / все.
3. Нажмите Запуск переноса. Прогресс и ошибки смотрите в «Журнале событий».

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

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

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

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

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

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


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

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

Теперь товар в заказах синхронизируется не только по полю Код, но и Доп. артикул. Информация о товаре также добавляется в 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-файл. Сформированные накладные сохраняются до момента создания новой накладной.
Разное
Как оплатить приложение

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


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

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

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

FAQ и устранение неполадок
Можно. Свяжитесь с нами.
Контакты нашей подержки
Время работы
Пн-Пт с 9:00 до 18:00, Сб-Вс выходной по времени Алматы (+5)

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

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