[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-workday\u002Fstatus":3,"docs-tabs-workday\u002Fstatus":6},{"content":4,"lastmod":5},"\n## Текущий статус\n\n`GET \u002Fv1\u002Fworkday\u002Fstatus`\n\nВозвращает текущее состояние рабочего дня сотрудника: статус, время начала и завершения, длительность, перерывы.\n\n## Параметры\n\n| Параметр | Тип | Обязательный | Описание |\n|----------|-----|--------------|---------|\n| `userId` | number | нет | Идентификатор сотрудника. По умолчанию — пользователь, которому принадлежат токены ключа. Чужие `userId` доступны только администраторам портала и непосредственным руководителям сотрудника — иначе Bitrix24 возвращает ошибку доступа |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -H \"X-Api-Key: YOUR_API_KEY\" \\\n  https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkday\u002Fstatus\n```\n\n### curl — статус другого сотрудника\n\n```bash\ncurl -H \"X-Api-Key: YOUR_API_KEY\" \\\n  \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkday\u002Fstatus?userId=503\"\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\u002Fstatus\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkday\u002Fstatus', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { data } = await res.json()\nconsole.log('Статус:', data.status)\nconsole.log('Активный день:', data.active)\nconsole.log('Длительность:', data.duration)\n```\n\n### JavaScript — статус другого сотрудника\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkday\u002Fstatus?userId=503', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { data } = await res.json()\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkday\u002Fstatus', {\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.status` | string | Статус дня: `OPENED`, `CLOSED`, `PAUSED`, `EXPIRED` |\n| `data.timeStart` | string | Дата и время начала текущего или последнего дня (ISO 8601) |\n| `data.timeFinish` | string \\| null | Дата и время завершения. `null` для незакрытого дня. Для дня в `PAUSED` — момент начала текущей паузы |\n| `data.duration` | string | Длительность дня в формате `HH:MM:SS` |\n| `data.timeLeaks` | string | Суммарная длительность пауз за день в формате `HH:MM:SS` |\n| `data.active` | boolean | Признак активной записи рабочего дня |\n| `data.ipOpen` | string | IP-адрес начала дня. Пустая строка, если день начат без фиксации IP |\n| `data.ipClose` | string | IP-адрес завершения дня. Пустая строка для незакрытого дня |\n| `data.latOpen` | number | Географическая широта точки начала. `0` — координаты не переданы |\n| `data.lonOpen` | number | Географическая долгота точки начала |\n| `data.latClose` | number | Географическая широта точки завершения |\n| `data.lonClose` | number | Географическая долгота точки завершения |\n| `data.tzOffset` | number | Смещение часового пояса сотрудника в секундах (зависит от настроек сотрудника на портале — пример `10800` соответствует UTC+3) |\n\nКогда у запрошенного сотрудника нет записи рабочего дня, в `data` присутствует только `status` — остальные поля отсутствуют. Подробнее — «Вырожденный ответ без записи дня» в «Известных особенностях».\n\n## Возможные значения `status`\n\n| Статус | Описание |\n|--------|---------|\n| `OPENED` | Рабочий день открыт |\n| `CLOSED` | Рабочий день закрыт |\n| `PAUSED` | Рабочий день на паузе |\n| `EXPIRED` | Рабочий день не был закрыт до начала следующих календарных суток |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"status\": \"OPENED\",\n    \"timeStart\": \"2026-05-05T09:00:00+03:00\",\n    \"timeFinish\": null,\n    \"duration\": \"04:00:00\",\n    \"timeLeaks\": \"00:30:00\",\n    \"active\": true,\n    \"ipOpen\": \"203.0.113.10\",\n    \"ipClose\": \"\",\n    \"latOpen\": 0,\n    \"lonOpen\": 0,\n    \"latClose\": 0,\n    \"lonClose\": 0,\n    \"tzOffset\": 10800\n  }\n}\n```\n\nСотрудник без записи рабочего дня — ответ вырождается до одного поля `status`:\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"status\": \"CLOSED\"\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| 400 | `INVALID_PARAMS` | `userId` не является положительным целым числом |\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` (например, нет прав на чужого `userId`) |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов к Битрикс24 |\n| 502 | `BITRIX_UNAVAILABLE` | Портал Битрикс24 недоступен |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n- **Состояние после закрытия.** После закрытия дня эндпоинт продолжает возвращать сведения последнего дня (`CLOSED`, заполненный `timeFinish`) до открытия следующего — отчёт по закрытому дню доступен этим же запросом.\n- **Запись может быть любой давности — сверяйте `timeStart` с сегодняшней датой.** `status` и `timeStart` описывают *последнюю* запись рабочего дня сотрудника, а она может быть сколь угодно старой: Битрикс24 `timeman.status` возвращает последнюю запись независимо от её возраста. И день, `CLOSED` три года назад, и день, оставшийся `EXPIRED` (открытым и не закрытым) пять дней назад, отдаются как есть — ни один из них не означает «сегодня». У эндпоинта нет фильтра «только сегодня», поэтому, чтобы понять, относится ли день к текущей дате, сравните дату из `timeStart` с сегодняшней на своей стороне, прежде чем доверять `status`. Для командного дашборда считайте запись, у которой `timeStart` не сегодняшний, как «рабочий день сегодня не начат».\n- **Вырожденный ответ без записи дня.** Если у запрошенного сотрудника нет записи рабочего дня, `data` содержит только поле `status`. Остальные поля (`timeStart`, `timeFinish`, `duration` и прочие) в ответе отсутствуют, поэтому проверяйте наличие поля перед чтением. Запись отсутствует, например, у сотрудника, которому день ни разу не открывали.\n- **Закрытие просроченного дня.** В статусе `EXPIRED` день закрывается задним числом. Передайте в [`POST \u002Fv1\u002Fworkday\u002Fclose`](\u002Fdocs\u002Fworkday\u002Fclose) параметр `time` с датой, равной дате открытия дня — это значение `timeStart` из ответа этого эндпоинта — вместе с обязательным `report`. Дата `time`, не равная дате открытия, возвращает `422`.\n\n## Смотрите также\n\n- [Открыть рабочий день](\u002Fdocs\u002Fworkday\u002Fopen) — `POST \u002Fv1\u002Fworkday\u002Fopen`.\n- [Закрыть рабочий день](\u002Fdocs\u002Fworkday\u002Fclose) — `POST \u002Fv1\u002Fworkday\u002Fclose`.\n- [Поставить на паузу](\u002Fdocs\u002Fworkday\u002Fpause) — `POST \u002Fv1\u002Fworkday\u002Fpause`.\n- [Настройки учёта](\u002Fdocs\u002Fworkday\u002Fsettings) — `GET \u002Fv1\u002Fworkday\u002Fsettings`.\n- [Рабочий день](\u002Fdocs\u002Fworkday) — обзор раздела.\n","2026-07-07",{}]