Опишите доработку или сценарий — обсудим вместе с другими клиентами.
Интеграция с Купер (СберМаркет)
Технические данные
Совместимые редакции
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Малый бизнес
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Бизнес
- Программа для ЭВМ "1С-Битрикс24". Лицензия Интернет-магазин + CRM (12 мес.)
Описание
Подключите интернет-магазин на 1С-Битрикс к маркетплейсу «Купер» (бывший СберМаркет). Товары, цены и остатки уходят на витрину автоматически, а заказы покупателей Купера появляются в админке рядом с обычными заказами сайта. Без выгрузок вручную, без Excel и без отдельной программы-посредника.
Каталог всегда актуален
- Полная выгрузка категорий, товаров и торговых предложений через официальный Content API Купера.
- Цены и остатки по каждой торговой точке: свой склад и свой тип цены для каждой точки.
- Акционные цены из отдельного типа цен.
- Изменили цену, остаток или карточку товара — изменение уйдёт в Купер при следующем запуске агента, обычно через несколько минут. Полную выгрузку делать не нужно.
- Названия, описания, фото, штрихкоды, вес, НДС, весовые и штучные товары, атрибуты из любых свойств инфоблока.
- Статистика привязки товаров к карточкам Купера и список отклонённых товаров прямо в админке.
Заказы в обе стороны
- Заказ с Купера сразу создаётся на сайте: состав, покупатель, адрес, окно доставки, комментарии, способ оплаты, скидки, данные B2B-клиента.
- Изменения из Купера применяются к заказу на сайте: состав и суммы после сборки, перенос окна доставки, смена оплаты, оплата, отмена, назначение и прибытие курьера.
- Меняете статус заказа на сайте — Купер получает уведомление: «в работе», «собран», «готов к выдаче», «доставлен» и другие.
- Модуль сам соблюдает порядок событий, которого требует Купер. Пропущенный обязательный шаг он отправит первым.
- Фактический состав после сборки, вес весовых товаров и коды маркировки «Честного знака» передаются в Купер.
- Гибкие соответствия статусов, служб доставки, платёжных систем и свойств заказа.
Готовность к 289-ФЗ
С 01.10.2026 вступает в силу закон о платформенной экономике. Модуль уже передаёт всё, что Купер требует для карточки товара:
- признак необходимости сертификации;
- коды ТН ВЭД и ОКПД2, GTIN, изготовителя, медизделия и ТСР;
- разрешительные документы: сертификаты, декларации, СГР, регистрационные удостоверения.
Инфоблок документов и нужные свойства товара создаются одной кнопкой. Модуль сам проверяет форматы кодов и дат, поэтому ошибочные данные не уйдут в Купер.
Надёжность и прозрачность
- Журнал обмена: каждый запрос и ответ с телом и результатом.
- Неудачная отправка уведомления повторяется автоматически.
- Соблюдение лимитов API Купера, повтор запросов при перегрузке сервера.
- Защищённый приём вебхуков: токен client-token или логин и пароль.
- Проверка подключения и адреса вебхука одной кнопкой из настроек.
- Работает с любым веб-сервером: адрес приёма заказов не зависит от правил urlrewrite.
Для кого
Для ритейлеров и сетей, которые продают через Купер и сами собирают и/или доставляют заказы. Также подходит тем, кто передаёт в Купер только каталог.
1. Установка
- Установите модуль из Маркетплейса или распакуйте архив в /local/modules/ либо /bitrix/modules/.
- Откройте «Настройки → Настройки продукта → Модули» и нажмите «Установить» у модуля «Интеграция с Купер».
- Установщик создаёт таблицы, агенты, адрес для приёма заказов /kuper-webhook/ и генерирует токен для вебхуков.
Настройки модуля: «Настройки → Настройки продукта → Настройки модулей → Интеграция с Купер». Рабочие страницы: «Магазин → Купер».
2. Вкладка «Подключение»
- В личном кабинете партнёра Купера откройте раздел «Подключение к API» и скопируйте client_id и client_secret.
- Вставьте их в настройки и выберите контур: рабочий или тестовый. Ключи у контуров разные.
- Укажите retail_chain_slug — идентификатор вашей сети в Купере, его сообщит менеджер.
- Нажмите «Проверить подключение». Должно появиться «Токен получен» и число торговых точек.
- Включите галочку «Интеграция включена».
3. Вкладка «Магазины»
- Выберите сайт, на который будут создаваться заказы.
- Проверьте адрес сайта: он нужен для ссылок на фото товаров.
- Нажмите «Загрузить точки из Купера» или добавьте точки вручную. Идентификатор точки должен совпадать с её «Ключом» в Купере.
- Для каждой точки выберите склад, из которого берётся остаток, и тип цены.
4. Вкладки «Каталог» и «Свойства товаров»
- Выберите инфоблоки каталога. Торговые предложения подключатся автоматически.
- Выберите идентификатор товара для Купера: ID или внешний код (XML_ID). После первой выгрузки его не меняйте.
- Настройте описание, фото, штрихкоды, тип упаковки (штучный или весовой), НДС.
- На вкладке «Свойства товаров» сопоставьте характеристики Купера (вес, бренд, страна и т. д.) со свойствами инфоблока. Атрибут weight обязателен.
- Задайте интервал отправки изменений и периодичность полной выгрузки.
5. Вкладка «289-ФЗ»
- Нажмите «Создать инфоблок документов и свойства товаров». Модуль создаст:
- инфоблок «Разрешительные документы (Купер)»;
- привязку к документам в карточке товара;
- свойства для кодов ТН ВЭД, ОКПД2 и других полей;
- и сам заполнит соответствия.
- инфоблок «Разрешительные документы (Купер)»;
6. Первая выгрузка каталога
- Откройте «Магазин → Купер → Выгрузка каталога».
- Нажмите «Запустить полную выгрузку» и дождитесь завершения.
- Через некоторое время проверьте результат кнопками «Статистика» и «Отклонённые товары».
Дальше изменения отправляются автоматически. Выгрузку можно также запускать по cron:
php -f /путь/к/сайту/bitrix/modules/slytek.kuper/tools/cron_export.php
7. Вкладка «Обмен заказами»
- Скопируйте адрес вебхука (вида https://ваш-сайт/kuper-webhook/, со слэшем в конце).
- Выберите авторизацию: заголовок client-token или логин и пароль.
- Передайте менеджеру Купера адрес и выбранные данные авторизации.
- Нажмите «Проверить адрес вебхука». Если адрес недоступен, нажмите «Восстановить точку приёма».
- Способ авторизации уведомлений о статусах (JWT или client-token) выберите так, как указано в вашем подключении к Куперу.
8. Вкладки «Заказы», «Доставка и оплата», «Статусы»
- Выберите тип плательщика и сохраните настройки. После этого появится список свойств заказа.
- Сопоставьте поля заказа Купера (ФИО, телефон, адрес, окно доставки, код выдачи и др.) со свойствами заказа.
- Выберите покупателя для заказов: один пользователь для всех или поиск и создание по e-mail.
- Сопоставьте способы доставки и оплаты Купера со службами доставки и платёжными системами сайта.
- На вкладке «Статусы»:
- в разделе «События Купера → статус на сайте» задайте, какой статус получает заказ при событиях Купера;
- в разделе «Статус на сайте → уведомление в Купер» задайте, о каких статусах сообщать Куперу. Обязательные события: «Взят в работу», «Готов к доставке / выдаче», «Доставлен / выдан».
- в разделе «События Купера → статус на сайте» задайте, какой статус получает заказ при событиях Купера;
Если сборку и доставку выполняет Купер, соответствие «статус → уведомление» оставьте пустым.
9. Проверка работы
- Попросите менеджера Купера отправить тестовый заказ и убедитесь, что он появился в списке заказов сайта.
- Смените его статус на сайте. В журнале обмена («Магазин → Купер → Журнал обмена») должна появиться успешная отправка уведомления.
- Все ошибки обмена с подробностями видны в журнале: используйте фильтр «Результат: Ошибка».
Частые вопросы
- «Не удалось получить токен». Проверьте client_id, client_secret и контур: ключи тестового контура не работают на рабочем.
- Заказы не приходят. Проверьте адрес вебхука кнопкой в настройках, галочки «Интеграция включена» и «Принимать заказы из Купера», совпадение токена или пароля с переданными Куперу.
- Товар не появился в Купере. Посмотрите «Отклонённые товары» на странице выгрузки и записи журнала с ошибками.
- Уведомление отклонено с кодом 405. Событие не подходит для вашей схемы работы точки или отправлено не в том порядке. Подробности есть в журнале.
Телефон/Telegram/Max/Whatsapp: +79169640793
Telegram: @slytekorg
Max: @slytekorg
E-mail: info@slytek.org
Время работы: Пн-Пт: 9-17 МСК
Время реагирования: 1-3 рабочих дня
Установите этот модуль прямо сейчас!
Для этого укажите адрес сайта:
Подтвердите что сама лицензия у вас куплена
