---
title: Визиты и их статусы
summary: Визит — одна запись клиента на одну или несколько услуг, занимающая мастера, место и аппарат. Он записан, подтверждён, состоялся или отменён; визит без записи вносят задним числом.
tools: [talemo_book_visit, talemo_record_walk_in, talemo_get_visit, talemo_list_visits, talemo_get_calendar]
related: [finding-times, moving-and-cancelling-visits, visit-notices, resources, services-and-prices, ../clients/contact-card]
search: [запись, визит, статус записи, клиент без записи]
---

# Визиты

Визит связывает карточку клиента (см. [Карточка контакта](../clients/contact-card.md)),
филиал, одну или несколько услуг, ресурсы, которые они занимают, и время. Все услуги
визита записывают, переносят и отменяют вместе. Мастер у визита один, а место и аппарат — у каждой услуги
свои: маникюр на столе и педикюр на кушетке — один визит. Визиты живут в **Календаре** веба.

## Статусы

- **записан** — визит есть и ждёт;
- **подтверждён** — человек нажал **Подтвердить** на записанном визите;
- **состоялся** — визит закрыт с тем, как всё прошло на самом деле;
- **отменён** — с причиной (см.
  [Перенос и отмена визитов](moving-and-cancelling-visits.md)).

**Не закрыт** — пометка на визите, она лежит вне четырёх статусов. Записанный или подтверждённый визит, чьё
время прошло, носит её, пока человек не отметит, что он состоялся, или не отменит
его. Календарь показывает, сколько визитов не закрыто, а **Не закрытые визиты**
перечисляют их с кнопкой **Разобрать**. Пока их не разберут, выручка этих дней
неполная.

## Запись

Визит записывают через подбор (см. [Подбор времени](finding-times.md))
инструментом `talemo_book_visit`: карточка клиента, услуги, начало и, если нужно,
ресурсы. Начало должно лежать на шаге записи, в будущем, в открытом времени и быть
свободным. Карточка из «Не разобраны» становится клиентом, когда на неё записывают
визит.

Если человека ещё нет в контактах, вместо карточки называют **нового клиента**: имя и номер
телефона (в окне записи — **Для кого → Новый клиент**, в инструментах — `new_party` вместо `party_id`,
названо должно быть что-то одно). Talemo ищет этот номер среди телефонов и номеров WhatsApp ваших
контактов. Нашёл — визит ложится на найденную карточку под её именем, введённое имя не сохраняется, и
человек видит, на чью карточку записали. Не нашёл — заводит карточку клиента и записывает на неё; в
истории контакта останется строка «Карточку завели при записи на визит». Нужны право добавлять контакты
и открытое поле «Телефон»; без права ответ — «У вас нет права добавлять клиентов. Выберите клиента из
контактов или попросите это право у владельца.». Показ (`dry_run`) номер не ищет: он всегда показывает
новую карточку с введённым именем.

Онлайн-администратор тоже записывает, переносит и отменяет визиты, но только для
клиента, с которым говорит в этой переписке.

## Цены

Каждая услуга визита берёт цену и валюту из прайса, когда визит записывают (см.
[Услуги, цены и валюта](services-and-prices.md)). Правка прайса записанные
визиты не меняет. **Изменить цену** правит цены только одного визита, а история
визита хранит, кто их изменил и когда. Роль, которой закрыто поле «Цена», цен
визитов не видит вовсе.

Когда у услуги есть своя цена для уровня мастеров (см. [Уровни мастеров](master-levels.md)),
визит берёт цену того мастера, к которому записан: цену его уровня, а мастер без уровня и
уровень без своей цены берут обычную. Цена, которую клиентке показали — на странице записи или
назвал онлайн-администратор или подключённый инструмент, — сверяется при записи: если цена
мастера с тех пор изменилась, ничего не записывается, показывается новая цена, и визит
записывается заново уже по ней. Уже записанный визит свою цену сохраняет, когда мастера
переводят на другой уровень.

## Визит, который состоялся

