Интеграция со СБИС (Retail), ver. 1.0.2

Зачем нужен этот модуль?

Если товарный учёт и чеки вы ведёте в СБИС (Saby) Retail, а сайт работает на 1С-Битрикс — вам нужна синхронизация. Обычно её собирают вручную: кто-то скриптом выгружает товары, кто-то руками прокидывает заказы, остатки обновляются раз в сутки и чаще всего неактуальные.

**Модуль «Интеграция со СБИС (Retail)»** закрывает весь цикл:

- Выгружает каталог СБИС в стандартный XML/YML-файл, готовый для импорта в любой инфоблок Битрикс.
- Обновляет остатки отдельной лёгкой выгрузкой — быстрой и пригодной для запуска раз в несколько минут.
- Отправляет заказы с сайта в СБИС Retail сразу после оформления, чтобы кассир в магазине видел их в общей ленте.
- Позволяет скрыть часть номенклатуры по значению атрибута (например, «Не выгружать на сайт» = «Да»).
- Работает по расписанию через штатные агенты Битрикс, никаких внешних сервисов не требует.

Ключевые возможности

- **Авторизация OAuth.** Используются стандартные поля СБИС: `app_client_id`, `app_secret`, `secret_key`. Токен запрашивается на лету.
- **Полная выгрузка каталога.** Рекурсивный обход разделов прайс-листа, сбор товаров со всеми атрибутами, штрих-кодами, изображениями.
- **XML и YML в одну выгрузку.** Можно включить любой формат или оба — будет сгенерировано до четырёх файлов (каталог + остатки × два формата).
- **Лёгкая выгрузка остатков.** Файл `stocks.xml` / `stocks.yml` только с `id` и `stock` — обновляется отдельно, без перечитывания всего каталога.
- **Отправка заказов в СБИС.** Событие `OnSaleOrderSaved` отправляет заказ через `/retail/order/create`. Товары идентифицируются по артикулу (`nomNumber`). Весовые товары передаются как одна позиция с точной итоговой ценой; граммовка и фасовка попадают в комментарий заказа.
- **Фильтр товаров.** Товары, у которых заданный атрибут СБИС имеет указанное значение, не попадают ни в каталог, ни в остатки.
- **Расписание на агентах.** Создавайте задания на выгрузку каталога и остатков, включайте/выключайте их, задавайте интервал, запускайте вручную из админки. Статус последнего прогона видно на странице «Расписания».
- **Страница ручного запуска.** Кнопка «Выгрузить номенклатуру» + таблица с путями к готовым файлам.
- **Безопасная отдача HTML-описаний.** Абзацы СБИС конвертируются в корректный HTML (внутри CDATA), Битрикс сохраняет структуру текста при импорте в `DETAIL_TEXT`.
- **SSL-проверка настраивается.** По умолчанию проверка сертификата включена; можно отключить для dev-окружений с самоподписанными сертификатами (опция `ssl_verify`).
- **Включение/выключение заказов.** Галка в настройках — быстро поставить интеграцию на паузу, не трогая товары.

Как это работает

1. Создаёте OAuth-приложение в СБИС, копируете три ключа.
2. Устанавливаете модуль в Битрикс через «Установка решений».
3. В настройках модуля вставляете ключи и выбираете нужный прайс-лист из списка (подгружается по кнопке «Загрузить»).
4. Создаёте одно или два расписания: «Каталог раз в сутки» и «Остатки раз в 5 минут».
5. На стороне Битрикс подключаете любой стандартный агент импорта XML/YML к файлу `/upload/sbis/import.xml` — например, `esol.importxml` или встроенный импорт каталога.
6. Включаете галку «Отправлять заказы в СБИС» — новые заказы сразу уходят в retail.

Требования

- Bitrix CMS 20.0 и выше (любая редакция)
- PHP 8.0 и выше
- Расширение cURL (обычно стандартно)
- MySQL / MariaDB с поддержкой `utf8mb4`
- Действующий тариф СБИС Retail с доступом к `/retail/*` API и возможностью создать OAuth-приложение