Инструкция

Посмотреть сведения по коду

Откройте «Проверить QR-код», нажмите «Сканировать QR-код» и наведите камеру на маркировку. Ограниченные сведения о справочных объектах доступны до входа. Проверка QR заявки требует входа и доступа к этой заявке.

• Для тары: наименование, номер, описание и доступность.
• Для зоны погрузки: зона, тип, ворота, расположение и доступность.
• Для парковочного места: номер и состояние.
• Для кода сотрудника или водителя: результат проверки действительности без раскрытия персональных данных.
• Для заявки: сведения доступны только после входа и в пределах вашей роли. Создатель видит только созданные им заявки, водитель — назначенные ему, диспетчер и администратор — все заявки. QR-код не открывает доступ к чужой перевозке.

Распознавание изображения ещё не означает, что объект найден. Портал проверяет поддерживаемый тип и наличие записи. Сообщения «Формат QR-кода не поддерживается» и «Объект по QR-коду не найден» требуют проверки самой маркировки у ответственного за справочник. QR стороннего сервиса не обязан работать в портале.

Если QR заявки возвращает 404, войдите в свою учётную запись под нужной ролью и повторите проверку. Водителю следует уточнить текущее назначение у диспетчера; создателю — проверить, что заявку создал именно он. Если доступ по-прежнему отсутствует, передайте диспетчеру номер заявки и сообщение, не меняя код в ссылке.

Использовать доступную тару или зону

1. Убедитесь, что открылись сведения именно о нужном объекте и он доступен.
2. Для тары нажмите «Добавить тару к грузу». Для зоны выберите «Забрать отсюда» или «Доставить сюда».
3. Если вход ещё не выполнен, войдите как создатель заявок, диспетчер или водитель. Выбранный объект появится в форме новой заявки.
4. Проверьте остальные поля и сохраните заявку отдельной кнопкой.

Перенос объекта доступен создателям заявок, диспетчерам и водителям. Для других типов QR такая подстановка не предусмотрена. Просмотр кода сам по себе не создаёт заявку и не подтверждает забор или доставку.

Если маркировка содержит готовую ссылку проверки портала, её можно открыть обычным переходом, в том числе без JavaScript. Встроенная камера требует JavaScript. В окне сканирования нет поля ручного ввода кода или загрузки фотографии QR. В новой заявке место можно выбрать из справочника; тару создатель заявок или диспетчер может выбрать из списка, а водитель указывает сканированием. Не подменяйте требуемую рабочую проверку публичным просмотром.

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

Сверьте тип объекта, номер тары или зону, ворота и расположение. При несовпадении прекратите подстановку в заявку и сообщите ответственному за маркировку. Успешная публичная проверка означает только найденную запись: она не доказывает соответствие физической наклейки предмету, доступ к перевозке или выполнение её этапа.

Для обращения запишите место проверки, видимый номер объекта и точное сообщение портала. Можно приложить снимок повреждённой маркировки без посторонних данных. Не заменяйте код соседней тары похожим и не редактируйте ссылку, чтобы получить другой результат.

Запустить камеру

1. Откройте портал по HTTPS в браузере с поддержкой камеры и включённым JavaScript.
2. Нажмите кнопку сканирования в нужной операции и разрешите доступ к камере для этого сайта.
3. Выберите «Задняя» или «Передняя». При необходимости нажмите «Включить камеру» либо «Перезапустить камеру».
4. Поместите весь QR-код в кадр, удерживайте устройство спокойно и дождитесь сообщения о результате.

Неактивная кнопка до запуска камеры не означает поломку портала. При бликах измените угол, при размытии немного отодвиньте устройство; очистите объектив и обеспечьте освещение.

Фонарик, масштаб и смена камеры

