Оптово-розничный магазин с B2B-кабинетом

Решение codebrain.b2b — готовый интернет-магазин на 1С-Битрикс для тех, кто продаёт и в розницу, и оптом. Мастер установки создаёт сайт за несколько минут: витрина с каталогом, фильтром и корзиной для розничных покупателей и кабинет компании для оптовиков — цены по договору, несколько корзин, заказ по артикулам и из Excel, согласование внутри компании, кредитный лимит и отсрочка, счета, УПД и акты сверки. У поставщика — кабинет менеджера: кто из клиентов перестал покупать, у кого просрочка, какие заказы ждут подтверждения.

Решение бесплатное. Заказы кабинета — обычные заказы модуля «Интернет-магазин»: статусы, оплаты, отгрузки, печатные формы и обмен с 1С работают как всегда.

Демо-версия: b2bdemo.codebrain.su — магазин светотехники с заполненными данными. Войдите как дилер (владелец оптовой компании) или как менеджер поставщика одной кнопкой, без регистрации. Настройки оформления меняйте смело — их видите только вы. Раз в сутки демо возвращается к исходному состоянию.

#Возможности

• Витрина и розница: главная из блоков, каталог на штатных компонентах с умным фильтром, быстрым просмотром и галереей, бренды, избранное и сравнение, подписка на поступление, умный поиск с опечатками и раскладкой, корзина и личный кабинет покупателя, вход по паролю или коду из письма и SMS.
• Оформление без программиста: 12 палитр и свои цвета, логотип, шрифт, контакты, соцсети, блоки главной с аудиторией и датами показа, регионы со своими телефонами, складами и ценами. Панель настроек прямо на сайте.
• Кабинет компании: регистрация с проверкой ИНН, сотрудники с ролями и своими должностями, лимиты, бюджеты подразделений, цепочки согласования до 5 шагов, двухфакторный вход.
• Цены и ассортимент: тип цены компании, правила по разделам, брендам и товарам, скидки от количества, персональные цены из коммерческих предложений, свой ассортимент и склады для компании или сегмента.
• Заказ: каталог-таблица с остатками по складам, несколько корзин, быстрый заказ вставкой артикулов, загрузка Excel/CSV, заказ из любого документа с помощью ИИ, списки и регулярные закупки, резерв, несколько адресов и складов в одном заказе, окна доставки, подтверждение поставщиком.
• Финансы и документы: кредитный лимит, отсрочка, долг и просрочка, взаиморасчёты, оплата по QR и онлайн, счета, УПД и акты сверки со статусами ЭДО, смета для заказчика с наценкой.
• Обращения: вопросы, запросы КП (принятое КП становится ценами компании), претензии с фото — замена, зачёт или возврат на склад.
• Для оптовика: прайс-лист с подпиской, выгрузка каталога (CSV, XLSX, YML, JSON) и постоянные ссылки для сайта партнёра, аналитика закупок, новости, обучение, опросы, конкурсы.
• Сложные схемы: дропшиппинг, дилеры с розничными клиентами, холдинги с общим лимитом, punchout (OCI и cXML).
• Интеграции: обмен с 1С, REST API кабинета (70 методов, OpenAPI) с вебхуками, уведомления в кабинете, push, Telegram и MAX.
• Для поставщика: кабинет менеджера на сайте, админка — компании, договоры, правила цен, ассортимент, обращения, обучение, конкурсы, оформление и настройки.

#Требования

#Установка

1. Установите решение из Маркетплейса: Marketplace → Каталог решений, найдите «Оптово-розничный интернет-магазин с B2B-кабинетом» и нажмите «Установить». Модуль проверит окружение и сообщит, если чего-то не хватает.
2. Запустите мастер готового магазина — ссылка появится после установки модуля (или откройте /bitrix/admin/wizard_install.php?wizardName=codebrain:b2b).
3. Шаги мастера:
   • Сайт — новый или существующий. На существующем сайте его главная сохранится как index_before_b2b.php.
   • Оформление и контакты — название, телефон, почта, адрес, цвет.
   • Каталог — демо-каталог с брендами или ваш инфоблок; демо-компания для первого знакомства.
   • Реквизиты поставщика — попадут в счёт на оплату.
   • Установка.
