Ошибка 28 «Документ содержит некорректные коды маркировки»: структура кода, регистр символов и проверка через ЧЗ.Бизнес

Ошибка 28 «Документ содержит некорректные коды маркировки» - это отказ системы принять документ из-за проблемы не с логикой цепочки, не с дублированием, а с самим содержимым кода. Система говорит: «один или несколько кодов в этом документе имеют неправильную структуру, и я не могу их обработать». В апреле 2026 года эта ошибка стабильно входит в пятёрку самых частых при работе с ЭДО и маркировкой - и при этом остаётся одной из наименее понятных для пользователей, потому что визуально код на упаковке может выглядеть совершенно нормально.

Чтобы разобраться в ошибке 28, нужно понять, как устроен код маркировки изнутри - какие элементы он содержит, почему регистр символов имеет критическое значение и как быстро локализовать проблемный код в документе с сотнями позиций.

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

Код маркировки - это не просто набор случайных символов. Это строго структурированная строка, каждый элемент которой несёт конкретную смысловую нагрузку. ГИС МТ при получении документа проверяет каждый код на соответствие этой структуре. Любое отклонение - ошибка 28.

Из чего состоит код маркировки

Стандартный код маркировки для большинства товарных групп в России построен по следующей схеме:

Элемент кода	Идентификатор применения (AI)	Длина	Содержание
GTIN	01	14 цифр	Глобальный идентификатор торговой единицы - код товара
Серийный номер	21	До 13 символов	Уникальный номер конкретной единицы товара
Ключ проверки	91	4 символа	Техническая строка для верификации подлинности
Код проверки (крипто-хвост)	92	44 символа	Криптографическая подпись - защита от подделки

Итоговая строка кода выглядит примерно так:

010460406000338521ZbT0Zk7YbA91EE06922dGVxjA/bT6r/xh+kbJkfCYMdhrnStGPk=

Разберём по элементам: 01 - идентификатор GTIN, 04604060003385 - сам GTIN (14 цифр), 21 - идентификатор серийного номера, ZbT0Zk7YbA - серийный номер, 91 - ключ проверки, EE06 - его значение, 92 - идентификатор крипто-хвоста, 22dGVxjA/bT6r/xh+kbJkfCYMdhrnStGPk= - сам крипто-хвост.

Между элементами кода стоят невидимые разделители - управляющие символы ASCII с кодом 29 (групповой разделитель, GS). Именно они отделяют GTIN от серийного номера и серийный номер от ключа проверки. В текстовом представлении эти символы не видны - но система их ищет и проверяет.

Форматы передачи кода: где чаще всего возникает искажение

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

Формат передачи КМ	Как выглядит	Типичное искажение
Полный КМ (с крипто-хвостом)	GTIN + серийник + ключ + крипто-хвост	Обрезка крипто-хвоста, потеря GS-разделителей
Короткий КМ (без крипто-хвоста)	GTIN + серийник	Неверная длина GTIN, лишние символы в серийнике
Base64-кодирование	Строка в Base64	Замена символов +, /, = на URL-safe варианты
Hex-представление	Шестнадцатеричная строка	Смешение регистра (A и a - разные символы)
Строка в XML/JSON документе	Экранированные специальные символы	Двойное экранирование, потеря управляющих символов

Регистр символов: маленькая буква против большой - и почему это не мелочь

Регистр символов в коде маркировки - это не стилистика. Это часть данных. Система маркировки чувствительна к регистру в серийном номере и крипто-хвосте: символ A и символ a - это два разных значения. Замена одного на другой делает код некорректным с точки зрения ГИС МТ.

Откуда берётся проблема с регистром на практике:

