QR-код в 1С: строка оплаты ST00012, генерация через БСП и счёт с QR-кодом

АлгоритмыОпубликовано

QR-код в 1С чаще всего нужен на счёте: покупатель наводит камеру банковского приложения, и платёжка заполняется сама. В статье — как устроена платёжная строка ST00012 по ГОСТ Р 56042-2014 и как собрать её в коде, как получить картинку QR функциями подсистемы БСП «Генерация штрихкода», как вывести код в печатную форму и на управляемую форму и чем такой QR отличается от оплаты по QR-коду через СБП.

Из чего состоит задача «QR-код в 1С»

QR-код — это двумерный штрихкод, в который кодируется строка. Поэтому любая задача с QR в 1С раскладывается на две части: сформировать правильную строку и превратить её в картинку, которую можно вывести на форму или в печатную форму. Для оплаты строка должна соответствовать формату, который понимают банковские приложения, а для картинки в конфигурациях на БСП есть готовая подсистема «Генерация штрихкода». Обычные линейные штрихкоды (EAN-13 и другие) разобраны в статье про штрихкоды в 1С.

Отдельно стоит вопрос «оплаты по QR-коду» в смысле Системы быстрых платежей. Это другая технология: QR СБП выдаёт банк, и сформировать его без банка нельзя. О разнице — в конце статьи.

Формат строки ST00012 для платежей по ГОСТ Р 56042-2014

QR-код на счёте или квитанции, который распознают банковские приложения, построен по стандарту ГОСТ Р 56042-2014 «Двумерные символы штрихового кода для осуществления платежей физических лиц». Строка состоит из трёх блоков: служебного, обязательных реквизитов и дополнительных реквизитов.

Служебный блок

Длина служебного блока — ровно 8 знаков, элементы идут без разделителей:

ЭлементЗнаковЗначение
Идентификатор формата2ST
Версия стандарта40001
Набор кодированных знаков11 — WIN1251, 2 — UTF8, 3 — KOI8-R
Разделитель1По умолчанию |

Отсюда и берётся начало строки ST00012|: формат ST, версия 0001, кодировка UTF-8, разделитель «вертикальная черта». Признак кодировки должен совпадать с тем, как строка реально записывается в QR-код: если генератор кодирует текст в UTF-8, ставьте 2, иначе кириллица в банковском приложении превратится в нечитаемые символы.

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

Каждый реквизит записывается в виде Псевдоним=Значение, реквизиты отделяются разделителем. Обязательные реквизиты идут сразу после служебного блока в строго определённом порядке.

ПсевдонимРеквизитМакс. знаков
NameНаименование получателя (обязательный)160
PersonalAccНомер счёта получателя (обязательный)20
BankNameНаименование банка получателя (обязательный)45
BICБИК (обязательный)9
CorrespAccКорреспондентский счёт банка (обязательный)20
SumСумма платежа в копейках18
PurposeНазначение платежа210
PayeeINNИНН получателя12
KPPКПП получателя9
PayerINNИНН плательщика12

Полный перечень псевдонимов (налоговые реквизиты, КБК, ОКТМО, ФИО и адрес плательщика) приведён в приложении к стандарту. Пример готовой строки:

Пример кода
ST00012|Name=ООО "Ромашка"|PersonalAcc=40702810900000000001|BankName=ПАО "БАНК"|BIC=044525000|CorrespAcc=30101810400000000000|PayeeINN=7700000000|KPP=770001001|Purpose=Оплата по счету № 125 от 10.11.2026, НДС не облагается|Sum=1250050

Сумма 1250050 означает 12 500,50 рубля. Реквизиты в примере вымышленные.

Формирование строки в коде

Строку удобно собирать функцией, которая принимает структуру реквизитов. Важно убрать разделитель из значений: символ | в наименовании или назначении платежа сломает разбор строки.