4. Мастер создаёт типы цен (розничная и оптовые), склады, плательщиков (физлицо, юрлицо, ИП) со свойствами, платёжные системы «Наличными», «Оплата по счёту» и «Отсрочка», доставки, страницы (витрина, каталог, бренды, личный кабинет, кабинет компании /b2b/, политика и согласие на обработку персональных данных), правила ЧПУ, шаблон сайта и почтовые события. Повторный запуск ничего не дублирует.
5. Переведите агенты на cron, если они ещё выполняются на хитах.

Магазин уже работает? Кабинет можно подключить к существующему сайту без мастера: Настройки → Портал → Создать раздел — появится папка кабинета, а каталог останется вашим.

#Быстрый старт

1. Codebrain → B2B-портал → Настройки: каталог и свойства (артикул, бренд, упаковка), типы цен, склады, показ цен гостям, минимальная сумма заказа, доставки и оплаты кабинета.
2. Оформление сайта: логотип, палитра, контакты, слайды и баннеры главной.
3. Проверьте тексты политики и согласия на обработку персональных данных (/privacy/, /consent/) и дополните их реквизитами магазина.
4. Зарегистрируйте тестовую компанию на сайте (или возьмите демо-компанию мастера), подтвердите её в Компании, задайте тип цены и договор с лимитом.
5. Войдите в кабинет /b2b/ её сотрудником и оформите заказ. Он появится в Магазин → Заказы как обычный заказ.
6. Для обмена с 1С создайте токен в Настройки → Обращения и обмен и скачайте обработку-пример.

#Витрина

Шапка с меню каталога, поиском, избранным, сравнением и корзиной. Главная собирается из блоков: слайдер, баннеры, преимущества, разделы каталога с иконками, популярные товары с кнопкой «Показать ещё», бренды, «Оптовым покупателям», «О компании». Порядок, видимость и содержимое блоков меняются в «Оформлении сайта».

#Каталог

Каталог работает на штатном компоненте bitrix:catalog со своими шаблонами: разделы с подразделами, умный фильтр (первые параметры открыты, остальные — под «Все фильтры»; числа и цена — ползунком; плашка «Найдено: N» сразу при выборе), сортировка, постраничная навигация с «Показать ещё». В карточке товара в списке — несколько фото (листаются наведением мыши или свайпом) и быстрый просмотр.

Страница товара: галерея с просмотром на весь экран, цена и наличие, главные характеристики, бренд и артикул, все характеристики и описание, документы товара (сертификаты, инструкции из файловых свойств), аналоги и сопутствующие товары, «Сообщить о поступлении», если товара нет.

#Бренды

Бренды хранятся отдельным инфоблоком: логотип, описание, текст, SEO. Страница /brands/ — все бренды, страница бренда — его разделы и товары с фильтром. Свойство «Бренд» каталога — привязка к элементам инфоблока брендов; мастер создаёт её сам.

#Цены на витрине

• Гость видит розничные цены или «Войдите, чтобы увидеть цену» — настройка «Показывать цены гостям».
• Розничный покупатель покупает по розничной цене штатной корзиной и оформлением, его заказы — в личном кабинете /personal/.
• Сотрудник подтверждённой компании видит в том же каталоге цены по договору, а «В корзину» кладёт товар в корзину кабинета компании.

#Поиск

Свой поисковый индекс: основы слов, исправление опечаток, неверная раскладка («ыфтвфкв» → «стандарт»), синонимы из настроек, характеристики и разделы, артикулы без пробелов и дефисов. Индекс строит агент; после массовой загрузки товаров нажмите Настройки → Каталог → Переиндексировать.

#Вход, регистрация, персональные данные

Вход по паролю или по одноразовому коду из письма или SMS (администраторы входят только по паролю). Во всех формах с персональными данными — галочка согласия со ссылками на политику и согласие; каждое согласие пишется в штатный журнал Битрикса «Соглашения». Уведомление о cookie с выбором «Только необходимые» / «Принять»: счётчик Метрики запускается только после согласия.

#Оформление сайта

Codebrain → B2B-портал → Оформление сайта — внешний вид без правки шаблона:

• Цвета: 12 готовых палитр или свои цвета шапки, кнопок, наведения и фона; светлая или цветная шапка и подвал; скругления, шрифт, ширина страницы.
• Логотип и контакты: логотип (картинка или SVG), отдельный логотип для телефона, значок сайта, название и слоган, телефоны, почта, адрес, режим работы, точка на карте, соцсети (Telegram, MAX, WhatsApp, VK, YouTube, Rutube, ОК, Дзен).
• Главная: блоки, их порядок и тексты; разделы каталога с иконками; слайды, баннеры и преимущества — с картинкой для телефона, аудиторией (всем, гостям, рознице, сотрудникам компаний, сегменту) и датами показа.
• Каталог: товаров на странице, колонки, показ артикула и остатка.
• Регионы: выбор города в шапке; у региона свои контакты, склады, розничный тип цены и текст о доставке.
• Подвал, уведомление о cookie, Метрика (с вебвизором по желанию), SEO главной, свой код в <head>.

Администратор может менять оформление и прямо на сайте: шестерёнка в левом нижнем углу открывает панель с палитрами (изменения видны сразу), логотипом и контактами, шапкой и подвалом, порядком блоков главной.

#Кабинет компании

Кабинет оптового покупателя — папка /b2b/ (меняется в настройках). Меню: Главная, Каталог, Корзины, Заказы, Обращения, Финансы, Документы, Аналитика, Новости, Компания; на телефоне — нижние вкладки. Главная показывает кредитный лимит и долг, персонального менеджера, новые документы, заказы по состояниям, обращения, списки закупок и новости — набор блоков зависит от прав сотрудника.

#Регистрация компании

Посетитель регистрирует себя и компанию одной формой: ИНН проверяется по контрольной сумме, реквизиты подсказывает DaData (если указан токен), дубли по ИНН+КПП не создаются. Если включена модерация, компания ждёт подтверждения менеджера — до этого покупатель видит розничные цены. Один пользователь может состоять в нескольких компаниях и переключаться между ними.

#Сотрудники и должности

Владелец компании приглашает сотрудников по ссылке (ссылка одноразовая, действует 7 дней). Встроенные роли: владелец, согласующий, закупщик, бухгалтер, наблюдатель. Компания может создать свои должности с набором прав: каталог и свои заказы, все заказы компании, оформление заказов, согласование, обращения, финансы, документы, аналитика, сотрудники, реквизиты, журнал действий. Сотруднику задаются лимиты на заказ и на месяц. Выдать можно только те права, что есть у себя.

#Бюджеты и согласование

• Бюджеты подразделений: сумма на месяц, квартал или год и сотрудники бюджета; мягкий контроль — предупреждение, жёсткий — отказ.
• Цепочки согласования: правило по сумме заказа, разделам или бюджету автора, до 5 шагов; согласует конкретный сотрудник, должность или роль. Шаги, которые автор согласует сам, пропускаются. Без правил заказ сверх лимита уходит на одно согласование.

Согласующие получают письмо и уведомление; на странице Согласование — заявки, ждущие решения, и история.

#Каталог кабинета

Каталог-таблица: разделы деревом, поиск по названию и артикулу, «в наличии», остатки по складам, кратность и упаковка, торговые предложения строками, «под заказ», «цена по запросу» (кнопка запроса КП), дата поставки. Цена — по договору компании, рядом — розничная и скидка. Карточка товара кабинета — фото, остатки, характеристики, модификации, документы, аналоги.

#Корзины и быстрый заказ

• До 30 корзин на компанию, общие для сотрудников: «Объект на Лесной», «Склад» и т. п. Перенос строк между корзинами, «Поделиться», выгрузка в CSV и PDF.
• Предупреждения о изменившейся цене, остатке и товарах «под заказ»; замена отсутствующего товара аналогом.
• Быстрый заказ: вставьте столбец «артикул — количество» из письма или таблицы; загрузка Excel/CSV — колонки определяются по заголовкам или по содержимому; ненайденные строки остаются в журнале загрузок.
• Заказ из любого документа с ИИ: PDF, DOCX, фото, текст письма — модель находит товары и количества (нужен модуль «AI-генератор контента» с вашим провайдером).
• Смета для своего заказчика: PDF от имени компании покупателя с её наценкой, без упоминания поставщика.

#Списки закупок и регулярные закупки

