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 знаков, элементы идут без разделителей:
| Элемент | Знаков | Значение |
|---|---|---|
| Идентификатор формата | 2 | ST |
| Версия стандарта | 4 | 0001 |
| Набор кодированных знаков | 1 | 1 — 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 в настройках счёта; конкретное место настройки зависит от конфигурации и релиза. Для своей печатной формы порядок такой:
- В макете в нужной области нарисуйте элемент «Рисунок» и задайте ему имя, например
QRКод. - При формировании печатной формы получите двоичные данные картинки.
- Присвойте картинку рисунку области перед выводом.
ОбластьПодвал = Макет.ПолучитьОбласть("Подвал");
Строка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.