---
title: Ресурсы — мастера, места, аппараты
summary: Ресурс — это то, на что записывают время в филиале. Ресурсов три вида — мастер, место и аппарат, и приходят они с набором «Запись клиентов».
tools: [talemo_list_resources, talemo_create_resource, talemo_update_resource, talemo_deactivate_resource, talemo_activate_resource, talemo_delete_resource, talemo_get_resource_history, talemo_list_visits]
related: [resource-schedule, who-does-what, services-and-prices, visits, ../kits/industry-kits]
search: [мастер, специалист, кабинет, кресло, оборудование]
---

# Ресурсы

Ресурс — это то, на что записывают время: человек, который делает работу, место,
где её делают, аппарат, который для неё нужен. Ресурс принадлежит одному
филиалу и в другой не переносится. Визит занимает один или несколько ресурсов
сразу (см. [Визиты](visits.md)).

## Мастер, место, аппарат

Все три приходят с отраслевым набором (см. [Отраслевые наборы](../kits/industry-kits.md)).

- **Мастер** — человек, который делает услугу. Его можно связать с человеком
  из команды, и только мастера.
- **Место** — кресло, стол, кушетка или кабинет. Место без графика для услуг ничего не
  меняет: место они берут, только когда у какого-то места филиала есть график, и тогда все
  услуги филиала берут его сразу (см. [«Услуги, цены и валюта»](services-and-prices.md)).
  Заведённому месту график ставят сразу, иначе на него не записать.
- **Аппарат** — прибор или оборудование, например лампа.

Названия зависят от отрасли бизнеса: в массаже, спа и велнесе говорят
«специалист, кабинет, оборудование», в спорте — «тренер, зал, тренажёр», в
тату — «мастер, место, оборудование», в обучении — «преподаватель, кабинет,
инструмент». Устроены они везде одинаково.

## Мастер как ресурс и «Мастер» как роль

Это разные вещи. Мастер-ресурс — человек, на которого записывают, он стоит в
календаре филиала. Роль — набор прав с названием, который выдают человеку из
команды, и называться она тоже может «Мастер». Роль можно ограничить своими
визитами: тогда она видит визиты, где занят ресурс, которым человек работает.
Эту связь задаёт поле **Кто из команды**. Её же ставит приглашение, если в нём выбран
календарь: новый мастер заводится вместе с приглашением, а когда человек принимает его,
он привязывается к мастеру сам (см. [Приглашения в команду](../account/invitations.md)).

## Поля и где они

Ресурсы открытого филиала лежат в разделе **«Мастера, места и аппараты»** левой
панели (название по отрасли; раздел есть, пока стоит набор «Запись клиентов»).
Список разбит на мастеров, места и аппараты, у каждого ресурса видно, когда он работает сегодня, что
делает и когда у него ближайшее свободное время; отключённые лежат отдельной
карточкой **Отключены**. У ресурса есть **Название**, то, кто это — мастер, место или аппарат, — и, только у
мастера, **Кто из команды**. Время записывают только на ресурсы, добавленные
здесь. Один человек — один мастер в филиале: второй ресурс на того же человека не
заводится, пока первый в работе. Если сменить, кто это — мастер, место или аппарат, — ресурс перестаёт делать то,
что делал раньше; отметьте, что он делает, в карточке ресурса, в окне
**Какие услуги делает** (см. [«Кто что умеет»](who-does-what.md)).

## Карточка ресурса

Нажмите на ресурс в списке — откроется его карточка: как идёт сегодня и неделя,
обычный график и до какого дня можно записать, сколько услуг он делает из тех,
которым нужен такой же мастер, место или аппарат, ближайший визит и заметка. Ниже — лента: визиты ресурса и
правки самого ресурса, у каждой правки видно, кто её сделал и когда; правки графика видит только тот,
кому открыт график. Из карточки
меняют название, то, кто это, и человека из команды, график, услуги, а также отключают и
удаляют ресурс. Заметка — для своих, например «Левша — стол у окна»: её видит
тот, кто видит ресурс, а подписывается она тем, кто написал.

## Отключение

