@hubex/mcp 0.9.20260922 → 0.9.20260923

package/generated/index.dev.json

@@ -10908,7 +10908,7 @@
       "service": "SC",
       "method": "DELETE",
       "path": "/ServiceContract",
-      "summary": "Метод для удаления договоров",
+      "summary": "Удаление договоров обслуживания",
       "tags": [
         "ServiceContract"
       ],
@@ -10922,7 +10922,7 @@
       "service": "SC",
       "method": "DELETE",
       "path": "/ServiceContract/{contractID}/assets",
-      "summary": "Метод удаления объектов связанных с договорами",
+      "summary": "Удаляет список объектов, привязанных к сервисному договору",
       "tags": [
         "ServiceContract"
       ],
@@ -10938,7 +10938,7 @@
       "service": "SC",
       "method": "DELETE",
       "path": "/ServiceContract/{contractID}/assets/{assetID}",
-      "summary": "Метод удаления объекта сязанного с сервисным договором",
+      "summary": "Удаляет объект, привязанный к сервисному договору",
       "tags": [
         "ServiceContract"
       ],
@@ -10955,7 +10955,7 @@
       "service": "SC",
       "method": "DELETE",
       "path": "/ServiceContract/{contractID}/attachments",
-      "summary": "Метод помечает связку договора и вложения как удаленную",
+      "summary": "Помечает связи договора и вложений как удалённые",
       "tags": [
         "ServiceContract"
       ],
@@ -10971,7 +10971,7 @@
       "service": "SC",
       "method": "DELETE",
       "path": "/ServiceContract/{contractID}/contacts",
-      "summary": "Метод удаления контактов привязанных к договорам",
+      "summary": "Удаляет список контактов, привязанных к сервисному договору",
       "tags": [
         "ServiceContract"
       ],
@@ -10987,7 +10987,7 @@
       "service": "SC",
       "method": "DELETE",
       "path": "/ServiceContract/{contractID}/contacts/{contactID}",
-      "summary": "Метод удаления контакта привязанного к договору по Id",
+      "summary": "Удаляет контакт, привязанный к сервисному договору",
       "tags": [
         "ServiceContract"
       ],
@@ -11004,7 +11004,7 @@
       "service": "SC",
       "method": "DELETE",
       "path": "/ServiceContract/{id}",
-      "summary": "Метод для удаления договора",
+      "summary": "Удаление договора обслуживания по идентификатору",
       "tags": [
         "ServiceContract"
       ],
@@ -11020,7 +11020,7 @@
       "service": "SC",
       "method": "GET",
       "path": "/ServiceContract",
-      "summary": "Метод получения списка договоров обслуживания",
+      "summary": "Получение списка договоров обслуживания",
       "tags": [
         "ServiceContract"
       ],
@@ -11045,7 +11045,7 @@
       "service": "SC",
       "method": "GET",
       "path": "/ServiceContract/{contractID}",
-      "summary": "Метод получения договора обслуживания по ID",
+      "summary": "Получение договора обслуживания по идентификатору",
       "tags": [
         "ServiceContract"
       ],
@@ -11061,7 +11061,7 @@
       "service": "SC",
       "method": "GET",
       "path": "/ServiceContract/{contractID}/assets",
-      "summary": "Метод получения списка объектов сервисного договора",
+      "summary": "Возвращает список объектов, привязанных к сервисному договору",
       "tags": [
         "ServiceContract"
       ],
@@ -11080,7 +11080,7 @@
       "service": "SC",
       "method": "GET",
       "path": "/ServiceContract/{contractID}/attachment/{attachmentID}",
-      "summary": "Метод получения прикрепленного к договору файла вложения",
+      "summary": "Возвращает прикреплённый к договору файл-вложение",
       "tags": [
         "ServiceContract"
       ],
@@ -11099,7 +11099,7 @@
       "service": "SC",
       "method": "GET",
       "path": "/ServiceContract/{contractID}/attachments",
-      "summary": "Метод получения списка файлов вложений прикрепленных к договору",
+      "summary": "Возвращает список файлов-вложений, прикреплённых к договору",
       "tags": [
         "ServiceContract"
       ],
@@ -11119,7 +11119,7 @@
       "service": "SC",
       "method": "GET",
       "path": "/ServiceContract/{contractID}/attachments/{attachmentID}",
