Заказы Kaspi перестали попадать в Битрикс24: порядок проверки и когда звать подрядчика

Если заказы Kaspi перестали попадать в Битрикс24, почти всегда сломалось одно из четырех звеньев: доступ к API Магазина на Kaspi.kz, само приложение или коннектор, пользователь Битрикс24, от имени которого работает интеграция, или настройки воронки, куда падают сделки. Проверка по порядку занимает 15-30 минут и показывает, можно ли починить обмен самим или нужен подрядчик.

Обычно все выглядит так. Утром менеджер открывает CRM, видит, что последняя сделка с Kaspi пришла вчера в 16:40, а в кабинете продавца за это время набралось два десятка новых заказов. Часть из них уже ждет подтверждения, и счетчик времени на принятие идет. Первая реакция у всех одинаковая: «Kaspi что-то поменял». Иногда так и есть, но чаще причина внутри портала, и найти ее можно без программиста.

Как устроена интеграция Kaspi и Битрикс24

Интеграция Kaspi и Битрикс24 работает через API Магазина на Kaspi.kz: программа-посредник по токену запрашивает заказы из кабинета продавца и создает по ним сделки в CRM. На практике это отдельный модуль: приложение, внешний сервис или доработка, которую кто-то для вас настроил и подключил к обоим кабинетам.

Токен авторизации — это ключ, по которому Kaspi узнает вашу систему и отдает ей данные кабинета. По инструкции Kaspi Гида о токене авторизации, получить его может только руководитель компании в веб-версии кабинета продавца, в разделе Настройки > Токен API. Там же сказано, что токен не меняется, сколько бы раз вы его ни открывали, а любой, у кого он есть, может получать информацию о заказах и товарах вашего кабинета.

С какой стороны стоит посредник, зависит от того, как интеграцию делали. На проектах встречаются три схемы:

Схема	Где живет логика обмена	Кто обычно чинит
Приложение из Битрикс24 Маркета	У разработчика приложения, в портале только настройки	Разработчик приложения, администратор портала проверяет подписку и права
Сторонний сервис-коннектор	В облачном сервисе, который связывает Kaspi с CRM	Поддержка сервиса, у вас доступ к его личному кабинету
Собственная доработка через вебхук	На вашем сервере или хостинге подрядчика	Тот, кто писал код, или новый подрядчик после изучения

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

Порядок проверки, когда заказы Kaspi не попадают в Битрикс24

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

1. Найдите последний заказ, который дошел. Сравните номер последней сделки из Kaspi в CRM со списком заказов в кабинете продавца. Точное время остановки помогает связать сбой с событием: увольнением, сменой тарифа, правкой воронки.
2. Проверьте, не пришли ли заказы в другое место. Иногда сделки создаются, но не в той воронке или не с тем ответственным. Найдите в CRM номер свежего заказа через поиск.
3. Откройте приложение или кабинет коннектора. У большинства решений есть журнал обмена или страница статуса. Ошибка авторизации, лимит или просроченная оплата обычно видны прямо там.
4. Проверьте подписку и оплату. Если интеграция стоит из Маркета как платное приложение, посмотрите в виджете «Мой тариф», активна ли подписка на Маркетплейс. Если это внешний сервис, проверьте, не закончился ли оплаченный период у него.
5. Проверьте пользователя интеграции. Узнайте, от чьего имени работает приложение или вебхук, и не уволен ли этот сотрудник, не урезаны ли ему права на CRM.
6. Посмотрите изменения в воронке. Удаленная стадия, новое обязательное поле, переименованное значение списка или новый робот на первой стадии способны остановить создание сделки.
7. Сверьте токен Kaspi. Убедитесь, что в настройках интеграции стоит тот же токен, что в кабинете продавца, без пробелов и обрезанных символов.

Если на каком-то шаге нашлась явная причина, исправьте ее и создайте тестовый заказ или дождитесь следующего реального. После исправления часть интеграций сама подтягивает пропущенные заказы, часть нет. Это зависит от решения, поэтому список заказов за период сбоя все равно стоит сверить вручную.

