Получить все слоты времени по ресурсам (включая занятые), GET /api/v1/time-slots.

Используйте kronos_get_available_slots, если нужны только свободные слоты для показа клиенту — этот инструмент возвращает полную картину (занято + свободно), полезно для административного/диагностического просмотра расписания.

Args: params (GetTimeSlotsInput): filial_id, resource_id (список id ресурсов, обязателен), date (YYYY-MM-DD, опционально), day_count (1-30, по умолчанию 1), interval (5-720 минут, по умолчанию 60).

Returns: str: JSON-ответ Кронос как есть (форма ответа не документирована вендором).

Error Handling: - "Error: filial_id is required..." если не передан и не задан KRONOS_DEFAULT_FILIAL_ID - "Error: Kronos rejected the request (HTTP 401/403)..." при неверном API-ключе или недоступном филиале

Получить только СВОБОДНЫЕ слоты времени, GET /api/v1/available-slots.

Это основной инструмент для показа клиенту доступных дат/времени при бронировании — в отличие от kronos_get_time_slots, здесь уже отфильтрованы занятые слоты.

Args: params (GetAvailableSlotsInput): filial_id, resource_id (список id ресурсов, обязателен), date (YYYY-MM-DD, опционально), day_count (1-30, по умолчанию 1), interval (5-720 минут, по умолчанию 60).

Returns: str: JSON-ответ Кронос как есть (форма ответа не документирована вендором).

Examples: - Use when: "какие свободные слоты на ближайшую субботу для площадки Северок" - Don't use when: нужна полная занятость слота (используйте kronos_get_time_slots)

Получить слоты времени по типу ресурса (а не по конкретному id), GET /api/v1/time-slots/resource-type.

Полезно, когда бронирование должно быть безразлично к конкретному зáлу/аниматору — например «любой доступный зал этого типа на 14:50».

Args: params (GetTimeSlotsByResourceTypeInput): filial_id, resource_type_id (обязателен), date, day_count, interval.

Returns: str: JSON-ответ Кронос как есть.

Получить список ресурсов филиала (залы, аниматоры и т.п.), GET /api/v1/resources.

Используйте это, чтобы узнать реальные id ресурсов перед вызовом kronos_get_time_slots / kronos_get_available_slots / kronos_create_event — эти id не задокументированы заранее, их нужно получать именно через этот инструмент.

Args: params (ListResourcesInput): filial_id (обязателен), resource_type_id (опциональный список для фильтрации по типу).

Returns: str: JSON-ответ Кронос как есть.

Получить список услуг/товаров филиала, GET /api/v1/services.

Нужно, чтобы узнать реальные id услуг (в т.ч. group_service_id для группового события) перед вызовом kronos_create_event.

Args: params (ListServicesInput): filial_id (обязателен).

Returns: str: JSON-ответ Кронос как есть.

Получить данные одной записи (брони) по id, GET /api/v1/event/{id}.

Args: params (GetEventInput): filial_id, event_id (обязательны).

Returns: str: JSON-ответ Кронос как есть.

Error Handling: - "Error: Not found (HTTP 404)..." если записи с таким id нет в этом филиале

Получить список записей (броней) с фильтрами, GET /api/v1/events.

Поддерживает пагинацию (page/limit) и фильтры по датам, ресурсам, услугам, id и родительскому групповому событию (parent_id — чтобы получить всех «доборных детей» конкретного группового слота).

Args: params (ListEventsInput): filial_id (обязателен); page, limit, ids, parent_id, date_from, date_to, resources, products — все опциональны.

Returns: str: JSON-ответ Кронос как есть (форма пагинации не задокументирована вендором — проверить на реальном аккаунте).

Получить список пользовательских полей записи, настроенных в аккаунте, GET /api/v1/custom-fields/{accountId}.

Нужно, чтобы узнать реальные id и типы кастомных полей перед тем как передавать custom_fields в kronos_create_event / kronos_update_event.

