> For the complete documentation index, see [llms.txt](https://help.zenky.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.zenky.io/exchange/iiko/transport.md).

# Подключение и настройка Iiko Transport

Рассказываем, как подключить Iiko Transport (CloudAPI) к вашему магазину Zenky.

## Переход с Iiko Biz на Iiko Transport

Если вы переходите с Iiko Biz на Iiko Transport, вам может потребоваться дополнительная настройка на стороне Iiko. Воспользуйтесь этой статьёй из справочного центра Iiko, чтобы подготовиться к переходу с Biz на Transport – <https://ru.iiko.help/articles/#!api-documentations/perevod-klienta-s-bizapi-na-cloud-api>

Вам может потребоваться помощь ваших специалистов по Iiko.

## Подключение интеграции

Для подключения интеграции с Iiko Transport перейдите в раздел ["Интеграции"](https://my.zenky.io/dashboard/marketplace) в панели управления Zenky. На этой странице в левом меню выберите раздел **«PoS-системы»**, а затем нажмите на карточку интеграции.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FFjX0bF1LaGYpF8GEWxjo%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-14%20%D0%B2%2022.00.01.png?alt=media&amp;token=b0f59e5f-2edb-4995-b4b4-b3e34af43f32" alt=""><figcaption><p>Выбор интеграции с Iiko Transport.</p></figcaption></figure>

На новой странице вы увидите информацию о подключаемой интеграции. Пожалуйста, прочитайте описание полностью, потому что оно может содержать важную для вас информацию (особенно, если вы переходите с API Iiko Biz).

Так же вы можете просмотреть какие разрешения API-токена Zenky требуются интеграции, а так же какие вебхуки будут отправляться в интеграцию.

После ознакомления нажмите на кнопку **«Подключить интеграцию»** в правом боковом меню.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FsJQODz9MBtMYZd6MNd1j%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-14%20%D0%B2%2022.00.49.png?alt=media&amp;token=30bd259a-2db0-482a-a19c-537226b50aa7" alt="" width="375"><figcaption><p>Кнопка подключения интеграции.</p></figcaption></figure>

На новой странице вам потребуется ввести ваш логин API IIko Transport. В зависимости от того, когда вы настраивали ключи на стороне Iiko, они могут выглядеть по-разному. В большинстве случаев они могут выглядеть так:

* `fdd1dc29914a43e1a5767b82a88c8c53` – 33-значная строка;
* `e22240e8-6fe` – 12-значная строка с разделителем;
* 8-значная строка или короче. Такие ключи могут иметь короткий срок жизни, поэтому их использовать не рекомендуется.

{% hint style="info" %}
Если у вас ещё нет API-логина для Iiko Transport, воспользуйтесь инструкцией в справочном центре Iiko – <https://ru.iiko.help/articles/#!api-documentations/podklyuchenie-poluchenie-api-klyucha>

Вам может потребоваться помощь ваших специалистов по Iiko.

Статья по срокам действия ключей – <https://ru.iiko.help/articles/#!api-documentations/sroki-deystviya-api-klucha>
{% endhint %}

Введите этот ключ в поле на первом этапе настройки, согласитесь с передачей токена и отправкой вебхуков разработчику интеграции, после чего нажмите на **«Подключить интеграцию»**.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FGtjPLxp83Hb6EOdiLKD7%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-14%20%D0%B2%2022.01.50.png?alt=media&amp;token=978a970e-4d42-4e47-855a-4e90b3adce66" alt=""><figcaption></figcaption></figure>

На следующем этапе вам нужно будет выбрать основную организацию, с которой будет вестись работа интеграции. В частности, эта организация будет отвечать за:

* **Импорт каталога.** Мы будем синхронизировать каталог только из этой организации (даже если на вашем логине доступны другие организации);
* **Работу Iiko Card.** Бонусы будут синхронизироваться только для покупателей, которые доступны внутри этой организации.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FpClXB7WPJzGC54Qyw3cd%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-14%20%D0%B2%2022.02.20.png?alt=media&amp;token=ca333972-cd65-494d-9e12-b510000ab958" alt=""><figcaption><p>Выбор основной организации Iiko Transport.</p></figcaption></figure>

## Настройки обмена с Iiko Transport

После успешного подключения вам станут доступны дополнительные настройки обмена. Некоторые из них следует настроить сразу после подключения обмена, чтобы все функции интеграции работали корректно (сопоставление способов оплаты; сопоставление статусов заказов; сопоставление терминалов со складами).

### Сопоставление способов оплаты

Для того, чтобы мы могли отправлять заказы в Iiko с правильным указанием способа оплаты, вам необходимо сопоставить типы оплаты из Iiko со способами оплаты Zenky. Сделать это можно в дополнительном действии **«Сопоставление способов оплаты»**, которое доступно в начале страницы.

Найдите в списке настроек блок **"Оплата".** Вы увидите окно, в левой части которого будут перечислены доступные типы оплаты Iiko, а в правой – выбор способа оплаты Zenky для каждого типа оплаты Iiko. Если у вас несколько способов оплаты - жмите кнопку `Добавить значение.`

Выберите нужный способ оплаты Zenky для каждого типа оплаты Iiko и сохраните список. **Обратите внимание, что каждый способ оплаты Zenky можно выбрать только один раз.**

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FMneCma1edTM6twn6tgGp%2Fimage.png?alt=media&amp;token=0cade01e-e418-4764-a8f2-baa55161e5c2" alt=""><figcaption><p>Блок сопоставления способов оплаты Iiko и Zenky.</p></figcaption></figure>

### Сопоставление статусов заказов&#x20;

Если вы хотите, чтобы статусы заказов автоматически изменялись в Zenky после их изменения в Iiko, сначала вам нужно сопоставить статусы из Iiko со статусами из Zenky.

Листаем настройки до блока **"Заказы"**. В этом окне вам нужно будет нажать на кнопку **Добавить значение** столько раз, сколько статусов вы хотите автоматизировать, а затем выбрать аналогичный статус из Iiko для статуса Zenky (необязательно сопоставлять абсолютно все статусы).

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2F8zLC0jpHZa6zlg8OLlXx%2Fimage.png?alt=media&amp;token=c647becd-828c-4d7d-b226-6655e0444f86" alt=""><figcaption><p>Окно сопоставления статусов заказов Iiko и Zenky.</p></figcaption></figure>

Как минимум один статус должен быть отмечен как **«Завершающий»**. Это означает, что как только заказ в Iiko перейдёт в один из таких статусов, мы перестанем запускать проверку статуса для такого заказа. Обычно завершающими статусами являются **«Закрыта»** («Выполнен») и **«Отменена»** («Отменён»).

{% hint style="info" %}
**Обратите внимание, что каждый статус Iiko можно выбрать только один раз.**
{% endhint %}

После того, как вы завершите сопоставление статусов, нажмите на кнопку **«Сохранить»** (может потребоваться проскроллить всплывающее окно).

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FgTBpCnSZxVUDMNsSzTIn%2Fimage.png?alt=media&amp;token=c8d4173c-a4e4-469c-855d-39dd1010af6b" alt=""><figcaption></figcaption></figure>

### Сопоставление терминалов Iiko и складов Zenky

Для отправки заказов напрямую на терминалы, необходимо сопоставить склады Zenky с соответствующими терминалами Iiko.

{% hint style="warning" %}
**Обратите внимание**

По умолчанию мы будем отправлять заказы напрямую на терминалы. Это значит, что если вы работаете с Колл-центром Iiko, заказы не будут попадать к операторам КЦ, а вместо этого будут падать напрямую на кассы.

Если для вас это неприемлемо, вы можете воспользоваться **черновиками заказов** (см. ниже).
{% endhint %}

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FwggofGbjNrR18xCE7ax6%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-14%20%D0%B2%2022.04.11.png?alt=media&amp;token=570a249c-c5d6-4431-ad38-dcabbd3195bf" alt=""><figcaption><p>Сопоставление терминалов и складов.</p></figcaption></figure>

Для каждого терминала можно выбрать опцию **«Отправлять заказы напрямую»**. Если опция выбрана, то все заказы, которые будут связаны с выбранным складом Zenky, будут отправлены напрямую на сопоставленный терминал. Связь заказа со складом Zenky происходит в одном из двух случаях:

1. Если покупатель оформил заказ на самовывоз и выбрал склад в качестве точки самовывоза;
2. Если покупатель оформил заказ на доставку, а зона доставки, в которую входит адрес, привязана к текущему складу.

Кроме этого, для одного терминала можно выбрать опцию **«Использовать по умолчанию»**. На терминал, отмеченный такой опцией, будут отправляться заказы, которые не связаны ни с одним складом Zenky.

После завершения сопоставления нажмите на кнопку **«Сохранить»**.

### Настройки номенклатуры

В настройках номенклатуры вы можете отключить автоматическую синхронизацию каталога (из вашего Iiko в ваш магазин Zenky), выбрать режим обмена фотографиями и уточнить, что именно использовать в качестве категорий товаров – группы товаров или категории товаров.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FsAJvjxz073i5t01l7P0n%2Fimage.png?alt=media&amp;token=52041036-a7c1-4c4d-a0ac-ac7c503ea685" alt=""><figcaption></figcaption></figure>

Если вы отключите синхронизацию каталога, вам по-прежнему будет доступна ручная синхронизация ([см. ниже](#ruchnaya-sinkhronizaciya-kataloga)).

По умолчанию для товаров используются только фотографии из Iiko, но если вы хотите дополнительно загрузить фотографии в панели управления Zenky, измените настройку **«Режим обмена фотографиями товаров»** на **«Использовать фотографии из Iiko и загруженные вручную»**. Режим **«Использовать только фотографии, загруженные вручную»** полностью отключает импорт фотографий товаров из Iiko.

Если во время подключения интеграции вы выбрали неправильное значение настройки **«В качестве категорий использовать»**, после её изменения вам потребуется очистить обменник Iiko и выполнить ручную синхронизацию каталога ([см. ниже](#ruchnaya-sinkhronizaciya-kataloga)).

Настройка **«Использовать фотографии групп»** позволяет загружать изображения групп из Iiko в категории товаров Zenky (но только если в качестве категорий у вас используются группы).

### Настройки заказов

В настройках заказов вы можете отключить или включить **отправку заказов** в Iiko (при этом возможность оформления заказа на сайте или в приложении отключена не будет; так же вы продолжите получать уведомления о новых заказах в Telegram или на почту), **способ отправки заказов в Iiko**, **проверку статусов** (для работы этой функции необходимо сопоставить статусы заказов; [см. выше](#sopostavlenie-statusov-zakazov)), добавление номера заказа и связанного склада в комментарии к заказам.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FYoFzAbH09hP56ujoBHRx%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-14%20%D0%B2%2022.58.26.png?alt=media&amp;token=a16eb431-9be2-4b27-a989-d036879abbed" alt=""><figcaption><p>Настройки заказов Iiko Transport.</p></figcaption></figure>

#### Способ отправки заказов в Iiko

Интеграция с Iiko Transport поддерживает три способа отправки заказов из Zenky в Iiko:

1. **На терминалы.** Как было описано выше, с этой настройкой мы будем отправлять заказы напрямую на связанный со складом терминал (или на терминал, выбранный по умолчанию, если к заказу не привязан склад);
2. **Автораспределение.** В этом случае Iiko будет распределять заказы по терминалам самостоятельно. Для работы этой опции потребуется включить автораспределение на стороне Iiko;
3. **Черновики заказов.** Вместо отправки на терминалы мы будет создавать черновики заказов, которые будут доступны операторам облачного Колл-центра Iiko. Операторы смогут переводить черновики в подтверждённые заказы и отправлять их на конкретные терминалы самостоятельно. Для работы черновиков необходимо настроить <mark style="color:red;">**внешнее меню**</mark>. Если у вас есть терминалы со включенной опцией **«Отправлять заказы напрямую»** (в настройках интеграции Zenky с Iiko Transport), черновики для них создаваться не будут, а заказы будут уходить напрямую на такие терминалы.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FzkIj4K2Jye1wXDdjiu0I%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-14%20%D0%B2%2022.03.10.png?alt=media&amp;token=0a9b243b-e985-47c7-a3cb-2ac5a52dc589" alt=""><figcaption><p>Выбор способа отправки заказов в Iiko.</p></figcaption></figure>

#### Внешнее меню для черновиков

Для работы черновиков необходимо настроить и выгрузить в API Iiko Transport внешнее меню. После того, как вы это сделаете, в настройке **«Внешнее меню по умолчанию»** появится выбор ваших меню. Выберите нужное (если несколько) и сохраните настройки. После этого вы сможете получать заказы в виде черновиков.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2Fm0eEUM1pc99IsTBZ9p6G%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-14%20%D0%B2%2022.02.58.png?alt=media&amp;token=b4c469c7-9621-43ab-86c6-46b46f2246f6" alt=""><figcaption><p>Выбор внешнего меню по умолчанию.</p></figcaption></figure>

#### Проверка статусов перенесённых заказов

Настройка **«Проверять статусы перенесённых заказов»** может быть полезна, если у вас несколько точек и вы переносите оформленные заказы между ними. С выключенной настройкой перенесённый заказ получит статус **«Отменён»**, который отобразится в истории заказов на сайте или в мобильном приложении (так же покупатель может получить пуш-уведомление об отмене заказа, если они у вас подключены).

Вместо этого мы можем попытаться отследить статус нового заказа (перенесённого на другую точку) и обновлять исходный заказ в Zenky  с его информацией. ID нового заказа определяется с помощью API  (мы проверяем поле `movedDeliveryId`).

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

### Покупатели

Раздел **«Покупатели»** позволяет уточнить, какие данные покупателей будут отправляться в базу Iiko (во время отправки заказов).

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FoZqIyW42gfUdDUI0LWZ9%2Fimage.png?alt=media&amp;token=ed50df61-3133-411d-aeab-19173c91e6e6" alt=""><figcaption></figcaption></figure>

* В режиме **«Перезаписывать всегда»** имя, фамилия и дата рождения покупателей будут перезаписываться данными из Zenky в любом случае, даже если они указаны в профиле Iiko. Например, если в базе Iiko покупатель записан как «Иван Иванов», а в базе Zenky – «Ivan Ivanov», после отправки заказа в базе Iiko имя и фамилия станут «Ivan Ivanov»;
* В режиме **«Перезаписывать пустые значения»** данные покупателя будут отправлены в Iiko, только если они не указаны. Например, покупатель с именем Иван (но без фамилии) после отправки заказа будет записан как «Иван Ivanov». Мы рекомендуем использовать этот режим.

Важно отметить, что если какие-то данные покупателя не указаны в базе Zenky, информация в базе Iiko не будет перезаписана пустыми значениями в любом из указанных режимов.

### Iiko Card

Если вы используете Iiko Card и у вашего магазина Zenky подключена программа лояльности, в этом разделе вы можете указать дополнительные параметры обмена бонусами.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FdzSyNsZ3XA6EutJ9qhxW%2Fimage.png?alt=media&amp;token=49bd174c-2bd7-4a54-9e5b-0af3bc42e265" alt=""><figcaption></figcaption></figure>

* С помощью настройки **«Способ синхронизации бонусов из Iiko Card в Zenky»** вы можете выбрать как именно бонусы из Iiko Card будут передаваться в программу лояльности Zenky. \
  \
  Способ **«Корректировка баланса»** будет создавать одну транзакцию пополнения или списания бонусов в Zenky – например, если баланс покупателя в Zenky – 500 бонусов, а в IikoCard – 250, то во время синхронизации будет создана одна транзакция корректировки на списание 250 бонусов (при этом изначально баланс в Iiko мог быть изменён несколькими транзакциями). \
  \
  Способ **«Изменение баланса»** будет создавать отдельные транзакции пополнения или списания бонусов после каждой операции в iiko.
* Настройка **«Источник бонусов для корректировки»** может быть полезна, если вы используете несколько кошельков Iiko Card. По умолчанию при корректировке мы берём баланс только из первого кошелька с нужным типом (настройка **«Кошелек для пополнения бонусов Zenky»**). При работе с несколькими кошельками бонусы могут синхронизироваться некорректно, поэтому вы можете поменять значение на **«Использовать баланс всех подходящих кошельков»** – в этом случае мы просуммируем баланс бонусов.
* В списке **«Начисления бонусов Zenky, которые нужно отправлять в Iiko Card»** вы можете выбрать типы транзакций Zenky, которые должны изменять баланс покупателя в Iiko Card. Например, если вы используете программу «Пригласи друга» в Zenky, бонусы за приглашения друзей не будут отправляться в Iiko Card, пока вы не выберете тип **«Награда за приглашение»** в этом списке.\
  \
  **Важно**: если вы начисляете кэшбэк на стороне Iiko Card, не выбирайте тип транзакции **«Кэшбэк»** из этого списка. Так же в настройках бонусной программы (раздел [**«Лояльность» -> «Бонусная система»**](https://my.zenky.io/dashboard/store/profile/loyalty)) вам нужно поменять значение настройки **«Обработчик кэшбэка»** на **«Внешняя система»**. В противном случае покупатель может получить два кэшбэка – один от Zenky и один от Iiko Card.
* В настройке **«Кошелёк для пополнения баланса в Iiko Card»** вы можете выбрать конкретный кошелёк, в который будут отправляться бонусы из Zenky. Если вы используете один кошелёк, можете оставить значение этой настройки по умолчанию (**«Использовать первый подходящий кошелёк»**).

### Стоп-листы

{% hint style="info" %}
Для работы стоп-листов необходимо включить проверку остатков товаров при добавлении товара в корзину или во время оформления заказа. Сделать это можно включив настройку **«Проверка остатков товаров»** в разделе **«Магазин» -> «Настройка заказов»**. Выберите любой режим проверки и укажите этап проверки остатков.
{% endhint %}

Если синхронизация стоп-листов включена, остатки всех товаров из вашего стоп-листа будут передаваться в Zenky. Когда остатки в стоп-листе достигнут нуля, заказы с этим товаром нельзя будет оформить (если включена проверка остатков).

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FM5SNopvXIIwc6hKVtOtP%2Fimage.png?alt=media&amp;token=40802405-3fdf-41b7-a165-ec7f14b26a92" alt=""><figcaption></figcaption></figure>

Настройка **«Поведение остатков при удалении товара из стоп-листа»** отвечает за поведение, когда товар **удаляется** из стоп-листа. Например, вы добавили некий товар в стоп-лист с нулевыми остатками. Через какое-то время вы вернули его в продажу и удалили из стоп-листа. В зависимости от того, какое значение выбрано у этой настройки, товар либо станет доступен для заказа в Zenky, будет снят с продажи или же будет проигнорирован (остатки в Zenky не изменятся).

### Адреса доставки

В некоторых базах Iiko могут наблюдаться проблемы с приёмом заказов с сайта или из приложения – бывает, что локальная база адресов имеет некоторые различия и из-за этого не может определить адрес доставки. Например, в вашей базе все улицы могут быть записаны как «Ленина улица», «Октябрьская улица» и т.д., в то время как мы отправляем адрес доставки без указания типа улицы – просто «Ленина» или «Октябрьская».\
\
Если вас коснулась эта проблема, мы можете добавить свои правила форматирования улиц, и мы будет формировать адрес доставки в соответствии с этими правилами.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2F0kHkLJGFkqS5BMh58sAJ%2Fimage.png?alt=media&amp;token=1cfa0028-91be-4042-98e6-85a526b6d548" alt=""><figcaption></figcaption></figure>

Вы можете добавить несколько правил для тех типов улиц, которые в вашей базе записаны по-особому. Поле **«Расположение»** отвечает за то, где подставлять тип улицы – до названия («улица Ленина») или после («Ленина улица»). Поле **«Тип названия»** задаёт короткое название типа улицы («ул») или полное («улица»).

Заполните все поля, чтобы увидеть предпросмотр строки улицы, которая будет отправлена в Iiko.

{% hint style="info" %}
Перед тем, как добавлять правила, проконсультируйтесь с вашим системным администратором Iiko или с интегратором. Возможно, в вашей базе улицы заполнены без типов, поэтому добавлять правила не потребуется.

Мы используем базу ФИАС, которую получаем от сервиса Dadata.ru.&#x20;
{% endhint %}

### Импорт каталога

Вы можете выполнить ручную синхронизацию каталога из базы Iiko в базу Zenky, не дожидаясь автоматической выгрузки (происходит раз в 20 минут, если каталог в Iiko изменился).

В столбце слева найдите пункт **"Действия"** и нажмите на него.  В открывшемся окне вы можете указать дополнительные параметры ручной синхронизации.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FGxUOOZmZvzrkSOuA9Vvk%2Fimage.png?alt=media&amp;token=1b0de3ad-90e8-4021-8a1d-398a21ba32c2" alt=""><figcaption></figcaption></figure>

* **«Игнорировать ревизию»** – синхронзация будет выполнена, даже если каталог в Iiko не изменился. Если настройка не выбрана и каталог не менялся, данные не будут повторно выгружены в Zenky;
* **«Полная выгрузка»** – если выбрано, в Zenky будет передан весь каталог Iiko (товары, категории и модификаторы). В противном случае мы выгрузим только те данные, которые были изменены после последней синхронизации.

После запуска импорта данные поступят в каталог Zenky спустя несколько минут (обычно – не более 5 минут, но в некоторых случаях время ожидание может быть увеличено).

### Проверка номенклатуры

Если какие-то товары или категории в вашем каталоге не отображаются (или отображаются неправильно), вы можете проверить актуальный ответ API номенклатуры от Iiko Biz.

Сделать это можно, с помощью блока **"Проверка номенкулатуры"**

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FlPc9x4hPFpAi5jDauOt0%2Fimage.png?alt=media&amp;token=e69a5090-a452-4bc8-93d2-b39f0590aff6" alt=""><figcaption></figcaption></figure>

В открывшемся окне нажмите на кнопку **«Загрузить номенклатуру»**. Ответ API будет доступен в текстовом поле (формат JSON). Для проверки данных вам может потребоваться помощь вашего системного администратора Iiko или интегратора.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FPbwKjaA22fH7Zo55uZXb%2Fimage.png?alt=media&amp;token=059ac372-4b45-48fb-ba91-c8844b41c7aa" alt=""><figcaption></figcaption></figure>

При проверке обращайте внимание на номер ревизии (поле `revision`) и дату последней выгрузки (поле `uploadDate`). Если необходимые данные присутствуют в выгрузке, но не появляются в каталоге Zenky после принудительной ручной синхронизации, вам может потребоваться очистка данных обменника Iiko.

### Очистка данных

Мы храним копию вашего каталога Iiko в промежуточном сервисе, который мы называем обменником Iiko. С его помощью мы определяем какие данные изменились (чтобы не синхронизировать весь каталог постоянно), принимаем заказы из Zenky и отправляем их в Iiko, а так же выполняем дополнительные сервисные действия (проверка статусов заказов, синхронизация бонусов и стоп-листов и т.д.).

Если вы заметили какие-то неточности в каталоге или хотите полностью сбросить все данные и начать с чистого листа, вам поможет очистка данных в обменнике Iiko.

{% hint style="info" %}
Мы удаляем только те данные, которые храним у себя. Никакие очистки данных не удалят информацию из вашей базы Iiko.
{% endhint %}

Найдите пункт **«Очистка данных» -** он находится в самом низу страницы **"Действия"**. В открывшемся окне вы можете выбрать, какие именно данные нужно удалить.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FnPLWUWJpHFeJXfE5YM58%2Fimage.png?alt=media&amp;token=1cf6c541-5828-4ece-9de3-bd1a7a1bbc5f" alt=""><figcaption></figcaption></figure>

* **«Удалить категории»** – из обменника будут удалены все категории товаров (или группы товаров, если в качестве категорий вы используете группы);
* **«Удалить товары»** – из обменника будут удалены все товары;
* **«Удалить модификаторы»** – из обменника будут удалены все модификаторы товаров (групповые и одиночные);
* **«Удалить стоп-листы»** – из обменника будут удалена вся информация о стоп-листах. Остатки товаров в Zenky не будут изменены;
* **«Удалить заказы»** – из обменника будут удалены все заказы, которые были ранее отправлены в Iiko (в самой базе Iiko заказы удалены не будут). Если какие-то заказы ещё находились в стадии проверки статусов, их статусы больше не будут обновляться;
* **«Удалить статусы заказов»** – из обменника будет удалено сопоставление статусов заказов Iiko и Zenky;
* **«Удалить способы оплаты»** – из обменника будет удалено сопоставление способов оплаты Iiko и Zenky;
* **«Удалить терминалы»** – из обменника будет удалено сопоставление терминалов Iiko и складов Zenky.

Выберите нужные опции и нажмите на кнопку **«Удалить данные»**. В течение нескольких минут (до пяти) данные в обменнике будут удалены, после чего вы сможете выполнить ручную синхронизацию для импорта свежих данных.

#### Очистка каталога Zenky

Если очистка данных обменника не помогла решить проблему или же вы начали наблюдать дубликаты категорий или товаров, вам потребуется очистить каталог Zenky.

{% hint style="danger" %}
Очистка каталога Zenky крайне **не рекомендуется** для магазинов, которые уже начали работу и принимают заказы. В случае удаления товаров все заказы покупателей в Zenky будут обнулены, и у покупателей не будет возможности просмотреть историю заказов.

Так же изменятся ссылки на товары или категории. Если вы размещали ссылки на конкретные категории товаров, они перестанут работать.
{% endhint %}

Очистка каталога Zenky доступна в разделе [**«Магазин» -> «Очистка данных»**](https://my.zenky.io/dashboard/store/profile/cleanup). Очистку данных может запустить только сотрудник магазина с ролью **«Владелец»** и не чаще одного раза в 24 часа.&#x20;

После очистки каталога Zenky, повторно очистите данные обменника, подождите несколько минут и выполните ручную синхронизацию.

## Обновление API-логина Iiko Transport

Если ваш API-логин Iiko Transport истёк, вы можете обновить его в разделе **«Действия»** вашей интеграции с Iiko Transport в панели управления магазином Zenky.

{% hint style="info" %}
Обратите внимание

В статье справочного центра Iiko дана информация о сроках действия API-ключей – <https://ru.iiko.help/articles/#!api-documentations/sroki-deystviya-api-klucha>
{% endhint %}

Перейдите в раздел ["Интеграции"](https://my.zenky.io/dashboard/marketplace) в панели управления Zenky. На этой странице выберите раздел «Установленные» и нажмите на карточку интеграции с Iiko Transport.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FRbCApzwvkLO2aKUldnjm%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-14%20%D0%B2%2023.23.44.png?alt=media&amp;token=4c065abf-0c7f-4931-8255-0e0a010720b9" alt=""><figcaption><p>Выбор установленной интеграции Iiko Transport.</p></figcaption></figure>

На открывшейся странице выберите раздел «Действия» в левом меню. Найдите блок «Изменить API логин» и введите новый логин в поле **«Новый логин API Iiko Transport»**.

{% hint style="danger" %}
**Будьте внимательны!**

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

Пожалуйста, проконсультируйтесь с вашими специалистами по Iiko, прежде чем изменять API логин.

Если логин не подойдёт, вы увидите текст ошибки во всплывающем окне (см. ниже).
{% endhint %}

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FMUydnKgcXCqkBT96OYzG%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-14%20%D0%B2%2023.22.12.png?alt=media&amp;token=1d6774e6-d901-4769-b71d-5b82aa30b184" alt=""><figcaption><p>Интерфейс ввода нового API-логина Iiko Transport.</p></figcaption></figure>

Нажмите на **«Сохранить логин»**. После отправки данных откроется всплывающее окно, в котором вы увидите результат изменения логина.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FJI1MmyFg3LFHx0X0wZda%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-14%20%D0%B2%2023.27.03.png?alt=media&amp;token=fcb52b0d-b5f1-40cb-913f-116817565914" alt=""><figcaption><p>Пример успешного изменения API-логина.</p></figcaption></figure>

Выше показан пример успешного изменения логина API. Однако, вы можете увидеть одну из следующих ошибок, если что-то пошло не так:

* <mark style="color:red;">**Вы указали некорректный логин API Iiko Transport.**</mark> Возникает, когда вы ввели в поле неправильный логин. Перепроверьте значение или проконсультируйтесь с вашими специалистами по Iiko.
* <mark style="color:red;">**Не удалось получить список организаций для этого логина API Iiko Transport.**</mark> Возникает, когда введён корректный логин, но у него нет доступа ни к одной организации Iiko. Перепроверьте логин или проконсультируйтесь с вашими специалистами по Iiko.
* <mark style="color:red;">**Текущая организация отсутствует в списке организаций, полученных из Iiko Transport.**</mark> Скорее всего, вы указали логин API, который относится к другой организации. Возникает, когда у нового токена нет доступа к текущей организации по умолчанию. Организация по умолчанию задаётся в настройке «Организация по умолчанию», а отвечает за синхронизацию каталога и бонусов. Убедитесь, что у нового логина есть доступ к этой организации.