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

Что нужно знать об особенностях Kaspi

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

Телефон покупателя скрыт. Kaspi отдаёт вместо номера маску вида +0(000)-000-00-00. Позвонить по такому номеру нельзя, поэтому модуль его в заказ не пишет — в комментарии появляется строка «Телефон покупателя скрыт Kaspi». Связаться с покупателем можно через кабинет Kaspi.

Дата начала выгрузки — жёсткая граница. Заказы созданные раньше этой даты не выгружаются. Если нужен более старый период, сдвиньте дату назад и дождитесь следующего цикла.

Первая выгрузка может занять несколько циклов. Kaspi не отдаёт больше двух недель за раз, а модуль обрабатывает до 500 заказов за цикл. Если дата начала давняя, заказы будут подтягиваться постепенно.

Причин отмены ровно три. Других Kaspi не принимает.

Часть статусов Kaspi ставит сам. «Одобрен банком», «В процессе отмены», «Возвращён» — их можно только получить, отправить обратно нельзя.

Каталог обновляется вручную. Автоматической перезагрузки каталога пока нет.

Шаг 7. Каталог товаров

Каталог нужен для того, чтобы товары в заказах привязывались к вашим товарам в CRM. Без него RetailCRM при каждом заказе создаёт новый товар со случайным кодом, и каталог засоряется.

Kaspi не отдаёт каталог через API — такого метода у них просто нет. Поэтому есть два способа:
Способ 1 — загрузить файл. Скачайте прайс-лист в кабинете Kaspi («Скачать прайс-лист в XML») и перетащите его в область загрузки. Оставьте «Источник фида» = «Загрузка файла вручную».
Способ 2 — по ссылке. Если у вас есть постоянная публичная ссылка на выгрузку, переключите «Источник фида» на «Скачивание по ссылке», вставьте адрес и нажмите «Забрать фид сейчас».

Кнопка «Забрать фид сейчас» неактивна, пока источник не переключён на «Скачивание по ссылке».

После загрузки появится блок «Последний принятый фид»: когда принят, сколько позиций в файле, сколько из них пойдёт в CRM и сколько отброшено.
Для проверки ранее загруженного файла можно воспользоваться кнопкой «Скачать исходный файл»
Ниже — блок «Замечания к данным». Красные замечания означают, что позиция в CRM не попадёт:

• нет артикула — товар не с чем сопоставить;
• нет цены — RetailCRM такой товар не примет;
• артикул повторяется — в CRM попадёт только первая позиция.

Оранжевые замечания не мешают выгрузке, но на них стоит посмотреть. Самое частое — «нет остатка»: Kaspi не прислал количество, и товар приедет в CRM с нулевым остатком. Отдельного внимания заслуживает «кириллица в латинском артикуле» — в артикуле затесалась русская буква среди английских, глазами это не различить, а товар из-за этого может не найтись.

Загружать прайс-лист нужно вручную каждый раз, когда цены или остатки изменились. Автоматического обновления пока нет.


Шаг 8. Подключение каталога в RetailCRM

RetailCRM не принимает файл — она скачивает каталог по ссылке сама.
На вкладке «Каталог» найдите блок «Ссылка для RetailCRM» и скопируйте адрес кнопкой копирования.
В RetailCRM откройте Настройки → Магазины → ваш магазин → вкладка «Каталог»:

1. Выберите вариант «Загружать из ICML».
2. Вставьте скопированную ссылку в поле «URL ICML-файла».
3. Поставьте галочку «Загрузить каталог из ICML сейчас».
4. Нажмите «Сохранить».

Через несколько минут в разделе «Товары» появится категория «Kaspi» с подкатегориями по брендам.

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

Шаг 9. Включение синхронизации

Вернитесь на вкладку «Системные настройки» и включите переключатели:
«Выгрузка заказов из Kaspi включена» — модуль начнёт забирать заказы.
«Выгрузка статусов в Kaspi включена» — модуль начнёт возвращать статусы. Помните: это меняет заказы реальных покупателей в Kaspi.
Нажмите «Сохранить».

Проверка после настройки

1. Заказы приходят. Подождите один период выгрузки (по умолчанию 5 минут) и откройте вкладку «Логи». Выберите направление «Kaspi → CRM». Должна появиться запись «Выгрузка заказов: создано N, обновлено M…». Нули — не ошибка, значит новых заказов не было.

2. Заказ выглядит правильно. Откройте импортированный заказ в CRM и проверьте:

• номер заказа совпадает с номером в Kaspi;
• товары привязаны к вашему каталогу, а не созданы заново;
• заполнены тип доставки, тип оплаты, стоимость доставки и адрес;
• в комментарии менеджера есть блок [Kaspi] … [/Kaspi] со служебными данными.

