Підключення до каталогу платформи і прив’язка своїх товарів через 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 та його документацію.

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

Пов’язані теми