**Закрыть визит** записывает, как было на самом деле: время, кто делал, какие услуги
и сколько заплатили. Всё это идёт в тот же визит, а план остаётся в его истории.
Закрытый визит можно закрыть ещё раз, поправив его, и каждая правка сохраняется.
Время мастера на деле и есть время визита. Место и аппарат остаются такими, как их
записали: у услуги, которая была в записи, свой записанный отрезок вместе с уборкой, и
закрытие не двигает его вслед за настоящим временем. Услуга, которую добавили при закрытии,
получает долю настоящего времени, а время делится между услугами по их длительности в
прайсе. Её место — то же, что у соседней услуги, если оно ей подходит; если подходит
несколько мест, его можно выбрать в окне. Услуга, которую не сделали, освобождает своё место.
В карточке визита у каждого места и аппарата названы услуги, ради которых он занят: эту связь
запоминает запись, и закрытие со сдвигом, повторное закрытие и правка цены её не меняют, так что
стол остаётся с маникюром, а кушетка — с педикюром. У визитов, записанных до того, как связь
стали запоминать, услугу относят к месту своей роли, с которым её настоящее время пересекается
дольше всего.

## Визит без записи

**Визит без записи** вносит клиента, который пришёл без записи. Он сразу пишется как
состоявшийся и всегда в прошлом: его конец не может быть позже, чем сейчас. Подбор и
шаг тут не нужны, только настоящее время. Если это время лежит вне открытого времени
ресурса, **Продлить день и записать** открывает его в дне этого ресурса, и день
становится «изменён вручную». Инструмент — `talemo_record_walk_in`. Подтверждение и
напоминание для такого визита не создаются. Клиента называют так же, как при
записи: карточкой или новым клиентом по имени и номеру. Маникюр на столе и педикюр на
кушетке — один визит одного мастера, как при записи; когда услуге подходит несколько мест,
назовите то, что было занято на каждой услуге.

## Кто может

Подбор, просмотр, запись, правка, перенос, отмена, запись факта и удаление — отдельные
права уровня филиала; они есть у роли «Администратор». Право можно ограничить «своим»:
тогда человек видит и записывает только визиты на ресурс, которым работает.

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