3. Каталог загрузился. В CRM: Товары → должна быть категория «Kaspi». Количество товаров сверьте с полем «Пойдёт в CRM» на вкладке «Каталог».

4. Статусы возвращаются. Возьмите один заказ и переведите его в статус, сопоставленный с записываемым статусом Kaspi. На вкладке «Логи» выберите направление «CRM → Kaspi» — должна появиться запись вида «Статус заказа 123456789 в Kaspi: … → …». Проверьте, что статус изменился и в кабинете Kaspi.
Если записи нет вовсе — триггер в CRM не создан или в адресе опечатка.

Журнал обменов
Вкладка «Логи» — главный инструмент разбора. Записи хранятся 14 дней.
Фильтры позволяют искать по номеру заказа Kaspi (стоит первым, потому что чаще всего вопрос звучит как «а что с заказом 123456789?»), по результату, событию и направлению.
Результатов три, и «Пропущено» — не ошибка:

Шаг 6. Причины отмены

Когда менеджер отменяет заказ в CRM, модуль должен сообщить Kaspi причину отмены. Kaspi принимает ровно три причины, других не существует:

• Отказ покупателя;
• Не удалось связаться с покупателем;
• Товара нет в наличии.

Слева выберите статус отмены из вашей CRM, справа — причину для Kaspi.
Если для статуса отмены нет строки и не отмечена строка «По умолчанию», отмена в Kaspi не отправится: придумать причину модуль не может.
Нажмите «Сохранить».

Шаг 4. Типы оплат

Сопоставьте способы оплаты Kaspi с типами оплаты вашей CRM.
Kaspi не публикует полный список своих типов оплаты, поэтому в выпадающем списке только известные: «Оплачен на Kaspi», «Рассрочка Kaspi Red», «Оплата при получении», «Кредит Kaspi». Своё значение можно вписать вручную — просто начните печатать в поле.
Отметьте одну строку как «По умолчанию» — она применится, когда точного совпадения нет.
Нажмите «Сохранить».

Шаг 5. Типы доставок

Так же сопоставьте способы доставки. Известные значения: «Доставка по городу», «Доставка по региону до двери», «Самовывоз из пункта выдачи», «Доставка по региону до пункта выдачи». Список открытый — можно вписать своё.
Нажмите «Сохранить».

Шаг 3. Статусы заказов

Здесь задаётся соответствие между статусами заказа в Kaspi и в вашей CRM. Эта таблица работает в обе стороны: при выгрузке заказов статус Kaspi переводится в статус CRM, а при обратной синхронизации — наоборот.
Нажмите «Добавить статус» и заполните строки. Слева выбирается статус Kaspi, справа — ваш статус CRM.
Обязательно настройте как минимум:

• Принят продавцом → ваш статус «принят в работу»;
• Завершён → ваш статус завершённого заказа;
• Отменён → ваш статус отменённого заказа.

Строка «По умолчанию» — что делать со статусами, которых нет в таблице. Отметьте одну строку как строку по умолчанию. Если этого не сделать, заказы с несопоставленным статусом не попадут в CRM вообще — они будут молча пропускаться.
Часть статусов Kaspi выставляет сам, и отправить их обратно нельзя — это «Одобрен банком», «В процессе отмены», «Возвращён». Их можно указать в таблице, чтобы принимать такие заказы, но при обратной синхронизации модуль их пропустит.
Нажмите «Сохранить».
Синхронизация статусов происходит автоматически раз в 15 минут.

Если вверху вкладки появилась жёлтая плашка «Часть заказов не будет импортирована» — прочитайте её. Там перечислены статусы Kaspi, для которых не задано соответствие.

Шаг 2. Системные настройки

Здесь задаётся, куда и как попадают заказы. Переключатели внизу пока не включайте — сначала настройте остальные вкладки.
Магазин RetailCRM (обязательно) — магазин, в котором будут создаваться заказы Kaspi.
Тип заказа и Способ оформления — подставятся в каждый заказ. Необязательны, но лучше выбрать.
Разделы заказов в Kaspi (обязательно) — какие разделы кабинета Kaspi проверять. Это именно разделы списка заказов (Новые, Доставка, Архив), а не статусы. Завершённый заказ лежит в разделе «Архив», поэтому если вам нужны завершённые заказы — отметьте «Архив».
Ключ товара из Kaspi — по какому значению искать товар в вашем каталоге. «Артикул продавца» приходит вместе с заказом и ничего не стоит. «Код товара в Kaspi» требует дополнительного запроса на каждую позицию каждого заказа и замедляет выгрузку — выбирайте его, только если ваш каталог построен на кодах Kaspi.
Поле оффера в RetailCRM — в какое поле товара CRM подставляется этот ключ. Должно совпадать с тем, где в вашем каталоге хранится артикул.
Поиск дублей клиента — искать ли существующего клиента перед созданием заказа.
Дата выгрузки заказов из Kaspi в RetailCRM (обязательно) — заказы созданные раньше этой даты не выгружаются. Ставьте дату, начиная с которой вам нужны заказы в CRM.
Период выгрузки заказов, минут — как часто проверять новые заказы. По умолчанию 5 минут.
Нажмите «Сохранить».

