Kokhanenko: B2B Catalog API добавляет к сайту на 1С-Битрикс управляемый API для выгрузки каталога во внешние системы: дилерские кабинеты, партнёрские витрины, мобильные приложения, CRM, PIM, BI-отчёты и интеграционные сервисы.
Модуль предназначен не для массовой выгрузки прайс-листа, а для безопасной выдачи каталожных данных внешним системам, партнёрам, дилерам и клиентским приложениям через защищённый API с индивидуальными токенами и ограничениями доступа.
Модуль помогает отдавать не весь каталог всем подряд, а разные наборы данных разным клиентам. Для каждого внешнего клиента можно создать отдельный API-токен, объединить токены в группы и настроить ограничения по полям ответа, типам цен, разделам каталога и значениям свойств товаров.
API возвращает товары, активные разделы и количество доступных товаров. Поддерживаются JSON и XML, постраничная выдача товаров, Authorization: Bearer, скачивание ответа файлом и публичная HTML-страница /api/ с короткой справкой по endpoint-ам.
Кому подходит- интернет-магазинам и B2B-порталам на 1С-Битрикс;
- компаниям, которые передают каталог дилерам, партнёрам или франчайзи;
- проектам, где нужно подключить внешний сайт, мобильное приложение, CRM, PIM или BI-систему;
- командам, которым важно разделять доступ к ценам, остаткам, свойствам и разделам каталога.
- Endpoint товаров: /api/v1/products, /api/v1/products.json, /api/v1/products.xml.
- Endpoint количества товаров: /api/v1/products/count, включая JSON/XML-форматы.
- Endpoint разделов: /api/v1/categories, включая JSON/XML-форматы.
- Авторизация через Authorization: Bearer.
- Legacy-совместимость через query-параметр token.
- Группы токенов и индивидуальные правила для токенов.
- Ограничение полей ответа.
- Ограничение доступных типов цен.
- Исключение разделов из выдачи.
- Фильтрация товаров по значениям свойств.
- ACL до пагинации товаров: /products и /products/count считают доступный набор одинаково.
- Выбор свойств инфоблока, которые можно отдавать наружу.
- Базовая выгрузка торговых предложений, цен и остатков.
- Журнал API-запросов без сохранения полного токена и query string.
- Служебные поля api_version: v1 и schema_version: 1.0 в успешных ответах.
Модуль не хранит полный plain-token в базе. Полное значение токена показывается только один раз при создании или перевыпуске, а дальше в административных списках отображается только префикс. Для production-интеграций рекомендуется использовать Bearer-авторизацию, чтобы токен не попадал в URL, access-логи и историю браузера.
Журнал запросов хранит endpoint, метод, статус, длительность, IP, ID/пользователя токена и hash query string. Полный токен и исходная query string в журнал не записываются.
- В настройках модуля добавлены кнопки для автоматического подключения route-файла модуля в /bitrix/.settings.php и добавления rewrite-правила для /api/v1 в .htaccess, если проверка показывает ошибку.
- Перед изменением системных файлов создаётся резервная копия рядом с исходным файлом с суффиксом .kokhanenko_catalogapi_YYYYmmdd_HHMMSS.bak.
- Автоматические действия только добавляют недостающую настройку или правило и не удаляют существующую конфигурацию проекта.
- После успешного исправления в настройках выводится путь к созданной копии, а кнопка исправления скрывается.
- Добавлена возможность задавать индивидуальный список свойств товаров для группы токенов или конкретного токена.
- Реализован приоритет выбора свойств API-выдачи: токен → группа → общие настройки модуля → свойства не отдаются.
- Пустой индивидуальный список считается отсутствием индивидуальной настройки и включает наследование следующего уровня.
- В административные страницы ограничений группы и токена добавлен отдельный блок «Свойства товаров для выдачи по API».
- Формат API-ответа, endpoint-ы и schema_version не изменены.
- Установите модуль стандартным способом в административной части Bitrix.
- В настройках модуля включите API и выберите инфоблок каталога.
- При необходимости укажите инфоблок торговых предложений.
- Выберите коды свойств, которые разрешено отдавать через API.
- Проверьте route-файл /local/routes/kokhanenko_catalogapi.php и routing-настройки проекта.
- Создайте группу токенов и API-токен для внешнего клиента.
- Проверьте доступ запросом к /api/v1/products/count.
curl -H "Authorization: Bearer htm_xxxxxxxxxxxxxxxxxxxxx" \ "https://example.ru/api/v1/products/count" |
curl -H "Authorization: Bearer htm_xxxxxxxxxxxxxxxxxxxxx" \ "https://example.ru/api/v1/products?page=1&limit=10&pretty=1" |
❓ Обратная связь и поддержка
По вопросам работы модуля, а также предложениям по добавлению новой функциональности, вы можете обращаться по электронной почте: info@kokhanenko.pro.
Для покупки товара в нашем интернет-магазине выберите понравившийся товар и добавьте его в корзину. Далее перейдите в Корзину и нажмите на «Оформить заказ» или «Быстрый заказ».
Если оформляете быстрый заказ: напишите ФИО, телефон и e-mail. Вам перезвонит менеджер и уточнит условия заказа. По результатам разговора вам придет подтверждение оформления товара на почту или через СМС. Теперь останется только ждать доставки и радоваться новой покупке.
Оформление заказа в стандартном режиме выглядит следующим образом. Заполняете полностью форму по последовательным этапам: адрес, способ доставки, оплаты, данные о себе. Советуем в комментарии к заказу написать информацию, которая поможет курьеру вас найти. Нажмите кнопку «Оформить заказ».
Оплачивайте покупки удобным способом. В интернет-магазине доступно 3 варианта оплаты:
- Наличные при самовывозе или доставке курьером. Специалист свяжется с вами в день доставки, чтобы уточнить время и заранее подготовить сдачу с любой купюры. Вы подписываете товаросопроводительные документы, вносите денежные средства, получаете товар и чек.
- Безналичный расчет при самовывозе или оформлении в интернет-магазине: карты МИР. Чтобы оплатить покупку на сайте, система перенаправит вас на сервер платежной системы. Здесь нужно ввести номер карты, срок действия и имя держателя.
- Электронные системы при онлайн-заказе: ЮMoney. Для совершения покупки система перенаправит вас на страницу платежного сервиса. Здесь необходимо заполнить форму по инструкции.
- Безналичная оплата на наш расчетный счет по выставленному счету.
Экономьте время на получении заказа. В интернет-магазине доступно 4 варианта доставки:
- Электронная поставка - все необходимые сведения о лицензии, праве пользования, кодах, ключах и др. высылаются покупателю на его e-mail.
- Курьерская доставка. Когда товар будет отправлен с нашего склада, Вам придет уведомление. В день доставки с Вами заблаговременно свяжется курьер для уточнения времени и деталей доставки. Доставка производится "до двери". Осмотрите упаковку на целостность и соответствие указанной комплектации.
- Постамат. Когда заказ поступит на точку, на Ваш телефон или e-mail придет уникальный код. Заказ нужно оплатить в терминале постамата. Срок хранения — 3 дня.
- Доставка Почтой России. Когда заказ придет в отделение, на Ваш адрес придет извещение о посылке. Перед оплатой Вы можете оценить состояние коробки: вес, целостность. Вскрывать коробку самостоятельно Вы можете только после оплаты заказа. Один заказ может содержать не больше 10 позиций и его стоимость не должна превышать 100 000 р.
Дополнительная информация.
Изучите полный алгоритм продления лицензий на модули 1С-Битрикс: Маркетплейс, включая активацию льготных купонов. Мы детально разбираем все условия: обязательный 30-дневный срок для сохранения максимальной выгоды, пропорциональное ценообразование (12,5%, 25%, 50% от цены модуля) и ограничение по минимальной сумме в 500 рублей. Этот гайд поможет вам эффективно планировать бюджет и гарантировать актуальность вашего проекта.
