Инструкция
📄 PDF

Инструкция для владельцев магазинов

Версия 2.0 — Июнь 2026

Быстрый старт

После регистрации магазина через /register КОД:

  1. Получишь реферальную ссылку для клиентов
  2. Используй /admin для входа в панель управления
  3. Следуй инструкциям ниже в зависимости от типа бизнеса

Тип 1: Склад-магазин (самовывоз)

Подходит для: оптово-розничных магазинов, пунктов выдачи

Шаг 1: Настройка категорий

  1. /admin → «Категории»
  2. «Добавить категорию»
  3. Создай категории товаров (например: «Электроника», «Одежда»)

Шаг 2: Добавление товаров

  1. /admin → «Товары» → «Добавить товар»
  2. Заполни:
    • Название товара
    • Описание
    • Цену (розничную)
    • Себестоимость (для расчёта прибыли)
    • Категорию
    • Фото (можно несколько)
  3. Для оптовых продаж:
    • «Изменить товар» → выбери товар
    • Установи «Тип продажи» → «Опт»
    • Укажи размер лота (например: 10 шт)
    • Цена будет умножена на размер лота

Шаг 2.5: Оприходование товаров на склад

Важно!

После добавления товара нужно оприходовать его на склад!

  1. /admin → «Товары» → выбери товар
  2. Нажми «Остатки»
  3. Нажми «Приход»
  4. Введи:
    • Количество (например: 100)
    • Закупочную цену за единицу (например: 50.5)
    • Комментарий (например: «Партия от поставщика А»)
  5. Товар оприходован! Система автоматически:
    • Рассчитает среднюю закупочную цену
    • Сделает товар доступным для заказа
    • Покажет текущий остаток

Массовое оприходование

Если товаров много, используй «Массовый приход»:

  1. Нажми «Скачать шаблон XLSX» — получишь готовый шаблон
  2. Открой в Excel/LibreOffice/Google Sheets
  3. Заполни данными (строки-примеры удали)
  4. Сохрани и отправь файл обратно в чат бота
  5. Получишь отчёт об успешных и ошибочных строках

Через шаблон можно дозалить склад существующих товаров (укажи product_id) или создать новые товары + сразу сделать их приход (оставь product_id пустым).

Форматы: CSV, XLSX, XLS

Минимальный остаток

Установи минимум для важных товаров:

  1. «Остатки» → «Мин. остаток»
  2. Укажи минимальное количество (например: 10)
  3. Когда остаток упадёт ниже — получишь уведомление

Шаг 3: Настройка доставки (самовывоз)

  1. /admin → «Доставка»
  2. Нажми «Самовывоз» (переключатель)
  3. Нажми «Адрес магазина»
  4. Введи адрес (например: «Москва, ул. Пушкина, д. 10»)
  5. Отправь геолокацию (или нажми «Пропустить»)
  6. Готово! Клиенты смогут выбирать самовывоз при заказе

Шаг 4: Делегирование работы

Роль: Сборщик

Как добавить:

  1. /admin → «Персонал»
  2. «Добавить сотрудника»
  3. Введи Telegram ID сотрудника (или юзернейм)
  4. Выбери роль «Сборщик»
  5. Сотрудник получит уведомление

Шаг 5: Работа с заказами

Сборщик:

  1. Получает уведомление о новом заказе
  2. /admin → «Заказы» → «В обработке»
  3. Нажимает на заказ → «Собрать заказ»
  4. Указывает место хранения (например: «Стеллаж А-5»)
  5. «Готов к выдаче»

Выдача клиенту:


Тип 2: Магазин с курьерской доставкой

Подходит для: доставки на дом, службы доставки, рестораны

Шаг 1: Настройка самовывоза (базово)

  1. /admin → «Доставка»
  2. Включи «Самовывоз» (переключатель)
  3. Нажми «Адрес магазина»
  4. Введи адрес склада/магазина
  5. Отправь геолокацию (это важно для расчёта расстояния курьером)

Шаг 2: Настройка курьерской доставки

  1. /admin → «Доставка»
  2. Включи «Курьер» (переключатель)
  3. После включения появятся дополнительные кнопки для настройки тарифов

Шаг 3: Установка координат магазина

Самый важный шаг!

Без координат система не сможет рассчитывать стоимость доставки по расстоянию.

  1. /admin → «Доставка»
  2. Нажми «Координаты магазина» (после включения курьера)
  3. Отправь геолокацию магазина (открой Telegram → отправь своё местоположение)
  4. Координаты сохранятся автоматически
Как отправить геолокацию в Telegram

Зачем нужны координаты:

Шаг 4: Настройка тарифов курьерской доставки

После включения курьера и установки координат появятся кнопки для настройки:

4.1 Базовая ставка курьера

  1. Нажми «База курьеру: X₽»
  2. Введи сумму в рублях (например: 200)
  3. Это минимальная сумма, которую получит курьер за доставку
  4. Даже если расчёт по расстоянию даст меньше — курьер получит базовую ставку

4.2 Бесплатный радиус

  1. Нажми «Бесплатный радиус: X км»
  2. Введи расстояние в километрах (например: 3)
  3. В пределах этого радиуса доставка стоит только базовую ставку
  4. Например: радиус 3 км, ставка 200₽ → до 3 км = 200₽

4.3 Тариф за километр

  1. Нажми «Тариф за км: X₽»
  2. Введи стоимость за каждый километр сверх бесплатного радиуса (например: 50)
  3. Формула: Стоимость = Базовая ставка + (расстояние - радиус) × ставка за км
  4. Пример: базовая 200₽, радиус 3 км, ставка 50₽/км, расстояние 7 км:
    • 200 + (7-3) × 50 = 200 + 200 = 400₽

4.4 Порог веса (если доставляете тяжёлые товары)

  1. Нажми «Порог веса: X кг»
  2. Введи порог в килограммах (например: 5)
  3. Если вес заказа превышает этот порог — начисляется доплата

4.5 Доплата за дополнительный килограмм

  1. Нажми «Доплата за доп.кг: X₽»
  2. Введи стоимость за каждый кг сверх порога (например: 30)
  3. Пример: порог 5 кг, доплата 30₽/кг, вес заказа 8 кг:
    • Доплата: (8-5) × 30 = 90₽

4.6 Бесплатная доставка от суммы заказа

  1. Нажми «Бесплатно от: X₽»
  2. Введи сумму заказа, при которой доставка бесплатна (например: 3000)
  3. Если заказ ≥ 3000₽ — клиент не платит за доставку (но курьер всё равно получает оплату)

4.7 Максимальное расстояние доставки

  1. Нажми «Макс. расстояние: X км»
  2. Введи максимальное расстояние доставки (например: 15)
  3. Если клиент дальше — курьерская доставка не будет предложена
  4. Введи 0, если ограничение не нужно

4.8 Минимальная сумма заказа для курьера

  1. Нажми «Мин. сумма для курьера: X₽»
  2. Введи минимальную сумму заказа для курьерской доставки (например: 500)
  3. Если заказ меньше этой суммы — курьерская доставка не будет предложена

4.9 Плоский тариф (fallback)

  1. Нажми «Плоский тариф (fallback): X₽»
  2. Введи фиксированную стоимость доставки (например: 350)
  3. Используется, если:
    • У покупателя нет геолокации
    • У магазина не установлены координаты
    • Расстояние не может быть рассчитано

Шаг 5: Добавление курьера

  1. /admin → «Персонал»
  2. «Добавить сотрудника»
  3. Введи Telegram ID или юзернейм курьера
  4. Выбери роль «Курьер»
  5. Курьер получит уведомление и сможет начать работу
Как работает роль курьера

Шаг 6: Работа курьера (пошагово)

Курьер:

  1. /admin → «Начать смену» → система запомнит его местоположение
  2. Нажимает «Свободные заказы» → видит доступные заказы
  3. Каждый заказ показывает:
    • Адрес клиента
    • Сумму заказа
    • Примерную выплату курьеру
  4. Нажимает «Взять заказ» → заказ назначается на курьера
  5. Нажимает «Я на месте у магазина» → владелец уведомлён
  6. Забирает заказ → «Забрал у магазина»
  7. Получает навигацию (ссылка на Яндекс.Карты)
  8. Едет к клиенту
  9. «Я на месте у клиента» → клиент уведомлён
  10. «Доставил» → заказ завершён
Важно

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

Шаг 7: Работа с проблемами доставки

Если у курьера возникла проблема, он может сообщить о ней:

Владелец может ответить:

Формула расчёта стоимости доставки

Стоимость = Базовая ставка
+ max(0, расстояние − бесплатный радиус) × ставка за км
+ max(0, вес заказа − порог веса) × доплата за кг

Примеры расчёта:

Пример 1

Базовая ставка 200₽, радиус 3 км, ставка 50₽/км, расстояние 7 км:

200 + (7-3) × 50 = 200 + 200 = 400₽

Пример 2

Базовая ставка 150₽, радиус 5 км, ставка 40₽/км, расстояние 2 км (в пределах радиуса):

150 + 0 = 150₽

Пример 3

Базовая ставка 200₽, радиус 3 км, ставка 50₽/км, вес 8 кг, порог 5 кг, доплата 30₽/кг:

200 + (7-3) × 50 + (8-5) × 30 = 200 + 200 + 90 = 490₽

Пример 4

Бесплатная доставка от 3000₽, заказ 3500₽, расстояние 10 км:

0₽ (бесплатно, но курьер получит базовую ставку 200₽)

Пример 5

У клиента нет геолокации (fallback):

Плоский тариф (например: 350₽)


Тип 3: Доставка в точки (пункты выдачи)

Подходит для: поставщиков в магазины, кофейни, рестораны

Шаг 1: Настройка точек доставки

  1. /admin → «Доставка»
  2. Включи «Доставка в точки»
  3. Нажми «Управление точками»
  4. «Добавить точку»

Шаг 2: Добавление точки

  1. Введи название точки (например: «Кофейня на Ленина»)
  2. Введи адрес (например: «Москва, ул. Ленина, д. 5»)
  3. Отправь геолокацию (или нажми «Пропустить»)
  4. Введи расписание (например: «Суббота 10:00-12:00») или «нет»

Шаг 3: Управление точками

Каждую точку можно:

Шаг 4: Работа с заказами

  1. Клиент выбирает точку при оформлении заказа
  2. Сборщик видит заказ и собирает его
  3. Сборщик отмечает «Готов к выдаче»
  4. Курьер забирает заказ и доставляет в точку
  5. Клиент забирает заказ из точки

Роли и права

Роли сотрудников

Добавление сотрудника

  1. /admin → «Персонал»
  2. «Добавить сотрудника»
  3. Введи Telegram ID сотрудника
  4. Выбери роль
  5. Сотрудник получит уведомление

Рабочая анкета

При первом входе в /admin сотрудник должен заполнить рабочую анкету: настоящее ФИО и рабочий телефон. Эти данные увидят клиенты при доставке.


Управление складом

Остатки и оприходование

Массовое оприходование

Используй Excel/CSV файл для массового добавления товаров на склад. Скачай шаблон XLSX в боте:

product_id,quantity,purchase_price,comment
1,100,50.5,Партия от поставщика А
2,50,120,

Привлечение клиентов


Дополнительные функции


Советы

Общие советы

  1. Начни с малого — добавь 5-10 товаров, настрой доставку, протестируй
  2. Заполни профиль — укажи адрес, координаты, расписание
  3. Добавь сотрудников — распредели роли для эффективной работы

Для склад-магазина:

  1. Используй категории — для удобства навигации
  2. Следи за остатками — установи минимальный остаток
  3. Используй места хранения — для маршрутов сборки
  4. Планируй развоз заранее

Для курьерской доставки:

  1. Установи координаты магазина — без них не рассчитается расстояние
  2. Настрой все тарифы — базовая ставка, радиус, ставка за км, вес
  3. Добавь курьеров через «Персонал»
  4. Курьеры должны быть на смене — иначе не получат уведомления
  5. Проверяй статус доставки в «Отчёты» → «Курьерская доставка»

Частые вопросы (FAQ)

Как изменить цену товара?

+

/admin → «Товары» → «Изменить товар» → выбери товар → введи новую цену

Как удалить товар?

+

«Изменить товар» → выбери товар → «Удалить товар»

Клиент не видит мой магазин

+

Он должен перейти по твоей реферальной ссылке

Как продлить подписку?

+

Свяжись с суперадмином для продления

Сотрудник не видит заказы

+

Проверь его роль в «Персонал»

Как отключить товар временно?

+

«Изменить товар» → «Доступность» → «Недоступен»

Товар автоматически стал недоступен

+

Проверь остатки. Система автоматически отключает товар при нулевом остатке. Оприходуй товар через «Остатки» → «Приход»

Как посмотреть остатки товара?

+

«Товары» → выбери товар → «Остатки»

Как отменить заказ?

+

Открой заказ → «Отменить заказ». Резерв товаров снимется автоматически

Как загрузить много товаров на склад?

+

Используй «Массовый приход» — скачай шаблон XLSX, заполни и отправь файл боту

Где посмотреть какие товары заканчиваются?

+

/admin → «Низкие остатки»

Как настроить курьерскую доставку?

+

/admin → «Доставка» → включи «Курьер» → установи координаты магазина → настрой тарифы

Как добавить курьера?

+

/admin → «Персонал» → «Добавить сотрудника» → выбери роль «Курьер»

Как рассчитывается стоимость доставки?

+

Формула: Базовая ставка + (расстояние - бесплатный радиус) × ставка за км + (вес - порог) × доплата за кг

Курьер не получает уведомления?

+

Проверь, что курьер на смене («Начать смену»)

Как посмотреть статистику курьерской доставки?

+

/admin → «Отчёты» → «Курьерская доставка»

Как курьер берёт заказ?

+

«Свободные заказы» → «Взять заказ»

Как курьер сообщает о проблеме?

+

В процессе доставки появляются кнопки с типами проблем (клиент не отвечает, не нашёл адрес и т.д.)

