Где взять API-ключ?

В веб-офисе iiko, в настройках интеграции iikoCloud API (iiko Transport). Нужное значение называется **apiLogin**. Renta меняет его на короткоживущий токен на каждом запуске, поэтому в Renta хранится только сам ключ.

Почему запуск падает, если поставить старую дату начала?

Пайплайны IikoCloud не принимают дату начала глубже 90 дней. Запуск останавливается до первого запроса к API. Сдвиньте **Date start** внутрь окна в 90 дней, история, загруженная прошлыми запусками, при этом сохранится.

Какие заказы попадают в таблицу?

Все доставки выбранного периода в любом состоянии. Renta запрашивает все десять статусов iiko, от **Unconfirmed** до **Delivered**, **Closed** и **Cancelled**, поэтому отменённые заказы тоже приходят строками и отсекаются по колонке со статусом.

Можно ли одним пайплайном покрыть несколько ресторанов?

Да. **Organisation** это мультиселект, и все отмеченные организации попадают в одну таблицу. Строки различаются по колонке organizationId .

Заказы отбираются по дате создания или по дате доставки?

По дате доставки. Запуск за конкретный день возвращает заказы, доставка которых назначена на этот день, независимо от того, когда их создали. Если нужна ещё и дата создания, добавьте в пайплайн поле order_created_date .

IikoCloud

Renta выгружает в ваше хранилище данных доставки IikoCloud: заказ со статусом, временем, клиентом, адресом, оплатами, скидками и составом.

Пайплайн охватывает организации, которые вы выбираете из своего аккаунта iiko, и загружает доставки за указанный период.

Аутентификация

Renta авторизуется в IikoCloud по API-ключу. Ключ принадлежит интеграции iikoCloud API в веб-офисе iiko, там он называется apiLogin.

Токен доступа Renta не хранит. Она меняет ключ на короткоживущий токен в начале каждого запуска, поэтому отзыв ключа в iiko сразу отрезает Renta от данных.

Подключение источника IikoCloud

Перейдите в каталогStep 1

В консоли Renta откройте Connections > Catalog в левом меню.
Разверните категорию CRM и нажмите карточку IikoCloud. Соседняя карточка IikoWeb относится к другому коннектору, для веб-офиса iiko.

Карточка IikoCloud в категории CRM каталога подключений Renta

Введите API-ключStep 2

API Key.
Значение apiLogin вашей интеграции iikoCloud API.

Поле API Key в форме нового подключения IikoCloud

Назовите подключение и сохранитеStep 3

Заполните Source name (название используется только внутри консоли Renta) и нажмите Save.

Поле Source name и кнопк�а Save в форме подключения IikoCloud

Проверьте подключениеStep 4

Подключение появится в списке Sources со статусом Active и будет готово к использованию в пайплайнах.

Список Sources с новым подключением IikoCloud в статусе Active

Создание пайплайна IikoCloud

Выберите IikoCloud как источникStep 1

В левом меню нажмите New pipeline. Оставьте выбранной вкладку ETL, найдите IikoCloud в блоке Already connected и нажмите Next step. Каталог длинный, поэтому быстрее всего добраться через поиск.

Шаг выбора источника в мастере пайплайна с найденным через поиск IikoCloud

Выберите подключениеStep 2

Выберите созданное подключение IikoCloud и нажмите Next step.

Шаг выбора подключения IikoCloud с API login на карточке

Выберите назначениеStep 3

На шаге Destination выберите хранилище, которое примет данные, и нажмите Next step.

Шаг выбора назначения с подключёнными хранилищами

Выберите подключение назначенияStep 4

Выберите подключение назначения и нажмите Next step.

Настройка пайплайна

Последний шаг мастера собирает все настройки в одну длинную форму.

Организация

В аккаунте iiko может быть несколько организаций, и пайплайн читает только те, что вы отметите здесь.

Пикер Organisation с одной отмеченной организацией

Список приходит из вашего аккаунта iiko, под названием каждой организации подписан её идентификатор. Если отметить несколько, все они попадут в одну таблицу, а строки будет различать колонка organizationId.

Тип отчёта

Тип отчёта определяет, что именно извлекает пайплайн.

Выпадающий список Report Types пайплайна IikoCloud

Тип отчёта	Описание
`Delivery orders`	Доставки выбранного периода по отмеченным организациям, в любом состоянии от Unconfirmed до Cancelled. Одна строка на заказ: статус, время, клиент, адрес, оплаты, скидки и состав.

Параметры

Отметьте поля, которые нужно загружать. Каждое выбранное поле станет колонкой таблицы назначения.

Пикер Parameters отчёта Delivery orders со всеми отмеченными полями

Тип отчёта

Поиск

