Отделы и сотрудники

Отделы

В терминологии Sailplay, Отдел - это любая составная (или логическая) часть вашего бизнеса. Отделом может быть, например, магазин, склад, Отдельная касса, мобильное приложение (как тип), либо часть сайта, либо весь сайт. Соответственно, store_department_id - идентификатор (ID) Отдела партнера в системе Sailplay, который используется для авторизации приложения и получения токена для API запросов.

📘

Инфо

При создании аккаунта в нем по умолчанию создается один отдел Default department и сотрудник site. Для получения авторизационных данных от данного отдела необходимо обратиться к менеджеру Sailplay.

Для создания отдела используется метод /api/v2/partners/departments/create/, передав в него авторизационный токен и store_department_id отдела Default department или другого, созданного ранее. Также можно указать наименование отдела, внутренний идентификатор в вашей системе (например в 1С), часовой пояс и т.д.

Редактирование информации об отделе осуществляется методом /api/v2/partners/departments/edit/. При работе с методом в запросе указывается store_department_id и token - как идентификаторы отдела, от которого выполняется запрос, а department_id - как идентификатор редактируемого отдела.

Метод /api/v2/partners/departments/list/ используется для получения списка всех отделов аккаунта.

Сотрудники

Сотрудник - это единица Отдела, для которой доступны операции: авторизация, совершение покупок/заказов, выдача подарков и т.д. Сотрудник может быть как физическим лицом, так и частью IT-системы. Например, имеет смысл для вашего веб-сайта создать отдельную учетную запись Сотрудника, через которую будут совершаться API-запросы, связанные с действиями ваших клиентов на вашем веб-сайте. Это позволит разделить аналитику в разрезе отдельных Отделов, Подразделений и Сотрудников.

Важно, что у каждого Сотрудника есть свой личный PIN-код, которым он подписывает все транзакции. Каждый Сотрудник может принадлежать одному и только одному Отделу. Если Сотрудник должен иметь возможность проводить транзакции в рамках другого Отдела, его нужно там создать.

Создание сотрудника в отделе осуществляется методом /api/v2/partners/managers/create/. Для указания отдела в котором будет создан новый сотрудник необходимо передать его store_department_id в параметре dep_id.

Методы /api/v2/partners/managers/view/ и /api/v2/partners/managers/edit/ позволяют получить личную информацию из карточки сотрудника и отредактировать ее при необходимости.

/api/v2/partners/managers/delete/ служит для удаления сотрудника. Запрос на удаление должен быть отправлен из отдела, в котором был создан сотрудник.