Частые причины остановки обмена и как их узнать

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

Что видно	Вероятная причина	Что проверить
Обмен встал в первый день месяца или в дату продления	Закончилась подписка или оплата сервиса	«Мой тариф» в портале, кабинет коннектора
Обмен встал после ухода сотрудника	Интеграция была на уволенном пользователе и ее отключили	Список сотрудников с активными интеграциями
Заказы перестали приходить сразу после правки воронки	Стадия, поле или справочник, на которые ссылается интеграция, изменены	Историю изменений воронки, журнал ошибок приложения
Приходят не все заказы, а часть	Фильтр по статусу, складу или городу в настройках интеграции	Настройки отбора заказов в приложении или коннекторе
В журнале ошибка авторизации	Неверный или чужой токен	Токен в кабинете продавца и в настройках обмена
Ничего не менялось, ошибок нет	Сбой у разработчика приложения или на сервере доработки	Обращение к разработчику, логи сервера

Отдельно про увольнение. В справке Битрикс24 об увольнении сотрудника описано, что при увольнении человека с активными вебхуками портал предлагает выбор: отключить интеграции или оставить их включенными. Во втором случае они переходят на системного пользователя, копию уволенного, и продолжают работать. Если в спешке нажали «отключить», обмен с Kaspi встанет в ту же минуту. Обратная сторона тоже есть: оставленный вебхук работает, и любой, у кого есть ссылка на него, получает доступ к данным портала.

Про подписку. В ответах Битрикс24 о приложениях Маркетплейса сказано, что после окончания подписки платные приложения становятся недоступны, но все данные сохраняются, и доступ вернется после продления. Сделки за прошлые месяцы, значит, никуда не денутся. А вот заказы, пришедшие за время простоя, придется переносить отдельно.

Что делать с заказами Kaspi, пока обмен не работает

Пока обмен стоит, заказы нужно принимать в кабинете продавца Kaspi вручную и параллельно вести список, чтобы потом перенести их в CRM. Главное в эти часы — не сорвать сроки принятия заказов, а порядок в CRM можно навести после ремонта.

Практичный порядок на время сбоя такой:

1. Назначьте одного человека, который следит за новыми заказами в кабинете продавца и принимает их. Если этим занимаются все понемногу, кто-то обязательно решит, что заказ уже взял коллега.
2. Заведите простую таблицу: номер заказа Kaspi, время, товар, сумма, кто принял. Через нее потом удобно сверять, что попало в CRM.
3. Предупредите склад и доставку, что часть заказов временно идет мимо CRM. Если отгрузка у вас запускается со стадии сделки, ее придется запускать вручную.
4. После восстановления обмена сравните таблицу со сделками в CRM за тот же период. Недостающие заказы заведите вручную или попросите подрядчика сделать догрузку через API.
5. Отметьте в CRM, что сделки заведены вручную, например отдельным источником или тегом. Так отчеты по каналу Kaspi за этот месяц не исказятся.

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

Что можно проверить самому, а когда звать подрядчика

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

Администратор портала без опыта разработки обычно справляется с такими задачами:

• продлить подписку или оплатить коннектор;
• вернуть уволенного сотрудника или перенастроить интеграцию на служебного пользователя;
• восстановить удаленную стадию или убрать обязательность нового поля;
• заново вставить токен из кабинета продавца;
• вручную завести в CRM заказы, которые пришли во время сбоя.

Звать подрядчика лучше сразу, если обмен написан собственным кодом и человек, который его делал, недоступен. Без документации новый специалист сначала изучает, как все устроено, и разумнее начать это до того, как остановка затянется. То же самое касается частичной потери заказов: когда приходят не все сделки, причина часто сидит в логике отбора, и угадывать ее методом перебора дольше, чем прочитать код или настройки.

Чтобы разговор с подрядчиком занял минуты, а не часы, подготовьте до звонка короткую справку: номер и время последнего заказа, который дошел до CRM; название приложения или сервиса; кто и когда последний раз менял воронку; не было ли увольнений и продлений в эти дни; скриншот ошибки из журнала, если он есть. Токен в переписку не вставляйте: подрядчик возьмет его из кабинета сам, если вы дадите ему такой доступ.

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

