Мы делаем витрину интернет-магазина на 1С-Битрикс отдельным приложением на Nuxt с серверной отрисовкой, а Битрикс оставляем тем, в чём он силён: админкой, источником данных и обменом с 1С. Данные витрина получает через наш модуль BIK.REST-API — готовый REST API для каталога, фильтра, корзины, заказа и личного кабинета. Шаблоны, где PHP перемешан с HTML, а JavaScript разбросан по десяткам файлов, мы для новых витрин не пишем: их дорого менять, трудно передавать и почти невозможно переиспользовать для мобильного приложения.
главное за минуту
- Битрикс остаётся админкой и обменом с 1С: менеджеры и 1С-специалист работают как раньше.
- Витрина — отдельное приложение на Nuxt с серверной отрисовкой: поисковики и мессенджеры видят готовую страницу.
- Связка — модуль BIK.REST-API: готовые методы вместо своего API под каждый проект.
- Цена подхода — второй стек в команде и новые экраны для модулей маркетплейса. Окупается, когда витрину часто меняют или нужен второй фронт — например, приложение.
- Переход идёт без переезда с Битрикса и без простоя — так мы обновили магазин ЕЦНК.
Что не так с шаблонами, где PHP перемешан с HTML
Классический сайт на 1С-Битрикс собирается из компонентов и их шаблонов. В одном файле template.php живут запрос к данным, условия, вёрстка и кусок скрипта; стили и JavaScript лежат рядом, в папке шаблона, в init.php, в готовом решении из маркетплейса. Через 3–4 года и пару подрядчиков никто уже не знает, какой из 5 скриптов отвечает за кнопку «В корзину».
Отсюда знакомые симптомы. Чтобы поменять карточку товара, фронтенд-разработчик ждёт бэкендера. Чтобы добавить поле в ответ — задача программисту и выкладка. Обновление готового решения затирает правки, а мобильному приложению всё равно нужен API, которого у шаблонного сайта нет. Среди тех, кто приходит на поддержку, мы встречаем магазины на готовых шаблонах с забытыми демо-разделами и чужими реквизитами, со старым PHP и давно не обновлённым Битриксом.
Как обычно на Битриксе и как с BIK.REST-API
Сравнение ниже — со страницы модуля: по каждой типовой задаче видно, где уходят часы программиста.
| Как обычно на Битриксе | С BIK.REST-API |
|---|---|
| Для отдельного фронтенда пишут свой слой API под каждый проект | Готовые методы каталога, корзины, заказа и личного кабинета — более 100 |
| Добавить поле в ответ: задача программисту, правка кода и выкладка | Поле отмечают чипом в админке, кеш сбрасывается сам |
| Документацию для фронтенда пишут вручную, и она устаревает | Swagger / OpenAPI строится из кода и данных сайта, с примерами |
Фильтр каталога — компонент catalog.smart.filter в шаблоне | Значения, счётчики и цены фильтра — одним запросом |
| После выгрузки из 1С фасетный индекс перестраивают вручную | Индекс перестраивается сам после выгрузки и по расписанию |
| Доработки делают в модуле или ядре, при обновлении — конфликт | События «до / после» и свои классы в /local/bik.rest/ |
| Сроки кеша зашиты в компонентах | Сроки кеша задаются в админке, кеш сбрасывается при изменении данных |
Как устроена отдельная витрина
Данные идут той же дорогой, что и раньше: 1С выгружает товары, цены и остатки в Битрикс по обычному обмену. Новое звено одно — модуль BIK.REST-API отдаёт эти данные витрине в виде JSON. Сайт на Nuxt отрисовывает страницу на сервере, поэтому поисковик и превью в мессенджере получают готовый HTML, а не пустую заготовку под скрипты. Подробнее о том, зачем магазину серверная отрисовка, — в статье SSR на Nuxt и REST API для магазина.
Путь данных от учётной системы до покупателя
- 1С товары, цены, остатки, заказы
- обычный обмен , в 1С-Битрикс
- 1С-Битрикс админка и обмен
- , в BIK.REST-API
- BIK.REST-API REST API и документация
- JSON , в сайт на Nuxt
- те же запросы , в мобильное приложение
- сайт на Nuxt серверная отрисовка
- мобильное приложение
Важно, что граница проходит по данным, а не по людям. Контент-менеджер правит товар в админке Битрикса, 1С-специалист не трогает настройки обмена, а фронтенд-разработчик меняет витрину, не залезая в PHP.
| Что остаётся в Битриксе | Что уходит в витрину на Nuxt |
|---|---|
| Каталог, инфоблоки, цены и остатки | Дизайн, вёрстка и анимация |
| Обмен с 1С и фасетный индекс | Страницы каталога, карточка, поиск, фильтр в интерфейсе |
| Заказы, оплаты, службы доставки | Корзина и оформление заказа как экраны |
| Пользователи и права | Личный кабинет как интерфейс |
| Контент: статьи, акции, баннеры | Метатеги, разметка и скорость первого экрана |
Как выглядит запрос к API
Фронтенду не нужно знать, как устроены инфоблоки. Он запрашивает список товаров и получает ровно те поля, которые отмечены в админке. Пример снят с демо-стенда модуля и сокращён; адрес — условный.
curl "https://example.ru/api/iblock/catalog/elements?limit=1" {
"data": [
{
"id": 4,
"name": "Штаны Полосатый Рейс",
"code": "pants-striped-flight",
"section": { "id": 8, "name": "Штаны", "code": "pants" },
"offers": [
{
"id": 42,
"product": {
"quantity": 100,
"price": { "price": 1999, "currency": "RUB", "discount": 0 }
}
}
]
}
],
"pagen": { "total": 10038, "limit": 1, "offset": 0 }
} Тот же ответ получит и мобильное приложение — второй бэкенд под него писать не нужно. Как мы подключаем приложение к работающему магазину, разбираем в статье мобильное приложение к магазину на Битриксе.
- более 100 методов API — каталог, фильтр, корзина, заказ, личный кабинет, формы
- около 10 минут от установки модуля до первого ответа API
- 0 сторонних библиотек — только модули Битрикса, без Composer
- 5 слоёв кеша со сроками в админке
Как это было у ЕЦНК и других клиентов
У ЕЦНК Битрикс остался админкой — контент-менеджеры работают в нём, как раньше, — а покупатели видят новую витрину на Nuxt, которая получает данные через BIK.REST-API. Как мы шли от копии сайта до запуска без простоя, подробно разобрали в статье новый сайт без переезда с Битрикса.
Так же устроены ювелирный клуб VOLNOVA — каталог 5 брендов, конструктор украшений и заказы, которые уходят в 1С, — и закрытый B2B-кабинет Свежесладкого, где API на Битриксе отдаёт каждому оптовому клиенту его цены и остатки из 1С.
Честно о возражениях
У подхода есть цена, и заказчики правы, когда спрашивают о ней. Вот 4 возражения, которые мы слышим чаще всего, и что мы с ними делаем.
«Это двойная стоимость фронта»
Отчасти да: витрину верстают и программируют заново, готовый шаблон из маркетплейса дешевле на старте. Но бэкенд API мы не пишем — модуль его уже содержит, а обмен с 1С и админку не трогаем. Разница окупается на втором редизайне и на первом приложении. Если магазину нужен типовой сайт на 3 года без изменений, мы честно советуем готовое решение.
«Модули маркетплейса со своими шаблонами перестанут работать»
Перестанут — их витринная часть. Логика модуля (доставка, оплата, расчёт) работает в Битриксе и дальше, а экран для неё мы делаем на Nuxt. Поэтому до старта составляем список установленных модулей и для каждого решаем: оставить логику, заменить или убрать.
«Обновления ядра Битрикса что-то сломают»
Доработки под проект живут в /local/bik.rest/ — через события «до / после» и свои классы, а не в коде модуля и ядра, поэтому обновление их не затирает. После обновления ядра мы прогоняем проверку методов API на тестовой копии и только потом выкладываем.
«Нужен второй стек в команде»
Нужен: к PHP добавляется JavaScript и Nuxt. Зато роли разделяются: фронтенд-разработчику не нужно знать Битрикс, бэкендеру — вёрстку. В проектах, где это оговорено, мы передаём заказчику исходники витрины, а модуль работает по лицензии.
Как мы переходим на отдельную витрину
-
Аудит
Смотрим обмен с 1С, версии PHP и Битрикса, установленные модули и старые адреса страниц.
-
Копия и обновление
Переносим сайт на тестовую копию, обновляем PHP и Битрикс, ставим и настраиваем BIK.REST-API.
-
Дизайн и витрина
Делаем макеты и собираем витрину на Nuxt на реальном каталоге из админки.
-
SEO-подготовка
Карта сайта, robots, шаблоны метатегов и 301 со старых адресов.
-
Запуск
Переключаем домен на новую витрину без простоя, старый сайт держим под рукой.
Разработку магазина под ключ, от аудита до поддержки после запуска, мы описали на странице разработка интернет-магазинов.
Если отмечено 4 пункта и больше, отдельная витрина почти наверняка окупится. Если 3 — подход оправдан, когда среди отмеченных есть приложение или частые редизайны; иначе сравните его с обновлением текущего сайта. Если 1–2, сначала стоит навести порядок в текущем сайте.
Я считаю, что Битрикс хорош как склад данных и плох как конструктор витрины. Мне кажется, когда его не заставляют делать и то и другое, витрину проще менять, а 1С-специалисту спокойнее: редизайн не задевает его обмен.
Частые вопросы
Что такое headless 1С-Битрикс?
Схема, где Битрикс отвечает за данные, админку и обмен с 1С, а витрину показывает отдельное приложение — сайт на Nuxt или мобильное приложение — через REST API. Официального headless-режима у Битрикса нет, поэтому нужен свой слой API; у нас это модуль BIK.REST-API.
Подходит ли модуль для Битрикс24?
Нет. BIK.REST-API работает с «1С-Битрикс: Управление сайтом» и требует PHP 8.0 и выше. Требования — на странице модуля.
Придётся ли переделывать обмен с 1С?
Нет. Обмен остаётся в Битриксе как есть; модуль только отдаёт витрине то, что уже лежит в инфоблоках, и сам перестраивает фасетный индекс после выгрузки.
Не потеряет ли сайт позиции в поиске при смене витрины?
Витрина на Nuxt отрисовывает страницы на сервере, так что поисковик получает готовый HTML. Остальное — SEO-подготовка до запуска — карта сайта, метатеги и 301 со старых адресов, как мы сделали для ЕЦНК.
Можно ли потом дорабатывать API под свой проект?
Да. Доработки делаются через события «до / после» и свои классы в /local/bik.rest/ — они живут отдельно от модуля и не затираются при обновлении.








