API

Пошук

Увесь функціонал сервісу iFurn.pro доступний через API. Дії, які менеджер виконує в адмін-панелі — створення замовлення, зміна статусу, позначка готовності деталі, перенесення палети, відкриття зміни, нарахування зарплати, обмін каталогом з обліковою системою — можна викликати програмно. Дані з виробництва надходять назовні: до інтернет-магазину, мобільного застосунку, CRM, BI-системи, складської системи партнера.

Частина можливостей реалізована лише в API і в адмін-панелі не відображається: пакетні операції, прямий обмін з обліковою системою, звіти від верстатів CNC за фактом обробки деталі, доступ до timeline-подій замовлення, міжфірмові оптові потоки.

Типові сценарії інтеграції

  • Облікові системи. Двосторонній обмін замовленнями, цінами, залишками, статусами оплат.
  • Інтернет-магазин або конфігуратор. Замовлення з браузера клієнта надходить в адмінку з готовою картою розкрою, програмою CNC і розрахунковою вартістю.
  • Мобільний застосунок замірника. Проєкт, створений у клієнта, потрапляє в адмінку без перенесення даних вручну.
  • B2B-кабінет для партнерів. Дилер бачить свої ціни, оформлює замовлення за кінцевого клієнта, читає статуси виробництва.
  • Виробничі верстати та QR-портал. Верстати CNC й етикеткові принтери фіксують виконані операції через API.
  • Аналітика та BI. Вивантаження статистики за замовленнями, продажами, витратою матеріалів, операціями.
  • Чат-боти та сповіщення. Telegram, Viber, голосові асистенти — кожен звертається до одного й того самого API.

Основні розділи API

Замовлення — 28 методів

  • Отримання і створення. Створити замовлення, прочитати список за фірмою / клієнтом / статусом / періодом, отримати картку з деталями і послугами, розрахувати вартість до збереження, імпорт з облікової системи.
  • Керування статусами. У роботу, у виробництво, у редагування, скасування, готовий до відвантаження, відвантажений, на доставці, повернення до попереднього статусу.
  • Події та timeline. Історія замовлення: хто і коли змінював статус, ставив позначку, віддавав на доставку.
  • Дод. послуги. Прив'язати власні послуги до замовлення чи деталі; постановка замовлення в чергу генерації CNC-програм.

Виробництво — 20 методів

  • Маркування деталей. Позначити і зняти позначку про виконану операцію (розпил, кромка, свердління, фрезерування) за деталлю або за групою деталей.
  • Пакування. Позначити деталь запакованою, зняти позначку, очистити пакувальні позначки. Коли останню деталь запаковано — замовлення переходить у «готовий до відвантаження».
  • Статистика CNC-операцій. Метри розпилу, погонні кромки, штуки свердлінь за періодом, фірмою, матеріалом, товщиною.
  • Розкрій, GL і QR. Отримати програму різання, конвертація в карту розкрою, звіт CNC за деталлю, QR-код замовлення.

Товари та матеріали — 17 методів

  • Артикули. Отримання каталогу, пошук за кодом, за фільтром, за папкою, оновлення параметрів.
  • Склад товарів. Створення надходження, оновлення залишку, прив'язка товару до замовлення, отримання залишків на момент виробництва замовлення.
  • Дод. інформація та зв'язки матеріалів. Довільні пари «матеріал — кромка», «матеріал — виробник», «артикул — клієнт»; повна номенклатура фірми.

Клієнти та користувачі — 18 методів

  • Клієнти. Пошук / створення / оновлення клієнта, прив'язка зовнішнього коду, пошук за телефоном, масове оновлення контактів.
  • Працівники цеху. Список операторів і комірників, створення, призначення ролі, зміна пароля, видача QR-картки для входу до QR-порталу.
  • Менеджери та продавці. Список, перевірка прав, прив'язка до точок продажу, генерація нового пароля.

Редактор кромки — 28 методів

  • Фаска. CRUD за параметрами і зв'язками з матеріалами/кромкою.
  • Радіусне заокруглення. Параметри фрези, припуску, кута.
  • Зріз під кутом. Параметри фрези, зв'язки матеріал-кромка для кожного варіанта.
  • Врізні ручки. J-профіль, GOLA, точкові; зв'язки з типами кромки та параметрами фарбування.
  • Фарбування та зв'язки. Призначення фарбування на ручку, прив'язка кольору до кромки.

