[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-workday\u002Fopen":3,"docs-tabs-workday\u002Fopen":6},{"content":4,"lastmod":5},"\n## Открыть рабочий день\n\n`POST \u002Fv1\u002Fworkday\u002Fopen`\n\nОткрывает новый рабочий день текущего пользователя. Вайбкод проксирует запрос в Битрикс24 без дополнительной обработки и возвращает ответ как есть. Поведение для уже активных дней определяется на стороне Битрикс24: для дня в статусе `OPENED` возвращается текущее состояние без изменений; для дня в статусе `PAUSED` — день переводится обратно в `OPENED` с продолжением учёта.\n\n## Поля запроса (body)\n\nВсе параметры опциональны. Тело может быть пустым: `{}`.\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `userId` | number | нет | Идентификатор сотрудника. По умолчанию — пользователь, которому принадлежат токены ключа |\n| `time` | string | нет | Дата и время начала в формате ISO 8601 (например `2026-05-05T09:00:00+03:00`). Дата должна совпадать с текущей. Применяется только когда день в статусе `CLOSED`. При указании этого поля становится обязательным `report` |\n| `report` | string | нет | Причина изменения. Обязательно при заданном `time` и для сотрудников с фиксированным графиком работы |\n| `lat` | number | нет | Географическая широта точки начала рабочего дня |\n| `lon` | number | нет | Географическая долгота точки начала рабочего дня |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkday\u002Fopen \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{}'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkday\u002Fopen \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{}'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkday\u002Fopen', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({}),\n})\nconst { data } = await res.json()\nconsole.log('Статус:', data.status)\nconsole.log('Открыт в:', data.timeStart)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkday\u002Fopen', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({}),\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` для незакрытого дня |\n| `data.duration` | string | Длительность дня в формате `HH:MM:SS`. Для только что открытого — `00:00:00` |\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 | Географическая долгота точки начала. `0` — координаты не переданы |\n| `data.latClose` | number | Географическая широта точки завершения |\n| `data.lonClose` | number | Географическая долгота точки завершения |\n| `data.tzOffset` | number | Смещение часового пояса сотрудника в секундах (зависит от настроек сотрудника на портале; пример `10800` соответствует UTC+3) |\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\": \"00:00:00\",\n    \"timeLeaks\": \"00:00:00\",\n    \"active\": true,\n    \"ipOpen\": \"\",\n    \"ipClose\": \"\",\n    \"latOpen\": 0,\n    \"lonOpen\": 0,\n    \"latClose\": 0,\n    \"lonClose\": 0,\n    \"tzOffset\": 10800\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` | Битрикс24 вернул `INVALID_PARAMS` — нарушена валидация поля запроса |\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`. Возможные причины: дата `time` не совпадает с текущей, отсутствует `report` при заданном `time`, день уже в нужном состоянии |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов к Битрикс24 |\n| 502 | `BITRIX_UNAVAILABLE` | Портал Битрикс24 недоступен |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Закрыть рабочий день](\u002Fdocs\u002Fworkday\u002Fclose) — `POST \u002Fv1\u002Fworkday\u002Fclose`.\n- [Поставить на паузу](\u002Fdocs\u002Fworkday\u002Fpause) — `POST \u002Fv1\u002Fworkday\u002Fpause`.\n- [Текущий статус](\u002Fdocs\u002Fworkday\u002Fstatus) — `GET \u002Fv1\u002Fworkday\u002Fstatus`.\n- [Рабочий день](\u002Fdocs\u002Fworkday) — обзор раздела.\n","2026-07-07",{}]