Как не узнать о следующей остановке через сутки

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

Приемы ниже можно комбинировать:

1. Отдельный служебный пользователь. Интеграция работает от отдельной учетной записи с нужными правами. Менеджер или администратор однажды уволится, а служебная запись останется.
2. Контрольная метрика. Руководитель отдела или администратор раз в день смотрит, сколько сделок с источником Kaspi создано за сутки. Ноль в рабочий день — сигнал проверить обмен.
3. Автоматическое оповещение. Подрядчик настраивает проверку, которая пишет в чат, если за последние несколько часов не создано ни одной сделки из Kaspi. Порог зависит от вашего обычного потока заказов.
4. Календарь оплат. Даты продления подписки и оплаты коннектора заносятся в календарь ответственного с напоминанием заранее.
5. Описание интеграции. Одна страница в базе знаний портала: какая схема, кто разработчик, где журнал, от чьего имени работает, где хранится токен.

Подробнее о том, как отслеживать любые обмены, мы писали в статье про мониторинг интеграций Битрикс24. А если вы только выбираете, как вообще связать маркетплейсы с CRM, начните с обзора интеграции Битрикс24 с маркетплейсами.

Отдельное внимание токену. По описанию работы с API в Kaspi Гиде, после получения токена Kaspi советует отправить тестовый запрос и убедиться, что ответ приходит с кодом 200. Тот же тест полезно повторять при любом подозрении на сбой: если запрос с вашим токеном проходит, проблема почти наверняка на стороне интеграции или портала. Делать это должен технический специалист, потому что токен дает доступ к заказам, и пересылать его в мессенджерах посторонним не стоит.

Пример разбора: обмен встал после ухода администратора

Типичный сценарий, собранный из похожих случаев, показывает, как быстро находится причина, если идти по шагам. Детали условные, но такая последовательность событий встречается часто.

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

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

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

Как техподдержка Битрикс24 разбирает остановку обмена с Kaspi

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

По нашему опыту внедрений, в большинстве случаев причина находится в портале: интеграцию отключили при увольнении сотрудника, кто-то переделал воронку или забыли продлить оплату. Реже приходится связываться с разработчиком приложения, и совсем редко дело в изменениях на стороне Kaspi. Поэтому при обращении полезно сразу сообщить три вещи: когда пришел последний заказ, какая у вас схема интеграции и что менялось в портале за последние дни.

Заказы на Kaspi идут и вечером, и в выходные, и обмен может встать в любой из этих часов, поэтому наша линия техподдержки Битрикс24 работает 24/7 и принимает такие заявки в любое время. Если обмен встал и своими силами за полчаса его не поднять, оставьте заявку на странице техподдержки Битрикс24 24/7: подключимся, найдем причину и поможем перенести заказы, пришедшие во время простоя. Техническая поддержка Битрикс24 у нас включает и последующую настройку контроля, чтобы следующий сбой вы увидели в течение часа, а не на следующее утро.

Частые вопросы

Почему заказы Kaspi перестали приходить в Битрикс24, если мы ничего не меняли?

Чаще всего что-то все же изменилось, просто не в CRM: закончилась подписка на Маркетплейс или оплата коннектора, уволили сотрудника, от имени которого работала интеграция, или кто-то поправил воронку. Начните с даты последнего пришедшего заказа и сравните ее с событиями в компании. Если совпадений нет, обращайтесь к разработчику интеграции.

Нужно ли менять токен Kaspi, если интеграция перестала работать?

Обычно нет. По данным Kaspi Гида, токен в разделе Настройки > Токен API не меняется, сколько бы раз его ни открывали, и получить его может только руководитель компании. Сначала проверьте, что в настройках интеграции стоит именно этот токен без лишних символов, и только потом ищите другие причины.

Пропадут ли заказы, которые не попали в CRM во время сбоя?

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

Сколько времени занимает поиск причины?

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

Можно ли сделать так, чтобы о сбое обмена сообщали автоматически?

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