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

от Винтра

Купить: 14 900 руб Тестировать (7 дней)

Скриншоты

https://marketplace.1c-bitrix.ru/upload/update/dc2/tjdeos4p2anp1sc77rv733v1pc457ycr/screenshot_1_settings.png

https://marketplace.1c-bitrix.ru/upload/update/33f/pa1clnzdwpkh8s3rvqqlye91v59v7uz1/screenshot_2_schedules.png

https://marketplace.1c-bitrix.ru/upload/update/6f8/m3cs4v4y2j4g9chnnc2pb55mowdndu0t/screenshot_3_export.png

Технические данные

Дата публикации:

08.05.2026

Версия:

1.0.2

Адаптивность:

Нет

Поддержка композита:

Нет

Число установок:

Менее 50 раз

Совместимые редакции

Описание

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

Если товарный учёт и чеки вы ведёте в СБИС (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-приложение

1. Скачайте архив модуля с Bitrix Marketplace.
2. Перейдите в Bitrix-админку: **Настройки → Установка решений** (`/bitrix/admin/partner_modules.php`).
3. Загрузите ZIP-архив или найдите модуль в каталоге маркетплейса.
4. Нажмите «Установить». Установщик создаст таблицу `wintra_sbis_schedules`, скопирует страницы админки в `/bitrix/admin/` и CSS в `/bitrix/css/wintra.sbisintegration/`.
5. После установки в меню **Сервисы** появится раздел **«Интеграция СБИС»**.

2. OAuth-приложение в СБИС

1. Войдите в СБИС (Saby) под администратором.
2. Откройте **Настройки → Интеграции → Внешние приложения → Создать приложение**.
3. Разрешите доступ к Retail API.
4. Сохраните и скопируйте три значения из карточки приложения:
- `app_client_id`
- `app_secret`
- `secret_key`

3. Настройки модуля

Меню **Сервисы → Интеграция СБИС → Настройки**.

1. Вставьте `app_client_id` / `app_secret` / `secret_key`.
2. Нажмите **«Тест подключения к СБИС»** — должно появиться «Токен получен». Если получаете ошибку — проверьте ключи и доступ к `online.sbis.ru`.
3. Рядом с «ID прайс-листа» нажмите **«Загрузить»** — модуль подтянет список прайсов. Выберите нужный.
4. Заполните «Название магазина» и «URL сайта» (URL подставляется автоматически из текущего домена, при необходимости поправьте).
5. Выберите форматы выгрузки (XML и/или YML).
6. При необходимости — заполните «Атрибут-фильтр» и «Значение» (например, атрибут «Не выгружать на сайт», значение «Да»).
7. Если нужно синхронизировать заказы в обратную сторону — поставьте галку «Отправлять заказы в СБИС».
8. Сохраните.

4. Расписания

Меню **Сервисы → Интеграция СБИС → Расписания**.

Создайте задания:

- **Каталог.** Тип `nomenclature`, интервал — в зависимости от размера (обычно раз в 6–24 часа).
- **Остатки.** Тип `stocks`, интервал 1–10 минут.

Задания запускаются системными агентами Битрикс. Убедитесь, что настроен крон:

```
*/1 * * * * php /path/to/bitrix/modules/main/tools/cron_events.php > /dev/null 2>&1
```

5. Импорт на стороне Битрикс

Модуль только **формирует файл**, он не пишет товары в инфоблок. Для записи используйте:

- штатный агент импорта каталога Битрикс, или
- сторонний модуль (`esol.importxml`, собственный handler — что удобнее).

Путь к файлу по умолчанию: `/upload/sbis/import.xml` (и `.yml` — если включены оба формата).

6. Первоначальный запуск

Меню **Сервисы → Интеграция СБИС → Запуск вручную → «Выгрузить номенклатуру»**. Дождитесь ответа, проверьте ссылку на получившийся файл.

Разработчик: Винтра Сайт: https://wintramedia.ru Email: support@wintramedia.ru

Перед обращением в поддержку, пожалуйста, подготовьте: