BIRKA WMS — сканирование ЧЗ (КИЗ)
BIRKA WMS — бесплатный онлайн-сканер кодов маркировки «Честный знак». Он читает DataMatrix камерой телефона или веб-камерой, разбирает код по стандарту GS1 и отдаёт строку, которую примут Wildberries, Ozon, «Честный знак» и учётные системы: с невидимыми GS-разделителями (ASCII 29) на своих местах. Из того же кода сервис печатает этикетку в PDF для термопринтера — по умолчанию 58 × 40 мм.
Распознавание идёт полностью в браузере (движок ZXing в WebAssembly). Коды маркировки не отправляются на сервер, не сохраняются и не попадают в чужие руки — история хранится только в вашем браузере.
GS-разделитель: главная причина ошибок с КИЗ
Код маркировки — это не просто строка символов, а последовательность полей стандарта GS1. Поля переменной длины должны заканчиваться служебным символом GS (Group Separator, ASCII 29, 0x1D). Его не видно ни в блокноте, ни в Excel, ни в поле ввода — но именно по нему система понимает, где заканчивается серийный номер и начинается криптохвост.
Wildberries прямо предупреждает продавцов:
«Проверьте, что ваш сканер поддерживает передачу GS-разделителей. Иначе КИЗ будет считываться с ошибками и не пройдёт проверку».
Разделители теряются в четырёх типовых ситуациях:
- код скопировали из Excel, Word, мессенджера или из письма — управляющие символы вырезаются;
- сканер работает в режиме «клавиатура» и не настроен на передачу GS;
- код перепечатали руками с этикетки — GS набрать с клавиатуры невозможно;
- код прочитали библиотекой, которая отдаёт «текст», а не сырые байты символа.
Этот сервис читает сырые байты DataMatrix, поэтому GS сохраняются. Если разделителей в коде не было, он честно об этом скажет и восстановит структуру по длинам полей — криптохвосты «Честного знака» имеют фиксированную длину, поэтому границы вычисляются однозначно.
Структура кода маркировки
| Поле | Что это | Длина | GS после поля |
|---|---|---|---|
| (01) | GTIN — код товара | 14 цифр | не нужен |
| (21) | Серийный номер единицы товара | до 20 символов, обычно 6 или 13 | нужен |
| (8005) | Цена в копейках (табак) | 6 цифр | не нужен |
| (91) | Ключ проверки | 4 символа | нужен |
| (92) | Значение проверки (криптоподпись) | 44 символа | последнее поле |
| (93) | Код проверки для молока, воды, пива | 4 символа | последнее поле |
Полный код маркировки (КМ) = код идентификации (01 + 21) + код проверки (91 + 92 либо 93). Код идентификации для большинства групп занимает 31 символ; криптохвост генерирует оператор «Честного знака», самостоятельно его придумать нельзя.
Проверка КИЗ перед поставкой FBS на Wildberries
- убедитесь, что сканируете именно КИЗ (DataMatrix «Честного знака»), а не баркод товара и не стикер заказа;
- проверьте, что в строке есть GS — сервис показывает их количество;
- сверьте GTIN на этикетке с GTIN в карточке товара: контрольная цифра проверяется автоматически;
- не сканируйте один и тот же КИЗ дважды — история на этой странице предупредит о повторе;
- если WB отвечает «неподходящий формат» при корректном коде — вводите КИЗ сканером прямо в поле кабинета, а не вставкой из буфера.
Размеры этикеток для печати
Сервис формирует PDF ровно того размера, который вы выбрали, — страница PDF равна этикетке, поэтому термопринтер печатает без масштабирования и полей. Макет стандартный: DataMatrix слева, под ним код в две строки, справа знак «Честный знак» и реквизиты. Дополнительно можно включить ИП, ИНН, наименование, артикул и штрихкод (ШК): внутренний баркод Wildberries и Ozon печатается в Code 128, товарный — в EAN-13.
| Размер | Где применяется |
|---|---|
| 58 × 40 мм | основной размер для маркетплейсов, помещается код и подписи |
| 40 × 30 мм | мелкий товар, косметика, аксессуары |
| 43 × 25 мм | узкая лента, минимум подписей |
| 58 × 60 мм | когда нужно название товара и состав |
| 30 × 20 мм | минимальный размер, только код |
| 100 × 150 мм | лист, короб, транспортная упаковка |
Требования к печати: модуль DataMatrix — не меньше 0,255 мм, сторона кода — от 12–15 мм, свободное поле вокруг кода — от 2 мм. Сервис считает эти величины для выбранной этикетки и предупреждает, если код получится нечитаемым.
Частые вопросы
Что такое GS-разделитель в коде маркировки и зачем он нужен?
GS (Group Separator, ASCII 29) — невидимый служебный символ, отделяющий поля переменной длины в GS1 DataMatrix. В коде «Честного знака» их обычно два: после серийного номера (21) и после ключа проверки (91). Без GS система видит один слипшийся блок данных и отвечает ошибкой «неподходящий формат кода».
Почему КИЗ не проходит проверку на Wildberries при поставке FBS?
Частые причины: код скопирован из Excel и потерял GS; сканер не передаёт служебные символы; вместо КИЗ передан внутренний штрихкод товара или только GTIN; код не введён в оборот или уже выбыл. Первые две причины проверяются прямо на этой странице.
Как проверить, передаёт ли мой сканер GS-разделители?
Откройте блок «Ввести / сканер-пистолет» и отсканируйте КИЗ в поле ввода. «GS получено: 2» — сканер настроен верно; «GS получено: 0» — включите в настройках сканера передачу GS (режимы GS1 / AIM ID / Transmit AIM code) или замените сканер.
Можно ли сканировать DataMatrix камерой телефона без приложения?
Да. Страница использует движок ZXing в WebAssembly и читает сырые байты символа, поэтому разделители не теряются. Нужен браузер с доступом к камере по HTTPS; распознавание идёт локально, код никуда не отправляется.
Что копировать в Wildberries: полный код или только серийный номер?
В кабинет передаётся код маркировки целиком, со всеми служебными символами. Серийный номер и код идентификации (01 + 21) удобны для учёта и сверки, но не заменяют полный КИЗ.
Код на этикетке потёрт и не читается — что делать?
Нажмите «Не сканируется? Сфотографировать»: снимок обрабатывается несколькими способами — растяжение контраста, бинаризация по Оцу, увеличение в 2–3 раза. Помогает также фонарик, съёмка под углом (уходит блик) и расстояние 10–15 см от кода.
Какой размер этикетки выбрать и почему код может не сканироваться после печати?
Для маркетплейсов чаще всего берут 58 × 40 мм. Главное — размер модуля DataMatrix: он должен быть не меньше 0,255 мм, а сторона кода — от 12–15 мм. Сервис считает обе величины для выбранной этикетки и предупреждает, если код получится нечитаемым: например, на 30 × 20 мм со всеми включёнными подписями модуль выходит около 0,16 мм — такой код печатать нельзя.
Какой штрихкод нужен для Wildberries и Ozon?
Внутренний баркод, который площадка выдаёт в кабинете, печатается в Code 128 — до 20 символов, допускаются латинские буквы и цифры. Заводской товарный штрихкод — EAN-13, 13 цифр. В блоке печати можно включить поле «Баркод (ШК)» и выбрать формат; если ввести 12 цифр для EAN-13, контрольная цифра посчитается сама.