Находите окна в расписании мастеров, пока их можно продать

Агент работает с API Yclients в разрезе одного филиала: его номер участвует в каждом запросе, и все цифры относятся именно к нему. Он читает записи и историю визитов, клиентов, услуги и категории, мастеров с их расписанием, свободные слоты, товары и склады, финансовые транзакции, лояльность и аналитику. Свободное окно он считает не по пустому месту в сетке, а по графику мастера и длительности услуги — иначе слот выглядит продаваемым, но не продаётся.

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

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

Доступ собран из двух токенов: партнёрский открывает только публичные методы, а данные филиала — записи, клиентов, финансы — отдаёт связка партнёрского и пользовательского вместе с номером филиала. Частота запросов у Yclients небольшая, поэтому агент не гоняет расписание по кругу и выбирает периоды осознанно. Если метод закрыт правами системного пользователя или записей за период не было, он скажет это прямо, а не покажет пустую таблицу.