Ссылки - QR коды и BAR коды

Система QR- и штрихкодов в CRM используется для идентификации договоров и товаров/услуг через сканирование.
Она позволяет сотрудникам мгновенно получать доступ к задачам и данным без ручного поиска, снижая ошибки и ускоряя работу.

Основная задача системы — превратить каждый объект в управляемую единицу с доступом к данным через одно действие — сканирование.

Где используется

Система маркировки применяется в процессах:

  • логистика (забор и доставка)
  • производство (обработка изделий)
  • склад и приёмка

Поддерживаемые сущности:

  • Договор
  • Товар или услуга внутри договора

Типы кодов

В системе используются два типа кодов:

Штрихкоды (статическая модель)

Штрихкод содержит зашитую строку с привязкой:

contract:{id}
contract_product:{id}

Примеры:

contract:5535
contract_product:8964

Особенности:

  • привязка задаётся в момент печати
  • изменить после печати невозможно
  • каждый код навсегда закреплён за конкретной сущностью
  • один договор или товар/услуга может иметь любое количество штрихкодов

Используется, когда нужна постоянная маркировка.

QR-коды (динамическая модель)

QR-код содержит только UUIDv4.

Особенности:

  • не содержит данных о сущности
  • привязка хранится в базе данных
  • создаётся автоматически при первом использовании
  • может быть привязан к любой сущности
  • можно изменить привязку без сброса
  • можно сбросить и использовать повторно
  • количество переиспользований не ограничено
  • один договор или товар может иметь любое количество QR-кодов

Используется, когда нужна гибкость и повторное использование.

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

Поддерживаются два варианта:

Мобильное приложение

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

Сканер в браузере

  • любой 1D/2D-сканер
  • работает как ввод с клавиатуры
  • не требует дополнительной настройки

Поведение при сканировании

Определение типа кода

Система анализирует входные данные:

  • {string}:{number} → штрихкод
  • {uuid v4} → QR-код
  • иначе → ошибка: “Неверный формат ссылки”

Поведение QR-кода

Если QR не привязан

Открывается форма привязки:

  • выбор договора
  • выбор товара или услуги

Особенности:

  • QR создаётся автоматически при первом сканировании (если его не было в системе)
  • автоподстановка работает:
    • на странице договора — подставляется договор
    • на странице задачи — подставляется связанная с задачей сущность(договор или товар/услуга)
  • пользователь может изменить выбор вручную

Дополнительно:

  • если у сущности уже есть привязанный QR — она подсвечивается оранжевым (для предотвращения дублирования)

Если QR привязан

Открывается страница просмотра данных.

Структура страницы:

Заголовок
Например: Договор #69055 / Товар или услуга #1152121

Eсли у роли пользователя есть разрешение “Ссылки”
Отображаются кнопки: "Почистить QR" и "Редактировать QR"

Задачи

  • список ссылок на задачи
  • пользователь сам выбирает нужную

Связанные данные

Блок Договор: ID, город, статус, фильтры и др. на основе ограничений ролью пользователя

Блок Товары и услуги:

  • если QR привязан к договору → список всех товаров/услуг
  • если к товару/услуге → только этот элемент

Управление QR (разрешение “Ссылки”)

При наличии разрешения доступны действия:

  • Почистить QR — мгновенно удаляет привязку (без подтверждения)
  • Редактировать QR — позволяет изменить привязку без сброса

Особенности:

  • действия доступны прямо на странице (без отдельного экрана)
  • обычно право не выдается линейным сотрудникам, чтобы избежать случайных изменений

Конкурентная привязка

Если два сотрудника одновременно сканируют непривязанный QR:

  • первый, кто сохранил привязку — фиксирует её
  • остальные работают уже с привязанным QR

Поведение штрихкода

При сканировании:

contract_product:1999218

Система:

  • сразу открывает страницу просмотра данных
  • поведение полностью аналогично QR с привязкой

Отличия:

  • нет кнопок управления
  • привязка не может быть изменена

Печать кодов

Штрихкоды

Доступны на страницах:

  • Договоры
  • Задачи

Особенности:

  • печать формируется на основе текущей фильтрации
  • если отфильтровано 10 элементов → будет 10 штрихкодов
  • можно печатать повторно неограниченное количество раз

QR-коды

Печатаются через отдельную страницу:

  • пользователь задаёт количество
  • генерируются UUID
  • отправляются на печать

Дополнительно:

  • можно использовать QR из внешних источников (типография)
  • такие QR создаются в системе автоматически при первом сканировании

Требования к оборудованию

  • принтеры с поддержкой Zebra Browser Print
  • использование шаблонов в формате ZPL

Шаблоны печати

  • настраиваются через интеграции
  • можно создать несколько шаблонов
  • поддерживается любая структура:
    • QR / штрихкод
    • текст
    • подписи
    • произвольная разметка

Редактирование возможно без разработчика при знании ZPL.

Ограничения и особенности

  • изменение привязки штрихкода невозможно
  • QR не имеет визуального состояния:
    • привязан → открываются данные
    • не привязан → форма привязки
  • поиск QR вручную в системе отсутствует
  • история сканирований и перепривязок не сохраняется
  • количество QR не ограничено

Безопасность

  • доступ к данным только после авторизации
  • QR содержит только UUID и не несёт информации сам по себе
  • без доступа к системе данные получить невозможно

Когда использовать

Используйте штрихкоды, если:

  • нужна постоянная привязка
  • объект не переиспользуется
  • есть возможность печати на термопринтере

Используйте QR-коды, если:

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

Итог

Система маркировки в CRM:

  • устраняет ошибки идентификации
  • ускоряет работу сотрудников
  • делает процессы прозрачными
  • масштабирует производство и логистику

Каждое изделие, договор или услуга становится точкой входа в систему — через одно действие: сканирование.