• После запуска нажмите кнопку с молнией «Включить фонарик», если она доступна. Повторное нажатие «Выключить фонарик» отключает подсветку. Фонарик зависит от выбранной камеры и браузера; при подписи «Фонарик недоступен для этой камеры» используйте внешнее освещение.
• В строке «Масштаб» перемещайте ползунок либо нажимайте «−» и «+». Текущее увеличение показано рядом с названием. Кнопка на границе допустимого диапазона становится неактивной — это нормальное состояние.
• Если устройство передаёт управление масштабом, портал использует диапазон камеры. Иначе доступен цифровой зум от 1× до 4×: подсказка просит держать код по центру рамки. При размытии или обрезанных краях уменьшите масштаб. Цифровое увеличение не восстанавливает детали повреждённой наклейки.
• При сообщении «Не удалось изменить масштаб» сканирование продолжается. Дождитесь окончания изменения, попробуйте меньшее увеличение либо перезапустите камеру. Если недоступен и цифровой режим, ориентируйтесь на подсказку под ползунком.
• «Задняя» и «Передняя» переключают источник изображения. После переключения или перезапуска снова проверьте кадр, фонарик и масштаб: возможности новой камеры могут отличаться, прежняя настройка не является общей настройкой устройства.

Понять сообщение сканера

• «Нет доступа к камере»: измените разрешение сайта в настройках браузера и повторите включение. Проверьте также разрешение камеры для самого браузера в настройках устройства.
• «Камера занята другой программой»: закройте использующее её приложение или другую вкладку, затем повторите попытку.
• «Камера не найдена»: подключите камеру либо откройте портал на устройстве с камерой.
• «Модуль сканирования не загрузился»: проверьте соединение и обновите страницу, предварительно сохранив нужные данные формы.

Код считывается, но не подходит

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

Место в форме создания можно выбрать из списка. Создателю заявок доступен и ручной выбор тары, а водитель заполняет поле «Тара (QR-код)» сканированием: оно доступно только для просмотра. Поле QR места доставки также заполняется сканером и не допускает ручного ввода. Для проверки привязанной тары и доставки в заданное место нужны работающая камера и правильный QR-код. Если конечное место не задано, доставка завершается фотографией места разгрузки с ориентирами; при заданном месте фото не заменяет QR. При отсутствующей маркировке тары свяжитесь с диспетчером: ручного подтверждения для привязанной тары нет.

Закройте окно крестиком «Закрыть» или клавишей Escape: камера останавливается. После успешного применения кода окно закрывается автоматически; проверьте заполненное поле или результат операции. После неподходящего кода окно может остаться открытым с сообщением — исправьте выбор маркировки, а не считайте само распознавание успешным действием.

Подготовить повторную попытку

Закройте окно сканера перед переходом к другой операции. Если разрешение камеры менялось в настройках, заново откройте сканер. Наведите камеру на один код: несколько наклеек в кадре повышают риск считать чужой объект. Масштаб камеры и увеличение страницы жестом двумя пальцами — разные действия.

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

Подготовить код нужного объекта

QR доступен в справочниках тары и мест пользователям, которым разрешён соответствующий раздел. Проверяйте физический объект до подготовки маркировки.

1. Откройте «Тара» или «Места», найдите нужную запись по названию и номеру.
2. Если код ещё не сформирован, нажмите «Создать QR»; если уже есть — «Обновить QR». В окне сверьте название, тип, номер и расположение, если оно показано.
3. Дождитесь проверки записи и успешного формирования изображения. Скачивание доступно после подтверждения создания.
4. Нажмите «Скачать SVG», если нужен файл маркировки, «Открыть карточку», чтобы проверить объект, или «Копировать ссылку», чтобы передать ссылку на проверку.

Ожидаемый результат: файл относится к выбранной записи, а карточка показывает тот же предмет или место. Скачивание не прикрепляет тару к грузу и не подтверждает погрузку. Чтобы перейти к другому объекту, закройте окно и выберите его строку.

Обновление и старые распечатки