Список закупок сохраняется из корзины или заказа и кладётся в корзину по сегодняшним ценам. Регулярная закупка раз в неделю, две или месяц напоминает, собирает корзину или сама оформляет заказ — с теми же лимитами, бюджетами и согласованием.

#Оформление заказа

Договор (с остатком лимита), адрес и способ доставки, желаемая дата и окно доставки, условия разгрузки, оплата, свой номер заказа и комментарий. Можно разбить заказ по адресам (до 5 адресов, количество делится) или по складам (автоматическое распределение по наличию) — магазин получит отдельный заказ на каждый адрес или склад. Минимальная сумма заказа, лимиты, бюджеты и кредит проверяются на всю корзину.

#Заказы

Список с фильтром «в работе / отгружено / выполнено / отменено», «Все заказы» и «Мои заказы». Карточка заказа: этапы, позиции, отгрузки с трек-номерами, оплаты, документы, история изменений, счёт PDF, «Повторить», «Оплатить», оценка после отгрузки, ZIP документов товаров заказа.

Если включено подтверждение заказов поставщиком, заказ сначала попадает менеджеру: он может поправить цены и количество или отклонить заказ.

#Обращения: вопросы, КП, претензии

Одна лента с перепиской и файлами для трёх типов обращений:

• Вопрос менеджеру.
• Запрос коммерческого предложения — из корзины, карточки товара или «цены по запросу». Менеджер ставит цены и срок действия; после «Принять» цены становятся персональными ценами компании, а позиции уходят в новую корзину. КП скачивается в PDF.
• Претензия по своему заказу: позиции, количество, причина, желаемое решение, фото. Менеджер решает: заказ на замену или допоставку, зачёт суммы в расчётах, возврат товара на склад.

#Финансы и оплата

Кредитный лимит и сколько свободно, долг и просрочка, платежи по неделям, договоры, движение по договору (взаиморасчёты). При просрочке новые заказы с отсрочкой не принимаются. Оплата: QR-код по реквизитам (ГОСТ Р 56042) на один или несколько счетов или онлайн-оплата картой и СБП через платёжную систему магазина.

#Документы и ЭДО

Счета, УПД, акты сверки и другие документы приходят из 1С; фильтр по типам, «ждут подписи», скачивание по одному или ZIP. Статусы ЭДО (отправлен, доставлен, подписан, отклонён) и ссылка на документ у оператора приходят из учётной системы. Запрос акта сверки за период — из кабинета.

#Аналитика, прайс-лист и выгрузка каталога

• Аналитика: закупки, заказы, средний чек, экономия против розницы, сравнение с прошлым периодом, по месяцам, топ товаров, разделы и сотрудники; выгрузка в XLSX/CSV.
• Прайс-лист в XLSX/CSV с ценами компании, розницей, скидкой, остатком и упаковкой; подписка на почту раз в неделю или месяц.
• Выгрузка каталога для сайта партнёра: CSV, XLSX, YML, JSON с ценами компании, остатками, свойствами и фото; постоянные ссылки для автоматической загрузки.

#Новости, обучение, опросы, конкурсы

Новости и акции — всем, сегменту или выбранным компаниям. Обучающий центр: уроки с видео (YouTube, Rutube, VK), текстом, файлами и тестом с проходным баллом. Опросы с итогами для поставщика. Мотивация дилеров: конкурс по сумме или количеству закупок за период со ступенями призов; баллы начисляются в программу модуля «Бонусы, кэшбэк и реферальная программа».

#Уведомления

Колокольчик кабинета — статусы заказов, согласования, ответы на обращения, новые документы; каждому сотруднику — то, что касается его прав. Дублирование в браузерные push-уведомления, в Telegram и MAX (бот отвечает на «заказы», «долг», «документы» и артикулы — цена и остаток).

#Безопасность кабинета

Двухфакторный вход по коду из приложения (Google Authenticator, Яндекс Ключ и др.) с резервными кодами; компания может потребовать его от всех сотрудников. Журнал действий хранит год: заказы, согласования, скачивания документов, изменения сотрудников и должностей.

#Дилеры, холдинги, дропшиппинг