Пример кода
Функция СтрокаПлатежаГОСТ(Реквизиты) Экспорт

    Части = Новый Массив;
    Части.Добавить("ST00012");
    Части.Добавить("Name=" + ЗначениеДляQR(Реквизиты.Получатель));
    Части.Добавить("PersonalAcc=" + ЗначениеДляQR(Реквизиты.РасчетныйСчет));
    Части.Добавить("BankName=" + ЗначениеДляQR(Реквизиты.Банк));
    Части.Добавить("BIC=" + ЗначениеДляQR(Реквизиты.БИК));
    Части.Добавить("CorrespAcc=" + ЗначениеДляQR(Реквизиты.КоррСчет));

    Если ЗначениеЗаполнено(Реквизиты.ИНН) Тогда
        Части.Добавить("PayeeINN=" + ЗначениеДляQR(Реквизиты.ИНН));
    КонецЕсли;
    Если ЗначениеЗаполнено(Реквизиты.КПП) Тогда
        Части.Добавить("KPP=" + ЗначениеДляQR(Реквизиты.КПП));
    КонецЕсли;
    Если ЗначениеЗаполнено(Реквизиты.Назначение) Тогда
        Части.Добавить("Purpose=" + Лев(ЗначениеДляQR(Реквизиты.Назначение), 210));
    КонецЕсли;
    Если ЗначениеЗаполнено(Реквизиты.Сумма) Тогда
        Копейки = Окр(Реквизиты.Сумма * 100, 0);
        Части.Добавить("Sum=" + Формат(Копейки, "ЧГ=0"));
    КонецЕсли;

    Возврат СтрСоединить(Части, "|");

КонецФункции

Функция ЗначениеДляQR(Значение)
    Возврат СокрЛП(СтрЗаменить(Строка(Значение), "|", " "));
КонецФункции

Формат "ЧГ=0" отключает разделитель групп разрядов: без него число 1250050 превратилось бы в «1 250 050» с неразрывными пробелами, и банк не распознал бы сумму.

В БСП есть готовая функция для этой строки — ФорматнаяСтрокаУФЭБС. В старых версиях библиотеки она находится в модуле УправлениеПечатью, в новых — в модуле с национальной спецификой. Найдите её глобальным поиском и посмотрите, какую структуру реквизитов она ожидает.

Генерация QR программно через БСП

Картинку по строке в типовых конфигурациях рисует подсистема БСП «Генерация штрихкода». Она работает через внешнюю компоненту 1С для печати штрихкодов, которая формирует изображение в формате PNG (описание компоненты есть на its.1c.ru).

Короткий путь: ДанныеQRКода

Функция ДанныеQRКода(QRСтрока, УровеньКоррекции, Размер) возвращает двоичные данные PNG-картинки. В БСП 3.x она находится в общем модуле ГенерацияШтрихкода, в версиях 2.x — в модуле УправлениеПечатью (там у неё может быть дополнительный параметр для текста ошибки).

ПараметрЗначение
QRСтрокаСтрока, которую нужно закодировать
УровеньКоррекции0 — до 7 % повреждений, 1 — 15 %, 2 — 25 %, 3 — 35 %
РазмерДлина стороны картинки в пикселях; если код не помещается, картинка не формируется
Пример кода
&НаСервере
Функция КартинкаQR(СтрокаQR)

    ДвоичныеДанные = ГенерацияШтрихкода.ДанныеQRКода(СтрокаQR, 1, 200);
    Если ДвоичныеДанные = Неопределено Тогда
        Возврат Неопределено;
    КонецЕсли;
    Возврат Новый Картинка(ДвоичныеДанные);

КонецФункции

Полный контроль: ИзображениеШтрихкода

Если нужно управлять фоном, пропорциями или вписать логотип, используйте ГенерацияШтрихкода.ПараметрыГенерацииШтрихкода() и ГенерацияШтрихкода.ИзображениеШтрихкода(Параметры). Для QR тип кода — 16.

Пример кода
Параметры = ГенерацияШтрихкода.ПараметрыГенерацииШтрихкода();
Параметры.ТипКода = 16;              // QR
Параметры.Штрихкод = СтрокаQR;
Параметры.Ширина = 250;
Параметры.Высота = 250;
Параметры.УровеньКоррекцииQR = 1;    // 0 - L, 1 - M, 2 - Q, 3 - H
Параметры.ОтображатьТекст = Ложь;

Результат = ГенерацияШтрихкода.ИзображениеШтрихкода(Параметры);
Если Результат.Результат Тогда
    Картинка = Результат.Картинка;   // также есть Результат.ДвоичныеДанные
КонецЕсли;