После «Обновить QR» старые распечатанные коды продолжают работать. Обновление повторно формирует код той же записи и не меняет её идентификатор. Перепечатывать исправные наклейки не нужно. Права доступа и требования проверки груза или места сохраняются у всех ролей.

Если файл потерян или наклейка повреждена, откройте ту же запись, нажмите «Обновить QR» и скачайте SVG повторно. Не создавайте другой объект ради новой наклейки.

Напечатать и проверить маркировку

1. Скачайте SVG и откройте его в браузере или приложении, поддерживающем печать SVG. Отдельной кнопки «Печать QR» в окне нет.
2. Напечатайте чёрный QR на белом фоне без обрезки белого края и без искажения квадратных пропорций. Подписи размещайте рядом, не поверх кода.
3. Перед печатью тиража считайте бумажный образец через «Проверить QR-код». Сверьте тип и номер с тарой или местом, на которое будет нанесена маркировка.

Ошибки и отсутствие кода

• «Проверяем QR-код…»: дождитесь завершения запроса и формирования изображения. Кнопка скачивания появляется только после успеха.
• «Не удалось загрузить QR-код»: проверьте соединение и нажмите «Попробовать ещё раз» в окне. Повтор не меняет код объекта.
• Просьба войти заново: откройте портал под своей ролью и повторно найдите запись.
• «QR-код недоступен: у записи нет корректного однозначного идентификатора» или отсутствие кнопки QR: попросите администратора проверить данные справочника и возможные совпадения идентификаторов. Изменение масштаба и повторное скачивание не исправят запись.
• «Не удалось создать QR-код»: проверьте загрузку страницы и JavaScript; сохраните нужные данные формы перед повторным открытием страницы.
• Бумажный код не читается: проверьте резкость камеры, освещение, отсутствие бликов и целостность рисунка. Повреждённую или размытую наклейку напечатайте заново из SVG той же записи.

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

Когда появляется QR

При успешном создании тары, места, водителя, создателя заявок или заявки портал сохраняет отдельный неизменяемый идентификатор. QR и ссылка относятся к сохранённой записи. Повтор отправки той же заявки после потери связи не создаёт другой код. После разделения грузов каждая новая заявка получает свой QR; код исходной заявки сохраняется.

Тара использует тип 001001, место погрузки — 001002, стоянка из старой базы — 001003, водитель — 001004, создатель заявок — 001005, заявка — 002001. Начало кода определяет тип, оставшаяся часть — конкретную запись. Не редактируйте код или его начало вручную: действующие наклейки должны продолжать обозначать тот же объект.

У строки груза нет отдельного QR. Для проверки груза водитель считывает код привязанной тары. Если тара не привязана, он подтверждает груз кнопкой «Проверить». QR заявки или сотрудника не заменяет проверку тары, места доставки либо фотографию места без установленной точки.

Как создать QR

1. После сохранения откройте запись: «Тара», «Места», список водителей или создателей заявок либо карточку заявки.
2. Найдите нужную запись и нажмите «Создать QR». Эта кнопка показывается, когда QR ещё не сформирован. Если он уже есть, на её месте будет «Обновить QR» — создавать вторую запись для получения кода не нужно.
3. Дождитесь проверки записи, формирования изображения и подтверждения создания. После успеха кнопка станет «Обновить QR», в том числе после повторного открытия страницы.
4. В окне QR сверьте название, номер и место, если они показаны. Нажмите «Открыть карточку», чтобы проверить, к какой записи относится код.
5. Выберите «Скачать SVG», чтобы сохранить изображение для печати, или «Копировать ссылку», чтобы передать ссылку на проверку записи.

В списках сотрудников действие доступно по правам соответствующего раздела; карточка заявки доступна только пользователям, которым разрешён её просмотр. Для справочника без предусмотренного типа QR кнопки создания нет.

Как обновить QR