- Визит записывают только через подбор: сначала `talemo_find_times`, потом `talemo_book_visit` с `party_id` (карточка клиента) или `new_party` (новый клиент: `name` и `phone` с `address` и, номеру без `+`, `country`; ровно одно из двух, иначе `request.body_invalid`), `service_ids`, `start` варианта и его `resource_ids`. Вариант передают как есть. Запись проверяет начало ещё раз, поэтому время к этому моменту может уйти: статус 409, код `slot.overlap`; время вне открытого времени ресурса — `visit.outside_schedule` и `params.resource_id`, если `extend_schedule` его не откроет (ниже); начало в прошлом — `visit.past`; начало мимо шага — `request.body_invalid` и `params.field` `start`; ресурс, который не делает эти услуги, — статус 422, код `visit.resource_unfit`. Контакт из категории «Не разобраны» становится клиентом. С `new_party` ответ настоящей записи несёт `party_match`: `found` — карточка с этим номером была, визит лёг на неё под её именем, `created` — карточку завели; показ `party_match` не несёт. Без права добавлять контакты — статус 403, код `role.forbidden`, `params.capability` `party.create`: скажите человеку, что права нет, и предложите выбрать клиента из контактов или попросить право у владельца; роль, у которой закрыто поле «Телефон», получает `role.field_forbidden`.
- Статусы: записан, подтверждён, состоялся и отменён. `talemo_get_visit` показывает один визит: услуги по порядку, кто когда занят и, если роль вправе их видеть, цены. `talemo_list_visits` перечисляет в `visits` визиты филиала за период, одного контакта (`party_id`) или, с `unclosed`, прошедшие визиты, которые всё ещё записаны или подтверждены и которые нужно отметить состоявшимися или отменить. `talemo_get_calendar` показывает сетку на один–семь дней и считает не закрытые визиты в `unclosed_count`.
- `own_resource_ids` есть в ответах `talemo_list_visits` (рядом с `visits`) и `talemo_get_calendar` только тогда, когда человек видит лишь визиты ресурсов, связанных с ним: это ID этих ресурсов. Пусто — ни один ресурс в календаре с ним ещё не связан, поэтому его визитов не видно; поля нет — он видит все визиты филиала.
- Если у мастера отключили запись, а визиты у него остались, его колонка остаётся в календаре с пометкой «не принимает записи»: визиты видны, новое время на него не записать. Запись снова включают в его карточке. Колонка выключенного приходит и без визитов, когда `talemo_get_calendar` назвал его в `resource_id` (вопрос про одного мастера, место или аппарат), и всегда — своего выключенного ресурса у человека, который видит только свои визиты. Ресурса из `resource_id` нет, он не виден роли или лежит в другом филиале — статус 404, код `not_found`, `params.field` `resource_id`, `params.reason` `not_found` или `not_in_branch`; не uuid — `request.body_invalid` с тем же полем. Скажите человеку, что такого мастера в календаре этого филиала нет, и не подставляйте другого.
- У каждого визита есть `source`: `page` — клиентка записалась сама на странице записи филиала (см. [Страница записи филиала](branch-booking-page.md)), `salon` — все остальные случаи, записал ли человек, онлайн-админ или подключённый инструмент. Его показывают `talemo_get_visit`, `talemo_list_visits` и `talemo_get_calendar`.
- Прошедший визит записывают через `talemo_record_walk_in`, сразу как состоявшийся, с `party_id` или `new_party`, `service_ids`, `start`, `end` и, по желанию, `resource_ids`, `service_resources` (какое место или аппарат делал какую услугу, парами `service_id` и `resource_id`; мастер остаётся в `resource_ids`, а ресурс, который услуге не годится, отклоняется с `visit.resource_unfit`) и `price`. Он заканчивается не позже чем сейчас, иначе вызов отклоняется со статусом 409 и кодом `visit.future`. Время вне открытого времени ресурса отклоняется с `visit.outside_schedule`, если `extend_schedule` не откроет его в дне ресурса: скажите об этом человеку заранее.
- Когда человек просит записать на неоткрытое время, скажите, что откроется, и спросите: выходной, часы вне смены или ресурс без графика. Если он сказал «да», `talemo_book_visit` с `extend_schedule` true и мастером, местом или аппаратом в `resource_ids` открывает ровно время визита в дне каждого названного ресурса и записывает тем же шагом; без флага отказ остаётся `visit.outside_schedule`. Нужно право менять график: без него статус 403, код `role.forbidden`, `params.capability` `schedule.edit`. Открытое ответ называет в `opened` — `resource_id`, `name`, `kind` (`day_off`, `outside_shift` или `no_schedule`), `start`, `end` и, у `outside_shift`, смену `shift`, в которой оно стояло, — а `asks` перечисляет то, о чём человеку надо сказать сначала: `opens_time` и `client_message`, когда Talemo сразу напишет клиенту, что визит записан; `dry_run` показывает оба и ничего не записывает. Занятое время, например обед, остаётся закрытым и с флагом, а время ресурса, которого не назвали, не открывается никогда. Помощник человека в режиме **Спрашивать о важном** записывает сам, пока `asks` пуст, а иначе показывает карточку и ждёт **Разрешить**; в режиме **Спрашивать про всё** он ждёт всегда. Онлайн-админ время не открывает: он предлагает другое начало. Подбор никогда не предлагает закрытое и занятое время (см. [График ресурса](resource-schedule.md)).
- Услуги визита берут цену из прайса при записи, в валюте филиала; когда у услуги есть цена для уровня мастеров — цену мастера визита.
- `talemo_book_visit` принимает `price`: цены, которые назвали клиентке, по порядку `service_ids` — `price` каждой записи `services` у варианта, который записываете, десятичные строки в валюте филиала вроде "35.00", `null` — у услуги цены нет. Передавайте его, когда у варианта есть цены; без него визит записывается по цене своего мастера, без сверки. Если цена мастера с тех пор, как нашли вариант, изменилась, ничего не записывается: статус 409, код `visit.price_changed`, `params.service_id` первой разошедшейся услуги и `params.price` — её цена теперь. Назовите клиентке новую цену, найдите время заново и записывайте, только если она согласна. `level_id` записывает к мастерам одного уровня, когда мастера нет в `resource_ids` (`level_id` мастера в `fits` у `talemo_list_services` или `none` — мастера без уровня); внутри уровня мастера выбирает правило филиала.
