Руководства

Документация КодЛог

Полное руководство по использованию КодЛог

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

Добро пожаловать в КодЛог! Следуйте этим шагам, чтобы начать работу за 15 минут.

1. Регистрация компании

  1. Перейдите на страницу регистрации или запросите демо-доступ
  2. Заполните данные компании: название, ИНН, контактное лицо
  3. Подтвердите email — вы получите ссылку для активации
  4. Войдите в систему с вашими учётными данными

2. Настройка профиля

  • Компания — название, реквизиты, логотип
  • Регионы — добавьте регионы, в которых работают курьеры
  • Роли — настройте права доступа (admin, manager, courier)

3. Добавление пользователей

Пользователи → Добавить пользователя
├── ФИО: Иванов Иван Иванович
├── Email: ivanov@company.ru
├── Роль: Курьер
├── Регион: Москва и МО
└── → Отправить приглашение

Для массового добавления курьеров используйте импорт из Excel — скачайте шаблон в разделе «Пользователи».

Управление пользователями

Модуль управления пользователями позволяет создавать, редактировать и деактивировать учётные записи.

Роли и права доступа

  • Администратор — полный доступ: пользователи, настройки, все регионы, экспорт, API ключи
  • Менеджер — управление получателями и курьерами в назначенных регионах
  • Курьер — доступ только к мобильному приложению и своим заданиям

Региональный доступ

Каждый пользователь привязан к одному или нескольким регионам. Менеджеры видят только данные своего региона, администраторы — все регионы.

Журнал действий

Все действия пользователей логируются: вход в систему, изменение данных, экспорт, сканирование. Журнал доступен в разделе Настройки → Журнал.

Управление получателями

Получатели — это физические лица, которым доставляются маркированные товары.

Импорт из Excel

  1. Скачайте шаблон: Получатели → Импорт → Скачать шаблон
  2. Заполните обязательные поля: ФИО, СНИЛС, адрес, телефон
  3. Загрузите файл — система валидирует данные и покажет ошибки
  4. Подтвердите импорт
# Формат Excel-шаблона:
| ФИО | СНИЛС | Адрес | Телефон |
|------------------|----------------|--------------------------|------------------|
| Иванов И.И. | 123-456-789 00 | г. Москва, ул. Ленина, 1 | +7(999)123-45-67 |

Статусы получателей

  • Ожидает — получатель создан, коды не отсканированы
  • В процессе — часть кодов отсканирована
  • Подтверждён — все коды отсканированы и верифицированы
  • Отменён — получатель отменён вручную

Коды маркировки

Раздел содержит все отсканированные DataMatrix-коды с полной информацией.

Информация о коде

  • GTIN — глобальный номер товара (14 цифр)
  • Серийный номер — уникальный идентификатор единицы
  • Дата/время — момент сканирования
  • Геолокация — координаты места сканирования
  • Фото — фотоподтверждение доставки
  • Статус ЧЗ — результат верификации через API CRPT
  • Курьер — кто выполнил сканирование

Коды, не прошедшие верификацию Честный Знак, помечаются красным. Проверьте корректность кода или обратитесь в поддержку.

Отчёты и экспорт

Система формирует отчёты в реальном времени с экспортом в XLSX.

Типы отчётов

  • Получатели — полный список с статусами и количеством кодов
  • Коды маркировки — все отсканированные коды с деталями
  • Журнал действий — лог всех операций в системе
  • Статистика по курьерам — количество доставок, сканирований, время работы
Отчёты → Выберите тип → Укажите фильтры:
├── Период: с ___ по ___
├── Регион: Все / конкретный
├── Курьер: Все / конкретный
├── Статус: Все / Ожидает / Подтверждён
└── → Экспорт в Excel

Excel-файлы экспортируются со стилизованными заголовками, автошириной колонок и фильтрами — готовы к печати.

Установка приложения

КодЛог Курьер — мобильное приложение на Flutter для Android и iOS.

Требования

  • Android: 6.0+ (API 23), камера с автофокусом
  • iOS: 12.0+, камера с автофокусом
  • Рекомендуется: камера 8+ МП для надёжного сканирования

Установка

  1. Скачайте из Google Play или App Store → «КодЛог Курьер»
  2. Откройте приложение и введите данные, полученные от администратора
  3. Разрешите доступ к камере и геолокации
  4. Дождитесь синхронизации данных с сервером