• Ручной ввод кода в учётную систему. Оператор вводит код вручную и случайно меняет регистр - или автокоррекция в браузере/операционной системе переводит первый символ в верхний регистр.
• Экспорт и импорт через Excel или CSV. Excel при открытии файла с кодами может применить форматирование ячеек и изменить регистр текстовых строк. Особенно опасен режим «текст в верхнем регистре» при форматировании столбца.
• Преобразование в учётной системе. Некоторые версии 1С и других систем при обработке строк применяют функцию приведения к верхнему или нижнему регистру - это баг в логике обработки кодов маркировки.
• Передача через промежуточный API. Промежуточный сервис интеграции преобразует строки в верхний регистр «для унификации» - и ломает коды маркировки.
• Копирование кода из PDF или email. При копировании текста из PDF некоторые символы могут подменяться визуально похожими из другой кодировки - это меняет не только регистр, но и сам символ.

Допустимые символы в серийном номере: что разрешено, а что нет

Серийный номер кода маркировки - не произвольная строка. Он формируется по стандарту GS1 и может содержать только определённый набор символов.

Категория символов	Допустимые символы	Статус
Цифры	0–9	✅ Разрешены
Латинские буквы верхнего регистра	A–Z	✅ Разрешены
Латинские буквы нижнего регистра	a–z	✅ Разрешены
Специальные символы GS1	! " % & ' ( ) * + , - . / : ; < = > ? _	✅ Разрешены
Кириллица	А–Я, а–я	❌ Запрещены
Пробел	(пробел)	❌ Запрещён
Скобки квадратные	[ ]	❌ Запрещены
Символы национальных алфавитов	Любые не-ASCII	❌ Запрещены

Кириллица в серийном номере - одна из самых коварных ошибок. Буква «С» кириллическая и буква «C» латинская визуально неразличимы в большинстве шрифтов. Оператор вводит вручную и использует кириллическую раскладку - визуально всё выглядит правильно, но символ другой. ГИС МТ видит кириллицу и возвращает ошибку 28.

Полный список причин ошибки 28: от простых к сложным

Систематизируем все источники ошибки 28 - от самых очевидных до тех, которые выявляются только при детальном разборе интеграции.

Группа 1 - Проблемы со структурой кода

• Неверная длина GTIN. GTIN всегда ровно 14 цифр. Если в документе 13 или 15 - ошибка 28 неизбежна. Часто возникает при усечении ведущих нулей (например, 04604060003385 превращается в 4604060003385).
• Отсутствие обязательных идентификаторов применения (AI). Если в строке кода пропущены префиксы 01, 21, 91, 92 - система не может распознать элементы.
• Потеря управляющих символов-разделителей GS (ASCII 29). При передаче кода через текстовые поля, API или Excel невидимые символы GS могут быть удалены как «лишние». Без них элементы кода сливаются в единую строку неправильной структуры.
• Обрезка крипто-хвоста. Криптографическая подпись - 44 символа. Если строка обрезана - хвост неполный. Это происходит при ограничении длины поля в базе данных или при передаче через системы с лимитом длины строки.
• Лишние пробелы в начале или конце строки. Невидимый пробел до или после кода - и система считает код некорректным. Типично при ручном вводе или копировании.

Группа 2 - Проблемы с символами и кодировкой

• Кириллические символы вместо латинских. Как описано выше - визуально идентичные, технически разные.
• Изменение регистра символов при обработке. Приведение к верхнему или нижнему регистру в любом звене цепочки обработки.
• Замена символов при Base64-кодировании. Стандартный Base64 использует символы + и /. URL-safe Base64 заменяет их на - и _. Если система ожидает один вариант, а получает другой - ошибка 28.
• Двойное экранирование в XML. Символ & в XML записывается как &. Если система экранирует его дважды - получается &, и код становится некорректным.
• Перекодировка из UTF-8 в Windows-1251 и обратно. При прохождении кода через системы с разными кодировками часть символов может подмениться визуально похожими из другой таблицы символов.

Группа 3 - Проблемы с источником кода

