В процессе интеграции торгового оборудования, работы с маркетплейсами или складскими системами разработчики 1С часто сталкиваются с задачей конвертации штрихкодов. Типичный пример — необходимость преобразовать более емкий штрихкод формата CODE128 (или хэш-строку типа MD5) в классический 13-значный цифровой код EAN-13.
На первый взгляд задача кажется простой, но при детальном анализе мы упираемся в жесткие математические ограничения стандартов. В этой статье мы подробно разберем, почему прямое конвертирование без потерь невозможно, и рассмотрим практические, надежные способы решения этой задачи в среде 1С.
Давайте проанализируем структуру обоих стандартов штрихкодирования, чтобы понять природу проблемы:
Если ваша задача состоит в том, чтобы «втиснуть» произвольную строку из CODE128 (например, строковое представление MD5-хэша или GUID) в рамки EAN-13, мы сталкиваемся с проблемой «впихивания невпихуемого»:
000000000000 до 999999999999. То есть всего 10 в 12-й степени комбинаций.Попытка напрямую математически «сжать» 128-битный хэш в 12-значное десятичное число неизбежно приведет к возникновению коллизий — ситуации, когда разным исходным строкам будет соответствовать один и тот же штрихкод EAN-13. Для торгового учета это критично, так как сканирование кода приведет к путанице товаров или документов.
Ниже мы разберем несколько эффективных практических подходов, которые позволяют обойти это ограничение в 1С.
Это самый правильный с точки зрения архитектуры баз данных подход. Если вам нужно идентифицировать объект (номенклатуру, характеристику, документ) по коду EAN-13, но в системе он изначально идентифицируется длинной строкой (CODE128 или UUID), не нужно пытаться сжимать саму строку. Вместо этого мы свяжем длинный код с автоматически сгенерированным EAN-13 в базе данных.
Для этого в 1С используется независимый регистр сведений (например, типовой регистр ШтрихкодыНоменклатуры или созданный вручную СоответствиеШтрихкодов).
Рассмотрим алгоритм генерации такого кода по шагам:
Ниже представлен пример функции на встроенном языке 1С для расчета контрольного символа EAN-13:
Функция РассчитатьКонтрольныйСимволEAN13(Штрихкод12) Экспорт
Если СтрДлина(Штрихкод12) <> 12 Тогда
ВызватьИсключение "Для расчета контрольного символа EAN-13 строка должна содержать ровно 12 цифр!";
КонецЕсли;
Четные = 0;
Нечетные = 0;
Для Инд = 1 По 12 Цикл
Цифра = Число(Сред(Штрихкод12, Инд, 1));
Если Инд % 2 = 0 Тогда
Четные = Четные + Цифра;
Иначе
Нечетные = Нечетные + Цифра;
КонецЕсли;
КонецЦикла;
Сумма = Нечетные + Четные * 3;
Остаток = Сумма % 10;
Контрольный = ?(Остаток = 0, 0, 10 - Остаток);
Возврат Строка(Контрольный);
КонецФункции
При сканировании полученного штрихкода EAN-13 система выполняет быстрый поиск по индексу регистра сведений и мгновенно находит исходный объект или длинный GUID.
Если вам критически важно получать штрихкод динамически «на лету» без сохранения связей в базе данных, и вы готовы пойти на минимальный компромисс по уникальности, замените алгоритм MD5 на CRC32.
Контрольная сумма CRC32 представляет собой 32-битное беззнаковое целое число. Его максимальное значение равно 4 294 967 295, что укладывается ровно в 10 десятичных цифр. Это идеально подходит под структуру EAN-13!
Схема формирования такого штрихкода выглядит следующим образом:
[Префикс внутреннего кода "20"] + [10 цифр хэша CRC32] + [1 контрольная цифра EAN]
Начиная с версии платформы 1С 8.3.9, мы можем использовать встроенный объект ХешированиеДанных для быстрого расчета CRC32 без привлечения внешних библиотек и COM-объектов. Рассмотрим пример реализации:
Функция ПолучитьШтрихкодEAN13_CRC32(ВходнаяСтрока) Экспорт
// Шаг 1. Вычисляем хэш CRC32
Хеширование = Новый ХешированиеДанных(ХешФункция.CRC32);
Хеширование.Добавить(ВходнаяСтрока);
// ХешСумма для CRC32 возвращает двоичные данные (4 байта)
ДвоичныеДанныеХэша = Хеширование.ХешСумма;
// Преобразуем полученный массив байт в числовое значение
// Для этого воспользуемся чтением данных
ИмяВременногоФайла = ПолучитьИмяВременногоФайла();
ДвоичныеДанныеХэша.Записать(ИмяВременногоФайла);
ФайлПреобразования = Новый Файл(ИмяВременногоФайла);
ЧтениеДанных = Новый ЧтениеДанных(ИмяВременногоФайла);
ЧисловоеЗначение = ЧтениеДанных.ПрочитатьЦелое32();
ЧтениеДанных.Закрыть();
УдалитьФайлы(ИмяВременногоФайла);
// Получаем беззнаковое представление числа
Если ЧисловоеЗначение < 0 Тогда
ЧисловоеЗначение = ЧисловоеЗначение + 4294967296;
КонецЕсли;
// Шаг 2. Форматируем число до 10 знаков с ведущими нулями
СтрокаХэша = Формат(ЧисловоеЗначение, "ЧЦ=10; ЧДЦ=0; ЧГ=0");
СтрокаХэша = СтрЗаменить(СтрокаХэша, " ", "0");
// Шаг 3. Собираем EAN-13 с внутренним префиксом "20"
ОсноваEAN = "20" + СтрокаХэша;
КонтрольныйСимвол = РассчитатьКонтрольныйСимволEAN13(ОсноваEAN);
Возврат ОсноваEAN + КонтрольныйСимвол;
КонецФункции
Этот способ значительно снижает вероятность коллизий по сравнению с простым «обрезанием» MD5, так как в расчете CRC32 участвует вся исходная строка целиком.
Часто под задачей преобразования «CODE128 в EAN13» скрывается интеграция со службами доставки или государственными системами маркировки. В этих сферах активно используется стандарт GS1-128 (который базируется на CODE128).
Этот штрихкод содержит несколько блоков данных, разделенных специальными идентификаторами применения (AI). Одним из таких блоков является международный код товара GTIN, который по своей сути представляет собой тот же EAN-13, но дополненный ведущим нулем до 14 символов.
Префикс идентификатора применения для GTIN — это последовательность символов (01) или просто 01 в начале штрихкода.
Рассмотрим, как распарсить такую строку в 1С:
Функция ИзвлечьEAN13ИзGS1_128(ПолныйШтрихкод) Экспорт
// Пример входящей строки: "010460123456789310ABC123"
// Где "01" - идентификатор применения GTIN,
// "04601234567893" - сам GTIN (14 символов)
Если Найти(ПолныйШтрихкод, "01") = 1 Тогда
// Отсекаем идентификатор "01"
GTIN = Сред(ПолныйШтрихкод, 3, 14);
// В GTIN первый символ - это индикатор упаковки (обычно "0" для штучного товара)
// Остальные 13 символов - это чистый EAN-13
EAN13 = Правый(GTIN, 13);
Возврат EAN13;
КонецЕсли;
Возврат "";
EndФункции
Таким образом, вам не нужно «сжимать» CODE128. Достаточно проанализировать его структуру по правилам спецификации GS1 и извлечь оригинальный товарный код EAN-13.
Если внешние условия жестко требуют преобразовать любую строку CODE128 произвольной длины в формат EAN-13 без использования баз данных и вы готовы мириться с возможностью дублирования кодов на больших объемах данных, проанализируем алгоритм последовательной свертки (хэширования) символов.
Идея заключается в замене каждого символа его ASCII-кодом, попарном сложении этих кодов и вычислении остатка от деления на 10 для получения цифр штрихкода. Разберем этот алгоритм по шагам:
Этот метод гарантирует получение валидного штрихкода EAN-13, но помните: это крайняя мера, использовать которую в реальном товарном или финансовом учете крайне не рекомендуется из-за высокой вероятности совпадения кодов для разных товаров.
Очень часто разработчики пытаются уйти от формата CODE128 в сторону EAN-13 только из-за того, что CODE128 получается слишком длинным, плохо пропечатывается на маленьких термоэтикетках (например, размером 30х20 мм) или не считывается дешевыми лазерными сканерами.
Для решения этой проблемы не нужно портить данные и заниматься небезопасным сжатием хэшей. Достаточно использовать современные возможности платформы 1С:
Проанализировав все варианты, мы видим, что наиболее надежным решением является ведение регистра сопоставления кодов (Решение 1). Это гарантирует стабильную работу вашей системы без риска возникновения критических ошибок в учете.