1. Откройте ту же запись, для которой уже подготовлен QR, и нажмите «Обновить QR».
2. Дождитесь завершения проверки и формирования изображения. Сверьте запись в окне или через «Открыть карточку».
3. При необходимости скачайте SVG ещё раз или скопируйте ссылку. Обновление удобно, если файл потерян, нужна дополнительная наклейка или прежняя распечатка повреждена.

«Обновить QR» повторно формирует тот же код. Идентификатор записи и содержимое QR не меняются. При пустом поле QR и корректном идентификаторе «Создать QR» готовит маркировку для этого же объекта. Некорректную или неоднозначную запись кнопка не исправляет автоматически.

Работают ли старые распечатанные коды после обновления

Да. После «Обновить QR» старые распечатанные QR-коды продолжают работать и распознаются как та же запись. Перепечатывать исправные наклейки не нужно. Старый и повторно скачанный код обозначают один и тот же объект; обновление не аннулирует прежние распечатки и ссылки.

Это действует для всех ролей с учётом их прав доступа. QR не выдаёт дополнительных разрешений: для просмотра заявки может потребоваться вход, а водитель может выполнять действия только с доступной ему заявкой. Старый код тары по-прежнему проверяет привязанную тару, код места — нужную точку доставки. QR другого типа или другого объекта не подтверждает груз или доставку.

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

Как скачать и напечатать код

1. Откройте «Создать QR» или «Обновить QR» и дождитесь успешного формирования кода.
2. Нажмите «Скачать SVG». Сохраните файл и откройте его в браузере или приложении, которое поддерживает печать SVG. Отдельной кнопки «Печать QR» в окне кода нет; «Печать» в карточке заявки печатает форму заявки.
3. Используйте команду печати в выбранном приложении. Сохраните квадратные пропорции, чёрный код на белом фоне и белый край вокруг изображения. Не обрезайте рамку и не накладывайте подписи на код; название объекта можно разместить рядом.
4. Подберите размер так, чтобы камера уверенно считывала код с рабочего расстояния. Сначала напечатайте один образец и проверьте его до печати всего тиража.
5. Считайте распечатанный код через «Проверить QR-код» на портале. Сверьте тип, название и номер доступной карточки. Для тары проверьте, что наклейка относится именно к той таре, на которую её прикрепляют; для места — к нужной точке.

Для передачи на печать используйте скачанный SVG: он сохраняет чёткость при изменении размера. Скопированная ссылка предназначена для перехода к проверке, а не является готовым изображением для наклейки. Если файл потерялся, скачайте его повторно из той же записи.

QR сотрудника не позволяет войти в портал и не заменяет телефон, пароль или СМС. Проверка такого кода не публикует имя и телефон сотрудника. Ссылка на заявку не предоставляет доступ к чужой заявке: требуется вход и разрешение на её просмотр.

Если что-то не получается

• Если запись ещё не сохранена, сначала завершите создание. При потере связи восстановите результат отправки, прежде чем создавать вторую заявку.
• Если кнопки нет, проверьте, предусмотрен ли QR для этого типа записи и доступен ли вам нужный раздел. Не создавайте дубликат записи, чтобы обойти ограничения.
• Если идёт проверка или создание, дождитесь ответа. При сетевой ошибке нажмите «Попробовать ещё раз»: повтор не создаёт другой код. Если не удалось подтвердить создание, скачивание станет доступно после успешного повтора.
• Если данные записи изменились во время открытия QR, закройте окно и откройте его заново: портал заново проверит текущий код.
• Если распечатка не считывается, проверьте освещение, резкость камеры, отсутствие бликов, целостность рисунка и белого края. Не растягивайте и не обрезайте изображение. Повреждённую наклейку перепечатайте из сохранённого SVG или скачайте его заново.
• Если открывается другой объект или появляется сообщение о неверной таре либо месте, сверьте выбранную запись и наклейку. «Обновить QR» не превращает код другого объекта в нужный. Не подтверждайте груз вручную вместо обязательной проверки привязанной тары; при несоответствии обратитесь к диспетчеру.
• Если истёк сеанс, войдите заново и откройте запись из доступного вам раздела.
• При отсутствии корректного идентификатора, совпадении идентификаторов разных записей или недоступности записи портал не выдаёт QR. Администратору необходимо проверить исходные данные; повторное скачивание не исправляет совпадение. Существующие коды автоматически не переписываются.
• Пометка тары или места на удаление запрещает новый выбор в заявке, но сохраняет проверку уже используемой маркировки. Помеченный или заблокированный сотрудник не получает новую ссылку QR.