• Некачественное сканирование DataMatrix. Мятая упаковка, низкое разрешение сканера, бликующая поверхность - сканер считывает код с ошибками и передаёт в систему искажённую строку.
• Нанесение кода с браком у производителя. Редко, но бывает: GTIN или серийный номер, записанный в DataMatrix, изначально содержит ошибку. Такой код не пройдёт ни одну проверку.
• Использование тестового кода в рабочей среде. Тестовые коды, генерируемые в sandbox-окружении ГИС МТ, не являются валидными в продуктивной системе. Если они попадают в реальный документ - ошибка 28.
• Код от другой товарной группы. Структура кода для разных товарных групп может незначительно отличаться. Если в документ попал код, предназначенный для другой группы - система его не примет.

Как локализовать проблемный код в документе с сотнями позиций

Документ с пятьюстами кодами вернулся с ошибкой 28. Система говорит «документ содержит некорректные коды» - но не уточняет, какие именно. Это самая неприятная часть работы с данной ошибкой. Вот рабочий подход.

Метод 1 - Получить детализацию ошибки у оператора ЭДО

Большинство операторов ЭДО при ошибке 28 возвращают не просто код ошибки, но и детальное сообщение - в котором указан конкретный некорректный код или хотя бы его позиция в документе. Это первое место, куда нужно смотреть.

Где найти детализацию:

• Диадок: раздел «Журнал событий» по документу - там полный текст ответа ГИС МТ
• СБИС: карточка документа → вкладка «История» → развернуть событие с ошибкой
• 1С-ЭДО: регистр «Состояния ЭДО» → найти документ → посмотреть сообщение об ошибке
• Прямой API: тело ответа (response body) содержит JSON с полем errors, в котором перечислены проблемные коды

Метод 2 - Проверка каждого кода через ЧЗ.Бизнес

Если детализация не даёт конкретного кода - следующий шаг: проверить коды из документа через официальное приложение ЧЗ.Бизнес. Приложение покажет, находит ли система данный код вообще - и в каком он статусе.

Логика такая: если ЧЗ.Бизнес при сканировании упаковки находит код и показывает корректный статус - значит, проблема не в самом коде, а в том, как он представлен в документе (искажение при передаче). Если ЧЗ.Бизнес возвращает «код не найден» или ошибку - проблема в самом коде или в его источнике.

Результат в ЧЗ.Бизнес	Что это означает	Куда смотреть дальше
Код найден, статус корректный	Сам код валиден - проблема в его передаче в документ	Искать искажение в учётной системе или интеграции
«Код не найден в системе»	Код не существует в ГИС МТ	Проверять источник: сканирование, ввод вручную, производитель
Ошибка распознавания при сканировании	DataMatrix повреждён или нанесён некачественно	Попробовать ручной ввод кода; если не помогает - к производителю
Код найден, товарная группа не совпадает	В документ попал код от другого типа товара	Проверить источник кода, пересмотреть партию

Метод 3 - Проверка через ЛК ГИС МТ (ручной ввод кода)

В личном кабинете ГИС МТ, раздел «Проверка КМ», можно ввести код вручную - текстом, не сканированием. Это важно: если при вводе текстом из документа код находится, а при сканировании той же упаковки - нет, значит проблема в качестве нанесения DataMatrix на упаковке. Обратная ситуация (сканировани�� работает, текст из документа - нет) указывает на искажение кода при передаче в документ.

Метод 4 - Технический анализ строки кода (для разработчиков)

Если ошибка возникает в API-интеграции - можно провести разбор строки кода программными средствами. Проверить:

• Длину GTIN: ровно 14 символов после префикса 01
• Наличие символа GS (ASCII код 29 или \x1d) в нужных позициях
• Регистр символов в серийном номере совпадает с оригинальным кодом из ГИС МТ
• Полноту крипто-хвоста: ровно 44 символа после префикса 92
• Отсутствие символов вне разрешённого набора GS1

Пошаговый алгоритм устранения ошибки 28

Универсальная последовательность - от быстрых проверок к глубокому разбору:

Шаг	Действие	Инструмент	Время
1	Получить детализацию ошибки - какой именно код некорректен	ЛК оператора ЭДО, лог API	5 минут
2	Проверить проблемный код через ЧЗ.Бизнес (сканирование упаковки)	Приложение ЧЗ.Бизнес	2 минуты
3	Сравнить код с упаковки с кодом в документе побайтово	Текстовый редактор с отображением спецсимволов	10 минут
4а	Коды совпадают - искать проблему в структуре (GS-разделители, длина)	Hex-редактор или разработчик	30 минут
4б	Коды не совпадают - найти точку искажения в цепочке обработки	Лог учётной системы, интеграции	От 1 часа
5	Исправить код в документе или исправить логику обработки в системе	Учётная система, разработчик	Зависит от причины
6	Повторно отправить документ с исправленным кодом	ЭДО / API	5 минут
7	Убедиться в успешной обработке, зафиксировать корневую причину	ЛК ГИС МТ	5 минут

Что делать, если исправить код невозможно - упаковка с браком

Иногда DataMatrix на упаковке нанесён с браком настолько, что ни один сканер не может считать его корректно. В этом случае порядок действий следующий: зафиксировать проблему документально (акт о ненадлежащем качестве маркировки), направить претензию поставщику или производителю. Производитель обязан заменить маркировку или переоформить товар с корректными кодами. Продавать товар с нечитаемым кодом нельзя.

Специфика ошибки 28 в разных каналах передачи документов

Ошибка 28 проявляется по-разному в зависимости от того, через какой канал идёт передача. Понимание специфики каждого канала сокращает время диагностики.

При отправке через интерфейс оператора ЭДО вручную

Если оператор ЭДО имеет веб-интерфейс для ввода кодов маркировки вручную - скорее всего, проблема в ручном вводе: неверный регистр, кириллические символы, лишние пробелы. Решение: всегда сканировать упаковку сканером, а не вводить код вручную. Сканер считывает DataMatrix напрямую и не допускает ошибок регистра и подмены символов.

При отправке через 1С или другую учётную систему

Учётная система получает коды через сканер или из базы данных, формирует XML-документ и отправляет его оператору ЭДО. Точки потенциального искажения в этой цепочке:

• Поле в базе данных 1С для хранения кода маркировки имеет ограничение длины - крипто-хвост обрезается
• При формировании XML-документа система применяет экранирование или кодирование - искажает специальные символы
• Компонент для работы с оборудованием (сканером) неправильно передаёт GS-разделители в 1С

Практика показывает: при переходе на новую версию конфигурации 1С или при смене модели сканера штрих-кодов ошибки 28 могут появиться массово там, где раньше всё работало корректно. Это сигнал немедленно проверить форматирование кодов в новой версии.

При отправке через прямой API ГИС МТ

API-интеграция даёт наибольший контроль над форматом передачи, но и наибольшую ответственность. Типичные ошибки в API:

• JSON serialization - библиотека сериализации экранирует символы крипто-хвоста (/ становится \/), длина строки не меняется, но содержимое меняется
• URL encoding - если код передаётся как GET-параметр, символы +, /, = кодируются в %2B, %2F, %3D и не декодируются на другой стороне
• Content-Type mismatch - тело запроса отправляется как text/plain вместо application/json, и система обрабатывает строку иначе

Профилактика: как исключить ошибку 28 системно

Разовое устранение - это хорошо. Системное исключение причины - ещё лучше. Несколько мер, которые работают на практике.

Правило: коды всегда только через сканер, никогда вручную

Административное правило, которое закрывает весь класс ошибок, связанных с ручным вводом: все коды маркировки в систему вводятся исключительно сканированием DataMatrix. Ручной ввод запрещён как операция. Звучит жёстко - но полностью исключает ошибки регистра, подмены символов и опечаток при вводе.

Валидация кодов на входе в систему

В учётной системе или в интеграционном слое должна быть реализована валидация кода маркировки до записи в базу данных. Минимальный набор проверок:

• Длина GTIN ровно 14 символов после 01
• Все символы GTIN - цифры
• Серийный номер содержит только допустимые символы GS1
• Наличие GS-разделителей в нужных позициях
• Длина крипто-хвоста ровно 44 символа
• Отсутствие пробелов в начале и конце строки

