Employee API
Основной рабочий API системы. Используется фронтендом (веб-интерфейс) и мобильными устройствами (ТСД).
Префикс: /employee-api/
Аутентификация: JWT-токен
Аутентификация
POST /employee-api/auth/login
Body: { "login": "operator1", "password": "..." }
Response: { "token": "eyJ..." }
| Endpoint | Метод | Описание |
|---|---|---|
/auth/login | POST | Получение JWT-токена |
/auth/change-warehouse | POST | Смена текущего склада |
/auth/change-workspace | POST | Смена рабочего пространства |
Справочники (/employee-api/entities)
Универсальный CRUD для всех типов справочников через конструктор форм.
| Endpoint | Метод | Описание |
|---|---|---|
/entities/types | GET | Типы сущностей по категориям (ORGANIZATIONS, EMPLOYEE, SKU, WAREHOUSE, OTHER) |
/entities/ | GET | Быстрый поиск по типу и строке |
/entities/list/template | GET | Шаблон списка (колонки, фильтры, действия) |
/entities/list | POST | Данные списка с пагинацией и фильтрами |
/entities/list/action | POST | Действие над выбранными записями |
/entities/edit/template | GET | Шаблон формы редактирования + данные |
/entities/edit | POST | Сохранение с ущности |
/entities/edit/action | POST | Действие из формы |
/entities/edit/file/* | GET/POST/DELETE | Работа с файлами |
/entities/changes | GET | История изменений (Envers audit) |
Документы (/employee-api/documents)
Аналогичный универсальный CRUD для всех 33 типов документов.
| Endpoint | Метод | Описание |
|---|---|---|
/documents/types | GET | Типы документов по категориям (WAREHOUSE, RECEIPT, SHIPMENT) |
/documents/ | GET | Поиск документов по типу и строке |
/documents/list/template | GET | Шаблон списка |
/documents/list | POST | Данные списка |
/documents/list/action | POST | Действие над документами |
/documents/edit/template | GET | Шаблон формы + данные |
/documents/edit | POST | Сохранение документа |
/documents/edit/action | POST | Действие из формы |
/documents/edit/file/* | GET/POST/DELETE | Файлы |
/documents/related | GET | Дерево связанных документов (parent-child) |
/documents/changes | GET | История изменений (Envers) |
/documents/status-history | GET | История смены статусов |
Операции (складские АРМы)
Контроллеры в controller/employeeapi/operation/ — специализированные endpoint'ы для складских операций.
Заказы и батчи
| Контроллер | Префикс | Операции |
|---|---|---|
OrderBatchController | /order-batches | Формирование батчей, аллокация заказов |
OrderMonitoringController | /order-monitoring | Мониторинг статусов заказов |
Приёмка
| Контроллер | Префикс | Операции |
|---|---|---|
UnloadingController | /unloading | Разгрузка транспорта |
| Контроллеры приёмки | /receiving | Приёмка товаров, контроль качества |
PlacingController | /placing | Размещение на хранение |
ReturningController | /returning | Обработка возвратов |
Отбор и отгрузка
| Контроллер | Префикс | Операции |
|---|---|---|
PickingController | /picking | Отбор товаров |
ReplenishmentController | /replenishment | Подпитка зон отбора |
SortingController | /sorting | Сортировка по заказам |
PackingController | /packing | Упаковка заказов |
LoadingController | /loading | Погрузка в транспорт |
Складские операции
| Контроллер | Префикс | Операции |
|---|---|---|
MovementController | /movement | Внутрискладские перемещения |
InventoryController | /inventory | Инвентаризация |
BundleController | /bundle | Сборка наборов/комплектов |
AdditionalProcessingController | /additional-processing | Доп. обработка (маркировка, стикеровка) |
TransportUnitController | /transport-unit | Управление транспортными местами |
Информационные
| Контроллер | Префикс | Описание |
|---|---|---|
| Warehouse | /warehouse | Конфигурация склада |
| Employee | /employee | Управление пользователями |
| SKU | /sku | Каталог товаров |