1. Назначение и модель работы

Модуль автоматизирует полный цикл работы со счетом: определяет подходящее правило для конкретной оплаты заказа, формирует PDF, сохраняет его в постоянном архиве, отправляет покупателю, при необходимости направляет копию в бухгалтерию и предоставляет защищенное скачивание из личного кабинета.

2. Что нового в 2.2.1

Приемочный тест на конкретном магазине все равно рекомендуется: реальные коды свойств заказа, платежные системы, права файловой системы и SMTP-настройки отличаются между проектами.

3. Системные требования, установка и обновление

php -v
php -m | grep -E "^(dom|mbstring)$"

Новая установка

1. Скопируйте каталог bussol.score2 в /bitrix/modules/.
2. Установите решение в административной части Битрикс.
3. Откройте Bussol → Bussol: Счет заказа в PDF и отправка на почту → Настройки.
4. Для каждого SITE_ID настройте правила, реквизиты, свойства покупателя, PDF и почту.
5. Выполните тестовый заказ.

Обновление до 2.2.1

Переустановка не требуется: замените каталог /bitrix/modules/bussol.score2/ файлами версии 2.2.1. При первом подключении RuntimeInstaller синхронизирует публичный компонент личного кабинета, страницу управления шаблонами и защищенный tool-файл, а также регистрирует обработчик OnSalePaymentEntitySaved, если он еще не зарегистрирован.

4. Меню, права и многосайтовые настройки

Модуль расположен в отдельном верхнеуровневом разделе Bussol. Общая иконка Bussol сохраняется прежней; у самого модуля используется иконка SCORE2.

Все настройки сохраняются отдельно для каждого SITE_ID. Интерфейс содержит вкладки: Основные, Правила запуска, Компания, Покупатель, Отображение, QR-код, Письмо, Бухгалтерия, Личный кабинет.

5. Правила запуска

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

Для совместимости со старыми установками настройка одной платежной системы используется как базовое правило до первого сохранения нового набора правил. Обработчик изменения оплаты позволяет правилу с условием «Оплачен» сработать позже, когда платежная система изменит состояние платежа.

6. Пользовательские PDF-шаблоны

В разделе Шаблоны PDF можно создавать несколько HTML-шаблонов для каждого сайта. Пользовательский шаблон выбирается в правиле запуска или как шаблон по умолчанию.

Синтаксис шаблона