Название	Имя в API	Описание
id text	`id`
posId text	`posId`
externalNumber text	`externalNumber`
organizationId text	`organizationId`
timestamp int	`timestamp`
creationStatus text	`creationStatus`
errorInfo text	`errorInfo`
order.parentDeliveryId text	`order.parentDeliveryId`
order.customer.type text	`order.customer.type`
order.customer.id text	`order.customer.id`
order.customer.name text	`order.customer.name`
order.customer.surname text	`order.customer.surname`
order.customer.comment text	`order.customer.comment`
order.customer.gender text	`order.customer.gender`
order.customer.inBlacklist text	`order.customer.inBlacklist`
order.customer.blacklistReason text	`order.customer.blacklistReason`
order.customer.birthdate text	`order.customer.birthdate`
order.phone text	`order.phone`
order.deliveryPoint.coordinates.latitude float	`order.deliveryPoint.coordinates.latitude`
order.deliveryPoint.coordinates.longitude float	`order.deliveryPoint.coordinates.longitude`
order.deliveryPoint.address.street.id text	`order.deliveryPoint.address.street.id`
order.deliveryPoint.address.street.name text	`order.deliveryPoint.address.street.name`
order.deliveryPoint.address.street.city.id text	`order.deliveryPoint.address.street.city.id`
order.deliveryPoint.address.street.city.name text	`order.deliveryPoint.address.street.city.name`
order.deliveryPoint.address.index text	`order.deliveryPoint.address.index`
order.deliveryPoint.address.house text	`order.deliveryPoint.address.house`
order.deliveryPoint.address.building text	`order.deliveryPoint.address.building`
order.deliveryPoint.address.flat text	`order.deliveryPoint.address.flat`
order.deliveryPoint.address.entrance text	`order.deliveryPoint.address.entrance`
order.deliveryPoint.address.floor text	`order.deliveryPoint.address.floor`
order.deliveryPoint.address.doorphone text	`order.deliveryPoint.address.doorphone`
order.deliveryPoint.address.region text	`order.deliveryPoint.address.region`
order.deliveryPoint.address.line1 text	`order.deliveryPoint.address.line1`
order.deliveryPoint.externalCartographyId text	`order.deliveryPoint.externalCartographyId`
order.deliveryPoint.comment text	`order.deliveryPoint.comment`
order.status text	`order.status`
order.cancelInfo text	`order.cancelInfo`
order.courierInfo.courier.id text	`order.courierInfo.courier.id`
order.courierInfo.courier.name text	`order.courierInfo.courier.name`
order.courierInfo.courier.phone text	`order.courierInfo.courier.phone`
order.courierInfo.isCourierSelectedManually text	`order.courierInfo.isCourierSelectedManually`
order.completeBefore datetime	`order.completeBefore`
order.whenCreated datetime	`order.whenCreated`
order.whenConfirmed datetime	`order.whenConfirmed`
order.whenPrinted datetime	`order.whenPrinted`
order.whenCookingCompleted datetime	`order.whenCookingCompleted`
order.whenSended datetime	`order.whenSended`
order.whenDelivered datetime	`order.whenDelivered`
order.comment text	`order.comment`
order.problem text	`order.problem`
order.operator.id text	`order.operator.id`
order.operator.name text	`order.operator.name`
order.operator.phone text	`order.operator.phone`
order.marketingSource text	`order.marketingSource`
order.deliveryDuration int	`order.deliveryDuration`
order.indexInCourierRoute text	`order.indexInCourierRoute`
order.cookingStartTime datetime	`order.cookingStartTime`
order.isDeleted text	`order.isDeleted`
order.whenReceivedByApi datetime	`order.whenReceivedByApi`
order.whenReceivedFromFront datetime	`order.whenReceivedFromFront`
order.movedFromDeliveryId text	`order.movedFromDeliveryId`
order.movedFromTerminalGroupId text	`order.movedFromTerminalGroupId`
order.movedFromOrganizationId text	`order.movedFromOrganizationId`
order.externalCourierService text	`order.externalCourierService`
order.movedToDeliveryId text	`order.movedToDeliveryId`
order.movedToTerminalGroupId text	`order.movedToTerminalGroupId`
order.movedToOrganizationId text	`order.movedToOrganizationId`
order.menuId text	`order.menuId`
order.deliveryZone text	`order.deliveryZone`
order.sum float	`order.sum`
order.number int	`order.number`
order.sourceKey text	`order.sourceKey`
order.whenBillPrinted datetime	`order.whenBillPrinted`
order.whenClosed datetime	`order.whenClosed`
order.conception.id text	`order.conception.id`
order.conception.name text	`order.conception.name`
order.conception.code text	`order.conception.code`
order.guestsInfo.count int	`order.guestsInfo.count`
order.guestsInfo.splitBetweenPersons text	`order.guestsInfo.splitBetweenPersons`
order.items.type array_string	`order.items.type`
order.items.product.id array_string	`order.items.product.id`
order.items.product.name array_string	`order.items.product.name`
order.items.modifiers.product.id array_string	`order.items.modifiers.product.id`
order.items.modifiers.product.name array_string	`order.items.modifiers.product.name`
order.items.modifiers.amount array_string	`order.items.modifiers.amount`
order.items.modifiers.amountIndependentOfParentAmount array_string	`order.items.modifiers.amountIndependentOfParentAmount`
order.items.modifiers.productGroup.id array_string	`order.items.modifiers.productGroup.id`
order.items.modifiers.productGroup.name array_string	`order.items.modifiers.productGroup.name`
order.items.modifiers.price array_string	`order.items.modifiers.price`
order.items.modifiers.pricePredefined array_string	`order.items.modifiers.pricePredefined`
order.items.modifiers.resultSum array_string	`order.items.modifiers.resultSum`
order.items.modifiers.deleted array_string	`order.items.modifiers.deleted`
order.items.modifiers.positionId array_string	`order.items.modifiers.positionId`
order.items.modifiers.defaultAmount array_int	`order.items.modifiers.defaultAmount`
order.items.modifiers.hideIfDefaultAmount array_string	`order.items.modifiers.hideIfDefaultAmount`
order.items.modifiers.taxPercent array_string	`order.items.modifiers.taxPercent`
order.items.modifiers.freeOfChargeAmount array_int	`order.items.modifiers.freeOfChargeAmount`
order.items.price array_string	`order.items.price`
order.items.cost array_string	`order.items.cost`
order.items.pricePredefined array_string	`order.items.pricePredefined`
order.items.positionId array_string	`order.items.positionId`
order.items.taxPercent array_string	`order.items.taxPercent`
order.items.resultSum array_string	`order.items.resultSum`
order.items.status array_string	`order.items.status`
order.items.deleted array_string	`order.items.deleted`
order.items.amount array_string	`order.items.amount`
order.items.comment array_string	`order.items.comment`
order.items.whenPrinted array_datetime	`order.items.whenPrinted`
order.items.size array_string	`order.items.size`
order.items.comboInformation array_string	`order.items.comboInformation`
order.combos text	`order.combos`
order.payments.paymentType.id array_string	`order.payments.paymentType.id`
order.payments.paymentType.name array_string	`order.payments.paymentType.name`
order.payments.paymentType.kind array_string	`order.payments.paymentType.kind`
order.payments.sum array_string	`order.payments.sum`
order.payments.isPreliminary array_string	`order.payments.isPreliminary`
order.payments.isExternal array_string	`order.payments.isExternal`
order.payments.isProcessedExternally array_string	`order.payments.isProcessedExternally`
order.payments.isFiscalizedExternally array_string	`order.payments.isFiscalizedExternally`
order.payments.isPrepay array_string	`order.payments.isPrepay`
order.tips text	`order.tips`
order.discounts.discountType.id array_string	`order.discounts.discountType.id`
order.discounts.discountType.name array_string	`order.discounts.discountType.name`
order.discounts.sum array_string	`order.discounts.sum`
order.discounts.selectivePositions array_string	`order.discounts.selectivePositions`
order.discounts.selectivePositionsWithSum array_string	`order.discounts.selectivePositionsWithSum`
order.orderType.id text	`order.orderType.id`
order.orderType.name text	`order.orderType.name`
order.orderType.orderServiceType text	`order.orderType.orderServiceType`
order.terminalGroupId text	`order.terminalGroupId`
order.processedPaymentsSum float	`order.processedPaymentsSum`
order.loyaltyInfo.coupon text	`order.loyaltyInfo.coupon`
order.loyaltyInfo.appliedManualConditions text	`order.loyaltyInfo.appliedManualConditions`
order.externalData text	`order.externalData`
order_created_date date	`order_created_date`

