REST API для ERP и 1С

Интеграция снимает двойной ввод: заказы уезжают из ERP на площадку, ставки и статусы возвращаются обратно.

Расчёт стоимости

POST /api/quote
Content-Type: application/json

{
  "category": "cnc_lathe",
  "material": "aisi304",
  "qty": 250,
  "dim_x": 62, "dim_y": 62, "dim_z": 95,
  "tolerance_um": 25,
  "roughness": 1.6,
  "coating": "zinc",
  "deadline_days": 30
}

Ответ содержит вилку цены min/max, цену за штуку, срок в днях, массу заготовки и разбивку по статьям.

Лента заказов

GET /api/orders?category=cnc_mill3®ion=Москва&status=bidding&limit=20

Каталог производств

GET /api/suppliers?category=laser&verify=2&material=stainless:aisi_316l

Фильтр material принимает идентификатор из справочника марок (см. ниже). В ответе у каждого цеха — станочный парк и список заявленных материалов.

Подбор производств под заказ

GET /api/matches?order=124&limit=10

Возвращает цеха, у которых сходятся технология, рабочая зона, достижимая точность и заявленный материал, с оценкой score (0–100), уровнем confidence (high / medium / low), подобранным станком и списком причин. Каждая причина — объект { text, kind }, где kind равен ok для подтверждённого совпадения и warn для пробела в данных цеха.

Справочники

GET /api/reference

Коды операций, материалы с плотностью и ценой, покрытия, ряды допусков и шероховатости.

GET /api/materials?q=316

Полный справочник материалов и марок: 18 групп от сталей до технической керамики. Поле value — стабильный идентификатор для фильтров и профиля цеха.

GET  /api/company/materials?company=12
POST /api/company/materials

Материалы конкретного производства. Запись доступна владельцу профиля цеха.

Аутентификация и лимиты

Методы на чтение открыты без ключа и ограничены 120 запросами в минуту с адреса — этого хватает и живому пользователю, и обмену с 1С. Запись (материалы цеха, действия в кабинете) доступна только владельцу профиля по сессии. Выгрузка сделок в учётную систему идёт отдельным ключом в заголовке Authorization: Bearer <token> — ключ выдаёт оператор площадки.