Подключение к каталогу платформы и привязка своих товаров через API

#373

Платформа предоставляет собственный готовый каталог — около 100 000 товарных позиций от ведущих производителей плит, кромки и фурнитуры. Ваша фабрика подключается к каталогу через API, привязывает свои товары к нашим и работает с готовой базой вместо того, чтобы вести её с нуля.

Что это даёт вашей фабрике

  • Готовая база ~100 000 позиций — плиты (ЛДСП, МДФ, ДВП, акрил, стекло), кромка (ПВХ, ABS, меламин), фурнитура от основных производителей. Обновляется централизованно.
  • Не надо заводить вручную — большая часть ассортимента уже описана: габариты листа, толщина, декор, производитель, артикул, изображения. Фабрика только привязывает свои цены и остатки.
  • Единый словарь декоров — клиент видит знакомые названия и коды производителя; легко искать через поиск каталога.
  • Совместимости кромки и плиты уже описаны в платформе для большинства комбинаций — не нужно настраивать вручную.

Как фабрика привязывает свои товары к каталогу

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

  • Соответствие нашей позиции — ваш «ЛДСП Egger H1180» привязывается к нашей карточке с тем же артикулом / декором. Маппинг по артикулу, штрих-коду, внутреннему ID — на ваш выбор.
  • Свои цены — за м², за лист, комбинированный крой и т. д. Можно задать несколько типов цены на одну позицию (см. 4 типа продажи).
  • Свои остатки — берутся из вашей учётной системы в реальном времени. Клиент в кабинете видит «есть на складе» только при фактическом наличии.
  • Свои параметры — индивидуальные настройки материала: торцовки, направление реза, отключения услуг, запрет комб-кроя — индивидуально на вашу позицию (см. Индивидуальные настройки материала).
  • Свою кромку в пару — если вы традиционно ставите определённую кромку к определённой плите, привязка сохраняется и предлагается клиенту первой.

Если нужной позиции в нашем каталоге нет

Каталог большой, но не покрывает всё (редкий декор, локальный производитель, нестандартный размер). В таком случае позиция добавляется в админ-панели фабрики — раздел Каталог. Позиции добавляются массовым импортом товаров из XLSX-файла — ручного создания отдельной позиции в админке нет.

Поддерживаемые системы

Подключение через API — стандартный механизм платформы. Что подключается:

  • Любая система с открытым API (JSON / XML / SOAP) — подключается по документации платформы, обычно 1–3 дня работы.
  • Типовые учётные и складские системы — обмен настраивается тем же способом, отдельный коннектор не нужен.
  • Самописный учёт — платформа не привязана к конкретной программе: достаточно, чтобы система умела отправлять HTTP-запросы и разбирать JSON.

Что нужно для подключения

Платформа предоставляет фабрике универсальный HTTP API. С точки зрения фабрики подключение состоит из трёх частей:

  • Ключ доступа к API — выдаётся фабрике по запросу в техническую поддержку платформы. Используется для авторизации каждого запроса.
  • Документация по доступным методам — список действий, которые можно вызывать (получение справочников, поиск товаров, чтение и обновление остатков, работа с заказами, клиентами, производством). Передаётся вместе с ключом.
  • Реализация на стороне фабрики — отдельный модуль или сервис, который из вашей учётной системы формирует HTTP-запросы к API платформы. Разработку выполняет ваша IT-команда или внешний подрядчик. Платформа не привязана к конкретному стеку — подходит любая среда, поддерживающая HTTP-запросы и работу с JSON.

Маппинг товаров, формат цен, частоту синхронизации, обработку ошибок и retry-политику фабрика определяет сама — это часть реализации обработчика на её стороне. Платформа отвечает за стабильный API и его документацию.

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

Связанные темы