• Дилер с розничными клиентами: дилер создаёт компании своих клиентов; их цены — цены дилера с его наценкой, заказы клиента приходят дилеру на проверку и оформляются на условиях дилера.
• Холдинг: дочерние компании работают по договорам головной — общий лимит и долг; страница «Группа компаний» — закупки, долг и заказы группы.
• Дропшиппинг: партнёр оформляет заказы с доставкой своему покупателю. Агентская схема — поставщик продаёт покупателю по «цене для клиента», партнёр получает вознаграждение; «слепая» — партнёр покупает по своему договору, отгрузка — его клиенту.

#Кабинет менеджера поставщика

Менеджер поставщика работает на сайте: /b2b/manager/. Главная — свои клиенты с закупками за 90 дней и последним заказом, засыпающие клиенты (пауза больше двух обычных интервалов), просрочка, обращения без ответа, новые компании на проверке, заказы на подтверждение.

Карточка клиента — закупки по месяцам за год, главное за 90 дней, что клиент перестал покупать (брал 90–180 дней назад, но не в последние 90), заказы, обращения, сотрудники. Кнопки:

• Кабинет глазами клиента — только просмотр, без изменений.
• Работать за клиента — менеджер собирает корзину и оформляет заказ от имени сотрудника клиента или отправляет клиенту предложение корзины (письмо со ссылкой «Принять и оформить»).

Ещё в кабинете менеджера: ответы на обращения и КП, подтверждение заказов, оценки заказов, аналитика — продажи, повторные покупки, когорты, оборачиваемость задолженности, поисковые запросы без результатов. Администратор и пользователи с правом «Полный доступ» к модулю видят всех клиентов.

#Администрирование

Раздел Codebrain → B2B-портал в главном меню административной панели.

#Компании

Список компаний с поиском по названию и ИНН, новые — на подтверждение. Карточка компании: реквизиты, сотрудники, менеджер, тип цены и скидка, сегмент, договоры с лимитом и отсрочкой, взаиморасчёты, правила цен, режимы (дилер, дропшиппинг, холдинг, подтверждение заказов, выгрузка каталога, двухфакторный вход), punchout, журнал действий.

#Цены

Цена сотрудника считается так:

1. Тип цены компании (если задан), иначе тип из настроек, иначе базовая цена.
2. Правила цен — для всех компаний или одной: на весь каталог, раздел с подразделами, бренд или товар; процент, сумма или фиксированная цена; от количества; с датами и приоритетом. Из подходящих правил выигрывает больший приоритет, затем более точное (товар точнее раздела), затем правило компании, затем ступень по количеству, затем более низкая цена.
3. Скидка компании — самое слабое правило.

Персональные цены из принятых КП — правила с высоким приоритетом и сроком действия. Свою логику можно добавить обработчиком события OnPriceCalculate.

#Ассортимент

Для компании или сегмента: разделы, бренды, склады — «только» или «кроме». Скрытые товары не показываются, не продаются и не попадают в прайс-лист, выгрузки, API и бот.

#Обращения

Все вопросы, КП и претензии компаний: ответы, цены и срок КП, решения по претензиям. Письма о новых обращениях получает персональный менеджер компании, иначе — адрес из настроек.

#Новости, обучение, опросы, конкурсы

Новости и акции, уроки и тесты (прогресс по компаниям), опросы с итогами и выгрузкой в CSV, конкурсы для дилеров со ступенями и автоматическим начислением баллов после окончания.

#Настройки

Codebrain → B2B-портал → Настройки. Значения общие для всех сайтов или свои для каждого сайта (выбор сайта вверху страницы, «Сбросить настройки сайта к общим»).

#Обмен с 1С

Обмен идёт через адрес /bitrix/tools/codebrain_b2b_exchange.php: POST-запрос с JSON {method, params} и заголовком Authorization: Bearer <токен>. Токен создаётся в настройках и показывается один раз; можно ограничить обмен списком IP. Обработка-пример для 1С скачивается там же.

Заказы кабинета — обычные заказы «Интернет-магазина», поэтому штатный обмен заказами с 1С тоже работает.

#REST API и вебхуки

API кабинета даёт сайту, 1С или CRM покупателя всё, что сотрудник делает в кабинете: каталог и остатки, корзины, оформление, заказы, счета, согласования, документы, финансы, обращения, аналитику, прайс-лист, выгрузку каталога, сотрудников, дропшиппинг — около 70 методов.

