Установка приложения
- В сервисе МойСклад зайдите в раздел приложений и найдите поле поиска.
- Введите "Fixcom" в поисковую строку.
- Когда приложение появится в списке результатов, кликните на него.
- После открытия карточки приложения, пролистните её вниз и нажмите кнопку "Установить" в тарифе Безлимитище (5000 р.), чтобы начать 14-дневный бесплатный тестовый период. После окончания тестового периода, вы сможете перейти на любой другой без лишних трат.
- Когда приложение успешно установлено, нажмите на кнопку "Перейти в приложение", чтобы начать настройку.
Важно
- Приложение не работает на бесплатном тарифе МойСклад. Нужно приобрести базовый тариф или выше.
Подключение
Токен
После установки виджета необходимо его активировать, указав API-токен. Получить токен можно в партнерском кабинете Kaspi Магазина. Детальная инструкция по генерации API-токена доступна на сайте Kaspi.kz по этой ссылке. После ввода ключа нажмите кнопку "Сохранить".
Название компании и ID партнера
Интеграция не будет работать без заполнения полей "Название компании" и "ID партнера". Всю необходимую информацию можно найти в личном кабинете партнера Kaspi. После того как все поля заполнены и изменения сохранены, переходите к следующему этапу настройки.
Заказы
Организация
В выпадающем списке вам необходимо выбрать организацию из вашего кабинета МойСклад на который будут создаваться заказы. (не из Kaspi, а именно организацию из МойСклад)
Создание контрагента
Включив функцию, информация о клиентах (ФИО и телефон) будет копироваться из Kaspi в базу контрагентов в МойСклад. Если же настройка выключена, заказы будут привязаны к выбранному вами контрагенту.
Расширенные настройки заказов
Резервирование товаров
Функция автоматически резервирует товар при поступлении нового заказа из Kaspi.
Авто комплектация заказов
Функция автоматически комплектует заказ. Есть три сценария работы:
1. По количеству товаров в заказе. Это означает, что мы смотрим, сколько различных наименований товаров содержится в одном заказе. Например, если в заказе есть 5 разных товаров (например, яблоки, груши, бананы, апельсины и персики), то количество наименований товаров в этом заказе равно 5.
2. По сумме количества товара в заказе. Это означает, что мы считаем общее количество всех товаров в одном заказе. Например, если в заказе есть 5 яблок, 3 груши и 2 банана, то сумма количества товара в этом заказе равна 10 (5 + 3 + 2).
3. Вручную. Это означает, что мы не зависимо от кол-ва товаров и наименований отправляем в комплектацию указанную вами цифру.
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.kz по ссылке.
Комиссия за доставку
Функция автоматически переносит сумму доставки для продавцов из Kaspi Магазина в МойСклад. Она копирует эту информацию в заказе покупателя в дополнительное поле типа "число дробное".
Возможны три сценария работы функции "Учитывать в отгрузке и вх. платеже":
Возможны три сценария работы функции "Учитывать в отгрузке и вх. платеже":
- Не учитывать: Комиссия за доставку отображается только в заказе.
- В накладных расходах (Рекомендуем): Комиссия показывается и в заказе, и в документе "Отгрузка" в разделе "Накладные расходы", если документ создан нашей интеграцией.
- В отгрузке и вх. платеже: Комиссия видна в заказе, отгрузке, и входящем платеже. Созданные документы учитывают комиссию. Комиссия за доставку распределяется пропорционально стоимости каждого товара в общей сумме заказа.
Учитывать комиссию по товарам
Функция интеграции между Kaspi Магазином и МойСклад автоматически переносит сумму комиссии продавцов в заказе покупателя, записывая её в специальное поле "число дробное". Существует два способа настройки комиссии:
- Тарифы по категориям: Автоматическое назначение комиссии в зависимости от категории товара, включая повышенную комиссию Kaspi в период акций.
- Указать вручную: Возможность задать общий процент комиссии для всех заказов.
- Не учитывать: Комиссия отображается только в заказе.
- В накладных расходах (Рекомендуем): Комиссия указывается в заказе и в документе "Отгрузка" в разделе "Накладные расходы" (если документ создан через нашу интеграцию).
- В отгрузке и вх. платеже: Комиссия фигурирует в заказе, отгрузке и входящем платеже, при этом создаваемые документы учитывают размер комиссии.
Причина и комментарий при отмене заказа
Это две функции позволяют копировать причину и комментарий при отмене заказа из Kaspi в МойСклад.Автоматически синхронизировать информацию по двум функциям можно в два дополнительных поля по типу "текст" в заказе покупателя.
Планируемая дата передачи заказа курьеру
Данная функция предоставляет возможность копировать информации о планируемой дате передачи заказа курьеру из Kaspi в МойСклад.Копировать информацию о дате из Kaspi можно в несколько мест. Либо в дополнительное поле по типу дата в заказе покупателя, либо в системное поле МойСклад - "План. дата отгрузки".Рекомендуем в "План. дата отгрузки".
Планируемая дата доставки
Данная функция предоставляет возможность передачи информации о дате доставки товара из Kaspi в МойСклад.Копировать информацию о дате доставке из Kaspi можно в два места. Либо в дополнительное поле по типу дата в заказе покупателя, либо в системное поле МойСклад - "План. дата отгрузки".Рекомендуем в доп. поле.
Дата продажи / возврата / отмены заказа
Создайте доп. поле в разделе “Заказ покупателя” по типу Дата. В данное поле будет передаваться дата продажи, возврата или отмены заказа Kaspi.
Рэйтинг и отзыв
Рэйтинг и отзыв не работают. Kaspi отключили данный сервис.
Тип доставки
Данная функция предоставляет возможность передачи информации о типе доставки (самовывоз, постомат и д.р.) из Kaspi в МойСклад. Для её использования необходимо в разделе Заказ покупателей создать дополнительное поле по типу "строка" и выбрать в настройка приложения.
Статусы
Статусы
Для успешной синхронизации заказов необходимо провести сопоставление статусов заказов в МойСклад и Kaspi Магазине. Этот шаг является обязательным. Перед настройкой функции необходимо создать статусы заказов в МойСклад как в Kaspi.
Не оставляйте этапы без выбора статуса. Например, даже если вы не используете тип доставки "самовывоз", выбрать статус при этому нужно.
Важная информация про работу статусов
Не оставляйте этапы без выбора статуса. Например, даже если вы не используете тип доставки "самовывоз", выбрать статус при этому нужно.
Важная информация про работу статусов
- Заказы синхронизируются по статусам каждые 3 минуты
- Независимо от того, был ли изменен статус заказа в МойСклад, он всегда будет возвращаться к тому, который указан в Kaspi.
Документы
Приложение способно создавать такие документы, как входящий платеж, отгрузка, возврат и исходящий платеж. Чтобы настроить автоматическое создание документов при определенном статусе заказа, выберите нужный статус из выпадающего списка.
Обратите внимание на то, что статусы должны совпадать с теми, которые указаны в разделе "Статусы" (1) ниже, иначе документы не будут создаваться.
Для документа отгрузки возможно выбрать несколько статусов. При этом, если документ уже был создан, он не будет создаваться повторно, что поможет избежать дублирования отгрузок.
Также имеются две полезные функции: автоматическое удаление документов при отмене заказа и автоматическое создание исходящего платежа при возврате заказа.
Рекомендуем включить все опции
Важно!
Когда у вас включено автоматическое удаление отгрузки при отмене заказа, при отмене заказа клиентом до Postomat, товар сразу возвращается в наличие, даже если он еще в пути на склад. API Kaspi не показывает, где находится отмененный товар: на складе или в пути.
Обратите внимание на то, что статусы должны совпадать с теми, которые указаны в разделе "Статусы" (1) ниже, иначе документы не будут создаваться.
Для документа отгрузки возможно выбрать несколько статусов. При этом, если документ уже был создан, он не будет создаваться повторно, что поможет избежать дублирования отгрузок.
Также имеются две полезные функции: автоматическое удаление документов при отмене заказа и автоматическое создание исходящего платежа при возврате заказа.
Рекомендуем включить все опции
Важно!
Когда у вас включено автоматическое удаление отгрузки при отмене заказа, при отмене заказа клиентом до Postomat, товар сразу возвращается в наличие, даже если он еще в пути на склад. API Kaspi не показывает, где находится отмененный товар: на складе или в пути.
Обязательные доп поля
Обязательные доп поля
Функция позволяет автоматически заполнять обязательные поля в заказах в системе МойСклад. Поддерживаются все типы полей.
Обратите внимание, что обязательные дополнительные поля могут быть настроены только для заказов. Указание данных для обязательных полей из других объектов, кроме заказов, недоступно.
Обратите внимание, что обязательные дополнительные поля могут быть настроены только для заказов. Указание данных для обязательных полей из других объектов, кроме заказов, недоступно.
Включение синхронизации
Активируйте интеграцию, и заказы из Kaspi будут автоматически импортированы в МойСклад в раздел "Заказы покупателей". Синхронизация заказов по статусам происходит каждые 3 минуты.
Важно
Важно
- Если изменить информацию в заказе (например статус заказа) в МойСклад, заказ всегда будет возвращаться к состоянию, указанному в Kaspi. Однако это правило не применяется к товарам и складу в заказе: если вы измените товар или склад, изменение сохранится. Бывают ситуации, когда продавец договаривается с клиентом о доставке другого товара, не тот что был заказан изначально и именно по этой причине постоянной синхронизации по товарам нет. Если вы измените состав заказа в Kaspi, то это нужно сделать и в МойСклад
Товары
Перенос товаров в МойСклад из Kaspi Магазина
Перенос товаров в МойСклад из Kaspi Магазина
Для переноса товаров из Kaspi Магазина в МойСклад необходимо ввести авторизационные данные учетной записи пользователя в Kaspi. Это требуется, поскольку по API Kaspi не передает номенклатурную базу. Авторизация позволит выполнить парсинг и перенести необходимые данные в МойСклад.
Важно
Важно
- Учетная запись должна быть подключена только к 1-му Kaspi кабинету, иначе товар не перенесется.
Шаг 2. Настройка цены и артикула
Поле для цены
- Создайте цену продажи в карточке товара в МойСклад (инструкция), куда будет передана цена из Kaspi.
- Выберите созданную цену в выпадающем списке в настройке интеграции. В данное поле будет передана цена товара из Kaspi.
- Выберите в какое поле переносить артикул товара из Kaspi Магазина. Мы рекомендуем выбирать поле "Код товара".
- Переноситься именно артикул (продавца) товара, а не код из Kaspi
Шаг 3. Запуск переноса товаров
- Запустите перенос товаров.
- Ошибки при переносе товара вы можете посмотреть в Журнал событий в приложении.
- Работает только перенос товаров. Если вам нужны модификации или комплекты, то их заранее нужно создать вручную в МойСклад.
- Все перенесенные товары будут находится в группе Маркетплейсы -> Kaspi Магазин (Fixcom)
- Перенос товара не работает если есть обязательные поля у товара в МойСклад
Настройка остатков
Бренд
Создайте дополнительное поле в карточке товара. Назовите его Бренд. Тип создаваемого поля может быть Строка или Справочник. Данное поле является обязательным только при выгрузке товара, цен и остатков через XML.
- Если уже есть доп. поле Бренд, то создавать по новой его не нужно.
- Если не создать поле Бренд или оно будет пустым, то будет по умолчанию подставляться бренд Fixcom
Поле выгрузки товара
Создайте дополнительное поле в карточке товара по типу флажок и выберите его в выпадающем списке. Эта функция позволит отметить товары, которые должны быть выгружены на Kaspi.
Тип выгрузки товара
Эта настройка позволяет выбрать, какие товары вы хотите выгружать с помощью функции "Поле выгрузки товара". Вы можете выбрать выгружать все товары, кроме тех, у которых не стоит флажок, или только те товары, у которых флажок есть.
Тип артикула
Выбери поле, которое будет использоваться для поиска товара в МойСклад при получении заказа из Kaspi.
Рекомендуется использовать код товара, так как он уникален и существует у всех модификаций товаров.
Если выбран артикул, то в прайс-лист выгрузятся только основные товары с соответствующим артикулом, без модификаций.
Рекомендуется использовать код товара, так как он уникален и существует у всех модификаций товаров.
Если выбран артикул, то в прайс-лист выгрузятся только основные товары с соответствующим артикулом, без модификаций.
Тип остатка
Всегда выбирайте "Остаток - Резерв"
Цены
Тип цены
Вы можете продавать товар на Kaspi по другой цене, отличной от указанной стандартной в МойСклад, указав в приложении, откуда брать стоимость товара при формировании прайс-листа XML для Kaspi Магазина.
Подробнее об этом можно узнать, перейдя по ссылке "Как редактировать Типы Цен в МойСклад".
Подробнее об этом можно узнать, перейдя по ссылке "Как редактировать Типы Цен в МойСклад".
Цены по городам
Наша функция позволяет настроить уникальные цены для каждого города. Процесс настройки прост:
- Включите опцию "Цены по Городам".
- Добавьте новое дополнительное поле с типом "Флажок" в карточке товара и назовите его "Цены по Городам".
- Свяжите вновь созданное поле с разделом "Поле признак".
- Для каждого склада выберите соответствующий город (1) и укажите, какой тип цены из карточки товара следует использовать для данного города (2).
- Если цена у товара различается в зависимости от города, установите флажок в поле "Цены по Городам".
- Чтобы обновить информацию, нажмите кнопку "Выгрузить" в разделе "Обновление файла XML".
Склады
Настройки складов
Данный пункт позволяет связать склады/магазины Kaspi Магазина со складами в сервисе МойСклад (МС).
Вы можете выбрать несколько складов МС для одного ID склада Kaspi. Тогда все остатки по складам МС буду суммироваться.
Или можно выбрать один склад для нескольких ID складов Kaspi. Полезно использовать например тем, кто использует предзаказ.
При синхронизации, склад в заказах будет указываться в зависимости от настроек данной функции.
Вы можете выбрать несколько складов МС для одного ID склада Kaspi. Тогда все остатки по складам МС буду суммироваться.
Или можно выбрать один склад для нескольких ID складов Kaspi. Полезно использовать например тем, кто использует предзаказ.
При синхронизации, склад в заказах будет указываться в зависимости от настроек данной функции.
XML
С помощью ссылки вы можете обновлять цены и остатки на Kaspi. Если товара нет в наличии на складе, он будет перемещен в архив, а когда товар будет вновь в наличии, он автоматически публикуется на Kaspi. Скопируйте ссылку и вставьте в кабинете Kaspi в раздел "автоматическая загрузка" согласно инструкции по ссылке.
Важно
Важно
- Вы можете запускать и приостанавливать обновление остатков и цены в XML.
- При первом старте надо нажать кнопку "Выгрузить" для создания XML-файла.
- Обновление остатков и цен в файле XML зависит от кол-ва товаров и обычно выполняется каждые 20 минут.
- Приложение Fixcom проверяет остатки и цены товаров, модификаций и комплектов.
- Более детальная информация о синхронизации по XML доступна на сайте Kaspi.
- Если товар имеет серию, то его остаток не выгружается в XML.
Загрузка товаров в Kaspi
Модуль Шаблоны автоматизирует загрузку нового товара из МойСклад в Kaspi. Также не требуется ручного сопоставления на уровне Kaspi. На основании успешно выгруженного товара, создается карточка товара в Kaspi Магазине.
⚠️ Важно
⚠️ Важно
- Если хоть в одном товаре будет ошибка или не указано обязательно поле, то товар не выгрузится.
- Комплекты и модификации не выгружаются
- Описание товар не переноситься
- Наименование товара Kaspi обычно меняет после выгрузки
Предзаказ
Эта функция передает товар в Kaspi, который продается по предзаказу. Для ее активации необходимо создать дополнительное поле "Предзаказ" в карточке товара, используя тип данных "целое число". Если у вас разное количество дней предзаказа для разных городов, то необходимо создать дополнительное поле для каждого города. После включения функции, в списке складов появится колонка "Поле предзаказа". Необходимо выбрать созданное вами дополнительное поле из выпадающего списка. Есть три сценария работы предзаказ:
Включать предзаказ при остатке
Предзаказ работает у товара или комплекта, где есть положительный остаток.
Включать предзаказ без учета остатка
Предзаказ работает всегда.
Важно! Если поле предзаказа не заполнено/пустое, то в XML передается информация об реальном остатке товара на сладах.
Включать предзаказ при нулевом остатке
Включать предзаказ при остатке
Предзаказ работает у товара или комплекта, где есть положительный остаток.
Включать предзаказ без учета остатка
Предзаказ работает всегда.
Важно! Если поле предзаказа не заполнено/пустое, то в XML передается информация об реальном остатке товара на сладах.
Включать предзаказ при нулевом остатке
Предзаказ включается только при отсутствии товара/комплекта на всех складах.
Подробную информацию о работе предзаказа вы можете получить на сайте Kaspi.
Дополнительные артикулы
Данная функция необходима, если продаете один товар под несколькими карточками в Kaspi Магазине. Она позволяет присвоить одному товару несколько артикулов, для этого:
- Создайте в карточке товара доп. поле по типу текст.
- Через запятую пропишите все артикулы с Kaspi
- Выберите созданное поле в настройках нашего приложения.
Теперь товар в заказах синхронизируется не только по полю Код, но и Доп. артикул. Информация о товаре также добавляется в XML (смотрите последнее изображения).
В данном функционале есть недостаток. Если вы используете наш XML, то нельзя назначить разную стоимость для товаров с доп. артикулом. Но это легко решить с помощью комплектов! Для вас мы записали инструкцию по ссылке.
Учёт неснижаемого остатка
Если количество товара на складе достигнет неснижаемого остатка, то товар автоматически снимется с продажи в Kaspi. Можно указать неснижаемый остаток для всех товаров на определенном складе, так и для каждого товара.
Брать из карточки товара
Функция "Неснижаемый остаток" в данный момент доступна только для опции "В сумме на всех складах". Пункты "Одинаковый на всех складах" или "Задать для каждого" не поддерживают данную функцию. (Изображение 2)
Важно про модификации
Брать из карточки товара
Функция "Неснижаемый остаток" в данный момент доступна только для опции "В сумме на всех складах". Пункты "Одинаковый на всех складах" или "Задать для каждого" не поддерживают данную функцию. (Изображение 2)
Важно про модификации
К сожалению, МойСклад не позволяет просматривать неснижаемый остаток у модификаций. Мы сделали так, значение неснижаемого остатка основного товара распространяется и на модификации.
Разное
Репрайсер
Бот для автоматической регулировки цен в Kaspi Магазине. Мы сделали отдельное руководство по настройке бота понижения цен на Kaspi.
Ссылка на заказ
Вы можете легко открыть страницу заказа в Kaspi, не покидая МойСклад. Просто разверните виджет и нажмите на иконку, как показано на изображении, чтобы открыть нужный заказ в новой вкладке.
Массовая печать накладных Kaspi
С помощью этой функции вы можете легко массово скачивать накладные для заказов, находящихся на этапе "Ожидают передачи курьеру".
- Нажимая на кнопку "Скачать накладные" вы получаете только новые накладные, которые еще не были скачены. Ранее скаченные накладные будут автоматически перемещены в "Журнал накладных".
Изменение статусов заказа Kaspi из МойСклад
- Подтверждение заказа
- Комплектация заказа
- Подтверждение прибытия товара на склад/магазин
- Выдача заказа
- Отмена заказа (изображение 4)
- Возврат
Примечания
- Изменить статус заказ можно только в версии через браузер, в мобильном приложении это сделать пока не возможно.
- Иногда нужно обновить страницу заказа после изменения статуса, чтобы увидеть актуальную информацию
Стоимость виджета
Помесячная оплата
от 15 000 ₸
- 14 дней тестового периода
Как оплатить приложение
Оплата приложения осуществляется через МойСклад.
- Зайдите в карточку приложения
- Нажмите на кнопку "оплатить/оплатить сейчас"
- Нажмите на кнопку "выбрать способ оплаты"
- В открывшимся окне выберите "Robokassa"
- Произведите оплату
Приостановка приложения за неуплату
Если вы не оплачиваете приложение, оно приостанавливается на вашем аккаунте до момента оплаты.
Ответы на вопросы
Можно. Свяжитесь с нами.
Да, как заказы, так и выгрузка по остатками и цена в XML тоже работает как нужно. Если одного из товаров в комплекте будет не хватать, в XML такой товар будет считаться отсутствующим.
Да, можно. В нашей интеграции есть бот понижения цены - Репрайсер.
Да, можно. Просто замените API ключ в нашей интеграции на новый из вашего нового кабинета. Также вам нужно изменить Наименование и ID компании в нашей интеграции.
Это возможно, если заказ с типом доставки Kaspi Postomat