timeman.close
Scope: timeman Права на выполнение: для всех
Описание
Метод завершает текущий рабочий день.
Пример
Пример вызова:
https://portal.bitrix24.com/rest/timeman.close?auth=xxxxx&time=2017-04-21T17%3A30%3A00%2B09%3A00&report=test&lat=52.5162434&lon=13.3774829&user_id=5
Пример ответа:
{
"result": {
"STATUS": "CLOSED",
"TIME_START": "2017-04-21T07:30:00+08:00",
"TIME_FINISH": "2017-04-21T16:30:00+08:00",
"DURATION": "09:00:00",
"TIME_LEAKS": "00:00:00",
"ACTIVE": false,
"IP_OPEN": "192.168.0.1",
"IP_CLOSE": "192.168.0.100",
"LAT_OPEN": 54.7199881,
"LON_OPEN": 20.4879224,
"LAT_CLOSE": 52.5162434,
"LON_CLOSE": 13.3774829,
"TZ_OFFSET": 28800
}
}
Параметры
| Параметр | Описание |
|---|---|
| USER_ID | Идентификатор пользователя. Не обязателен, по умолчанию возвращаются настройки текущего пользователя. |
| TIME | Время окончания рабочего дня. Не обязателен, по умолчанию рабочий день закрывается текущим моментом с часовым поясом, в котором рабочий день был начат. Дата должна совпадать с датой начала рабочего дня. |
| REPORT | Причина изменения рабочего дня. Обязателен при указании параметра TIME и отключенном для сотрудника свободном графике. |
| LAT | Географическая широта начала рабочего дня. Не обязателен. |
| LON | Географическая долгота начала рабочего дня. Не обязателен |
Если часовая зона времени завершения рабочего дня отличается от часового пояса начала рабочего дня, то время будет пересчитано в часовой пояс начала дня.
Поля ответа
| Поле | Тип | Описание | Примечание |
|---|---|---|---|
| STATUS | string | Статус текущего рабочего дня. | Варианты значений:
|
| TIME_START | datetime | Дата-время начала рабочего дня. | Часовой пояс соответствует часовому поясу начала рабочего дня |
| TIME_FINISH | datetime | Дата-время заверения рабочего дня | Для незавершенного рабочего дня возвращается null |
| DURATION | HH:MM:SS | Длительность рабочего дня | Для незавершенного рабочего дня возвращается 00:00:00 |
| TIME_LEAKS | HH:MM:SS | Суммарная длительность перерыва за день | |
| ACTIVE | true|false | Подтвержденность рабочего дня | Значение false означает, что изменение рабочего дня ожидает подтверждения руководителем. |
| IP_OPEN | string | IP-адрес, с которого начат рабочий день | |
| IP_CLOSE | string | IP-адрес, с которого завершен рабочий день | Для незавершенного рабочего дня возвращается null |
| LAT_OPEN | double | Географическая широта точки начала рабочего дня | |
| LON_OPEN | double | Географическая долгота точки начала рабочего дня | |
| LAT_CLOSE | double | Географическая широта точки завершения рабочего дня | |
| LON_CLOSE | double | Географическая долгота точки завершения рабочего дня | |
| TZ_OFFSET | int | Смещение часового пояса сотрудника | Подразумевается часовой пояс, в котором день начат. При завершении дня время завершения приводится к часовому поясу начала дня. |
| TIME_FINISH_DEFAULT | datetime | Время завершения дня по умолчанию | Выводится только для рабочих дней в статусе EXPIRED. "Рекомендуемое" значение завершения дня, которое можно выводить пользователю в качестве значения по умолчанию. |
Сообщение не промодерировано, возможны ошибки и неточности.
| ||
| ||
|
Сообщение не промодерировано, возможны ошибки и неточности.
|
|
В каком формате должен быть параметр TIME?
|
|
Сообщение не промодерировано, возможны ошибки и неточности.
|
|
В какоми формате должен быть параметр TIME?
|
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.