Код с ошибкой валидации не должен записываться в базу - его нужно отклонить немедленно и сигнализировать оператору о проблеме. Это на порядок лучше, чем обнаруживать ошибку в момент отправки документа с тысячей кодов.

Выбор сканера с корректной поддержкой DataMatrix и GS-символов

Не все сканеры штрих-кодов одинаково хорошо работают с DataMatrix и управляющими символами. Требования к сканеру для работы с маркировкой:

Параметр	Требование	Примечание
Поддержка DataMatrix	Обязательно	Не все бюджетные сканеры читают DataMatrix
Передача GS (ASCII 29)	Настраиваемая	Нужна настройка в конфигурации сканера
Поддержка GS1-128	Желательно	Для работы с агрегированными кодами
Разрешение матрицы	Не менее 400 dpi	Для мелких DataMatrix на упаковке лекарств
Настройка суффикса/префикса	Отключаемая	Автоматический суффикс может добавить лишний символ к коду

Особенное внимание - настройке передачи символа GS. По умолчанию многие сканеры заменяют управляющий символ GS на обычный пробел или вообще его удаляют. Это нужно отключить через конфигурацию сканера (обычно через программирование сканера специальными штрих-кодами из документации производителя).

Контроль поля для хранения кода в базе данных

Полная строка кода маркировки может достигать 120 символов и более. Если поле в базе данных рассчитано на 100 символов - крипто-хвост будет обрезаться незаметно. Проверьте тип и длину поля: должно быть не менее VARCHAR(200) или аналог. Это элементарная проверка, которую часто упускают при первичной настройке.

FAQ - Частые вопросы об ошибке 28

Ошибка 28 - это проблема одного кода или всего документа?

Система возвращает ошибку 28 на весь документ целиком - но причиной может быть даже один некорректный код из тысячи. Документ не обрабатывается частично: либо все коды в нём корректны и документ принимается, либо хотя бы один некорректен - и документ отклоняется полностью. Именно поэтому так важно быстро локализовать проблемный код методами, описанными выше.

Как понять, что проблема в регистре символов, а не в чём-то другом?

Сравните строку кода из документа с кодом, считанным непосредственно со сканера с упаковки. Если строки отличаются только регистром отдельных символов - вы нашли причину. Для наглядного сравнения используйте текстовый редактор с функцией сравнения строк (diff) - например Notepad++, VS Code или любой онлайн-diff инструмент. Посимвольное сравнение сразу покажет расхождение.

Можно ли исправить код вручную прямо в документе ЭДО?

Зависит от интерфейса оператора ЭДО. Некоторые операторы позволяют редактировать черновик документа до отправки - в этом случае можно исправить код прямо в интерфейсе. Если документ уже отправлен и отклонён - его нужно аннулировать (или он автоматически возвращается в статус черновика) и создать новый с исправленным кодом. Редактировать уже отправленный и принятый документ в ГИС МТ нельзя.

Ошибка 28 возникла после обновления конфигурации 1С - что делать?

Это типичная ситуация: разработчики конфигурации изменили логику обработки строк кодов маркировки, и где-то в новой версии появилось приведение к регистру или обрезка строки. Первый шаг: откатить несколько документов на ту версию конфигурации, которая работала - и сравнить форматы кодов в XML-файлах. Если различие найдено - обращаться к разработчику конфигурации с описанием проблемы. Это их зона ответственности. Второй шаг: проверить настройки компонента сканера в новой версии.

Влияет ли ошибка 28 на статус кодов маркировки в ГИС МТ?

Нет - если документ отклонён с ошибкой 28, никаких изменений статусов кодов в ГИС МТ не происходит. Документ не был принят системой, значит операция не была зафиксирована. Коды остаются в том же статусе и у того же владельца, что и до попытки отправки документа. Это плюс: можно спокойно разобраться с ошибкой и повторить отправку без последствий для истории кодов.

