Что содержит QR-этикетка
В карточке заказа для каждой позиции формируется подписанная ссылка этикетки. По ней доступны название заказа и поставщика, точка, товар, вариация, артикул, фото, количество, цена и статус позиции. Данные покупателей и комиссия посредника в этикетку не включаются.
Ссылка защищена криптографической подписью HMAC: изменение токена не позволяет подменить заказ или товар. Срок действия создаваемой ссылки — семь дней. После истечения сервер отклонит её, а offline-кэш также не покажет данные.
Какие статусы работают offline
- Начать выкуп — переход в «Выкупается».
- Отметить собранным — переход в «Собран».
- Готово к отправке — переход в «Готов к отправке».
- Отправлено — переход в «Отправлен».
При сетевой ошибке выбранный статус сохраняется только на текущем устройстве и для текущего UID аккаунта. В очередь записываются публичный ID заказа, статус, комментарий и время создания. Суммы, товарные позиции, покупатели и платёжные данные в локальную очередь не записываются.
Как проходит синхронизация
- Верните устройство в сеть и откройте заказ. Событие восстановления соединения запускает синхронизацию автоматически.
- Кабинет последовательно отправляет сохранённые статусы на сервер с проверкой прав и актуального состояния заказа.
- Если сервер уже имеет такой или более поздний статус, запись считается применённой и удаляется из очереди.
- После успеха данные заказа обновляются. При устаревшем или недопустимом переходе запись остаётся для разбора, а кабинет показывает предупреждение.
- Если действие больше не нужно, нажмите «Очистить» в блоке очереди и повторите нужное действие онлайн.
Ограничения и безопасность на устройстве
- Offline-очередь привязана к аккаунту, но физический доступ к разблокированному устройству всё равно нужно защищать.
- Очередь имеет ограничение по количеству и сроку хранения записей; не используйте её как долгосрочный архив.
- Для offline-этикетки нужно сначала успешно открыть её онлайн — неоткрытая ранее ссылка из ниоткуда не появится.
- Срок ссылки проверяется даже без сети. Просроченная этикетка не открывается из кэша.
- Service worker обрабатывает только специальный адрес этикеток и не кэширует остальные API заказов, оплат или кабинета.