Имена полей структуры параметров и их значения по умолчанию описаны в комментарии к функции ПараметрыГенерацииШтрихкода вашей версии БСП. Если конфигурация не содержит БСП, есть два пути: внедрить подсистему «Генерация штрихкода» вместе с компонентой или подключить другую внешнюю компоненту генерации QR.

Счёт с QR-кодом: вывод в печатную форму

В типовых конфигурациях фирмы «1С» печатная форма счёта на оплату уже умеет выводить QR-код с платёжными реквизитами организации — обычно достаточно заполнить реквизиты банковского счёта и включить вывод QR в настройках счёта; конкретное место настройки зависит от конфигурации и релиза. Для своей печатной формы порядок такой:

  1. В макете в нужной области нарисуйте элемент «Рисунок» и задайте ему имя, например QRКод.
  2. При формировании печатной формы получите двоичные данные картинки.
  3. Присвойте картинку рисунку области перед выводом.
Пример кода
ОбластьПодвал = Макет.ПолучитьОбласть("Подвал");

СтрокаQR = СтрокаПлатежаГОСТ(РеквизитыПлатежа);
ДанныеКартинки = ГенерацияШтрихкода.ДанныеQRКода(СтрокаQR, 1, 200);
Если ДанныеКартинки <> Неопределено Тогда
    ОбластьПодвал.Рисунки.QRКод.Картинка = Новый Картинка(ДанныеКартинки);
КонецЕсли;

ТабличныйДокумент.Вывести(ОбластьПодвал);

Размер картинки в пикселях влияет на чёткость, а размер на бумаге задаётся размером рисунка в макете. Для печати берите картинку с запасом (200–300 пикселей) и не растягивайте рисунок непропорционально. Для подключения своей формы к стандартному механизму печати смотрите статью о подключении печати в УТ 11.

QR-код на управляемой форме

Чтобы показать код на форме, создайте реквизит формы типа «Строка», выведите его полем картинки и поместите в него адрес картинки во временном хранилище:

Пример кода
&НаСервере
Процедура ОбновитьQRНаСервере()

    ДанныеКартинки = ГенерацияШтрихкода.ДанныеQRКода(СтрокаПлатежаГОСТ(РеквизитыПлатежа()), 1, 200);
    Если ДанныеКартинки <> Неопределено Тогда
        АдресКартинкиQR = ПоместитьВоВременноеХранилище(ДанныеКартинки, УникальныйИдентификатор);
    КонецЕсли;

КонецПроцедуры

1С: оплата по QR-коду через СБП

QR по ГОСТ Р 56042 и QR Системы быстрых платежей часто путают, хотя работают они по-разному.

QR по ГОСТ (ST00012)QR СБП
Что внутриБанковские реквизиты получателяПлатёжная ссылка, зарегистрированная в СБП
Кто формируетСама программа, без участия банкаБанк получателя по запросу программы
Что делает покупательПриложение заполняет платёжное поручение, человек проверяет и отправляетПодтверждает оплату, деньги приходят за секунды
Статус оплаты в 1СТолько по банковской выпискеМожно получить сразу через банк

QR-коды СБП бывают статическими (одна наклейка, сумму покупатель вводит сам) и динамическими (формируются под конкретную покупку с суммой) — так их описывает оператор СБП. В типовых конфигурациях 1С подключение к СБП реализовано через Библиотеку интернет-поддержки пользователей и сервис «1С:СБП»: программа запрашивает у банка платёжную ссылку, выводит её как QR на экран или в счёт и затем получает статус оплаты. Самостоятельно «нарисовать» рабочий QR СБП по строке нельзя — без регистрации в банке ссылка не будет действительной.

Как проверить готовый QR-код

Перед тем как отдавать доработку пользователям, проверьте код тем же способом, каким им будут пользоваться покупатели. Распечатайте счёт или откройте его на экране и отсканируйте камерой банковского приложения в разделе оплаты по QR. Приложение должно показать получателя, ИНН, банк, назначение платежа и сумму без ручного ввода. Сверьте каждое поле со строкой, которую сформировала программа: если сумма показана в сто раз больше или меньше, значит, ошибка в переводе в копейки; если пустое назначение — проверьте написание псевдонима Purpose точно так, как в стандарте.

