API

Поиск

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

Часть возможностей реализована только в API и в админ-панели не отображается: пакетные операции, прямой обмен с учётной системой, отчёты от ЧПУ-станков по факту обработки детали, доступ к timeline-событиям заказа, межфирменные оптовые потоки.

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

Учётные системы. Двусторонний обмен заказами, ценами, остатками, статусами оплат.
Интернет-магазин или конфигуратор. Заказ из браузера клиента поступает в админку с готовой картой раскроя, программой ЧПУ и расчётной стоимостью.
Мобильное приложение замерщика. Проект, созданный у клиента, попадает в админку без переноса данных вручную.
B2B-кабинет для партнёров. Дилер видит свои цены, оформляет заказы за конечного клиента, читает статусы производства.
Производственные станки и QR-портал. ЧПУ-станки и этикеточные принтеры фиксируют выполненные операции через API.
Аналитика и BI. Выгрузка статистики по заказам, продажам, расходу материалов, операциям.
Чат-боты и уведомления. Telegram, Viber, голосовые ассистенты — каждый ходит в один и тот же API.

Основные разделы API

Заказы — 28 методов

Получение и создание. Создать заказ, прочитать список по фирме / клиенту / статусу / периоду, получить карточку с деталями и услугами, рассчитать стоимость до сохранения, импорт из учётной системы.
Управление статусами. В работу, в производство, в редактирование, отмена, готов к отгрузке, отгружен, на доставке, возврат на предыдущий статус.
События и timeline. История заказа: кто и когда менял статус, ставил отметку, отдавал на доставку.
Доп. услуги. Привязать собственные услуги к заказу или детали; постановка заказа в очередь генерации ЧПУ-программ.

Производство — 20 методов

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

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

Артикулы. Получение каталога, поиск по коду, по фильтру, по папке, обновление параметров.
Склад товаров. Создание поступления, обновление остатка, привязка товара к заказу, получение остатков на момент производства заказа.
Доп. информация и связи материалов. Произвольные пары «материал — кромка», «материал — производитель», «артикул — клиент»; полная номенклатура фирмы.

Клиенты и пользователи — 18 методов

Клиенты. Поиск / создание / обновление клиента, привязка внешнего кода, поиск по телефону, массовое обновление контактов.
Работники цеха. Список операторов и кладовщиков, создание, назначение роли, смена пароля, выдача QR-карты для входа в QR-портал.
Менеджеры и продажники. Список, проверка прав, привязка к точкам продаж, генерация нового пароля.

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

Фаска. CRUD по параметрам и связям с материалами/кромкой.
Радиусное скругление. Параметры фрезы, припуска, угла.
Срез под угол. Параметры фрезы, связи материал-кромка для каждого варианта.
Врезные ручки. J-профиль, GOLA, точечные; связи с типами кромки и параметрами покраски.
Покраска и связи. Назначение покраски на ручку, привязка цвета к кромке.

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

Партнёры. Список партнёров, свойства (наценка, валюта, кредитный лимит), привязка клиента к партнёру.
Товары оптом. Поиск в каталоге партнёра, информация по товару, исключения каталога, доступные типы материалов.
Настройки и цены. Индивидуальные настройки товара под партнёра, розничные цены поверх оптовых.
Склад и розница. Привязка точек розничного источника товара.
Заказы оптом. Создание заказа со стороны дилера, фильтрация, перевод во внутренний заказ фирмы-поставщика.
Поставки. Создание поставки из оптового заказа, список поставок, привязка позиций.

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

Смены. Открытие, закрытие, обновление, удаление, список открытых; коэффициенты для праздничных, ночных, простых смен.
Доп. документы. Бонусы, штрафы, корректировки, привязанные к смене и работнику; CRUD.
Тарифы и отчёты. Добавление тарифа на услугу, тарифы по фирме, сводный отчёт по работникам за период.
Планы. План по умолчанию на услугу, план на конкретную смену, обновление по типу услуги.

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

Привязка клиента к филиалу/салону, чтобы заказ автоматически попадал к нужному менеджеру: получить, получить полный список, установить, удалить.

Справочники и прочее — 25 методов

Справочники. Фирмы платформы, роли пользователей, единицы измерения, типы продажников, производители материалов, валюты.
Типы и статусы. Услуги производства, типы услуг, типы товаров, статусы заказов.
Валюты. Добавление курса, статистика изменения за период.
Специальные позиции (SP). Точечные обработки/услуги — CRUD по позиции и её типу.
Прочее. Бригады работников, ячейки склада, лейблы, библиотека 3D-объектов, изображения товаров, импорт/экспорт проектов.

Возможности, недоступные в админ-панели

Пакетные операции. Создание сотен заказов одним вызовом, массовый перевод партии в производство, массовое обновление прайса.
Чтение сырых событий. Полный timeline заказа с временными метками каждого изменения. В UI отображается только итоговая история.
Машинные отчёты с ЧПУ. Метод cut_part_report вызывается софтом станка после завершения детали — это поток данных из цеха в реальном времени.
Обмен с учётной системой. Метод 1c_make_order и сопутствующие — формат учётной системы один-в-один без переходных таблиц.
Параллельные потоки оптовой торговли. 31 метод раздела «Оптовая торговля» предназначены для дилерских интеграций.
Кастомизация под партнёра. Индивидуальные цены, исключения каталога, привязка к филиалам — программная настройка без правки в админке.

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

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

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

Документация обновляется автоматически при релизах платформы.

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

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

Интеграция с учётной системой

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

Тарификация

Подключение API не имеет отдельной платы. API-ключ выдаётся в рамках общего тарифа сопровождения фирмы. Жёстких лимитов на число запросов нет.