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