-      "summary": "Метод получения TemporaryRedirect на временную ссылку для скачки файла",
+      "summary": "Возвращает временную ссылку для скачивания файла-вложения",
       "tags": [
         "ServiceContract"
       ],
@@ -11129,9 +11129,7 @@
       ],
       "queryParams": [
         "thumbnailSize",
-        "noRedirect",
-        "offset",
-        "fetch"
+        "noRedirect"
       ],
       "hasBody": false,
       "bodyRequired": false
@@ -11141,7 +11139,7 @@
       "service": "SC",
       "method": "GET",
       "path": "/ServiceContract/{contractID}/attributes",
-      "summary": "Возвращает список пользовтельских полей по договору",
+      "summary": "Возвращает список пользовательских полей сервисного договора",
       "tags": [
         "ServiceContract"
       ],
@@ -11160,7 +11158,7 @@
       "service": "SC",
       "method": "GET",
       "path": "/ServiceContract/{contractID}/contacts",
-      "summary": "Метод получения списка контактов ответственных по договору",
+      "summary": "Возвращает список контактов, привязанных к сервисному договору",
       "tags": [
         "ServiceContract"
       ],
@@ -11179,13 +11177,15 @@
       "service": "SC",
       "method": "HEAD",
       "path": "/ServiceContract",
