Подписка на регулярные поставки

ТРЕБОВАНИЯ И УСТАНОВКА

Требуются PHP 8.2 или новее, главный модуль main 20.0.0 или новее и установленный модуль «Интернет-магазин» (sale). Эти требования проверяет установщик. Для подписок на товары также нужен работающий товарный каталог: iblock и catalog, товары, доступные покупателям цены и необходимые службы магазина. Поддержка MySQL/MariaDB или PostgreSQL должна обеспечиваться вашей версией и редакцией Битрикса.

Установите решение через Marketplace → Установленные решения. Установщик создаёт таблицы, копирует компоненты, JS и административные обёртки, регистрирует почтовые события, обработчик удаления покупателя и агенты. Страницу личного кабинета и размещение формы на витрине настройте отдельно.

КОМПОНЕНТЫ ВИТРИНЫ

Создайте /personal/subscription/index.php:

```php
<?php
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/header.php';
$APPLICATION->IncludeComponent('ozhogov:subscription.account', '', [
   'SHOW_LOG' => 'Y',
   'SHOW_CLOSED' => 'Y',
   'COUNT' => 20,
]);
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/footer.php';
```

В карточке товара подключите форму, передав ID товара или торгового предложения:

```php
$APPLICATION->IncludeComponent('ozhogov:subscription.form', '', [
   'PRODUCT_ID' => (int)$arResult['ID'],
   'SHOW_SAVING' => 'Y',
   'ACCOUNT_URL' => '/personal/subscription/',
]);
```

ACCOUNT_URL формы задаётся параметром компонента. Адрес личного кабинета в настройках модуля используется для ссылок в письмах: при переносе страницы измените оба адреса. Оформление и управление доступны авторизованному покупателю. Компоненты не кэшируют данные; композит и собственные шаблоны проверьте отдельно на двух учётных записях.

УСЛОВИЯ И ЗАКАЗЫ

В настройках модуля проверьте скидку (5%), минимальный период (7 дней), предел состава (20 позиций), число живых подписок (20) и число оформлений покупателем за сутки (10). По умолчанию изменение состава и пропуск разрешены; ограниченная по дате пауза — до 90 дней, бессрочная пауза также возможна.

Укажите статус новых заказов (по умолчанию N), запас сборки (0 дней), тип плательщика, доставку и платёжную систему. При типе плательщика 0 модуль выбирает активный тип для сайта. При доставке 0 отдельная служба не назначается, при платёжной системе 0 оплата не создаётся: назначьте их в заказе либо настройте идентификаторы заранее. Проверьте фактические заказы, адресные свойства, ограничения служб и оплату на тестовом сайте. Автоматическая остановка после неудач по умолчанию выключена; при её включении порог по умолчанию — три неудачные поставки подряд.

ПРАВА, ПИСЬМА И ПЛАНИРОВЩИК

Выдайте сотрудникам право чтения subscription R или действий W. Дополнительно нужен доступ sale не ниже U; уровень P не поддерживается. Доступ к подписке проверяется по последнему заказу, а до первой поставки — по сайту подписки. Общая статистика требует полного доступа sale W. Действия с существующим заказом требуют права его изменения в sale.

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

Агенты сборки и предупреждений установлены с часовым интервалом, очистки — с суточным. Настройте штатный запуск агентов Битрикса; для регулярных поставок проверьте запуск через cron по правилам своей платформы. Проход сборки проверяет бюджет между заказами, поэтому длительная сборка одного заказа может превышать этот бюджет. Решение не гарантирует точное время физической доставки.

ПРОВЕРКА И ОБНОВЛЕНИЕ

Оформите тестовую подписку, проверьте письмо, состав, сумму и очередную дату; затем паузу, пропуск, изменение состава и отмену. Отдельно проверьте создание заказа, работу доставки и оплаты, ограниченные права сотрудника и сценарий недоступного товара.

При обновлении через Marketplace updater обновляет схему, восстанавливает ранее экранированные названия товаров, регистрирует недостающий обработчик удаления покупателя и переносит компоненты, JS и административные обёртки. Для ручного обновления используйте полный порядок из README модуля: одного копирования файлов или вызова Schema::ensure() недостаточно для регистрации обработчика и переноса общих файлов. Перед обновлением сделайте резервную копию файлов и таблиц; собственные шаблоны компонентов сравните с новой версией.