1С-Битрикс умеет выгружать каталог интернет-магазина прямо в раздел «Товары» сообщества ВКонтакте — без ручного заведения карточек и без сторонних сервисов. Функция входит в модуль «Интернет-магазин» (sale) и работает через официальный API ВКонтакте: Битрикс сам создаёт товары, подборки и поддерживает их в актуальном состоянии. Разберём, где включается выгрузка, что нужно подготовить на стороне сообщества и как настроить сопоставление свойств и синхронизацию.
Что даёт выгрузка товаров во ВКонтакте
Раздел «Товары» сообщества ВКонтакте — это встроенная витрина, где карточки открываются прямо внутри соцсети, а покупатель пишет продавцу или переходит на сайт. 1С-Битрикс формирует эти карточки автоматически из вашего торгового каталога: название, описание, цена, фотографии и категория берутся из инфоблока и передаются в VK по API.
Это не файл-фид, как YML для Яндекса, а прямая интеграция через API: Битрикс вызывает методы market.add, market.edit, market.delete и создаёт товары в сообществе. Поэтому выгрузка двунаправленно управляется из админки магазина — добавили товар на сайте, он появился в VK; сняли с продажи — скрылся и там.
Подготовка сообщества ВКонтакте
Перед настройкой в Битриксе на стороне ВКонтакте должны быть выполнены три условия, иначе API не примет товары:
- Включён раздел «Товары». В управлении сообществом (
Управление → Настройки → Разделы) активируется блок «Товары» — в базовом или расширенном режиме. - Заданы параметры магазина. Валюта, регион доставки, контакт для связи и способ оформления заказа (сообщение, корзина VK или переход на сайт).
- Права на управление. Токен доступа должен принадлежать администратору сообщества с правом на товары (
market).
Расширенный режим товаров нужен, если вы хотите использовать свойства и вариации (размеры, цвета) — он ближе к структуре торговых предложений Битрикса. Базовый режим ограничен простыми карточками без вариантов.
Подключение и токен доступа
Связь Битрикса с сообществом строится на ключе доступа (access token) приложения ВКонтакте. Общий порядок такой:
- В
vk.com/apps?act=manageсоздаётся Standalone-приложение — оно выступает «посредником» между сайтом и API. - Через диалог авторизации приложение получает токен с правами
market,photos,groupsиoffline(бессрочный ключ). - Полученный токен и числовой ID сообщества вносятся в настройки интеграции на стороне Битрикса.
В самом магазине настройки собраны в разделе Магазин → Настройки → Настройки товаров ВКонтакте (в зависимости от редакции и версии — в блоке интеграций модуля sale). Здесь указываются токен, ID группы, тип цены и инфоблок-источник.
market позволяет менять товары сообщества. Не публикуйте его в шаблонах и логах, а при смене администратора выпускайте токен заново.Сопоставление каталога и категорий
Товары ВКонтакте требуют, чтобы у каждой карточки была категория из справочника VK — произвольные разделы инфоблока туда не переносятся напрямую. Поэтому ключевая часть настройки — сопоставить разделы каталога Битрикса категориям ВКонтакте и разложить товары по подборкам (аналог витринных разделов внутри сообщества).
| Сущность Битрикса | Сущность ВКонтакте |
|---|---|
| Элемент инфоблока (товар/SKU) | Товар (market item) |
| Раздел каталога | Подборка (market album) |
| Тип цены | Цена товара |
| Детальная и доп. картинки | Фотографии карточки (главная + галерея) |
| Детальное описание | Описание товара |
Для полей карточки задаётся, откуда брать данные: название — из поля элемента, цена — из выбранного типа цены модуля «Торговый каталог», изображения — из детальной картинки и свойства типа «Файл». Если используются торговые предложения (SKU), в расширенном режиме VK они разворачиваются в вариации товара.
Первичная выгрузка и модерация
После настройки запускается первичная выгрузка. Битрикс перебирает отобранные разделы, создаёт в сообществе подборки, загружает фотографии и добавляет товары пачками через API. Важные моменты:
- Лимиты API. ВКонтакте ограничивает частоту запросов, поэтому большой каталог заливается порциями — процесс может занять время, это нормально.
- Фотографии обязательны. Товар без главного изображения VK не примет; ссылки на картинки должны быть доступны, чтобы Битрикс смог их передать.
- Модерация. Часть категорий (например, товары с ограничениями) ВКонтакте проверяет вручную — до одобрения карточка видна только администраторам.
После заливки проверьте витрину сообщества: правильно ли распределились подборки, подтянулись ли цены и не задвоились ли карточки. Повторный запуск не создаёт дубли — товары связываются с элементами каталога по внутреннему идентификатору.
Синхронизация цен, остатков и статусов
Смысл прямой интеграции — в том, что после первой выгрузки карточки обновляются автоматически. За регулярную синхронизацию в Битриксе отвечают агенты модуля или задание в планировщике cron.
- Цены. При изменении выбранного типа цены Битрикс отправляет
market.editи обновляет цену в карточке VK. - Наличие. Товар, ушедший в ноль или снятый с публикации, помечается недоступным либо скрывается из витрины.
- Новые и удалённые товары. Добавленные в каталог позиции создаются, а удалённые — убираются из сообщества.
define("BX_CRONHIT", true) в bitrix/php_interface/dbconn.php и заведите задание cron_events.php. Тогда обновления уходят в VK по расписанию, а не только при заходах на сайт.Если каталог питается из 1С, цепочка получается сквозной: 1С отдаёт цены и остатки в Битрикс по CommerceML, а Битрикс транслирует их во ВКонтакте. Тогда витрина сообщества всегда совпадает с реальным складом.
Типовые проблемы при выгрузке
Большинство сбоев связано с настройками сообщества и данными каталога, а не с самим модулем. На что смотреть в первую очередь:
- Токен без нужных прав или истёк. Ошибки доступа означают, что ключу не хватает
market/photosили он выпущен безoffline. - Не включён раздел «Товары». Пока витрина в сообществе выключена, API отклоняет добавление карточек.
- Нет категории VK. Товар без сопоставленной категории не создаётся — проверьте маппинг разделов.
- Битые или недоступные изображения. Если картинка недоступна по URL, товар уходит без фото или не проходит вовсе.
- Превышение лимитов API. При заливке большого каталога запросы стоит троттлить, иначе VK временно блокирует вызовы.
Диагностику удобно вести по журналу событий Битрикса и ответам API: код и текст ошибки от ВКонтакте почти всегда указывают на конкретную причину.
Итог
Выгрузка товаров во ВКонтакте — штатная возможность модуля «Интернет-магазин» 1С-Битрикс, работающая через API сообщества, а не через файл-фид. Порядок такой: включить раздел «Товары» в группе, выпустить бессрочный токен с правами market, привязать сообщество в настройках магазина, сопоставить разделы каталога подборкам и категориям VK и настроить синхронизацию агентами или кроном. Основная работа приходится не на клики в админке, а на чистоту данных: категории, цены, наличие и корректные изображения.
Если каталог большой, содержит торговые предложения со сложной матрицей вариаций или питается из 1С, мы настраиваем выгрузку в VK под ваши задачи — от базовой витрины сообщества до сквозной синхронизации 1С → Битрикс → ВКонтакте с мониторингом ошибок. Поможем связать каталог, склад и социальные площадки в один надёжный конвейер.
Частые вопросы
Чем выгрузка во ВКонтакте отличается от YML-фида?
Товары ВКонтакте создаются напрямую через API сообщества методами market.add и market.edit, а не отдаются файлом. Битрикс сам управляет карточками в группе, поэтому отдельная ссылка на фид не нужна.
Нужен ли сторонний модуль из Маркетплейса Битрикса?
Базовая интеграция входит в модуль «Интернет-магазин». Сторонние решения имеет смысл ставить для нестандартной логики, расширенных вариаций или тонкой настройки синхронизации.
Как получить токен доступа для интеграции?
Создайте Standalone-приложение ВКонтакте и через диалог авторизации выпустите ключ с правами market, photos, groups и offline. Токен и ID сообщества затем вносятся в настройки товаров ВКонтакте в админке магазина.
Как выгружаются товары с размерами и цветами?
Торговые предложения Битрикса переносятся в вариации товара VK, но только в расширенном режиме раздела «Товары». В базовом режиме доступны лишь простые карточки без вариантов.
Обновляются ли цены и остатки автоматически?
Да. После первой выгрузки агенты модуля или задание cron отправляют изменения цен, наличия и статусов в сообщество. Для стабильности агенты лучше перевести на крон.
Почему товар не появляется в сообществе?
Чаще всего из-за отсутствия сопоставленной категории VK, выключенного раздела «Товары», недоступной картинки или токена без нужных прав. Причину подскажут код и текст ошибки в ответе API.
Создаются ли дубли при повторной выгрузке?
Нет. Товары связываются с элементами каталога по внутреннему идентификатору, поэтому повторный запуск обновляет существующие карточки, а не плодит копии.
Можно ли синхронизировать данные из 1С?
Да. 1С передаёт цены и остатки в Битрикс по обмену CommerceML, а Битрикс транслирует их во ВКонтакте. Так витрина сообщества всегда совпадает с реальным складом.
Поможем с настройкой и поддержкой 1С-Битрикс: Управление сайтом
Поможем с настройкой, доработкой и поддержкой 1С-Битрикс: Управление сайтом.