-      "summary": "Метод получения общего количества договоров обслуживания",
+      "summary": "Получение общего количества договоров обслуживания",
       "tags": [
         "ServiceContract"
       ],
       "pathParams": [],
       "queryParams": [
         "searchText",
+        "offset",
+        "fetch",
         "taskID",
         "assetID",
         "includeUniversalContractsInAssetFilter",
@@ -11202,7 +11202,7 @@
       "service": "SC",
       "method": "POST",
       "path": "/ContractAttributes",
-      "summary": "Обновляет сведения о пользовательских полях объектов",
+      "summary": "Обновляет сведения о пользовательских полях договоров",
       "tags": [
         "ContractAttributes"
       ],
@@ -11216,7 +11216,7 @@
       "service": "SC",
       "method": "POST",
       "path": "/ServiceContract",
-      "summary": "Метод для создания или обновления договора/договоров обслуживания",
+      "summary": "Создание договоров обслуживания",
       "tags": [
         "ServiceContract"
       ],
@@ -11230,7 +11230,7 @@
       "service": "SC",
       "method": "POST",
       "path": "/ServiceContract/{contractID}/assets",
-      "summary": "Добавить список объектов к договору",
+      "summary": "Добавляет список объектов к сервисному договору",
       "tags": [
         "ServiceContract"
       ],
@@ -11246,7 +11246,7 @@
       "service": "SC",
       "method": "POST",
       "path": "/ServiceContract/{contractID}/attachments",
-      "summary": "Метод связывающий договор и вложение",
+      "summary": "Связывает договор с существующими вложениями",
       "tags": [
         "ServiceContract"
       ],
@@ -11262,7 +11262,7 @@
       "service": "SC",
       "method": "POST",
       "path": "/ServiceContract/{contractID}/attachments/upload/fromBody",
-      "summary": "Метод загружает файл на файловый сервер и привязывает его к договору. Данные будут получены из тела запроса.",
+      "summary": "Загружает файл на файловый сервер и привязывает его к договору (данные из тела запроса)",
       "tags": [
         "ServiceContract"
       ],
@@ -11278,7 +11278,7 @@
       "service": "SC",
       "method": "POST",
       "path": "/ServiceContract/{contractID}/attachments/upload/fromForm",
-      "summary": "Метод загружает файл на файловый сервер и привязывает его к договору. Данные будут получены из формы.",
+      "summary": "Загружает файл на файловый сервер и привязывает его к договору (данные из формы)",
       "tags": [
         "ServiceContract"
       ],
@@ -11294,7 +11294,7 @@
       "service": "SC",
       "method": "POST",
       "path": "/ServiceContract/{contractID}/contacts",
-      "summary": "Метод добавления контактов к договорам",
+      "summary": "Добавляет список контактов к сервисному договору",
       "tags": [
         "ServiceContract"
       ],
@@ -11310,7 +11310,7 @@
       "service": "SC",
       "method": "POST",
       "path": "/ServiceContract/{contractID}/v2/attachments/upload/fromForm",
-      "summary": "Метод загружает файлы на файловый сервер и привязывает его к договору. Данные будут получены из формы.",
+      "summary": "Загружает несколько файлов на файловый сервер и привязывает их к договору (данные из формы)",
       "tags": [
         "ServiceContract"
       ],
@@ -11326,7 +11326,7 @@
       "service": "SC",
       "method": "PUT",
       "path": "/ServiceContract",
-      "summary": "Метод изменения существующей заявки(ок)",
+      "summary": "Изменение договоров обслуживания",
       "tags": [
         "ServiceContract"
       ],
@@ -11340,7 +11340,7 @@
       "service": "SC",
       "method": "PUT",
       "path": "/ServiceContract/{contractID}/assets/{assetID}",
-      "summary": "Добавить объект к договору",
+      "summary": "Добавляет объект к сервисному договору",
       "tags": [
         "ServiceContract"
       ],
@@ -11359,7 +11359,7 @@
       "service": "SC",
       "method": "PUT",
       "path": "/ServiceContract/{contractID}/contacts/{contactID}",
-      "summary": "Метод добавления контакта к договору",
+      "summary": "Добавляет контакт к сервисному договору",
       "tags": [
         "ServiceContract"
       ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hubex/mcp",
-  "version": "0.9.20260922",
+  "version": "0.9.20260923",
   "type": "module",
   "description": "MCP server for managing HubEx test data (tasks, assets, companies, users) via the HubEx REST API",
   "author": "HubEx Team",

package/swagger/dev/IMPORT.json

@@ -21,7 +21,7 @@
           "Assets"
         ],
         "summary": "Импорт объектов и оборудования из Excel-файла",
-        "description": "## Пример запроса:\r\n`POST /Assets`\r\n            \r\nContent-Type: `multipart/form-data`\r\n            \r\nПоле формы: `File` — Excel-файл (.xlsx) с листом `Объекты и оборудование`.\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа отсутствует. Импорт объектов принят в обработку.\r\n            \r\n## Пример ошибки валидации файла (409):\r\nВозвращается Excel-файл с теми же данными и комментариями в ячейках с ошибками.\r\nВ заголовке ответа присутствует `X-Application-Errors: InvalidData`.\r\n            \r\n## Пример ошибки (409):\r\n```json\r\n[\r\n  {\r\n    \"traceIdentifier\": \"00-abc123\",\r\n    \"code\": \"InvalidData\",\r\n    \"message\": \"Загружен неверный файл\"\r\n  }\r\n]\r\n```\r\n## Негативные сценарии:\r\n- 409 Conflict: в файле есть ошибки валидации строк/ячеек — возвращается Excel с комментариями.\r\n- 409 Conflict: отсутствует лист `Объекты и оборудование` (`WrongFile`) или лист пустой (`EmptyFile`).\r\n- 409 Conflict: файл создан в неподдерживаемом приложении (например, MyOffice) — `UnsupportedFileFormat`.\r\n- 409 Conflict: отсутствует обязательное поле формы `File` или тело запроса некорректно.\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `AssetsImport`.",
+        "description": "## Пример запроса:\r\n`POST /Assets`\r\n            \r\nContent-Type: `multipart/form-data`\r\n            \r\nПоле формы: `File` — Excel-файл (.xlsx) с листом, имя которого зависит от `Accept-Language`\r\n(ru: `Объекты и оборудование`, en: `Assets`).\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа отсутствует. Импорт объектов принят в обработку.\r\n            \r\n## Пример ошибки валидации файла (409):\r\nВозвращается Excel-файл с теми же данными и комментариями в ячейках с ошибками.\r\nВ заголовке ответа присутствует `X-Application-Errors: InvalidData`.\r\n            \r\n## Пример ошибки (409):\r\n```json\r\n[\r\n  {\r\n    \"traceIdentifier\": \"00-abc123\",\r\n    \"code\": \"InvalidData\",\r\n    \"message\": \"Загружен неверный файл\"\r\n  }\r\n]\r\n```\r\n## Негативные сценарии:\r\n- 409 Conflict: в файле есть ошибки валидации строк/ячеек — возвращается Excel с комментариями\r\n  (`Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`,\r\n  заголовок `X-Application-Errors: InvalidData`).\r\n- 409 Conflict: отсутствует лист с ожидаемым именем (`WrongFile`) или лист пустой (`EmptyFile`).\r\n  Имя листа зависит от `Accept-Language` (ru: `Объекты и оборудование`, en: `Assets`).\r\n- 409 Conflict: файл создан в неподдерживаемом приложении (например, MyOffice) — `UnsupportedFileFormat`.\r\n- Отсутствует обязательное поле формы `File` или тело запроса некорректно —\r\n  обрабатывается model binding / global exception handling (не 409 Conflict).\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `AssetsImport`.",
         "parameters": [
           {
             "name": "X-Application-ID",
@@ -209,7 +209,7 @@
             "description": "Недостаточно прав для импорта объектов."
           },
           "409": {
-            "description": "Ошибка валидации файла или бизнес-конфликт.\r\nПри ошибках строк возвращается Excel-файл с комментариями;\r\nпри прочих ошибках — тело System.Collections.Generic.List`1.",
+            "description": "Ошибка валидации файла или бизнес-конфликт.\r\nПри ошибках строк — Excel-файл с комментариями и заголовком `X-Application-Errors: InvalidData`;\r\nпри прочих конфликтах — JSON System.Collections.Generic.List`1.",
             "content": {
               "text/plain": {
                 "schema": {
@@ -251,7 +251,7 @@
           "Companies"
         ],
         "summary": "Импорт компаний из Excel-файла",
-        "description": "## Пример запроса:\r\n`POST /Companies`\r\n            \r\nContent-Type: `multipart/form-data`\r\n            \r\nПоле формы: `File` — Excel-файл (.xlsx) с листом `Компании`.\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа отсутствует. Импорт компаний принят в обработку.\r\n            \r\n## Пример ошибки валидации файла (409):\r\nВозвращается Excel-файл с теми же данными и комментариями в ячейках с ошибками.\r\nВ заголовке ответа присутствует `X-Application-Errors: InvalidData`.\r\n            \r\n## Пример ошибки (409):\r\n```json\r\n[\r\n  {\r\n    \"traceIdentifier\": \"00-abc123\",\r\n    \"code\": \"InvalidData\",\r\n    \"message\": \"Загружен неверный файл\"\r\n  }\r\n]\r\n```\r\n## Негативные сценарии:\r\n- 409 Conflict: в файле есть ошибки валидации строк/ячеек — возвращается Excel с комментариями.\r\n- 409 Conflict: отсутствует лист `Компании` (`WrongFile`) или лист пустой (`EmptyFile`).\r\n- 409 Conflict: файл создан в неподдерживаемом приложении (например, MyOffice) — `UnsupportedFileFormat`.\r\n- 409 Conflict: отсутствует обязательное поле формы `File` или тело запроса некорректно.\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `CompaniesImport`.",
+        "description": "## Пример запроса:\r\n`POST /Companies`\r\n            \r\nContent-Type: `multipart/form-data`\r\n            \r\nПоле формы: `File` — Excel-файл (.xlsx) с листом, имя которого зависит от `Accept-Language`\r\n(ru: `Компании`, en: `Companies`).\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа отсутствует. Импорт компаний принят в обработку.\r\n            \r\n## Пример ошибки валидации файла (409):\r\nВозвращается Excel-файл с теми же данными и комментариями в ячейках с ошибками.\r\nВ заголовке ответа присутствует `X-Application-Errors: InvalidData`.\r\n            \r\n## Пример ошибки (409):\r\n```json\r\n[\r\n  {\r\n    \"traceIdentifier\": \"00-abc123\",\r\n    \"code\": \"InvalidData\",\r\n    \"message\": \"Загружен неверный файл\"\r\n  }\r\n]\r\n```\r\n## Негативные сценарии:\r\n- 409 Conflict: в файле есть ошибки валидации строк/ячеек — возвращается Excel с комментариями\r\n  (`Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`,\r\n  заголовок `X-Application-Errors: InvalidData`).\r\n- 409 Conflict: отсутствует лист с ожидаемым именем (`WrongFile`) или лист пустой (`EmptyFile`).\r\n  Имя листа зависит от `Accept-Language` (ru: `Компании`, en: `Companies`).\r\n- 409 Conflict: файл создан в неподдерживаемом приложении (например, MyOffice) — `UnsupportedFileFormat`.\r\n- Отсутствует обязательное поле формы `File` или тело запроса некорректно —\r\n  обрабатывается model binding / global exception handling (не 409 Conflict).\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `CompaniesImport`.",
         "parameters": [
           {
             "name": "X-Application-ID",
@@ -439,7 +439,7 @@
             "description": "Недостаточно прав для импорта компаний."
           },
           "409": {
-            "description": "Ошибка валидации файла или бизнес-конфликт.\r\nПри ошибках строк возвращается Excel-файл с комментариями;\r\nпри прочих ошибках — тело System.Collections.Generic.List`1.",
+            "description": "Ошибка валидации файла или бизнес-конфликт.\r\nПри ошибках строк — Excel-файл с комментариями и заголовком `X-Application-Errors: InvalidData`;\r\nпри прочих конфликтах — JSON System.Collections.Generic.List`1.",
             "content": {
               "text/plain": {
                 "schema": {
@@ -481,7 +481,7 @@
           "Materials"
         ],
         "summary": "Импорт материалов из Excel-файла (v1)",
-        "description": "## Пример запроса:\r\n`POST /Materials`\r\n            \r\nContent-Type: `multipart/form-data`\r\n            \r\nПоле формы: `File` — Excel-файл (.xlsx) с листом `Материалы`.\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа отсутствует. Импорт материалов принят в обработку.\r\n            \r\n## Пример ошибки валидации файла (409):\r\nВозвращается Excel-файл с теми же данными и комментариями в ячейках с ошибками.\r\nВ заголовке ответа присутствует `X-Application-Errors: InvalidData`.\r\n            \r\n## Пример ошибки (409):\r\n```json\r\n[\r\n  {\r\n    \"traceIdentifier\": \"00-abc123\",\r\n    \"code\": \"InvalidData\",\r\n    \"message\": \"Загружен неверный файл\"\r\n  }\r\n]\r\n```\r\n## Негативные сценарии:\r\n- 409 Conflict: в файле есть ошибки валидации строк/ячеек — возвращается Excel с комментариями.\r\n- 409 Conflict: отсутствует лист `Материалы` (`WrongFile`) или лист пустой (`EmptyFile`).\r\n- 409 Conflict: файл создан в неподдерживаемом приложении (например, MyOffice) — `UnsupportedFileFormat`.\r\n- 409 Conflict: отсутствует обязательное поле формы `File` или тело запроса некорректно.\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `MaterialImport`.",
+        "description": "## Пример запроса:\r\n`POST /Materials`\r\n            \r\nContent-Type: `multipart/form-data`\r\n            \r\nПоле формы: `File` — Excel-файл (.xlsx) с листом, имя которого зависит от `Accept-Language`\r\n(ru: `Материалы`, en: `Materials`).\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа отсутствует. Импорт материалов принят в обработку.\r\n            \r\n## Пример ошибки валидации файла (409):\r\nВозвращается Excel-файл с теми же данными и комментариями в ячейках с ошибками.\r\nВ заголовке ответа присутствует `X-Application-Errors: InvalidData`.\r\n            \r\n## Пример ошибки (409):\r\n```json\r\n[\r\n  {\r\n    \"traceIdentifier\": \"00-abc123\",\r\n    \"code\": \"InvalidData\",\r\n    \"message\": \"Загружен неверный файл\"\r\n  }\r\n]\r\n```\r\n## Негативные сценарии:\r\n- 409 Conflict: в файле есть ошибки валидации строк/ячеек — возвращается Excel с комментариями\r\n  (`Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`,\r\n  заголовок `X-Application-Errors: InvalidData`).\r\n- 409 Conflict: отсутствует лист с ожидаемым именем (`WrongFile`) или лист пустой (`EmptyFile`).\r\n  Имя листа зависит от `Accept-Language` (ru: `Материалы`, en: `Materials`).\r\n- 409 Conflict: файл создан в неподдерживаемом приложении (например, MyOffice) — `UnsupportedFileFormat`.\r\n- Отсутствует обязательное поле формы `File` или тело запроса некорректно —\r\n  обрабатывается model binding / global exception handling (не 409 Conflict).\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `MaterialImport`.",
         "parameters": [
           {
             "name": "X-Application-ID",
@@ -669,7 +669,7 @@
             "description": "Недостаточно прав для импорта материалов."
           },
           "409": {
-            "description": "Ошибка валидации файла или бизнес-конфликт.\r\nПри ошибках строк возвращается Excel-файл с комментариями;\r\nпри прочих ошибках — тело System.Collections.Generic.List`1.",
+            "description": "Ошибка валидации файла или бизнес-конфликт.\r\nПри ошибках строк — Excel-файл с комментариями и заголовком `X-Application-Errors: InvalidData`;\r\nпри прочих конфликтах — JSON System.Collections.Generic.List`1.",
             "content": {
               "text/plain": {
                 "schema": {
@@ -711,7 +711,7 @@
           "Materials"
         ],
         "summary": "Импорт материалов из Excel-файла (v2)",
-        "description": "## Пример запроса:\r\n`POST /Materials/v2.0`\r\n            \r\nContent-Type: `multipart/form-data`\r\n            \r\nПоле формы: `File` — Excel-файл (.xlsx) с листом `Материалы`.\r\n            \r\nПеред записью строки группируются по `MaterialErpID` (для каждого ERP ID сохраняется последняя запись).\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа отсутствует. Импорт материалов принят в обработку.\r\n            \r\n## Пример ошибки валидации файла (409):\r\nВозвращается Excel-файл с теми же данными и комментариями в ячейках с ошибками.\r\nВ заголовке ответа присутствует `X-Application-Errors: InvalidData`.\r\n            \r\n## Пример ошибки (409):\r\n```json\r\n[\r\n  {\r\n    \"traceIdentifier\": \"00-abc123\",\r\n    \"code\": \"InvalidData\",\r\n    \"message\": \"Загружен неверный файл\"\r\n  }\r\n]\r\n```\r\n## Негативные сценарии:\r\n- 409 Conflict: в файле есть ошибки валидации строк/ячеек — возвращается Excel с комментариями.\r\n- 409 Conflict: отсутствует лист `Материалы` (`WrongFile`) или лист пустой (`EmptyFile`).\r\n- 409 Conflict: файл создан в неподдерживаемом приложении (например, MyOffice) — `UnsupportedFileFormat`.\r\n- 409 Conflict: отсутствует обязательное поле формы `File` или тело запроса некорректно.\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `MaterialImport`.",
+        "description": "## Пример запроса:\r\n`POST /Materials/v2.0`\r\n            \r\nContent-Type: `multipart/form-data`\r\n            \r\nПоле формы: `File` — Excel-файл (.xlsx) с листом, имя которого зависит от `Accept-Language`\r\n(ru: `Материалы`, en: `Materials`).\r\n            \r\nПеред записью строки группируются по `MaterialErpID` (для каждого ERP ID сохраняется последняя запись).\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа отсутствует. Импорт материалов принят в обработку.\r\n            \r\n## Пример ошибки валидации файла (409):\r\nВозвращается Excel-файл с теми же данными и комментариями в ячейках с ошибками.\r\nВ заголовке ответа присутствует `X-Application-Errors: InvalidData`.\r\n            \r\n## Пример ошибки (409):\r\n```json\r\n[\r\n  {\r\n    \"traceIdentifier\": \"00-abc123\",\r\n    \"code\": \"InvalidData\",\r\n    \"message\": \"Загружен неверный файл\"\r\n  }\r\n]\r\n```\r\n## Негативные сценарии:\r\n- 409 Conflict: в файле есть ошибки валидации строк/ячеек — возвращается Excel с комментариями\r\n  (`Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`,\r\n  заголовок `X-Application-Errors: InvalidData`).\r\n- 409 Conflict: отсутствует лист с ожидаемым именем (`WrongFile`) или лист пустой (`EmptyFile`).\r\n  Имя листа зависит от `Accept-Language` (ru: `Материалы`, en: `Materials`).\r\n- 409 Conflict: файл создан в неподдерживаемом приложении (например, MyOffice) — `UnsupportedFileFormat`.\r\n- Отсутствует обязательное поле формы `File` или тело запроса некорректно —\r\n  обрабатывается model binding / global exception handling (не 409 Conflict).\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `MaterialImport`.",
         "parameters": [
           {
             "name": "X-Application-ID",
@@ -899,7 +899,7 @@
             "description": "Недостаточно прав для импорта материалов."
           },
           "409": {
-            "description": "Ошибка валидации файла или бизнес-конфликт.\r\nПри ошибках строк возвращается Excel-файл с комментариями;\r\nпри прочих ошибках — тело System.Collections.Generic.List`1.",
+            "description": "Ошибка валидации файла или бизнес-конфликт.\r\nПри ошибках строк — Excel-файл с комментариями и заголовком `X-Application-Errors: InvalidData`;\r\nпри прочих конфликтах — JSON System.Collections.Generic.List`1.",
             "content": {
               "text/plain": {
                 "schema": {
@@ -941,7 +941,7 @@
           "Tasks"
         ],
         "summary": "Импорт заявок из Excel-файла",
-        "description": "## Пример запроса:\r\n`POST /Tasks`\r\n            \r\nContent-Type: `multipart/form-data`\r\n            \r\nПоле формы: `File` — Excel-файл (.xlsx) с листом `Заявки`.\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа отсутствует. Импорт заявок принят в обработку.\r\nПосле импорта асинхронно отправляются уведомления и запросы на перевод по стадиям.\r\n            \r\n## Пример ошибки валидации файла (409):\r\nВозвращается Excel-файл с теми же данными и комментариями в ячейках с ошибками.\r\nВ заголовке ответа присутствует `X-Application-Errors: InvalidData`.\r\n            \r\n## Пример ошибки (409):\r\n```json\r\n[\r\n  {\r\n    \"traceIdentifier\": \"00-abc123\",\r\n    \"code\": \"InvalidData\",\r\n    \"message\": \"Загружен неверный файл\"\r\n  }\r\n]\r\n```\r\n## Негативные сценарии:\r\n- 409 Conflict: в файле есть ошибки валидации строк/ячеек — возвращается Excel с комментариями.\r\n- 409 Conflict: отсутствует лист `Заявки` (`WrongFile`) или лист пустой (`EmptyFile`).\r\n- 409 Conflict: файл создан в неподдерживаемом приложении (например, MyOffice) — `UnsupportedFileFormat`.\r\n- 409 Conflict: отсутствует обязательное поле формы `File` или тело запроса некорректно.\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `TaskImport`.",
+        "description": "## Пример запроса:\r\n`POST /Tasks`\r\n            \r\nContent-Type: `multipart/form-data`\r\n            \r\nПоле формы: `File` — Excel-файл (.xlsx) с листом, имя которого зависит от `Accept-Language`\r\n(ru: `Заявки`, en: `Tasks`).\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа отсутствует. Импорт заявок принят в обработку.\r\nПосле импорта асинхронно отправляются уведомления и запросы на перевод по стадиям.\r\n            \r\n## Пример ошибки валидации файла (409):\r\nВозвращается Excel-файл с теми же данными и комментариями в ячейках с ошибками.\r\nВ заголовке ответа присутствует `X-Application-Errors: InvalidData`.\r\n            \r\n## Пример ошибки (409):\r\n```json\r\n[\r\n  {\r\n    \"traceIdentifier\": \"00-abc123\",\r\n    \"code\": \"InvalidData\",\r\n    \"message\": \"Загружен неверный файл\"\r\n  }\r\n]\r\n```\r\n## Негативные сценарии:\r\n- 409 Conflict: в файле есть ошибки валидации строк/ячеек — возвращается Excel с комментариями\r\n  (`Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`,\r\n  заголовок `X-Application-Errors: InvalidData`).\r\n- 409 Conflict: отсутствует лист с ожидаемым именем (`WrongFile`) или лист пустой (`EmptyFile`).\r\n  Имя листа зависит от `Accept-Language` (ru: `Заявки`, en: `Tasks`).\r\n- 409 Conflict: файл создан в неподдерживаемом приложении (например, MyOffice) — `UnsupportedFileFormat`.\r\n- Отсутствует обязательное поле формы `File` или тело запроса некорректно —\r\n  обрабатывается model binding / global exception handling (не 409 Conflict).\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `TaskImport`.",
         "parameters": [
           {
             "name": "X-Application-ID",
@@ -1129,7 +1129,7 @@
             "description": "Недостаточно прав для импорта заявок."
           },
           "409": {
-            "description": "Ошибка валидации файла или бизнес-конфликт.\r\nПри ошибках строк возвращается Excel-файл с комментариями;\r\nпри прочих ошибках — тело System.Collections.Generic.List`1.",
+            "description": "Ошибка валидации файла или бизнес-конфликт.\r\nПри ошибках строк — Excel-файл с комментариями и заголовком `X-Application-Errors: InvalidData`;\r\nпри прочих конфликтах — JSON System.Collections.Generic.List`1.",
             "content": {
               "text/plain": {
                 "schema": {
@@ -1171,7 +1171,7 @@
           "Users"
         ],
         "summary": "Импорт пользователей из Excel-файла",
-        "description": "## Пример запроса:\r\n`POST /Users`\r\n            \r\nContent-Type: `multipart/form-data`\r\n            \r\nПоле формы: `File` — Excel-файл (.xlsx) с листом `Пользователи`.\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа отсутствует. Импорт пользователей принят в обработку.\r\nПосле импорта отправляются приглашения на верификацию аккаунта.\r\n            \r\n## Пример ошибки валидации файла (409):\r\nВозвращается Excel-файл с теми же данными и комментариями в ячейках с ошибками.\r\nВ заголовке ответа присутствует `X-Application-Errors: InvalidData`.\r\n            \r\n## Пример ошибки (409):\r\n```json\r\n[\r\n  {\r\n    \"traceIdentifier\": \"00-abc123\",\r\n    \"code\": \"InvalidData\",\r\n    \"message\": \"Загружен неверный файл\"\r\n  }\r\n]\r\n```\r\n## Негативные сценарии:\r\n- 409 Conflict: в файле есть ошибки валидации строк/ячеек — возвращается Excel с комментариями.\r\n- 409 Conflict: отсутствует лист `Пользователи` (`WrongFile`) или лист пустой (`EmptyFile`).\r\n- 409 Conflict: файл создан в неподдерживаемом приложении (например, MyOffice) — `UnsupportedFileFormat`.\r\n- 409 Conflict: отсутствует обязательное поле формы `File` или тело запроса некорректно.\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `UserImport`.",
+        "description": "## Пример запроса:\r\n`POST /Users`\r\n            \r\nContent-Type: `multipart/form-data`\r\n            \r\nПоле формы: `File` — Excel-файл (.xlsx) с листом, имя которого зависит от `Accept-Language`\r\n(ru: `Пользователи`, en: `Users`).\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа отсутствует. Импорт пользователей принят в обработку.\r\nПосле импорта отправляются приглашения на верификацию аккаунта.\r\n            \r\n## Пример ошибки валидации файла (409):\r\nВозвращается Excel-файл с теми же данными и комментариями в ячейках с ошибками.\r\nВ заголовке ответа присутствует `X-Application-Errors: InvalidData`.\r\n            \r\n## Пример ошибки (409):\r\n```json\r\n[\r\n  {\r\n    \"traceIdentifier\": \"00-abc123\",\r\n    \"code\": \"InvalidData\",\r\n    \"message\": \"Загружен неверный файл\"\r\n  }\r\n]\r\n```\r\n## Негативные сценарии:\r\n- 409 Conflict: в файле есть ошибки валидации строк/ячеек — возвращается Excel с комментариями\r\n  (`Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`,\r\n  заголовок `X-Application-Errors: InvalidData`).\r\n- 409 Conflict: отсутствует лист с ожидаемым именем (`WrongFile`) или лист пустой (`EmptyFile`).\r\n  Имя листа зависит от `Accept-Language` (ru: `Пользователи`, en: `Users`).\r\n- 409 Conflict: файл создан в неподдерживаемом приложении (например, MyOffice) — `UnsupportedFileFormat`.\r\n- Отсутствует обязательное поле формы `File` или тело запроса некорректно —\r\n  обрабатывается model binding / global exception handling (не 409 Conflict).\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `UserImport`.",
         "parameters": [
           {
             "name": "X-Application-ID",
@@ -1359,7 +1359,7 @@
             "description": "Недостаточно прав для импорта пользователей."
           },
           "409": {
-            "description": "Ошибка валидации файла или бизнес-конфликт.\r\nПри ошибках строк возвращается Excel-файл с комментариями;\r\nпри прочих ошибках — тело System.Collections.Generic.List`1.",
+            "description": "Ошибка валидации файла или бизнес-конфликт.\r\nПри ошибках строк — Excel-файл с комментариями и заголовком `X-Application-Errors: InvalidData`;\r\nпри прочих конфликтах — JSON System.Collections.Generic.List`1.",
             "content": {
               "text/plain": {
                 "schema": {