Перейти к содержимому
Sanaq

Помощь

Здесь собраны четыре шага настройки сервиса Sanaq и ответы на частые вопросы.

Содержание

  1. Как получить токен Kaspi
  2. Как загрузить банковскую выписку
  3. Себестоимость через шаблон Excel
  4. Подключение Telegram
  5. Частые вопросы

Как получить токен Kaspi

Токен — это ключ, который разрешает сервису Sanaq читать заказы и товары вашего магазина Kaspi. Его выдают в кабинете продавца Kaspi.

  1. 1

    Откройте кабинет продавца Kaspi: kaspi.kz/mc (откроется в новой вкладке)

  2. 2

    Перейдите в Настройки → Токен API.

  3. 3

    Если токен уже есть — скопируйте его. Новый создавайте, только если токена нет (Сформировать).

  4. 4

    Вставьте токен в поле «API-токен Kaspi» на странице «Магазин» и нажмите «Подключить».

Если создать новый токен, старый может перестать работать — другие сервисы (например, другая аналитика) отключатся.

После вставки мы проверяем токен одним запросом к Kaspi. Если он действителен, магазин подключается и начинается загрузка заказов: сначала за последнюю неделю, затем история за последние 30 дней. Ход загрузки виден на странице «Магазин» — обновлять её не нужно.

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

Если позже понадобится заменить токен (например, вы создали новый в кабинете Kaspi), вставьте новый токен в разделе «Заменить токен» на странице «Магазин». Подключать и заменять токен может только владелец организации.

Мы используем токен только для ЧТЕНИЯ: заказы, товары. Принять или отменить заказ, изменить цену — никогда. Токен хранится в зашифрованном виде; имена, телефоны и адреса покупателей не сохраняются.

Как загрузить банковскую выписку

Рекламы, бонусов за отзывы и платы за ведение счёта в заказах Kaspi нет — они видны только в выписке по счёту Kaspi Business. Загрузите выписку, и чистая прибыль учтёт и эти расходы.

Банковская выписка доступна начиная с тарифа «Оптимальный» — Тарифы.

Сначала скачайте файл выписки из Kaspi Business:

Kaspi Business → счёт Kaspi Pay → «Выписка» → выберите период и скачайте Excel (.xlsx).

  • Формат — Excel (.xlsx), размер — не больше 5 МБ.
  • Загружайте файл в том виде, в котором его выдал Kaspi Business: не удаляйте и не правьте строки. Если сумма строк не сходится со строкой «Итого» в выписке, файл не будет принят.
  • Период одной выписки — не больше 366 дней; более длинный период загружайте частями.
  • Последним днём периода выбирайте вчерашний день или более ранний: строки незавершённого дня не сохраняются, они придут со следующей выпиской.
  • Пересечения периодов не страшны: уже загруженные строки повторно не добавляются.

Затем загрузите файл в сервис Sanaq:

  1. 1

    1. Откройте страницу «Банковская выписка» (ссылка на неё есть и в «Настройках»).

  2. 2

    2. Выберите файл и нажмите «Проверить выписку».

  3. 3

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

  4. 4

    4. В первой выписке подтвердите, что счёт принадлежит этому магазину, — это делает владелец организации. Следующие выписки проверяются по тому же владельцу счёта автоматически.

  5. 5

    5. Нажмите «Сохранить» — прибыль пересчитается.

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

В дни без выписки расходы на рекламу неизвестны, поэтому на «Обзоре» чистая прибыль показывается с пометкой «без учёта рекламы».

В базе хранятся только категория, дата, сумма и номер документа. Контрагенты, их счета и ИИН/БИН, текст назначения платежа не сохраняются.

Себестоимость через шаблон Excel

Чтобы посчитать чистую прибыль, нужна себестоимость каждого товара. Её можно внести на странице «Себестоимость» вручную или файлом Excel; если товаров много, удобнее Excel.

  1. 1

    1. На странице «Себестоимость» нажмите «Скачать шаблон (.xlsx)». В шаблоне уже есть товары вашего магазина: без себестоимости — сверху, с уже внесённой — заполнены.

  2. 2

    2. В последнем столбце укажите себестоимость одной единицы каждого товара (закупочная цена и доставка до вас). Остальные столбцы не меняйте.

  3. 3

    3. Сохраните файл, загрузите его в поле на той же странице и нажмите «Проверить файл».

  4. 4

    4. На странице проверки показано число корректных строк и строк с ошибками. Если всё верно, нажмите «Сохранить» — прибыль пересчитается примерно за минуту.

Столбцы шаблона:

СтолбецЧто указывать
Код KaspiКод товара в Kaspi. По нему определяется товар.
SKU (артикул)Артикул продавца. Если код Kaspi пуст, товар определяется по нему.
НазваниеНазвание товара — только для вашего удобства; при импорте не читается.
Себестоимость, ₸Себестоимость одной единицы в тенге. Можно писать «4500» или «4 500,50».
  • Строки с пустой себестоимостью пропускаются — это не ошибка: можно заполнить только нужные товары.
  • Формат файла — .xlsx или .csv. Лимиты: размер — не больше 5 МБ, не больше 20 000 строк и 100 столбцов.
  • Строка с кодом, которого нет в магазине, или с повторяющимся товаром показывается как ошибочная и не сохраняется; корректные строки сохраняются.
  • Если ошиблись, импорт можно вернуть к прежним значениям кнопкой «Откатить».
  • Файл каталога из другого сервиса (со столбцами «Артикул / Код» и «Себестоимость за шт») тоже можно загрузить без изменений.

Сумма, внесённая через Excel, становится «текущей себестоимостью» товара и применяется к продажам за все периоды: если её изменить, прибыль за прошлые дни тоже пересчитается.

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

Подключение Telegram

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

  1. 1

    1. В разделе Telegram на странице «Настройки» нажмите «Подключить Telegram». Если вы только что подключили магазин, эта кнопка есть и на странице «Магазин».

  2. 2

    2. В новой вкладке откроется бот — нажмите в Telegram кнопку Start.

  3. 3

    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.

© 2026 ИП QAJET ALL · ИИН 960601300988
ПомощьПубличная офертаПолитика конфиденциальности
Поддержка: support@sanaq.app