Стоянки поддерживаются для чтения существующих кодов, если их справочник присутствует в старой базе. Отдельной формы создания стоянки на портале нет. Для справочников без предусмотренного типа QR код не создаётся.

Для интеграции через API

Для интеграции предусмотрен `GET /api/v1/qr/objects/{type}/{id}`: ответ содержит `id`, `type`, `payload` и относительную ссылку `url`. Используйте `payload` без изменений для изображения QR, а `url` — для перехода. Возможности ключа и права пользователя проверяются отдельно; этот запрос ничего не создаёт и не меняет. `GET /api/v1/qr/objects/{type}/{id}/state` дополнительно возвращает `created`. После успешного формирования изображения `POST /api/v1/qr/objects/{type}/{id}/issue` с `expected_payload` отмечает создание текущего QR; для запроса в личной сессии требуется CSRF. Старые поля записи не меняются.

Проверить, какой код требует действие

1. Откройте нужную назначенную заявку и проверьте её номер, этап и грузы.
2. Для груза с указанной тарой используйте «Считать QR-код тары» у этого груза. Для доставки в заданное место нужен QR именно этой зоны.
3. Дождитесь сообщения о результате, затем проверьте отметку груза или новый этап карточки.

Успешная проверка кода в публичном разделе «QR» показывает, что объект найден. Она не подтверждает, что этот объект относится к текущему грузу, водитель назначен на рейс или действие разрешено на текущем этапе.

Сообщение → что проверить

• «Считайте QR-код тары, указанной у груза, а не другого объекта»: отсканирован код зоны, сотрудника или иной тип. Найдите наклейку указанной тары.
• «Это другая тара — она не соответствует этому грузу»: сравните номер в карточке и на предмете. Не подтверждайте соседнюю тару; сообщите расхождение диспетчеру.
• «У груза указана тара. Подтвердите её только совпадающим QR-кодом»: для привязанной тары ручная отметка не подходит. При утраченной или повреждённой наклейке нужна проверка маркировки ответственным.
• «У этого груза не указана тара. Подтвердите проверку вручную»: используйте ручное действие только у действительно бестарного груза. Не меняйте описание груза ради обхода сканирования.
• «Проверка груза доступна после прибытия на погрузку и до начала перевозки»: сначала проверьте этап. Повторное сканирование на неподходящем этапе не поможет.
• «Сначала проверьте весь груз и тару»: проверьте каждую строку груза, включая несколько грузов в одной заявке.
• «Заявка не назначена этому водителю», «Нет доступа к этой заявке» или изменившийся этап: проверьте роль, назначение и актуальную карточку, затем свяжитесь с диспетчером.

Завершение доставки

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

Если место доставки не задано, водитель нажимает «Закрыть заявку» и делает обязательный новый снимок камерой с грузом и ориентирами. Галерея и загрузка готового файла не предлагаются; при запрете камеры разрешите её в настройках и повторите запуск. Дождитесь «Закрыта» и фотографии «Место завершения.jpg» или «Место завершения.png» в карточке.

Администратор и диспетчер могут выполнить «Закрыть заявку» только из «В пути». Для незаданного места фото и описание необязательны, оба можно оставить пустыми; итог сразу «Закрыта». Для заданного места по-прежнему требуется правильный QR, без замены фотографией или описанием. Если ответ потерялся, сначала проверьте статус и историю той же заявки.

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