Сканирование кодов

Процесс сканирования DataMatrix-кодов маркировки.

# Процесс сканирования:
1. Найдите получателя → поиск по ФИО или СНИЛС
2. Откройте карточку получателя
3. Нажмите «Сканировать код»
4. Наведите камеру на DataMatrix
5. Система автоматически:
├── Распознаёт код (ZXing + ML Kit)
├── Извлекает GTIN + серийный номер
├── Верифицирует через Честный Знак
├── Сохраняет фото с геолокацией
└── Обновляет статус получателя
6. Подтвердите результат

Поддерживаемые форматы

DataMatrix (основной), QR Code, EAN-13, EAN-8, Code 128, Code 39, ITF, UPC-A, UPC-E, PDF417, Aztec.

Функции сканера

  • Автофокус — непрерывная фокусировка на коде
  • Подсветка — встроенный фонарик для тёмных помещений
  • Ручной ввод — ввод кода вручную, если сканирование невозможно
  • Мультисканирование — последовательное сканирование нескольких кодов

Оффлайн-режим

Приложение полностью работоспособно без интернета.

  • Локальная БД — SQLite хранит все данные на устройстве
  • Сканирование — работает без сети, коды сохраняются локально
  • Автосинхронизация — при появлении интернета данные отправляются на сервер
  • Индикатор — счётчик несинхронизированных записей в интерфейсе
  • Конфликты — система автоматически разрешает конфликты при синхронизации

Верификация через Честный Знак недоступна в оффлайн-режиме. Коды будут верифицированы автоматически при синхронизации.

КодЛог Склад — обзор

Модуль складского учёта маркированной продукции с полным контролем на каждом этапе.

Структура склада

Склад
├── Зона приёмки
│ └── Ячейки A1–A20
├── Зона хранения
│ ├── Стеллаж 1 → Ячейки B1–B50
│ ├── Стеллаж 2 → Ячейки C1–C50
│ └── Стеллаж 3 → Ячейки D1–D50
└── Зона отгрузки
    └── Ячейки E1–E10

Возможности

  • Приёмка — сканирование кодов при поступлении, привязка к поставщику и партии
  • Хранение — размещение по зонам и ячейкам, быстрый поиск по местоположению
  • Перемещение — перемещение между зонами с полным аудитом
  • Отгрузка — контроль кодов маркировки при выдаче
  • Инвентаризация — плановая и внеплановая, выявление расхождений
  • Верификация ЧЗ — проверка через API Честный Знак при приёмке и отгрузке

Модуль Склад интегрирован с модулем Маршрутизация — товары, подготовленные к отгрузке, автоматически попадают в пул заявок для распределения по курьерам.

Складские операции

Приёмка товаров

# Процесс приёмки:
1. Создайте документ приёмки → укажите поставщика
2. Отсканируйте коды маркировки товаров
3. Система автоматически:
   ├── Распознаёт код (GTIN + серийный номер)
   ├── Верифицирует через Честный Знак
   ├── Привязывает к партии
   └── Размещает в зону приёмки
4. Подтвердите приёмку

Инвентаризация

  1. Создайте задание: Склад → Инвентаризация → Новая
  2. Выберите зону или весь склад
  3. Отсканируйте все товары в выбранной области
  4. Система сравнит фактические данные с учётными
  5. Просмотрите расхождения и подтвердите результат

Отчёты по складу

  • Остатки — текущее количество товаров по зонам и ячейкам
  • Движение — история приёмок, перемещений и отгрузок
  • Оборачиваемость — скорость движения товаров
  • Расхождения — результаты инвентаризаций

КодЛог Маршрутизация — обзор

Интеллектуальный routing-движок для автоматического распределения заявок и оптимизации маршрутов доставки.

Архитектура

# 5 логических блоков:
1. Подготовка данных → очистка адресов, геокодирование
2. Формирование рейсов → дата, регион, курьеры, лимиты
3. Алгоритм распределения → кластеризация, балансировка
4. Оптимизация последовательности → порядок точек, пробки
5. Мониторинг и аналитика → real-time, план-факт, KPI

Режимы оптимизации

  • Минимальное время — приоритет скорости, для срочных заказов
  • Минимальная дистанция — кратчайший путь, экономия топлива
  • Сбалансированный — баланс времени и дистанции (рекомендуемый)
  • Приоритетный — VIP-клиенты обслуживаются первыми

