Включается по обращению в поддержку.
Возможности
Загрузка зон запросами
- Зона создаётся и правится запросом: контур, название, точка, общее время доставки, время приготовления, время перевозки, минимальный заказ, цена доставки, порог бесплатной доставки и расписание работы зоны — всё за один раз.
- Контур передаётся текстом в формате WKT: односвязная область без самопересечений, координаты — долгота и широта.
- Обязательны при создании организация, точка и название; остальное дозаполняется позже в кабинете.
- Зоны читаются списком, правятся и удаляются тем же способом — выгружать их перед правкой не нужно.
- Загруженная зона ничем не отличается от нарисованной руками (Зоны доставки): она сразу видна на карте в кабинете, правится там же и участвует в подборе условий для адреса гостя на витрине.
Перенос зон с кассы
- Зоны, заведённые в iiko, переносятся одной кнопкой в кабинете: контур, название, время доставки, время приготовления, минимальный заказ и расписание работы зоны.
- Каждая зона встаёт к той точке, чей терминал указан в условии доставки на кассе.
- Повторный запуск сверяет зоны по названию: известные обновляет, новые заводит.
- Зона, заданная на кассе одной точкой, а не областью, переносится как пункт самовывоза.
Выгрузка зон обратно
- Зоны всех точек выгружаются одним файлом — в KML или в GeoJSON. Оба формата открываются картографическими конструкторами, поэтому выгрузка годится и для проверки контуров, и для публикации карты зон на сайте заведения.
- Выгрузка в GeoJSON включает пункты самовывоза — точками с подписью; выгрузка в KML содержит только курьерские зоны.
Как настроить
Загрузка запросами
- Нужна учётная запись сотрудника заведения с правом на зоны доставки: по логину и паролю выдаётся токен, им подписываются запросы.
- Точки заводятся до зон: зона создаётся под конкретную точку и вместе с ней принадлежит одной организации.
- В запросе указывают организацию, точку и название; контур передают текстом, расписание — списком интервалов по дням недели.
- Состав полей и формат контура описаны в документации разработчика, она открыта без авторизации.
Перенос с кассы
- В кабинете, в разделе интеграции с iiko, есть пункт «Импорт зон доставки» с кнопкой «Запустить импорт». Пункт появляется, когда подключение к кассе настроено.
- На кассе зоны и условия доставки должны быть заведены в разделе «График работы и картография», и у каждого условия указан терминал.
- Терминал точки в заведении должен совпадать с терминалом в условии доставки — по нему зона и находит свою точку.
- После каждого изменения зон на кассе импорт запускают заново.
Выгрузка
- Выгрузка живёт в кабинете отдельным экраном: две кнопки, KML и GeoJSON, и список зон под ними. Отобрать точку или отдельную зону нельзя — выгружается всё, что доступно учётной записи.
Что должно быть настроено и ограничения
- Зона не существует без точки: сначала точки с координатами, потом зоны.
- Зона и точка должны принадлежать одной организации, иначе зона не сохранится.
- Контур должен быть односвязной областью без самопересечений. Если контур не разобрался, приходит ошибка — зона с пустой границей не создаётся.
- Сверка при повторном переносе идёт по названию зоны. Переименование зоны на кассе или в заведении даёт вторую зону вместо обновления существующей.
- Одинаковые названия зон у разных точек одной организации при переносе с кассы конфликтуют: зоны ищутся по названию в пределах организации, а не точки.
- Если для зоны на кассе не нашлось условия доставки или терминала, совпадающего с точкой, зона пропускается молча — в заведении её просто не появится.
- Ход переноса в кабинете не виден: после нажатия кнопки показывается только сообщение о запуске.
- Загрузка идёт под учётной записью сотрудника заведения; отдельного доступа, ограниченного одними зонами, нет.
Чего нет
- Залить файл с зонами прямо в кабинете нельзя: формы для KML или GeoJSON там нет. Файл сначала превращают в контуры, а зоны заводят запросами.
- Одна зона — один замкнутый контур. Зона из нескольких раздельных областей и зона с вырезом внутри не переносятся: у зоны хранится только внешняя граница.
- Перенос с кассы ничего не удаляет: зона, снятая на кассе, в заведении остаётся и продолжает ловить адреса.
- С кассы не приходят цена доставки, порог бесплатной доставки, цвет зоны, приоритет при наложении, особые условия для гостя, слоты и передача заказов внешнему перевозчику — всё это задаётся в кабинете после переноса.
- Расписание с кассы приезжает одинаковым на все семь дней недели: разное время по дням на кассе не сохраняется.
- Перенос зон есть только у iiko и только в прежней схеме подключения; при подключении через iikoTransport зон нет. Другие кассы зоны не отдают.
- Импорт не проверяет результат: наложения контуров, дыры между зонами и зоны, уехавшие за разумное плечо, остаются на глаз человека.
Примеры
Переезд с готовыми зонами
- Заведение приносит файл с зонами из прежнего сервиса или из картографического конструктора.
- Контуры из файла переводят в текстовый вид и раскладывают по точкам.
- Зоны создаются запросами — по одной на контур, вместе с названием, временами и расписанием.
- В кабинете зоны проверяют на карте и дозаполняют цену доставки, порог бесплатной доставки и цвет.
- Витрина начинает принимать адреса: гость видит условия своей зоны при оформлении.
Зоны уже ведутся на кассе
- Подключение к iiko настроено, зоны и условия доставки заведены на кассе.
- В кабинете открывают «Импорт зон доставки» и запускают его.
- Зоны появляются у точек с названиями, временами и минимальным заказом из кассы.
- Цену доставки, цвет и приоритет задают в кабинете — с кассы они не приходят.
- При каждом изменении зон на кассе импорт запускают снова: известные зоны обновятся, новые добавятся.
Карта зон на сайте заведения
- Зоны выгружают из кабинета файлом.
- Файл открывают в картографическом конструкторе, где зонам задают цвета и подписи.
- Готовую карту размещают отдельной страницей сайта.
- Дальнейшие правки карты делают в конструкторе, и на странице они появляются сразу; зоны заведения при этом не меняются.