Оптова торгівля — 31 метод

  • Партнери. Список партнерів, властивості (націнка, валюта, кредитний ліміт), прив'язка клієнта до партнера.
  • Товари оптом. Пошук у каталозі партнера, інформація за товаром, винятки каталогу, доступні типи матеріалів.
  • Налаштування та ціни. Індивідуальні налаштування товару під партнера, роздрібні ціни поверх оптових.
  • Склад і роздріб. Прив'язка точок роздрібного джерела товару.
  • Замовлення оптом. Створення замовлення з боку дилера, фільтрація, переведення у внутрішнє замовлення фірми-постачальника.
  • Постачання. Створення постачання з оптового замовлення, список постачань, прив'язка позицій.

Зарплата та плани — 22 методи

  • Зміни. Відкриття, закриття, оновлення, видалення, список відкритих; коефіцієнти для святкових, нічних, звичайних змін.
  • Дод. документи. Бонуси, штрафи, коригування, прив'язані до зміни і працівника; CRUD.
  • Тарифи та звіти. Додавання тарифу на послугу, тарифи за фірмою, зведений звіт за працівниками за період.
  • Плани. План за замовчуванням на послугу, план на конкретну зміну, оновлення за типом послуги.

Точки продажу клієнтів — 4 методи

Прив'язка клієнта до філії/салону, щоб замовлення автоматично потрапляло до потрібного менеджера: отримати, отримати повний список, встановити, видалити.

Довідники та інше — 25 методів

  • Довідники. Фірми платформи, ролі користувачів, одиниці виміру, типи продавців, виробники матеріалів, валюти.
  • Типи та статуси. Послуги виробництва, типи послуг, типи товарів, статуси замовлень.
  • Валюти. Додавання курсу, статистика зміни за період.
  • Спеціальні позиції (SP). Точкові обробки/послуги — CRUD за позицією та її типом.
  • Інше. Бригади працівників, комірки складу, лейбли, бібліотека 3D-об'єктів, зображення товарів, імпорт/експорт проєктів.

Можливості, недоступні в адмін-панелі

  • Пакетні операції. Створення сотень замовлень одним викликом, масове переведення партії у виробництво, масове оновлення прайсу.
  • Читання сирих подій. Повний timeline замовлення з часовими мітками кожної зміни. В UI відображається лише підсумкова історія.
  • Машинні звіти з CNC. Метод cut_part_report викликається софтом верстата після завершення деталі — це потік даних із цеху в реальному часі.
  • Обмін з обліковою системою. Метод 1c_make_order і супутні — формат облікової системи один-в-один без перехідних таблиць.
  • Паралельні потоки оптової торгівлі. 31 метод розділу «Оптова торгівля» призначені для дилерських інтеграцій.
  • Кастомізація під партнера. Індивідуальні ціни, винятки каталогу, прив'язка до філій — програмне налаштування без правки в адмінці.

Повна документація — в адмін-панелі

В адмін-панелі відкрито розділ Документація API: інтерактивна документація у стилі Swagger. За кожним методом зазначено:

  • HTTP-метод і endpoint;
  • обов'язкові та опціональні параметри запиту, їхні типи і допустимі значення;
  • приклад JSON-запиту;
  • приклад відповіді з розшифруванням полів;
  • можливі коди помилок;
  • пісочниця — надсилання тестового запиту з браузера.

Документація оновлюється автоматично під час релізів платформи.

Авторизація та доступ

Запит підписується API-ключем фірми. Ключ зберігається в картці фірми і видається службою супроводу. Один ключ використовується на всю фірму одночасно з будь-якої кількості клієнтів: обмін з обліковою системою, мобільний застосунок, чат-бот, BI-дашборд.

Інтеграція з обліковою системою

В адмін-панелі — розділ «Пісочниця інтеграції з обліковою системою»: список точок звернення сервісу до облікової системи (ціни, залишки, зв'язки матеріал-кромка). Кожну точку можна протестувати з реальним запитом і побачити відповідь облікової системи. Після налаштування обмін іде автоматично.

Тарифікація

Підключення API не має окремої плати. API-ключ видається в межах загального тарифу супроводу фірми. Жорстких лімітів на кількість запитів немає.