Ограничения, которые учитываются

  • Временные окна доставки
  • Приоритет заявок
  • Тип доставки
  • Географические зоны
  • Лимит точек на курьера
  • Рабочие часы

Маршрутизация интегрирована с DaData (автодополнение адресов) и Яндекс (геокодирование, учёт пробок). Все запросы выполняются параллельно.

Планирование рейсов

Создание рейса

# Параметры рейса:
Маршрутизация → Новый рейс
├── Дата: 15.02.2026
├── Регион: Москва и МО
├── Курьеры: Иванов, Петров, Сидоров
├── Точка старта: ул. Складская, 1
├── Лимит точек: 30 на курьера
├── Лимит времени: 8 часов
├── Режим: Сбалансированный
└── → Рассчитать маршруты

Ручная корректировка

  • Перенос точки — перетащите точку из одного рейса в другой
  • Изменение порядка — перетащите точку вверх/вниз в списке
  • Пересчёт — система автоматически пересчитает маршрут после изменений

Заявки без координат (не прошедшие геокодирование) не участвуют в автоматическом распределении. Проверьте корректность адресов.

Мониторинг и аналитика

Контроль выполнения маршрутов в реальном времени.

Real-time мониторинг

  • Позиция курьера — отображение на карте в реальном времени
  • Контроль отклонений — уведомление при отклонении от маршрута
  • Фиксация времени — точное время прибытия и завершения на каждой точке
  • Авто-завершение — автоматическое завершение точки по геопозиции
  • План-факт — сравнение плановых и фактических показателей

KPI и метрики

# Доступные метрики:
├── Плановое vs фактическое время маршрута
├── Плановая vs фактическая дистанция
├── Среднее время на точку
├── Процент отклонений от плана
├── SLA выполнения
├── Загрузка курьеров
├── Эффективность распределения
└── Количество перерасчётов

Уведомления

  • Новый рейс — push-уведомление курьеру о назначенном маршруте
  • Перерасчёт — уведомление при изменении маршрута
  • ETA клиенту — автоматическая отправка расчётного времени прибытия
  • Подтверждение — уведомление о завершении доставки

Интеграция с 1С и Excel

Интеграция с 1С

  1. В КодЛог: Настройки → API → Создать ключ
  2. В 1С: установите обработку обмена (поставляется с КодЛог)
  3. Укажите URL API: https://api.kodlog.ru/v1 и ключ
  4. Настройте расписание: ежечасно / ежедневно / вручную
  5. Протестируйте обмен на тестовых данных

Поддерживаемые конфигурации: 1С:УТ, 1С:КА, 1С:ERP.

Обмен через Excel

Для компаний без 1С доступен импорт/экспорт через Excel-файлы. Скачайте шаблон, заполните данные и загрузите в систему.

Интеграция с Честный Знак

Серверная интеграция с API CRPT для верификации кодов маркировки.

Настройка

  1. Получите сертификат в личном кабинете Честный Знак
  2. В КодЛог: Настройки → Честный Знак → Загрузить сертификат
  3. Система автоматически авторизуется через simpleSignIn
  4. Включите автоматическую верификацию

Как работает верификация

# Процесс верификации кода:
Курьер сканирует код → Сервер КодЛог:
├── Парсит DataMatrix → GTIN + Serial
├── Отправляет запрос в API CRPT
├── Получает статус: valid / invalid / not_found
├── Сохраняет результат в БД
└── Отправляет результат в приложение

Решение проблем

Код не сканируется

  • Включите подсветку (фонарик) в сканере
  • Протрите линзу камеры
  • Убедитесь, что код не повреждён и не размыт
  • Держите камеру на расстоянии 10–15 см от кода
  • Используйте ручной ввод как альтернативу

Данные не синхронизируются

  • Проверьте подключение к интернету
  • Убедитесь, что приложение работает в фоне
  • Проверьте свободное место на устройстве
  • Выполните синхронизацию вручную: Настройки → Синхронизация

Ошибка верификации ЧЗ

  • Проверьте актуальность сертификата в настройках
  • Убедитесь, что код введён корректно
  • Проверьте статус API Честный Знак
  • Обратитесь в техподдержку

Нужна помощь?

Поддержка 24/7 — мы всегда на связи