Название	Имя в API	Описание
correlationId text	`correlationId`
organizations.responseType text	`organizations.responseType`
organizations.country text	`organizations.country`
organizations.restaurantAddress text	`organizations.restaurantAddress`
organizations.latitude float	`organizations.latitude`
organizations.longitude float	`organizations.longitude`
organizations.useUaeAddressingSystem text	`organizations.useUaeAddressingSystem`
organizations.version text	`organizations.version`
organizations.currencyIsoName text	`organizations.currencyIsoName`
organizations.currencyMinimumDenomination float	`organizations.currencyMinimumDenomination`
organizations.countryPhoneCode text	`organizations.countryPhoneCode`
organizations.marketingSourceRequiredInDelivery text	`organizations.marketingSourceRequiredInDelivery`
organizations.defaultDeliveryCityId text	`organizations.defaultDeliveryCityId`
organizations.deliveryCityIds text	`organizations.deliveryCityIds`
organizations.deliveryServiceType text	`organizations.deliveryServiceType`
organizations.defaultCallCenterPaymentTypeId text	`organizations.defaultCallCenterPaymentTypeId`
organizations.orderItemCommentEnabled text	`organizations.orderItemCommentEnabled`
organizations.inn text	`organizations.inn`
organizations.addressFormatType text	`organizations.addressFormatType`
organizations.isConfirmationEnabled text	`organizations.isConfirmationEnabled`
organizations.confirmAllowedIntervalInMinutes int	`organizations.confirmAllowedIntervalInMinutes`
organizations.isCloud text	`organizations.isCloud`
organizations.isAnonymousGuestsAllowed text	`organizations.isAnonymousGuestsAllowed`
organizations.addressLookup text	`organizations.addressLookup`
organizations.id text	`organizations.id`
organizations.name text	`organizations.name`
organizations.code text	`organizations.code`

