[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-workday\u002Fsettings":3,"docs-tabs-workday\u002Fsettings":6},{"content":4,"lastmod":5},"\n## Настройки учёта\n\n`GET \u002Fv1\u002Fworkday\u002Fsettings`\n\nВозвращает настройки учёта рабочего времени, действующие на портале для текущего пользователя: разрешено ли рабочее время, свободный ли график, допустимое начало и завершение дня, минимальная длительность.\n\n## Параметры\n\nПараметров нет.\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -H \"X-Api-Key: YOUR_API_KEY\" \\\n  https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkday\u002Fsettings\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkday\u002Fsettings\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkday\u002Fsettings', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { data } = await res.json()\nconsole.log('Учёт времени включён:', data.ufTimeman)\nconsole.log('Свободный график:', data.ufTmFree)\nconsole.log('Допустимое начало до:', data.ufTmMaxStart)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkday\u002Fsettings', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\nconst { data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | `true` при успешном ответе |\n| `data.ufTimeman` | boolean | Включён ли учёт рабочего времени для пользователя |\n| `data.ufTmFree` | boolean | Свободный график. `true` — нет ограничений по началу и завершению дня; `false` — действуют поля `ufTmMaxStart`\u002F`ufTmMinFinish`\u002F`ufTmMinDuration` |\n| `data.ufTmMaxStart` | string | Самое позднее допустимое время начала дня в формате `HH:MM:SS` |\n| `data.ufTmMinFinish` | string | Самое раннее допустимое время завершения дня в формате `HH:MM:SS` |\n| `data.ufTmMinDuration` | string | Минимальная длительность рабочего дня в формате `HH:MM:SS` |\n| `data.ufTmAllowedDelta` | string | Допустимое отклонение от установленного времени начала и завершения в формате `HH:MM:SS` |\n| `data.admin` | boolean | Является ли пользователь администратором учёта рабочего времени |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"ufTimeman\": true,\n    \"ufTmFree\": true,\n    \"ufTmMaxStart\": \"09:15:00\",\n    \"ufTmMinFinish\": \"17:45:00\",\n    \"ufTmMinDuration\": \"08:00:00\",\n    \"ufTmAllowedDelta\": \"00:15:00\",\n    \"admin\": true\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n403 — у ключа нет скоупа `timeman`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'timeman' scope\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |\n| 401 | `INVALID_API_KEY` | Неверный API-ключ |\n| 401 | `KEY_EXPIRED` | Срок действия API-ключа истёк |\n| 401 | `TOKEN_MISSING` | Ключу не настроены OAuth-токены для портала |\n| 402 | `ACCOUNT_FROZEN` | Баланс портала заморожен |\n| 403 | `SCOPE_DENIED` | У ключа нет скоупа `timeman` |\n| 422 | `BITRIX_ERROR` | Битрикс24 отклонил запрос — текст в `message` |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов к Битрикс24 |\n| 502 | `BITRIX_UNAVAILABLE` | Портал Битрикс24 недоступен |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n- **Привязка к токенам ключа.** Ответ соответствует пользователю, которому принадлежат токены ключа. У разных сотрудников значения могут отличаться, если для них настроены разные графики работы.\n\n## Смотрите также\n\n- [График работы](\u002Fdocs\u002Fworkday\u002Fschedule) — `GET \u002Fv1\u002Fworkday\u002Fschedule`.\n- [Текущий статус](\u002Fdocs\u002Fworkday\u002Fstatus) — `GET \u002Fv1\u002Fworkday\u002Fstatus`.\n- [Рабочий день](\u002Fdocs\u002Fworkday) — обзор раздела.\n","2026-07-07",{}]