• Ключ создаёт сотрудник с правом «API» в Кабинет → API и интеграции: отмечает разрешённые разделы и «изменения». Ключ действует с правами этого сотрудника и показывается один раз.
• Адрес: /bitrix/tools/codebrain_b2b_api.php?method=<метод>, заголовок Authorization: Bearer cb2b_…, тело — JSON, ответ {"ok": true, "data": …}.
• Лимит запросов в минуту на ключ — в настройках.
• Вебхуки: order.created, order.status, approval.*, ticket.answer, document.new, document.edo, dropship.fee, order.rated — с подписью X-CB2B-Signature: sha256=… (HMAC тела) и повторами при ошибке.
• Документация с параметрами каждого метода и примерами — в кабинете, API → Документация; описание OpenAPI 3 — ?method=openapi (для Postman и генераторов кода).

#Punchout

Для крупных клиентов с системами закупок (SAP SRM и др.): OCI и cXML — сотрудник клиента открывает каталог из своей системы закупок, собирает корзину и передаёт её обратно; cXML OrderRequest создаёт заказ. Настраивается в карточке компании: логин и пароль OCI или идентификатор и секрет cXML, разрешённые адреса возврата.

#Безопасность и персональные данные

• Права проверяются на каждом действии: сотрудник видит и меняет только данные своей компании и в пределах своих прав.
• Все изменения — POST-запросы с проверкой сессии; в публичной части нет ссылок с идентификатором сессии.
• Токены API, обмена, фидов и приглашений хранятся только хэшами.
• HTML от пользователей очищается; SVG-логотипы загружает только администратор.
• Вебхуки и внешние запросы не уходят во внутреннюю сеть.
• Согласия на обработку персональных данных пишутся в журнал «Соглашения»; Метрика и другие счётчики запускаются только после согласия на cookie.
• Данные передаются внешним сервисам только если вы их подключили: DaData (ИНН и название компании), Telegram/MAX (тексты уведомлений), провайдер ИИ (текст документа для заказа), Яндекс Карты на странице контактов (IP посетителя).

#Для разработчиков

#События

Обработчики регистрируются штатно: EventManager::getInstance()->addEventHandler('codebrain.b2b', 'OnPriceCalculate', …).

#Компоненты и шаблоны

• codebrain:b2b.cabinet — кабинет компании и кабинет менеджера (комплексный компонент, ЧПУ).
• codebrain:b2b.home — главная витрины из блоков оформления.
• codebrain:b2b.brands — бренды, codebrain:b2b.map — контакты с картой.
• Шаблон сайта codebrain_b2b со своими шаблонами штатных компонентов каталога, корзины, оформления, личного кабинета и авторизации. Для своих правок скопируйте шаблон под другим именем — обновления модуля его не затронут.

#Удаление модуля

Marketplace → Установленные решения → codebrain.b2b → Удалить. Модуль спросит, сохранить ли данные: при сохранении таблицы компаний, договоров, обращений, документов и настроек остаются и вернутся при повторной установке. Заказы, товары, типы цен, склады и страницы сайта, созданные мастером, не удаляются — это данные магазина. Шаблон сайта остаётся, пока его использует какой-нибудь сайт.

#Частые вопросы

Нужен ли отдельный сайт для опта? Нет. Оптовики и розничные покупатели работают на одном сайте: в одном каталоге каждый видит свои цены.

Как оптовику получить свои цены? Компания регистрируется на сайте или её создаёт менеджер в административной панели (либо её присылает 1С). После подтверждения сотрудники компании видят цены по её типу цены и правилам.

Уйдут ли заказы кабинета в 1С? Да. Это обычные заказы «Интернет-магазина»: они выгружаются штатным обменом. Дополнительно обработка-пример забирает их через API обмена вместе с номером заказа покупателя.

Можно подключить кабинет к уже работающему магазину? Да: Настройки → Портал → Создать раздел. Каталог, шаблон и заказы остаются вашими.

Работает ли решение на редакции «Малый бизнес» или «Старт»? Нет: нужны несколько типов цен и складов — это редакция «Бизнес» и выше.

Где посмотреть, как это выглядит? В демо-версии: b2bdemo.codebrain.su — войдите как дилер или менеджер.