Тема
Формат адреса доставки в iiko
ВАЖНО
Эта функция доступна в плагине начиная с версии 2.6.0.
Настройка определяет, в каком виде адрес доставки передаётся из WooCommerce в iiko при экспорте заказа. iiko поддерживает два формата адреса, и важно выбрать тот, который соответствует настройкам вашей организации в iiko.
Где находится настройка
Настройка Формат адреса расположена в разделе настроек экспорта плагина:
WooCommerce → Настройки → MAXPOS Integration → вкладка «Экспорт»:
Страница настроек плагина, вкладка «Экспорт», выпадающий список «Формат адреса» с тремя опциями.
Варианты настройки
Классический (Legacy)
Адрес передаётся в iiko в виде отдельных полей: улица, дом, индекс, корпус, квартира и т. д.
Когда использовать: если в вашей организации iiko адрес вводится и отображается по отдельным полям (улица, дом, квартира). Это формат по умолчанию для большинства организаций.
Город (City)
Адрес передаётся одной строкой, например: Москва, ул. Ленина, д. 5, кв. 10.
Когда использовать: если в настройках вашей организации в iiko включен новый формат адреса. В этом случае iiko ожидает адрес в виде одной строки, а не отдельных полей.
Авто (из организации)
Плагин автоматически определяет нужный формат, запрашивая настройки вашей организации в iiko.
Когда использовать: если вы не уверены, какой формат нужен, или у вас несколько организаций с разными форматами. Плагин сам подставит правильный формат при экспорте.
ИНФОРМАЦИЯ
Опция «Авто» получает формат из настроек организации в iiko при экспорте заказа. Результат кэшируется на 12 часов. Если вы изменили формат адреса в iiko, через 12 часов плагин подхватит актуальные данные автоматически.
Как работает плагин при разных значениях
| Значение | Поведение плагина |
|---|---|
| Классический | Адрес всегда отправляется в формате Legacy (отдельные поля). |
| Город | Адрес собирается в одну строку и отправляется в формате City. |
| Авто | Плагин запрашивает формат из iiko (с кэшированием до 12 часов) и подставляет его при экспорте. |
Использование Яндекс Карт и сторонних подсказок адреса
Плагин корректно передает адрес в iiko, даже если на сайте используются сторонние сервисы для ввода адреса (например, Яндекс Карты из модуля Delivery Zones).
Фильтрация районов в подсказках
По умолчанию Яндекс Карты в подсказках (suggest) могут возвращать названия районов (например, "Москва, Центральный административный округ, Тверской район, улица Арбат"). Это может быть избыточным для пользователя и мешать точному сопоставлению адреса со справочником iiko, где районы обычно не указываются.
В настройках зон доставки (WooCommerce -> Настройки -> MAXPOS Integration -> Зоны доставки) доступна опция «Убирать районы из подсказок адреса». При её включении плагин автоматически удаляет подстроки со словом «район» из списка подсказок Яндекса, делая адрес более чистым и понятным (например, "Москва, улица Арбат").
Вы можете выбрать один из двух вариантов работы со справочником улиц:
Вариант А: Точная привязка к справочнику iiko
- В настройках плагина включите опцию «Выводить список улиц».
- Отключите опцию «Стилизовать выпадающий список улиц».
Результат: Покупатель при оформлении заказа видит удобные подсказки от Яндекса. При этом плагин незаметно сопоставляет выбранный адрес с базой iiko и передает на кассу точный системный идентификатор улицы. Это гарантирует идеальное совпадение.
Вариант Б: Передача адреса обычным текстом
Если вы полностью отключили встроенные списки улиц в настройках плагина, интеграция всё равно будет работать.
Результат: Плагин просто возьмет названия города и улицы, которые ввел клиент, и отправит их в iiko в виде обычного текста. Номер дома также передается отдельно. После этого система iiko на стороне ресторана самостоятельно попытается распознать текст и найти нужную улицу в своей базе.
Оба варианта работают стабильно и успешно привязывают адрес доставки к заказу.
Официальная документация iiko
Работа с адресами (выгрузка городов и улиц)