Как добавить точку доставки?

+

/admin → «Доставка» → включи «Доставка в точки» → «Управление точками» → «Добавить точку»


Глоссарий

Основные термины

Админ-панель
Интерфейс управления магазином в Telegram-боте, доступный по команде /admin
Активационный код
Одноразовый код, полученный при регистрации магазина. Активирует подписку и связывает владельца с магазином.
Базовая ставка
Минимальная сумма оплаты курьера за доставку, независимо от расстояния
Бесплатный радиус
Расстояние в километрах от магазина, в пределах которого доставка стоит только базовую ставку
Бесплатная доставка
Доставка за счёт магазина при сумме заказа выше установленного порога
Владелец (Owner)
Главный администратор магазина с полными правами управления
Заказ
Заявка клиента на покупку товаров, состоящая из товаров, доставки и контактных данных
Закупочная цена
Стоимость закупки товара у поставщика, используемая для расчёта прибыли
Курьер
Сотрудник магазина, доставляющий заказы клиентам. Видит только заказы со статусом «Готов к доставке»
Курьерская доставка
Тип доставки, при котором заказ доставляется курьером по указанному клиентом адресу
Лот
Минимальная партия товара для оптовых продаж. Цена умножается на размер лота.
Менеджер
Сотрудник магазина с расширенными правами (товары, заказы, доставка, статистика)
Место хранения
Обозначение места на складе, где находится собранный заказ (например: «Стеллаж А-5»)
Минимальный остаток
Пороговое значение остатка товара, при котором система уведомляет о необходимости пополнения
Массовый приход
Загрузка остатков товаров из Excel/CSV файла через шаблон XLSX
Оборачиваемость
Количество раз, когда товар был продан за определённый период (обычно 30 дней)
Оприходование
Добавление товаров на склад (учёт поступления товара)
ПВЗ (Пункт выдачи)
Точка, куда клиент приходит забрать заказ. Отличается от самовывоза тем, что точка может быть в другом месте.
Подписка
Период действия магазина. Определяет, сколько дней магазин будет активен. Продлевается через бота.
Плоский тариф
Фиксированная стоимость доставки, используемая когда невозможно рассчитать расстояние (нет геолокации)
Работа смены
Режим работы курьера, при котором он получает уведомления о заказах. Начинается через «Начать смену»
Резервирование
Автоматическое «замораживание» товара при оформлении заказа, чтобы он не продался другому клиенту
Реферальная ссылка
Ссылка, по которой клиент переходит в магазин. Связывает клиента с магазином.
Роль
Набор прав доступа в системе (owner, manager, assembler, courier)
Самовывоз
Тип доставки, при котором клиент забирает заказ самостоятельно из магазина/пункта выдачи
Сборщик
Сотрудник магазина, собирающий заказы и отмечающий их готовность
Себестоимость
Цена закупки товара, используемая для расчёта прибыли
Склад-магазин
Тип бизнеса с самовывозом и/или доставкой курьером
Средняя закупочная цена
Автоматически рассчитываемая цена, взвешенная по количеству закупленных товаров
Стоимость доставки
Цена, которую клиент платит за доставку. Рассчитывается по формуле или фиксированная.
Тариф за км
Стоимость каждого километра сверх бесплатного радиуса
Товар
Единица ассортимента магазина, которую клиент может купить
Точка доставки
Место, куда курьер доставляет заказ (доставка в точки)
Уведомление
Сообщение, которое получает сотрудник или клиент при изменении статуса заказа
Формула расчёта доставки
Базовая ставка + (расстояние - радиус) × ставка за км + (вес - порог) × доплата за кг
Хранение
Место на складе, где находится товар/заказ
Экспорт
Выгрузка данных заказов, товаров и остатков в Excel-файл

Типы доставки

Самовывоз
Клиент забирает заказ из магазина или пункта выдачи
Курьерская доставка
Заказ доставляется курьером по адресу клиента
Доставка в точки
Заказ доставляется в указанные пункты выдачи

Роли сотрудников

Owner
Полный доступ ко всем функциям магазина
Manager
Управление товарами, заказами, доставкой, статистика, рассылка
Assembler
Сборка заказов, указание места хранения, отмена готовности
Courier
Приём заказов, навигация, доставка, сообщение о проблемах

Статусы заказов

Новый
Заказ только что создан клиентом
В сборке
Заказ в процессе сборки
Готов
Заказ собран, ожидает курьера или клиента
Курьер назначен
Курьер взял заказ
Курьер забрал
Курьер забрал заказ из магазина
Выполнен
Заказ доставлен/выдан клиенту
Отменён
Заказ отменён (клиентом или владельцем)

Статусы подписки

Активна
Магазин работает
Заморожена
Магазин приостановлен
Истекла
Подписка закончилась