{{#items}}
<tr>
  <td>{{@index}}</td>
  <td>{{name}}</td>
  <td>{{quantity}}</td>
  <td>{{price}}</td>
  <td>{{sum}}</td>
</tr>
{{/items}}

{{#show_qr}}{{#qr}}
<img src="{{qr}}" style="width:120px">
{{/qr}}{{/show_qr}}

7. Реквизиты, данные покупателя и состав PDF

Компания

Можно настроить наименование компании / ИП, адрес, ИНН, КПП, банк, БИК, расчетный и корреспондентский счета, телефон, email отправителя, ФИО руководителя и главного бухгалтера, а также изображения логотипа, печати и подписи.

Если email отправителя компании не заполнен, модуль использует email сайта, затем — email из настроек Главного модуля Битрикс.

Покупатель

Состав стандартного PDF

Денежные значения форматируются штатными средствами Битрикс. HTML-сущности декодируются, поэтому в PDF выводятся реальные пробелы и знак валюты, а не строки вида   и ₽.

8. QR-код и сумма прописью

QR-код

QR включается на отдельной вкладке и доступен во встроенном и пользовательских шаблонах. Генерация выполняется локально внутри модуля — внешний QR-сервис и интернет-доступ не нужны.

Для платежного режима необходимы как минимум наименование получателя, расчетный счет и БИК.

Сумма прописью

Переключатель «Сумма прописью» находится на вкладке Отображение. Для рублей учитываются формы «рубль / рубля / рублей» и «копейка / копейки / копеек».

15 599,00 ₽
→ Пятнадцать тысяч пятьсот девяносто девять рублей 00 копеек

В пользовательском шаблоне используются {{total_words}} и {{show_total_words}}.

9. Email покупателю и копия для бухгалтерии

Отправка покупателю

Автоматическая отправка выполняется фоновым заданием Битрикс. После события сохранения заказа или оплаты модуль повторно загружает заказ из базы и работает с уже сохраненным состоянием свойств и оплат.

Копия для бухгалтерии

10. Скачивание счета покупателем из личного кабинета

Модуль устанавливает компонент bussol.score2:personal.invoice. Он может показывать счета конкретного заказа или список доступных счетов текущего пользователя.

<?php
$APPLICATION->IncludeComponent(
    "bussol.score2:personal.invoice",
    "",
    [
        "ORDER_ID" => (int)($_REQUEST["ID"] ?? 0),
        "SHOW_TITLE" => "Y",
    ]
);
?>

Файл выдается через /bitrix/tools/bussol.score2_invoice.php по подписанной ссылке. Перед выдачей проверяются авторизация пользователя, принадлежность заказа текущему пользователю, разрешение правила и допустимый путь файла.

11. Автоматическая обработка, статусы и защита от дублей

События OnSaleOrderSaved и OnSalePaymentEntitySaved ставят заказ в отложенную обработку. Один и тот же заказ в рамках запроса не ставится в очередь повторно. Фоновая задача загружает заказ заново и передает его в сервис обработки.

Записи NEW, GENERATED и ERROR не блокируют последующую автоматическую попытку. Если PDF уже существует, модуль может использовать сохраненный файл вместо лишней повторной генерации.

12. Архив счетов и административные действия

Страница Счета выводит до 200 записей журнала с сортировкой по ID, дате создания или дате отправки.

Действия

13. Макросы и переменные пользовательского шаблона

Макросы строковых настроек

Основные группы данных PDF-шаблона

Недопустимые символы в имени PDF заменяются на _. Если расширение .pdf не указано, оно добавляется автоматически. Для заказа с несколькими внешними оплатами модуль предотвращает конфликт имен файлов, добавляя ID оплаты при необходимости.

14. Хранение данных, безопасность и диагностика

Хранение

Безопасность

Диагностика

Ошибки фоновой обработки, автоматической отправки и QR передаются в стандартный AddMessage2Log с меткой bussol.score2.

15. Чек-лист запуска

Перед вводом модуля в эксплуатацию пройдите проверку на копии магазина, затем повторите критичные пункты на рабочем сайте.

• PHP 8.2+; расширения dom и mbstring доступны.
• Битрикс 26+; установлен модуль sale.
• Для каждого SITE_ID включен модуль и настроены правила запуска.
• Правила проверены на нужных платежных системах, статусах и состоянии оплаты.
• Заполнены реквизиты продавца, логотип, печать и подпись.
• Коды COMPANY/FIO/EMAIL/PHONE/INN/KPP/ADDRESS соответствуют реальным свойствам заказа.
• Стандартный или пользовательский PDF-шаблон проверен на реальном заказе.
• Суммы и символ валюты отображаются корректно.
• Сумма прописью выводится в нужном формате.
• Если используется QR — он формируется и считывается для реальных реквизитов.
• Письмо покупателю получено с PDF-вложением.
• Если включена бухгалтерия — копия получена на нужных адресах.
• Проверены «Отправить повторно», «Переформировать PDF» и ручная бухгалтерская копия.
• PDF остается в архиве после отправки.
• Компонент личного кабинета показывает счет владельцу заказа и не выдает его постороннему пользователю.
• Проверено отсутствие автоматического дубля письма при повторном сохранении заказа.
• На многосайтовом проекте проведен отдельный тест для каждого сайта.
• Прямой HTTP-доступ к /upload/bussol.score2/ закрыт.
• Права групп на модуль соответствуют ролям сотрудников.