Altegio
Renta выгружает в ваше хранилище семь видов данных Altegio: финансовые транзакции, записи клиентов вместе с их услугами и документами, расчёт зарплаты по каждому сотруднику за каждый день, каталог услуг с категориями, список сотрудников и профиль каждого филиала.
Сеть салонов работает на нескольких филиалах, и в Altegio они называются компаниями. Один пайплайн охватывает столько филиалов, сколько нужно, а строки попадают в одну таблицу, где филиалы различает колонка Company ID.
Поля каждого типа отчёта вы выбираете сами. Каждый тип отчёта перезагружается целиком на каждом запуске, поэтому таблица назначения повторяет состояние аккаунта Altegio на момент старта запуска.
Аутентификация
Renta подключается к Altegio по двум значениям, которые выдаёт его маркетплейс: API key опознаёт приложение, а User hash key опознаёт пользователя, от имени которого приложение работает.
- API key.
Зарегистрируйтесь в маркетплейсе Altegio как разработчик. Altegio выдаёт ключ сам, и вы найдёте его в разделе Account settings маркетплейса. - User hash key.
Откройте настройки доступа к API того же приложения и заполните поле User ID. Чтобы найти этот идентификатор, зайдите в Altegio в Settings > List of users и откройте пользователя. Идентификатор будет вторым числом в адресной строке. Сохраните настройки, и значение появится в поле User token.
Пользователь, которому принадлежит hash key, определяет, до каких данных дотянется пайплайн. В выпадающем списке Companies появятся только доступные ему филиалы, а в хранилище попадут только те данные, которые разрешают его права.
Подключение источника Altegio
Выполните эти шаги, чтобы добавить Altegio как источник в Renta по API key и user hash key.
- Откройте раздел Connections > Catalog в левой панели.
- Откройте категорию CRM и нажмите на карточку Altegio.
- В поле API key вставьте ключ из раздела Account settings маркетплейса Altegio.
- В поле User hash key вставьте значение из поля User token вашего приложения в маркетплейсе.
- В поле Source name укажите название источника данных. Оно используется только в интерфейсе Renta.
- Нажмите Save.
Перед сохранением Renta запрашивает у Altegio список филиалов, поэтому ключ с опечаткой или пользователь без доступа не пройдут этот шаг.
Новый источник появляется в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна
Когда источник подключён, создайте пайплайн, чтобы синхронизировать данные Altegio с вашим назначением.
Создание пайплайна Altegio
Свяжите источник Altegio с назначением и настройте пайплайн.
В левой панели нажмите New pipeline. На шаге Source выберите Altegio в разделе Already connected и нажмите Next step.
Выберите созданное ранее подключение Altegio и нажмите Next step. На карточке видно название подключения и дату, когда оно было добавлено.
На шаге Destination выберите ваше назначение (например, Google BigQuery) и нажмите Next step.
Выберите подключение назначения, куда нужно загрузить данные, и нажмите Next step. На карточке видно датасет и проект, в которые попадут данные.
Настройка пайплайна
На последнем шаге выберите филиалы и отчёт, его поля и расписание.
Компании
Выберите филиалы Altegio, которые охватывает пайплайн. Список подтягив ается из вашего аккаунта Altegio, и отметить можно сколько угодно филиалов.
Всё отмеченное попадает в одну таблицу назначения. Колонка Company ID показывает, к какому филиалу относится строка, и доступна во всех семи типах отчётов, поэтому добавляйте её каждый раз, когда пайплайн охватывает больше одного филиала.
Список Selected Companies под выпадающим списком показывает текущий выбор и позволяет убрать из него филиал.
Тип отчёта
Выберите, какой объект Altegio выгружает пайплайн. Один пайплайн загружает один тип отчёта.
| Тип отчёта | Описание |
|---|---|
| Appointments report (записи клиентов) | Записи на услуги с датой и временем визита, статусом посещения и подтверждения, количеством клиентов, комментарием к записи, создавшим её пользователем, формой бронирования и признаком удаления. Клиент, сотрудник, услуги, докумен ты и продажи товаров приходят вложенными структурами. |
| Company metadata (профиль филиала) | Профиль филиала: название, категория, логотип, телефон, график работы, адрес, город, страна, часовой пояс, сокращение валюты и наличие оплаченной лицензии. |
| Service categories metadata (категории услуг) | Категории услуг филиала с идентификаторами категории и услуги, названием для онлайн-записи, минимальной и максимальной ценой, сотрудниками, которые оказывают услугу, ограничением по полу и весом сортировки. |
| Service metadata (каталог услуг) | Каталог услуг с длительностью, техническим перерывом, вместимостью, диапазоном цен и скидкой, настройками предоплаты и автоплатежа, вариантом налогообложения и НДС, доступностью онлайн-записи, категорией услуги, названиями для записи и для чека, а также признаком активности. |
| Staff metadata (сотрудники) | Список сотрудников с именем, специализацией, должностью, рейтингом, почтой и телефоном, аватарами, настройками онлайн-записи, привязанным пользователем, а также датой и причиной увольнения для тех, кто ушёл. |
| Staff salary (зарплата сотрудников) | Расчёт зарпл аты по каждому сотруднику за каждый день: зарплата, количество и сумма услуг, количество групповых услуг, количество и сумма продаж товаров, итоговая сумма, отработанные дни и часы. |
| Transactions (финансовые транзакции) | Финансовые транзакции филиала: сумма, касса, через которую прошли деньги, и признак наличных, клиент, связанная запись на услугу, идентификаторы визита и документа, категория и тип расхода, проданная позиция, комментарий и дата последнего изменения. |
Параметры
Выберите поля Altegio, которые попадут в таблицу назначения.
В каждой строке на вкладке Parameters видно название поля, а под ним название колонки, которую поле займёт в таблице назначения. Найдите параметр по названию через поле поиска или нажмите Select All. На вкладке Selected собрано всё, что вы выбрали, а список Selected Parameters под выбором позволяет удалить параметр.
Набор доступных полей зависит от типа отчёта, и заранее за вас ничего не выбрано.
В Appointments report пять полей содержат целые объекты, а не одиночные значения. Renta записывает их вложенными структурами и не разбивает одну запись на несколько строк.
| Поле | Что внутри |
|---|---|
| Client [Object] | Клиент записи: имя, телефон, почта, скидка, карта лояльности, а также количество состоявшихся и несостоявшихся визитов. |
| Documents [Object] | Документы визита с номером, типом, категорией, складом и датой создания. |
| Goods transactions [Object] | Товары, проданные во время визита, с артикулом, штрихкодом, ценой, скидкой и складом, с которого они ушли. |
| Services [Object] | Оказанные услуги с названием, количеством, ст оимостью, ценой за единицу, скидкой и признаком ручной цены. |
| Staff [Object] | Сотрудник, который принял запись, со специализацией, рейтингом и количеством оценок. |
В Transactions момент оплаты приходит дважды. В Transaction datetime лежит полная отметка времени, а в Transaction date тот же момент в виде календарного дня. Именно по нему удобно группировать выручку по дням в хранилище.
Название таблицы
Задайте название пайплайна и таблицы назначения.
- Integration name.
Название пайплайна. Оно используется только в интерфейсе Renta. - Table name.
Название таблицы назначения. Можно оставить сгенерированное название или ввести своё.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн з апускается раз в день в указанное время обновления. |
| Interval | Пайплайн запускается через указанные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время запуска), затем нажмите Create pipeline.
Новый пайплайн появляется в разделе Pipelines на вкладке ETL, где видно его запуски, прогресс и название таблицы назначения.
Стратегия синхронизации
Все типы отчётов Altegio Renta синхронизирует одинаково.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Полная перезагрузка | Transactions, Company metadata, Appointments report, Service categories metadata, Service metadata, Staff salary, Staff metadata | Каждый запуск читает выбранный тип отчёта целиком по каждому отмеченному филиалу и заменяет содержимое таблицы назначения. Ничто не сужает запуск до записей, изменившихся с прошлого раза, и ни одна запись не обновляется на месте. Таблица повторяет состояние аккаунта Altegio на момент запуска, поэтому запись, которую Altegio перестал отдавать, например удалённая запись клиен та, уходит из таблицы на следующем запуске. |
Ready to get started?
Build your data pipeline today or get a personalized demo. Start free!
Need help?
Get expert support to ensure your project succeeds. We're here to help!
Feature requests?
Help shape our product! Share your ideas for new features and integrations.