Руководства

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

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

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

Добро пожаловать в КодЛог! Следуйте этим шагам, чтобы начать работу за 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 хранит все данные на устройстве
  • Сканирование — работает без сети, коды сохраняются локально
  • Автосинхронизация — при появлении интернета данные отправляются на сервер
  • Индикатор — счётчик несинхронизированных записей в интерфейсе
  • Конфликты — система автоматически разрешает конфликты при синхронизации

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

Интеграция с 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 — мы всегда на связи