Документация Talemo

Визиты

На этой странице

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

Статусы

  • записан — визит есть и ждёт;
  • подтверждён — человек нажал Подтвердить на записанном визите;
  • состоялся — визит закрыт с тем, как всё прошло на самом деле;
  • отменён — с причиной (см. Перенос и отмена визитов).

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

Запись

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

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

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

Цены

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

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

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

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

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

Визит без записи вносит клиента, который пришёл без записи. Он сразу пишется как состоявшийся и всегда в прошлом: его конец не может быть позже, чем сейчас. Подбор и шаг тут не нужны, только настоящее время. Если это время лежит вне открытого времени ресурса, Продлить день и записать открывает его в дне этого ресурса, и день становится «изменён вручную». Инструмент — 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 — клиентка записалась сама на странице записи филиала (см. Страница записи филиала), 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 пуст, а иначе показывает карточку и ждёт Разрешить; в режиме Спрашивать про всё он ждёт всегда. Онлайн-админ время не открывает: он предлагает другое начало. Подбор никогда не предлагает закрытое и занятое время (см. График ресурса).
  • Услуги визита берут цену из прайса при записи, в валюте филиала; когда у услуги есть цена для уровня мастеров — цену мастера визита.
  • 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 — мастера без уровня); внутри уровня мастера выбирает правило филиала.

Инструменты этой темы

Связанные темы