Заказ приходит развёрнутым в плоскую строку. Вложенные части ответа iiko сохраняют свой путь в имени поля, поэтому order.loyaltyInfo.appliedManualConditions остаётся одним полем, а в колонке назначения точки заменяются на подчёркивания.

Добавьте order_created_date, если хотите инкрементальную загрузку. Это единственное поле, по которому Renta умеет партиционировать таблицу назначения, и настройка Overwrite Period появляется только после его выбора.

Имя интеграции и таблицы

Задайте название пайплайна в Renta и имя таблицы в назначении.

Поля Integration name и Table name в настройках пайплайна

Integration name.
Отображаемое название пайплайна в консоли Renta.
Table name.
Таблица в вашем назначении. Оставьте сгенерированное имя или введите своё.

Диапазон дат

Диапазон дат задаёт, за какие дни доставки загружаются заказы.

Поля Date start и Date end блока Date Range

Date start.
Первый день доставки, который нужно загрузить.
Date end.
Последний: фиксированная дата или подвижная граница, например Today.

Date start не может быть глубже 90 дней. Запуск с датой за пределами этого окна останавливается с ошибкой до первого запроса, таблица назначения при этом не меняется. Ограничение действует и на ручной Full refresh, поэтому таблицу старше 90 дней нельзя пересобрать с нуля.

Период перезаписи

Период перезаписи определяет, насколько глубоко назад каждый плановый запуск перезагружает уже загруженные дни. Настройка появляется, как только среди выбранных параметров есть order_created_date.

Выпадающий список Overwrite Period пайплайна IikoCloud

Заказы меняются после создания: проходят путь от WaitCooking через OnWay до Delivered или Cancelled. Именно окно перезаписи подтягивает эти изменения в таблицу, поэтому берите его не короче, чем заказы у вас остаются открытыми.

Расписание

Расписание решает, как часто выполняется пайплайн. Указанное здесь время Renta читает в UTC.

Выбор типа расписания с отмеченным вариантом Daily

Тип расписания	Описание
Manual	Пайплайн запускается только вручную из консоли Renta или через API.
Daily	Пайплайн запускается раз в сутки в указанное время обновления.
Interval	Пайплайн запускается через заданные интервалы времени.
Cron Expression	Пайплайн запускается по расписанию, заданному cron-выражением.

Для расписания Daily укажите Update time (точное время старта каждого запуска) и нажмите Create pipeline.

Выпадающий список Update time и кнопка Create pipeline

Renta также поддерживает запуск по API и работу с оркестраторами: Apache Airflow, Dagster, Prefect. Подробности в документации по расписанию.

Пайплайн появится в разделе Pipelines на вкладке ETL вместе с именем таблицы назначения, прогрессом запуска и количеством извлечённых строк.

Список Pipelines с новой интеграцией IikoCloud

Стратегия синхронизации

В таблице ниже описано, как Renta синхронизирует тип отчёта IikoCloud.

Стратегия	Поддерживаемые типы отчётов	Описание
Инкрементальное обновление	`Delivery orders` (с выбранным `order_created_date`)	Таблица назначения партиционируется по `order_created_date`. Каждый запуск удаляет дни окна перезаписи и загружает их заново, поэтому изменения статусов по открытым заказам доезжают до таблицы.
Полная перезагрузка	`Delivery orders` (без `order_created_date`)	Без колонки с датой таблицу нельзя партиционировать, поэтому каждый запуск заменяет всё её содержимое текущим диапазоном дат.

Ограничение в 90 дней и полная перезагрузка плохо сочетаются. Пайплайн без order_created_date переписывает таблицу на каждом запуске и дотягивается максимум на 90 дней назад, поэтому история глубже теряется на следующем же запуске. Выбирайте order_created_date всегда, когда собираетесь хранить больше квартала заказов.

Часто задаваемые вопросы

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.