Args: params (GetCustomFieldsInput): filial_id, account_id (обязательны).

Returns: str: JSON-ответ Кронос как есть.

Создать запись (бронь) в Кронос, POST /api/v1/event.

Поддерживает три сценария (по официальным примерам вендора):

1. Обычная индивидуальная запись — заполните order/contact, оставьте is_group пустым.

2. Групповое событие (сам сеанс/слот) — is_group=True, max_count, group_service_id, без order/contact.

3. Дочерняя запись на групповое событие (например, доборные дети/доплата) — parent_id указывает на id уже созданного группового события, count — сколько мест занимает эта дочерняя запись, свои order/contact.

ВАЖНО: max_count — это верхний предел вместимости, Кронос НЕ проверяет никакой нижний порог (минимальный размер группы) — эту валидацию должен делать вызывающий код, полагаться на API тут нельзя.

Args: params (CreateEventInput): filial_id, date_from, date_to, time_from, time_to (обязательны); остальные поля см. описание модели — status_id, name, parent_id, count, is_group, max_count, group_service_id, resources, order, contact, custom_fields, analytics (все опциональны, зависят от сценария).

Returns: str: JSON-ответ Кронос (201) как есть — форма не задокументирована вендором, но по аналогии с {id} в bind-lead ожидается id созданной записи.

Error Handling: - "Error: Kronos rejected the request (HTTP 401/403)..." при неверном ключе/филиале - "Error: Kronos API request failed with HTTP 400..." при неверной комбинации полей (например is_group=True вместе с contact) — проверьте тело ошибки в сообщении

Изменить запись — перенос времени, отмена или правка кастомных полей, PATCH /api/v1/event.

Три типовых сценария:

• Перенос: передайте date_from/date_to/time_from/time_to.

• Отмена: передайте status_id=0 (это штатный способ отмены с сохранением истории — предпочтительнее, чем kronos_delete_event, которое удаляет запись безвозвратно). Можно дополнительно передать loss_reason_id (1 = Нет оплаты, 2 = Не пришёл).

• Правка кастомных полей: передайте custom_fields — непереданные поля сохраняют текущее значение, пустая строка очищает значение поля.

Args: params (UpdateEventInput): filial_id, id (обязательны); date_from, date_to, time_from, time_to, status_id, loss_reason_id, custom_fields (опциональны, передайте только то, что действительно меняете).

Returns: str: JSON-ответ Кронос как есть.

Безвозвратно удалить запись, DELETE /api/v1/event/{id}.

Предпочитайте kronos_update_event со status_id=0 для обычной отмены брони — она сохраняет историю. Используйте это только когда запись должна исчезнуть полностью (например, была создана ошибочно).

Args: params (DeleteEventInput): filial_id, event_id (обязательны).

Returns: str: JSON-ответ Кронос как есть.

Привязать сделку amoCRM к записи Кронос, POST /api/v1/event/bind-lead.

Это единственный официальный мост между amoCRM и Кронос в Public API v1 — вызывайте его сразу после kronos_create_event, передав id только что созданной сделки в amoCRM и id только что созданной записи в Кронос.

Args: params (BindLeadInput): filial_id, lead_id (id сделки amoCRM), event_id (id записи Кронос) — все обязательны.

Returns: str: JSON-ответ Кронос как есть.

Подписаться на пуш-вебхуки по событиям записи, POST /api/v1/webhooks/subscribe.

Кронос будет отправлять POST-запросы на указанный url при create_event/update_event/ delete_event — это единственный push-механизм (в остальном API — pull/polling). Идемпотентность повторных вызовов с теми же параметрами не задокументирована вендором (может создавать дублирующиеся подписки) — проверить на реальном аккаунте.

Args: params (SubscribeWebhookInput): filial_id, url, actions (список из create_event/ update_event/delete_event, обязательны); filial_ids — опциональный список для ограничения вебхуков конкретными филиалами (по умолчанию — все филиалы аккаунта).

Returns: str: JSON-ответ Кронос как есть.