Что такое крипто-хвост и зачем он нужен?

Крипто-хвост (код проверки, AI 92) - это криптографическая подпись, которую ЦРПТ генерирует при эмиссии каждого кода маркировки. Она позволяет системе верифицировать подлинность кода без обращения к центральной базе - достаточно проверить соответствие крипто-хвоста и остальных данных кода. Именно крипто-хвост защищает систему от подделки кодов: невозможно придумать валидный код маркировки, не имея доступа к криптографическим ключам ЦРПТ. Обрезка или искажение крипто-хвоста - немедленная ошибка 28, потому что подпись перестаёт совпадать с данными.

Как проверить, что GS-разделители присутствуют в коде?

В обычном текстовом редакторе символ GS (ASCII 29) не отображается - строка выглядит как сплошная последовательность символов. Для просмотра: откройте Notepad++ и включите режим «Отображение всех символов» (View → Show Symbol → Show All Characters). GS будет отображаться как специальный значок. В VS Code можно установить расширение «Hex Editor» и посмотреть строку в шестнадцатеричном виде: байт 1D - это GS. При отсутствии GS между элементами кода структура нарушена и система вернёт ошибку 28.

Бывает ли ошибка 28 из-за проблем на стороне производителя товара?

Да, и это один из самых сложных случаев, потому что ни покупатель, ни продавец ничего не могут сделать самостоятельно. Если производитель при нанесении DataMatrix допустил ошибку в структуре кода (записал GTIN неверной длины или использовал недопустимые символы), такой код будет давать ошибку 28 при любой попытке его использовать. Решение: зафиксировать проблему, направить претензию производителю с описанием проблемного кода, потребовать замену маркировки или перемаркировку товара за счёт производителя.

Может ли один проблемный код из большой партии заблокировать всю поставку?

Да, именно так и работает логика обработки документа в ГИС МТ - документ принимается целиком или отклоняется целиком. Один некорректный код блокирует весь документ. На практике это означает: при работе с крупными партиями особенно важна предварительная валидация кодов до включения в документ. Лучше потратить минуту на проверку при формировании документа, чем разгребать ошибку после отклонения документа с тысячей кодов.

Ошибка 28 и ошибка 11 - в чём принципиальная разница?

Принципиально разные уровни проблемы. Ошибка 11 - код структурно корректен, система его видит и понимает, но операция с ним в данный момент недопустима по логике цепочки (неверный владелец, неверная последовательность). Ошибка 28 - код некорректен структурно, система не может его распознать и обработать вообще, вне зависимости от состояния цепочки. Если ошибка 11 - это «вы пришли не в ту дверь», то ошибка 28 - это «у вас неправильный ключ».

Существует ли официальный валидатор кодов маркировки от ЦРПТ?

Официального отдельного инструмента-валидатора со стороны ЦРПТ в открытом доступе на апрель 2026 года нет. Функцию проверки выполняют: раздел «Проверка КМ» в ЛК ГИС МТ (проверяет и структуру, и статус в системе), приложение ЧЗ.Бизнес (то же самое в мобильном формате), а также API ГИС МТ для разработчиков. Ряд операторов ЭДО предоставляет собственные инструменты валидации кодов маркировки в своём интерфейсе - уточните у вашего оператора.

Главное об ошибке 28 - коротко и по существу

Ошибка 28 - это всегда история о том, как код маркировки исказился где-то между упаковкой товара и документом в системе. Причин много: регистр, кириллица вместо латиницы, потерянный разделитель, обрезанный крипто-хвост, кривой сканер, баг в интеграции. Но метод работы с ней один: найти конкретный проблемный код, понять, где он исказился, исправить причину - не симптом.

Хорошая новость: ошибка 28 не меняет статусов кодов в ГИС МТ. Документ просто не принят - можно исправлять и пробовать снова без последствий для истории товара. Это делает её технически более безопасной, чем ошибки 11 или 4 - при условии, что вы не пытаетесь обойти систему, а устраняете корневую причину.