Полезно проверить код в двух-трёх разных банковских приложениях: они по-разному относятся к необязательным реквизитам и длине строки. Для печати выбирайте уровень коррекции 1 (около 15 %) — его хватает для обычной бумаги и лазерного принтера. Более высокий уровень повышает устойчивость к повреждениям, но делает код плотнее, и при той же площади на бумаге его модули становятся мельче. Строку отладки удобно временно вывести в комментарий к документу или в сообщение пользователю, чтобы сравнить её с тем, что распознал телефон.

Типичные ошибки

  • Кириллица «кракозябрами» в банковском приложении — признак кодировки в служебном блоке не совпадает с реальной кодировкой строки.
  • Сумма в рублях вместо копеек или с пробелами-разделителями разрядов.
  • Символ «|» внутри значения — строка разбирается неправильно, реквизиты «съезжают».
  • Слишком длинная строка — код становится плотным и плохо читается при печати. Сокращайте назначение платежа и не добавляйте лишние реквизиты.
  • Картинка не сформирована — заданный размер меньше минимально возможного для этой строки; увеличьте Размер или уменьшите уровень коррекции.
  • Ожидание мгновенной оплаты от QR по ГОСТ — это просто заполненная платёжка, поступление видно только по выписке.

Актуальность для новых версий

Формат платёжной строки определяет ГОСТ Р 56042-2014, версия формата в служебном блоке — 0001. Функции генерации QR входят в подсистему БСП «Генерация штрихкода» (общий модуль ГенерацияШтрихкода в БСП 3.x; в версиях 2.x функция ДанныеQRКода находилась в модуле УправлениеПечатью). Подключение к СБП в типовых конфигурациях зависит от релиза конфигурации и Библиотеки интернет-поддержки пользователей.

Частые вопросы

Что означает ST00012 в начале строки QR-кода?

Это служебный блок по ГОСТ Р 56042-2014: ST — идентификатор формата, 0001 — версия стандарта, 2 — кодировка UTF-8. За ним следует разделитель реквизитов, по умолчанию вертикальная черта.

Какие реквизиты обязательны в платёжном QR-коде?

Наименование получателя (Name), номер счёта (PersonalAcc), наименование банка (BankName), БИК (BIC) и корреспондентский счёт (CorrespAcc). Сумму (Sum), назначение (Purpose), ИНН и КПП получателя добавляют как дополнительные реквизиты.

В каких единицах указывается сумма в QR-коде?

В копейках, без разделителей. Сумма 12 500,50 рубля записывается как Sum=1250050. При формировании числа в 1С используйте формат ЧГ=0, чтобы не появились пробелы между разрядами.

Как сгенерировать картинку QR-кода в 1С программно?

В конфигурациях на БСП используйте функцию ГенерацияШтрихкода.ДанныеQRКода(Строка, УровеньКоррекции, Размер), которая возвращает двоичные данные PNG, или ИзображениеШтрихкода с типом кода 16. В старых версиях БСП функция ДанныеQRКода находится в модуле УправлениеПечатью.

Можно ли сделать QR-код СБП без банка?

Нет. QR СБП содержит платёжную ссылку, которую регистрирует банк получателя. В типовых конфигурациях 1С она запрашивается через Библиотеку интернет-поддержки и сервис 1С:СБП. Без банка можно сформировать только QR с реквизитами по ГОСТ.

Почему банковское приложение показывает непонятные символы вместо названия получателя?

Признак кодировки в служебном блоке не совпадает с реальной кодировкой строки. Если генератор кодирует текст в UTF-8, строка должна начинаться с ST00012.

Алгоритмы

Массив в таблицу значений 1С и обратно: структуры, табличные части и Excel

Готовые приёмы преобразования коллекций 1С: массив и массив структур в таблицу значений и обратно, таблица в структуру и соответствие, табличная часть, табличный документ и Excel, а также функции БСП.

Алгоритмы

Работа с датой в 1С программно: текущая дата, начало месяца, формат и разность

Все основные приёмы работы с датой в коде 1С: создание и преобразование, текущая дата, границы периодов, сдвиг и разность дат, форматирование, пустая дата и часовые пояса.

Алгоритмы

Обновление конфигурации 1С: типовой, платформы и сервера

Как обновить типовую конфигурацию 1С с доработками и без, что делать с поддержкой, как обновить базу данных, платформу и сервер 1С без потери данных.

Алгоритмы

Отладка в 1С: точки останова и отладка на сервере

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