IikoWeb
Renta выг ружает в ваше хранилище данных два OLAP-отчёта сервера iikoWeb: продажи на уровне блюд и складские и учётные транзакции.
Строка Sales report описывает одно блюдо в одном заказе вместе с его денежными и количественными показателями. Строка Transactions report описывает одну складскую или учётную проводку.
Аутентификация
Renta подключается к iikoWeb по адресу вашего сервера, логину и паролю пользователя. При каждом запуске она входит с этими учётными данными, заказывает отчёты и закрывает сессию, когда запуск заканчивается.
Renta проверяет учётные данные при сохранении подключения, поэтому опечатка в любом из трёх полей всплывает сразу.
Подключение IikoWeb как источника
- В консоли Renta откройте Connections > Catalog в левом меню.
- Раскройте категорию CRM и нажмите карточку IikoWeb. Соседняя карточка IikoCloud относится к другому коннектору, который работает с delivery-API iikoCloud.
Заполните три поля формы:
- Hostname.
Адрес вашего сервера iikoWeb, напримерcompany.iikoweb.ru, безhttps://. - Login.
Пользователь iikoWeb, под которым входит Renta. - Password.
Пароль этого пользователя.
В поле Source name задайте название подключения. Оно используется только внутри консоли Renta. Нажмите Save, и Renta войдёт на сервер, чтобы проверить учётные данные.
Новое подключение появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна IikoWeb
В левом меню нажмите New pipeline. Оставьте вкладку ETL, найдите IikoWeb в списке Already connected и нажмите Next step.
Выберите созданное подключение IikoWeb и нажмите Next step. На карточке видны логин и хост сервера.
На шаге Destination выберите хранилище, куда пойдут данные, и нажмите Next step.
Выберите подключение назначения и нажмите Next step.
Настройка пайплайна
Все настройки пайплайна IikoWeb собраны на последнем шаге мастера, в одной прокручиваемой форме.
Organisation
Пикер организаций определяет, какую часть вашего аккаунта iiko покрывает пайплайн.
В пикере перечислены организации вашего сервера iikoWeb вместе с их числовыми идентификаторами. Можно отметить несколько. Renta обходит организации по очереди, а строки складывает в одну таблицу.
Тип отчёта
Один пайплайн загружает один тип отчёта.
| Тип отчёта | Описание |
|---|---|
Sales report | Продажи с детализацией до блюда в заказе: атрибуты блюда, заказа, подразделения, склада, кассы и оплат, а также денежные и количественные показатели (себестоимость, скидки, НДС, прибыль, количество блюд). |
Transactions report | Складские и учётные проводки: продукт с иерархией и тегами, склад, счёт и корреспондирующий счёт, документ, тип транзакции и сумма движения. |
Параметры
Выберите поля iikoWeb для загрузки. Каждое выбранное поле становится колонкой таблицы назначения.
У каждого типа отчёта свой список полей. Он повторяет колонки того же OLAP-отчёта в интерфейсе iikoWeb. Всё отмеченное собрано на вкладке Selected.
Точки в именах полей превращаются в подчёркивания в таблице назначения, поэтому OpenDate.Typed приходит колонкой OpenDate_Typed.
В Sales report поле order_created_date заполняется из времени открытия заказа OpenTime, поэтому выбирайте их вместе. По этой колонке Renta партиционирует таблицу и загружает данные инкрементально. Подробности в разделе «Стратегия синхронизации» ниже.
Имя интеграции и таблицы
Пайплайн получает два имени: одно в консоли Renta, другое в хранилище.
- Integration name.
Отображаемое имя пайплайна в консоли Renta. - Table name.
Таблица в вашем назначении. Оставьте сгенерированное имя или задайте своё.
Диапазон дат
Диапазон дат ограничивает историю, которую загрузит первый запуск.
- Date start.
Первый загружаемый день. - Date end.
Последний день: фиксированная дата или подвижная граница вроде Today.
IikoWeb строит отчёт на каждый день диапазона на своей стороне, организация за организацией, а Renta ждёт готовности каждого отчёта. Широкий диапазон по нескольким организациям загружается заметно дольше, чем несколько дней.
Период перезаписи
Период перезаписи определяет, насколько далеко назад каждый плановый запуск переписывает уже загруженные дни.
Показатели продаж за последние дни продолжают меняться, пока в iiko закрывают смены и корректируют заказы. Окно перезаписи доносит эти правки до таблицы: каждый запуск удаляет последние дни и загружает их заново. Значение по умолчанию Last 3 days покрывает типичный цикл закрытия.
Расписание
Расписание задаёт, как часто запускается пайплайн. Время здесь указывается в UTC.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную из консоли Renta или через API. |
| Daily | Пайплайн запускается раз в день в указанное время обновления. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily задайте Update time (точное время старта запуска) и нажмите Create pipeline.
Пайплайн появится в разделе Pipelines на вкладке ETL. Там видны имя таблицы, прогресс запусков и число извлечённых строк.
Стратегия синхронизации
Таблица ниже описывает, как Renta синхронизирует каждый тип отчёта IikoWeb.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Инкрементальное обновление | Sales report (с выбранным order_created_date) | Таблица назначения партиционируется по order_created_date. Каждый запуск берёт дни, добавившиеся после прошлого запуска, плюс окно перезаписи, удаляет эти дневные партиции и загружает их заново с актуальными цифрами. |
| Полная перезагрузка | Sales report (без order_created_date), Transactions report | Без ключа партиционирования по дате каждый запуск заменяет всю таблицу содержимым текущего диапазона дат. |
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.