Помощь
Здесь собраны четыре шага настройки сервиса Sanaq и ответы на частые вопросы.
Как получить токен Kaspi
Токен — это ключ, который разрешает сервису Sanaq читать заказы и товары вашего магазина Kaspi. Его выдают в кабинете продавца Kaspi.
Откройте кабинет продавца Kaspi: kaspi.kz/mc (откроется в новой вкладке)
Перейдите в
Настройки→Токен API.Если токен уже есть — скопируйте его. Новый создавайте, только если токена нет (
Сформировать).Вставьте токен в поле «API-токен Kaspi» на странице «Магазин» и нажмите «Подключить».
После вставки мы проверяем токен одним запросом к Kaspi. Если он действителен, магазин подключается и начинается загрузка заказов: сначала за последнюю неделю, затем история за последние 30 дней. Ход загрузки виден на странице «Магазин» — обновлять её не нужно.
- Если токен не принимается, проверьте, что скопировали его из кабинета целиком.
- Если Kaspi не отвечает, повторите через минуту.
- Если появилось сообщение «Этот магазин подключён к другому аккаунту», возможно, вы раньше регистрировались с другим email: войдите с ним или напишите нам.
Если позже понадобится заменить токен (например, вы создали новый в кабинете Kaspi), вставьте новый токен в разделе «Заменить токен» на странице «Магазин». Подключать и заменять токен может только владелец организации.
Как загрузить банковскую выписку
Рекламы, бонусов за отзывы и платы за ведение счёта в заказах Kaspi нет — они видны только в выписке по счёту Kaspi Business. Загрузите выписку, и чистая прибыль учтёт и эти расходы.
Банковская выписка доступна начиная с тарифа «Оптимальный» — Тарифы.
Сначала скачайте файл выписки из Kaspi Business:
- Формат — Excel (.xlsx), размер — не больше 5 МБ.
- Загружайте файл в том виде, в котором его выдал Kaspi Business: не удаляйте и не правьте строки. Если сумма строк не сходится со строкой «Итого» в выписке, файл не будет принят.
- Период одной выписки — не больше 366 дней; более длинный период загружайте частями.
- Последним днём периода выбирайте вчерашний день или более ранний: строки незавершённого дня не сохраняются, они придут со следующей выпиской.
- Пересечения периодов не страшны: уже загруженные строки повторно не добавляются.
Затем загрузите файл в сервис Sanaq:
1. Откройте страницу «Банковская выписка» (ссылка на неё есть и в «Настройках»).
2. Выберите файл и нажмите «Проверить выписку».
3. На странице проверки посмотрите, что будет сохранено: реклама, бонусы за отзывы и плата за ведение счёта войдут в прибыль; комиссия, процессинг Kaspi Pay и доставка только сверяются с нашим расчётом.
4. В первой выписке подтвердите, что счёт принадлежит этому магазину, — это делает владелец организации. Следующие выписки проверяются по тому же владельцу счёта автоматически.
5. Нажмите «Сохранить» — прибыль пересчитается.
В дни без выписки расходы на рекламу неизвестны, поэтому на «Обзоре» чистая прибыль показывается с пометкой «без учёта рекламы».
Себестоимость через шаблон Excel
Чтобы посчитать чистую прибыль, нужна себестоимость каждого товара. Её можно внести на странице «Себестоимость» вручную или файлом Excel; если товаров много, удобнее Excel.
1. На странице «Себестоимость» нажмите «Скачать шаблон (.xlsx)». В шаблоне уже есть товары вашего магазина: без себестоимости — сверху, с уже внесённой — заполнены.
2. В последнем столбце укажите себестоимость одной единицы каждого товара (закупочная цена и доставка до вас). Остальные столбцы не меняйте.
3. Сохраните файл, загрузите его в поле на той же странице и нажмите «Проверить файл».
4. На странице проверки показано число корректных строк и строк с ошибками. Если всё верно, нажмите «Сохранить» — прибыль пересчитается примерно за минуту.
Столбцы шаблона:
| Столбец | Что указывать |
|---|---|
| Код Kaspi | Код товара в Kaspi. По нему определяется товар. |
| SKU (артикул) | Артикул продавца. Если код Kaspi пуст, товар определяется по нему. |
| Название | Название товара — только для вашего удобства; при импорте не читается. |
| Себестоимость, ₸ | Себестоимость одной единицы в тенге. Можно писать «4500» или «4 500,50». |
- Строки с пустой себестоимостью пропускаются — это не ошибка: можно заполнить только нужные товары.
- Формат файла — .xlsx или .csv. Лимиты: размер — не больше 5 МБ, не больше 20 000 строк и 100 столбцов.
- Строка с кодом, которого нет в магазине, или с повторяющимся товаром показывается как ошибочная и не сохраняется; корректные строки сохраняются.
- Если ошиблись, импорт можно вернуть к прежним значениям кнопкой «Откатить».
- Файл каталога из другого сервиса (со столбцами «Артикул / Код» и «Себестоимость за шт») тоже можно загрузить без изменений.
Сумма, внесённая через Excel, становится «текущей себестоимостью» товара и применяется к продажам за все периоды: если её изменить, прибыль за прошлые дни тоже пересчитается.
Если закупочная цена меняется от партии к партии, ведите партии (FIFO): на странице «Себестоимость» откройте товар и добавьте дату поступления партии, количество и цену за единицу. Продажи списываются с самой старой партии по порядку дат выдачи товара. Когда партия заканчивается, к оставшимся продажам применяется текущая себестоимость, а если и её нет — себестоимость продажи считается «неизвестной» и в прибыль не входит. Дата партии определяет только очерёдность: партия, внесённая с опозданием, тоже будет учтена.
Подключение Telegram
Каждое утро бот в Telegram присылает итоги вчерашнего дня: выручку, чистую прибыль, самый прибыльный товар и предупреждения. При желании он сообщает и о новых заказах.
1. В разделе Telegram на странице «Настройки» нажмите «Подключить Telegram». Если вы только что подключили магазин, эта кнопка есть и на странице «Магазин».
2. В новой вкладке откроется бот — нажмите в Telegram кнопку
Start.3. Вернитесь на страницу Sanaq: через несколько секунд появится надпись «Telegram подключён». Ссылка действует 15 минут; если не успели, нажмите кнопку ещё раз.
К одному магазину можно подключить несколько чатов: каждый пользователь организации сам подключает свой Telegram и при необходимости сам его отключает.
Настройки отчёта общие для магазина, их меняет владелец организации:
- Ежедневный отчёт · Время отчёта
- Время Алматы. Отчёт — за вчерашний день.
- Уведомления о новых заказах
- после каждой синхронизации, примерно раз в 10 минут
- Напоминание о выписке
- 3-го числа, если выписка за прошлый месяц не загружена
- Время отчёта выбирается с шагом 15 минут. Если данные ещё не обновились, отчёт может прийти чуть позже.
- Язык сообщений привязан к чату: по умолчанию это язык сайта в момент подключения Telegram. Изменить его можно в списке «Язык отчёта» в разделе «Настройки → Telegram» или командой
/langв боте. - Чтобы временно остановить сообщения, отправьте боту
/stop, чтобы включить снова —/start. - Кнопка «Отправить тестовый отчёт» сразу покажет, как выглядит отчёт.
Частые вопросы
О том, как считаются цифры, о тарифах и безопасности данных.
Почему чистая прибыль здесь отличается от суммы, которую перечисляет Kaspi?
Kaspi вычитает из выручки только свои удержания: комиссию, процессинг Kaspi Pay и доставку. При расчёте чистой прибыли дополнительно вычитаются себестоимость товара и налог (по умолчанию 4% выручки, меняется в «Настройках»), а в дни с загруженной банковской выпиской — ещё реклама, бонусы за отзывы и плата за ведение счёта.
Влияют и даты: выручку и прибыль мы считаем по дню выдачи товара покупателю, а возврат корректирует прибыль дня исходной продажи.
Продажи без себестоимости в прибыль не входят вообще — они показываются отдельно.
Что означает пометка «без учёта рекламы»?
Расходов на рекламу в заказах Kaspi нет — они берутся только из банковской выписки. В дни, не закрытые выпиской, реклама неизвестна, поэтому чистая прибыль помечается «без учёта рекламы»: реальная прибыль может быть меньше. Чтобы пометка исчезла, загрузите банковскую выписку.
В отчёте Telegram для такого дня добавляется строка с оценкой: применяется доля рекламы в выручке по выписке, период которой закончился за последние 60 дней.
Что такое продажа с «неизвестной себестоимостью»?
Это продажа товара, у которого не указана себестоимость (или партии закончились, а текущей себестоимости нет). Мы не считаем её прибыль нулевой: такая продажа не входит в расчёт прибыли и маржи.
Если такие продажи есть, на «Обзоре» появляется полоса с предупреждением: кнопка «Заполнить» сразу открывает эти товары на странице «Себестоимость».
Как считается безубыточная цена?
Безубыточная цена — минимальная цена, при которой прибыль товара равна нулю. В расчёт входят себестоимость, комиссия Kaspi по категории (с НДС), процессинг Kaspi Pay (0,95%), налог, стоимость доставки при этой цене и доля продаж в кредит.
Стоимость доставки Kaspi зависит от суммы заказа. Поэтому доставку мы берём не как среднюю за период, а по стоимости для суммы заказа при этой цене: по публичному тарифу Kaspi, а если по заказам вашего товара доставка выходит дороже — по ним. Данные магазина берутся из заказов за последние 60 дней; если магазин подключён недавно — из загруженной истории (30 дней до подключения и дни после него). Цена округляется до целого тенге вверх.
Цена с пометкой «с рекламой» покрывает и долю рекламы из последней банковской выписки. Безубыточная цена показывается начиная с тарифа «Оптимальный».
Откуда берётся ставка комиссии?
Из официальной таблицы Kaspi — по категории каждого товара. Если у вас индивидуальная скидка или акционный тариф, ставку можно скорректировать на странице «Комиссия» по категории, а на странице товара — по отдельному товару. Если категория не найдена в таблице, применяется ставка по умолчанию с пометкой «предположительно».
Как работает пробный период и что будет, когда он закончится?
Пробный период длится 7 дней и начинается с первой успешной синхронизации вашего магазина с Kaspi. В это время открыты возможности тарифа «Оптимальный».
За 2 дня до окончания и в день окончания мы предупредим по email и в Telegram. После окончания данные сохраняются, синхронизация с Kaspi продолжается, но в сервисе остаются открытыми только «Тарифы» и «Настройки», а отчёт в Telegram останавливается. Чтобы продолжить, выберите тариф.
Насколько защищены мои данные?
Токен Kaspi мы используем только для чтения данных: не принимаем и не отменяем заказы, не меняем цены. Токен хранится в зашифрованном виде.
Имена, телефоны и адреса покупателей не записываются ни в базу, ни в журналы — из заказа сохраняется только город. Из банковской выписки берутся только категория расхода, дата, сумма и номер документа. Подробнее — в Политике конфиденциальности.
Заказы за какое время загружаются при подключении магазина?
Сначала загружаются заказы за последнюю неделю, затем в фоне дополняется история за последние 30 дней; ход загрузки виден на странице «Магазин». Для дней раньше загруженной истории «Обзор» показывает не ноль, а «нет данных».
Что делать, если токен Kaspi стал недействительным?
Чаще всего это происходит, когда в кабинете Kaspi создают новый токен: старый может перестать работать. В этом случае на страницах «Обзор» и «Магазин» появляется предупреждение, а если подключён Telegram — придёт и сообщение.
Вставьте новый токен в разделе «Заменить токен» на странице «Магазин» — прежние данные сохранятся, синхронизация продолжится. Заменить токен может только владелец организации.
Как добавить сотрудника?
В разделе «Команда» на странице «Настройки» укажите его email и отправьте приглашение — это может сделать только владелец организации. Ссылка-приглашение действует 7 дней и подходит только аккаунту, зарегистрированному с этим email.
Участник видит обзор, прибыль и заказы, может вносить себестоимость и загружать банковскую выписку; тариф, оплата, приглашения и токен Kaspi доступны только владельцу организации. Число пользователей зависит от тарифа — Тарифы.
Как подключить ещё один магазин?
Магазин добавляет только владелец организации: кнопкой «Добавить магазин» на странице «Магазин», с собственным токеном Kaspi нового магазина. Учёт по каждому магазину ведётся отдельно, а переключаться между ними можно в верхней панели.
Несколько магазинов доступны на тарифе «Полный» — до 3 магазинов.
Не нашёл ответа на свой вопрос. Куда написать?
Напишите на support@sanaq.app: укажите название магазина и коротко опишите, что произошло. Не присылайте в письме токен Kaspi и пароль — мы никогда их не спрашиваем.
Не нашли ответ? Напишите нам: support@sanaq.app.