Ресурс, на котором впереди есть визиты, не отключается: сначала эти визиты
переносят на другой ресурс или отменяют. Проверка показывает их до того, как
что-то изменится (`dry_run` у инструмента). После отключения:

- график впереди уходит, обычный график остаётся;
- новое время на него не записать;
- прошедшие визиты и история остаются.

**Включить** возвращает ресурс в работу; график нужно завести заново (см.
[График ресурса](resource-schedule.md)). Мастера нельзя включить, пока
тот же человек работает другим ресурсом филиала.

## Удаление

Удалить можно только ресурс, на который ни разу не записывали время. Всё, у чего
есть история, отключают, и визиты помнят своего мастера или место.

## Кто может

Смотреть и менять ресурсы — права уровня филиала: «Администратор» меняет, «Бухгалтер»
только смотрит. Без набора «Запись клиентов» эти операции недоступны.

## Инструменты и отказы

- `talemo_list_resources` перечисляет ресурсы в работе бизнеса или одного филиала; с `deactivated` вместо них — отключённые. У каждого есть `role` — `master`, `place` или `device`, во всех бизнесах одинаковый — и, у мастера, человек из команды. Человеку мастера, места и аппараты называйте так, как их называет отрасль бизнеса (`vertical` в `talemo_list_businesses`).
- `talemo_create_resource` принимает `branch_id`, `name`, `role` и, только у мастера, `user_id` человека из команды. Один человек — один ресурс в работе в филиале: второй отклоняется со статусом 409 и кодом `record.duplicate`.
- `talemo_update_resource` меняет название, `role`, человека из команды или заметку; чего нет в запросе, остаётся, а пустая `note` убирает заметку. Заметка подписана тем, кто её написал, и временем. Отключённый ресурс не меняют, пока его не включили: статус 409, код `resource.deactivated`. Если поменяли `role`, отметьте заново, что ресурс делает, через `talemo_add_service_fit`.
- `talemo_deactivate_resource` выводит ресурс из работы. Его график впереди уходит (вернёт его только новое продление обычного графика, а дни, изменённые руками, потеряются), и время после этого на него записать нельзя: `resource.deactivated`. Ресурс с записями впереди отклоняется со статусом 409, кодом `resource.has_bookings` и `params.count`: сначала эти визиты переносят или отменяют. Инструмент меняет много сразу, поэтому сначала вызовите его с `dry_run`: в ответе записи впереди и `days_ahead` — сколько дней графика уйдёт. Настоящий вызов — только когда человек это увидел и сказал «да».
- `talemo_activate_resource` возвращает ресурс в работу и график сам не продлевает. Если человек из команды уже работает другим ресурсом филиала, вызов отклоняется со статусом 409, кодом `record.duplicate` и `params.field` `user_id`.
- `talemo_get_resource_history` показывает, что было с ресурсом, свежее сверху, страницами: его визиты, которые состоялись или отменены, и правки самого ресурса — завели, поправили, отключили, включили, задали обычный график, расписали до даты, изменили день или кусок времени, отметили или сняли услугу, — у каждой правки кто сделал (человек, помощник Talemo по его просьбе, программа) и когда. В правке только идентификаторы, коды и числа: текста заметки нет, а услуга названа так, как она называется сейчас. `visits_done` считает состоявшиеся визиты, `edits_count` — правки; `next` — это `before` следующего вызова, без него страница последняя; `only` — `visits` или `edits`. Визиты видит только роль, которой они открыты, правки графика — только роль, которой открыт график; роль, ограниченная «своим», видит визиты и правки графика только своего ресурса.
- Что у ресурса впереди — `talemo_list_visits` с `resource_id`, `from` и `live`: записанные и подтверждённые визиты от этого момента.
- `talemo_delete_resource` удаляет только ресурс, на который ни разу не записывали время. Ресурс с записями, прошлыми или будущими, отклоняется со статусом 409, кодом `resource.has_history` и `params.count`: его отключают. Удалённый ресурс пропал, повторный вызов даёт `not_found`. Перед удалением спросите человека; `dry_run` называет, сколько записей у ресурса было.

Эти отказы — ответы, а не сбои: скажите человеку, что мешает, и измените план.