Как перенести клиентов из Excel на счета Kaspi
Переезд с таблицы на автоматические счета Kaspi: импорт клиентов, «Уже оплачено до» без второго счёта, пауза до запуска, песочница и то же через API.
Короткий ответ. Перейти с таблицы Excel или Google на автоматические счета Kaspi можно за вечер. Клиенты загружаются из файла, тарифы заводятся один раз, а подписки назначаются с датой «Уже оплачено до»: кто уже заплатил за месяц в старой системе, второй счёт не получит. Счета по расписанию у нового бизнеса стоят на паузе, пока вы сами не нажмёте «Начать выставлять счета», поэтому загрузка базы никому ничего не отправит. Попробовать всё без денег можно в песочнице, а то же самое для программиста есть в API.
Почему переезд пугает и что на самом деле страшно
Обычно держит не сложность, а два страха. Первый: загружу клиентов, и им сразу уйдут счета, хотя я ещё ничего не настроил. Второй: тот, кто уже заплатил за этот месяц переводом или наличными, получит счёт повторно и решит, что вы путаете деньги.
Оба случая в KazPayment закрыты отдельными настройками. Ниже переезд по шагам в том порядке, в котором его удобно делать.
| Шаг | Где | Что даёт |
|---|---|---|
| 1. Попробовать | песочница | видно весь путь счёта без денег |
| 2. Подключить кассу | «Подключения» → «Вход в Kaspi» | сервис выставляет счета от вашего имени |
| 3. Загрузить клиентов | «Клиенты» → «Загрузить из файла» | база переезжает целиком |
| 4. Завести тарифы | «Тарифы» | за что и как часто платят |
| 5. Назначить подписки | «Подписки», поле «Уже оплачено до» | заплатившие не получат второй счёт |
| 6. Товары, если есть | «Товары» → «Загрузить из Excel» | прайс и QR на каждый товар |
| 7. Telegram клиентам | «Действия» → «Ссылка в Telegram» | бесплатные напоминания |
| 8. Включить | «Начать выставлять счета» | пошли счета по расписанию |
Шаг 1. Песочница: посмотреть без денег
Песочница есть на любом тарифе, включая Free. Это отдельная копия бизнеса: счёт выставляется, но оплату нажимаете вы сами кнопками «Оплатить», «Отклонить» или «Оплатить другой суммой». Дальше всё идёт как в бою: сверка отмечает оплату, видно, что пришло бы клиенту.
Клиентам из песочницы не пишется ничего, сообщения уходят только вам. Касса Kaspi там не нужна, денег и баланса нет. Заводится в «Подключения» → «Интеграция» → «Песочница для разработчиков», возврат кнопкой «Вернуться в бизнес». Подробнее: Песочница и первые шаги.
Песочница не превращается в боевой бизнес. Всё, что вы там завели, остаётся там, а настоящую базу загружаете уже в боевой кабинет.
Шаг 2. Касса Kaspi
Чтобы счета доходили до клиентов, сервису нужен вход в вашу кассу Kaspi Pay. Заведите в Kaspi Pay для бизнеса отдельного кассира с отдельной сим-картой и войдите под ним в «Подключения» → «Вход в Kaspi». Если отдать сервису свой личный номер, вы и сервис будете вытеснять друг друга при каждом входе.
Подключите и Telegram владельца: когда Kaspi закроет сессию, вы узнаете об этом из уведомления, а не от клиента. Подробно: Подключить кассу Kaspi.
Шаг 3. Клиенты из Excel или Google Таблиц
На странице «Клиенты» нажмите «Загрузить из файла (Excel / CSV)». Подойдёт
.xlsx или CSV, в том числе русский CSV с «точкой с запятой». Из Google Таблиц
скачайте файл через «Файл» → «Скачать». Файл до 5 МБ, большую базу кабинет сам
отправит частями.
Обязательна только колонка с телефоном, имя и почта по желанию. Лишние
колонки удалять не надо. Кабинет сам угадывает колонки по заголовкам (в том
числе казахским) и показывает предпросмотр. Номер понимается в любом виде:
8 701…, +7 (701)…, 7011234567, даже если Excel сохранил его числом.
Клиент с уже известным телефоном пропускается, поэтому загрузить файл повторно безопасно. После загрузки вы увидите, сколько создано, сколько пропущено дублей и какие строки не прошли, с номером строки файла и причиной.
Перед загрузкой выберите язык напоминаний, русский или казахский. Разным группам можно загрузить разными файлами.
Чего загрузка не делает: не назначает тарифы, не переносит историю оплат и не подключает Telegram. Все загруженные заводятся как физлица, реквизиты ИП и ТОО дополняются вручную. Подробно: Перенести базу клиентов из Excel.
Шаг 4. Тарифы
Тариф отвечает на вопрос «за что и как часто». Режимов три: подписка (регулярная оплата), пакет (8 занятий, 10 моек) и разовый. У подписки период бывает по календарю (неделя, месяц, квартал, год), свой период вроде учебного года или «от дня оплаты» каждые 7, 30, 90 или 365 дней.
Колонку с суммами из таблицы переносить не нужно: сумма живёт в тарифе, и одна правка тарифа меняет цену всем. Особую цену одному клиенту, например скидку второму ребёнку, задаёте в его подписке. Подробно: Первые начисления.
Шаг 5. Подписки и «Уже оплачено до»
Это главный шаг переезда. В форме подписки выбираете клиента, тариф и, если клиент уже заплатил мимо KazPayment, ставите дату в «Уже оплачено до». Старт подписки сам сдвигается на следующий день, и первое начисление будет за то, что ещё не оплачено.
Как выбрать дату:
| Тариф | Клиент заплатил | «Уже оплачено до» | Первое начисление |
|---|---|---|---|
| месяц, 1-го числа | за ноябрь | 30.11 | за декабрь |
| квартал | за октябрь–декабрь | 31.12 | за следующий квартал |
| от дня оплаты, 30 дней | до 14.12 | 14.12 | с 15.12 |
У календарного тарифа дата должна быть последним днём периода. Если поставить 20.11 на помесячном тарифе, первый счёт был бы за весь ноябрь, включая оплаченные дни, поэтому кабинет такую дату не примет и подскажет правильную. Исключение — тариф, где неполный первый период считается по дням.
Долг за прошлое при переносе не начисляется: этот срок оплачен в старой системе. Историю прежних оплат перенести нельзя, она остаётся у вас в таблице.
Если клиенту по ошибке оформить ту же подписку дважды, через API вернётся уже действующая: два абонемента означали бы два счёта в месяц.
Шаг 6. Товары, если вы продаёте не только подписки
Прайс тоже загружается из файла: «Товары» → «Загрузить из Excel». Нужны колонки с названием и ценой, для опта можно добавить «Оптовая цена», «Ед.» и «Артикул». За раз до 1000 товаров. Перезаливать прайс можно: товар узнаётся по артикулу или названию, меняется только цена, а QR на ценнике остаётся прежним. Подробно: QR-код Kaspi на товар.
Шаг 7. Ссылка в Telegram для клиентов
Напоминания идут в Telegram бесплатно, в WhatsApp стоят 18 ₸, SMS 30 ₸ за каждую часть сообщения. Поэтому имеет смысл попросить клиентов подключить Telegram. Ссылку берёте в строке клиента: «Действия» → «Ссылка в Telegram». Она одноразовая и действует 7 дней. Клиент открывает её, нажимает «Старт», и дальше напоминания идут ему в Telegram. Подключить чат за человека нельзя, это делает только он сам.
Как устроены сами напоминания, см. Напоминания об оплате клиентам.
Шаг 8. «Начать выставлять счета»
Пока на плашке вверху кабинета не нажата кнопка, счета по расписанию никому не уходят. Ручной счёт и ссылка на оплату работают сразу: их вы запускаете сами. Без подключённой кассы кнопки нет, плашка сначала попросит кассу.
Нажимайте, когда проверили подписки и даты «Уже оплачено до». На плашке видно, скольким клиентам начнут выставляться счета. Сам счёт в Kaspi уходит не в день начисления, а за 3 дня до срока: так он не протухнет. Срок меняется в «Напоминаниях» → «Когда выставляется счёт».
Первая неделя: что проверить
- Касса. В «Настройках» на вкладке «Интеграции» карточка Kaspi Pay показывает «ПОДКЛЮЧЕНО».
- Начисления. В разделе «Начисления» у перенесённых клиентов нет счетов за уже оплаченный срок.
- Первые оплаты. Заплатившие отмечаются сами, когда оплата появляется в выписке кассы.
- Сообщения. В журнале сообщений видно, кому, каким каналом и с каким итогом ушло напоминание.
- Отвергнутые строки. Если при загрузке часть строк не прошла, поправьте их в файле и загрузите тот же файл ещё раз.
- Баланс. Если у клиентов нет Telegram, напоминания уйдут в WhatsApp или SMS и будут списываться с баланса бизнеса.
То же через API
Если база живёт в другой программе, переезд можно сделать скриптом. Ключ
выпускается в кабинете, для пробы берите ключ песочницы (kp_test_…).
POST /api/v1/payersсphone,full_name,email,lang— завести клиента. Повтор с тем же телефоном вернёт существующего сcreated: false.GET /api/v1/plans— получитьplan_idтарифов. Сами тарифы заводятся только в кабинете.POST /api/v1/subscriptionsсpayer_phone,plan_idиpaid_until(ГГГГ-ММ-ДД) — подписка с переносом. Безstarts_onона начнётся на следующий день послеpaid_until. Неверная дата у календарного тарифа даст400.POST /api/v1/payers/<id>/telegram-link— ссылка клиенту в Telegram.GET /api/v1/settings/auto-billing— посмотреть паузу и число подписок,POST /api/v1/settings/auto-billing/start— включить счета по расписанию.
Пакетной загрузки клиентов одним запросом и загрузки товаров в API нет: клиенты заводятся по одному, товары — файлом в кабинете. Все поля и ответы: документация API.
Частые вопросы
Я загрузил клиентов. Им уже пришли счета?
Нет. Пока вы не нажали «Начать выставлять счета», счета по расписанию никому не уходят. Сама загрузка клиентов ничего не отправляет, а без подписок у клиентов и начислений нет. Ушли только те счета, которые вы выставили вручную.
Клиент заплатил мне наличными за этот месяц. Что поставить?
В подписке укажите «Уже оплачено до» последним днём оплаченного периода, например 30.11 для помесячного тарифа. Подписка начнётся 1 декабря, и первым будет счёт за декабрь. За ноябрь клиент ничего не получит.
Можно ли загрузить из файла сразу и тарифы, и подписки?
Нет, из файла загружаются только карточки клиентов: телефон, имя и почта. Тарифы заводятся в кабинете, подписки назначаются в разделе «Подписки» по одному клиенту или через API скриптом, если клиентов много.
Колонка с суммой в моей таблице пропадёт?
Она не загрузится. Сумму задаёт тариф, а особую цену клиенту — его подписка. Так одна правка тарифа меняет цену всем сразу, и никто не платит по старой строке файла.
Сколько стоит попробовать?
Песочница бесплатна на любом тарифе, включая Free, денег в ней нет. Боевой бизнес после регистрации сразу на Free без карты. Комиссию 0,95% с оплаты берёт Kaspi, KazPayment с оборота ничего не берёт.
Я ошибся с датой «Уже оплачено до». Как исправить?
Позже сдвинуть старт внутрь оплаченного срока нельзя. Отмените ошибочную подписку и оформите новую с правильной датой: пока счёт не выставлен, клиент ничего не заметит.
Попробуйте KazPayment бесплатно
Тестовый режим без ограничения по времени: заведите тарифы, товары и счета и посмотрите, как это работает, до того как подключать настоящую кассу.
Начать бесплатно