# Yclients

CRM для салонов красоты — записи, клиенты, услуги и расписание

## Сценарии

### Окна в расписании мастеров
Агент соберёт записи на неделю вперёд и покажет свободные слоты по мастерам, которые ещё можно продать.

### Клиенты, переставшие ходить
Агент поднимет клиентскую базу и найдёт тех, кто не был дольше обычного, — с услугами и суммами последних визитов.

### Выручка и Z-отчёт филиала
Агент сведёт финансовые транзакции и Z-отчёты по дням и покажет, из чего сложилась выручка филиала за период.

### Товарные остатки салона
Агент проверит склады филиала и товарные транзакции и покажет, какая косметика на исходе и что списывается быстрее, чем продаётся.

## Как подключить

### Откройте кабинет разработчика YCLIENTS
Войдите в YCLIENTS под пользователем, который управляет филиалом, и откройте yclients.com/appstore/developers. Кабинет виден только тому пользователю, из-под которого он создан, — под другим аккаунтом ключей там не будет.

### Скопируйте API-ключ партнёра
В кабинете разработчика откройте «Настройки аккаунта» и скопируйте API-ключ — это и есть partner token, hash-строка. Без него API не отвечает ни на один запрос, даже на публичные методы.

### Создайте приложение и отметьте права
В разделе «Мои приложения» создайте приложение, затем в его разделе «Доступ к API» отметьте права системного пользователя — клиенты, записи, услуги. Без галочек права не выдаются; публиковать приложение для этого не нужно.

### Заберите User token и номер филиала
После создания приложения в том же разделе «Доступ к API» появится поле «User token» — скопируйте его. ID филиала — число в адресной строке кабинета филиала: именно оно нужно как company_id.

## Частые вопросы

### Как подключить Yclients?
Токенами из кабинета разработчика yclients.com/appstore/developers: обязателен partner token из «Настройки аккаунта», плюс необязательные user token из раздела «Доступ к API» вашего приложения и ID филиала — число в адресной строке кабинета.

### Что агент видит в Yclients?
Записи и историю визитов, клиентов, услуги и категории, мастеров и расписание, свободные слоты, товары и склады, финансовые транзакции, лояльность и аналитику филиала.

### Пишет ли агент в Yclients?
Может: создавать и переносить записи, заводить клиентов и товарные операции. Объём записи задают права системного пользователя, отмеченные в разделе «Доступ к API».

### Зачем user token и номер филиала?
Partner token открывает только публичные методы. Данные филиала — записи, клиентов, финансы — отдаёт связка partner и user token, а company_id указывает, о каком филиале речь.

[Открыть Yclients](https://yclients.com/appstore/developers)