B2B-интеграции · Личный профессиональный опыт

Grifmaster API — каталог, персональные цены и интеграции для партнёров

Для дистрибьютора Grifmaster я разработал и развиваю API-сервис, через который партнёры получают актуальные данные каталога, персональные цены и товарные выгрузки. Помимо самого API, реализованы кабинет партнёра, управление организациями и доступами, правила скидок и инструменты аналитики для администратора.

B2B API · 1С · Excel-выгрузки · документация

Портал партнёра Grifmaster API — Портал партнёра: генератор прайс-листов, скидки, лимиты и справочник API

Задача бизнеса

Дистрибьютор работает с большим товарным каталогом и партнёрами на разных коммерческих условиях. Передавать каждому клиенту актуальные цены, остатки и номенклатуру вручную неудобно: данные меняются, прайсы устаревают, а интеграции требуют постоянной поддержки.

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

Что было разработано

Решение объединяет API для обмена данными с внешними системами, кабинет партнёра и административные инструменты.

Партнёры могут обращаться к API, получать товарные данные и формировать выгрузки. Администратор управляет организациями, доступами, ключами, ограничениями запросов и персональными условиями.

JSON/XML API для интеграций.
Генератор товарных выгрузок Excel/CSV.
Персональные цены и скидки по условиям организации.
Регистрация и подключение партнёров.
Управление API-ключами и лимитами.
Документация и инструменты самообслуживания.
История обращений и аналитика использования.

Как работает партнёр

Партнёр проходит регистрацию, получает доступ к сервису и может использовать API для интеграции каталога со своей учётной системой или сайтом.

Для задач, где прямое API-подключение не требуется, доступны готовые выгрузки. В кабинете можно увидеть условия организации, лимиты, справочник API и сведения для связи с менеджером.

Отдельно предусмотрены настройки профиля, уведомлений и безопасности, включая самостоятельное обновление API-ключа.

Управление организациями и коммерческими условиями

Административный интерфейс объединяет заявки на подключение, организации партнёров, ответственных менеджеров, права доступа и настройки API.

Для каждой организации можно управлять ключами, форматами, лимитами и возможностью получения товарных выгрузок.

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

Мониторинг и аналитика

Администратор может контролировать использование API: количество запросов, успешность ответов, объём переданных товарных данных и формирование файлов.

Отдельные отчёты показывают обращения к эндпоинтам, использование версий API, параметров фильтрации и брендов.

История запросов помогает анализировать работу подключённых организаций и разбирать технические проблемы.

Техническая реализация

Сервис реализован на PHP и MySQL и работает с данными каталога, поступающими из обмена с 1С. Для внешних потребителей предусмотрены API в форматах JSON/XML и формирование табличных выгрузок.

Помимо обмена данными, реализованы разграничение доступа, управление ключами и лимитами, система коммерческих правил и журналирование обращений.

Для административных и партнёрских сценариев разработаны отдельные пользовательские интерфейсы.

Результат

Работает B2B-сервис, который объединяет товарный API, самостоятельное получение прайсов, управление партнёрами и контроль использования интеграций.

Партнёры получают инструменты для работы с каталогом и своими коммерческими условиями, а сотрудники — централизованное управление доступами, скидками и подключениями.

Проект развивается вместе с задачами бизнеса и служит самостоятельным интеграционным решением в экосистеме Grifmaster.

Связь с Grifmaster B2B

Grifmaster API — интеграционный сервис для партнёров. Grifmaster B2B — отдельный полноценный кабинет на Laravel и Filament; он описан в соседнем кейсе.