Шаг 1. Основные настройки

Нажмите «Добавить подключение».
Название обработчика — как вы будете называть этот магазин в списке подключений. Поле обязательное, без него подключение не сохранится.
Токен Kaspi — вставьте токен из кабинета продавца.
Нажмите «Проверить соединение» до сохранения. Если всё верно, появится зелёная плашка «Kaspi принял токен» и число заказов за последние сутки. Ноль заказов — не ошибка, значит за сутки их просто не было.
Если появилась красная плашка «Соединение не установлено» — токен неверен или устарел. Возьмите его заново в кабинете Kaspi.
Нажмите «Сохранить». После этого откроются остальные вкладки.

При повторном открытии вкладки поле токена будет пустым, а рядом появится надпись «Токен уже сохранён». Это нормально: токен хранится, но не показывается. Заполните поле только если хотите заменить токен на новый.

Модуль связывает ваш магазин на Kaspi.kz с RetailCRM. Заказы с Kaspi приходят в CRM автоматически, статусы возвращаются обратно в Kaspi, а товары из прайс-листа Kaspi попадают в каталог CRM. Менеджеру больше не нужно открывать кабинет Kaspi, чтобы принять заказ или отметить его выданным — всё делается в привычном интерфейсе CRM.

Как работает модуль

Модуль работает в трёх направлениях.
Заказы Kaspi → RetailCRM. Модуль сам, по расписанию, проверяет, нет ли новых заказов, и создаёт их в CRM. В заказ переносятся товары, адрес доставки, стоимость доставки, способ оплаты и статус. Номер заказа Kaspi становится номером заказа в CRM.
Статусы RetailCRM → Kaspi. Когда менеджер меняет статус заказа в CRM, RetailCRM сообщает об этом модулю, и модуль сразу переводит заказ в соответствующий статус в Kaspi: принят, на сборке, выдан, отменён.
Каталог Kaspi → RetailCRM. Модуль принимает ваш прайс-лист из кабинета Kaspi и отдаёт его в CRM. Это нужно для того, чтобы товары в заказах привязывались к вашему каталогу, а не создавались каждый раз заново.

Важно понимать: Kaspi не умеет сообщать о новых заказах сам. Модуль периодически спрашивает Kaspi, нет ли чего нового. Поэтому заказ появляется в CRM не мгновенно, а в течение периода опроса — по умолчанию 5 минут. Это ограничение Kaspi, а не модуля.
Если у вас несколько магазинов на Kaspi, для каждого создаётся отдельное подключение со своим токеном и своими настройками.

Перед началом работы

Подготовьте заранее:
Токен Kaspi. Кабинет продавца Kaspi → Настройки → Магазины → API. Токен свой для каждого магазина.
Каталог магазина. Кабинет продавца Kaspi → кнопка «Скачать прайс-лист в XML». Либо постоянная ссылка на вашу собственную выгрузку, если она у вас есть.
Права администратора в RetailCRM. Понадобятся, чтобы подключить каталог и создать триггер.
Отдельный магазин в RetailCRM под Kaspi. Рекомендуем завести его заранее — так заказы и товары Kaspi не перемешаются с остальными. Сразу проверьте, что в этом магазине включены нужные типы доставки и оплаты: в RetailCRM они разрешаются отдельно для каждого магазина, и это самая частая причина, по которой импорт не работает.

Решите заранее:

• с какой даты начинать выгружать заказы;
• какие разделы заказов Kaspi вам нужны (новые, доставка, самовывоз, архив);
• какому статусу Kaspi соответствует какой статус заказа в вашей CRM;
• какие типы оплат и доставок Kaspi соответствуют вашим;
• какие статусы отмены в CRM означают какую из трёх причин отмены Kaspi.

Настройки модуля разделены на восемь вкладок: Основные, Системные настройки, Статусы заказов, Типы оплат, Типы доставок, Причины отмены, Каталог, Логи. Пока подключение не сохранено, доступна только первая вкладка — остальные появятся после сохранения.

Оставьте заявку и мы обсудим ваш бизнес-запрос и расскажем, чем можем быть полезны для вашей компании