iikoCloud (Transport) API for WooCommerce

Тип проекта: Плагин WordPress

Год: 2021

Цена: бесплатно

Ссылка: wordpress.org/plugins/skyweb-wc-iiko

Интеграция базового функционала iikoCloud API в WooCommerce: импорт категорий и товаров (размеров и модификаторов) и экспорт заказов.

Интеграция базового функционала iikoCloud API в WooCommerce: импорт категорий и товаров (размеров и модификаторов) и экспорт заказов.

iikoCloud API (iikoTransport API) является единой точкой для использования функционала, предоставляемого iiko.

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

Документация iiko
iikoTransport. API description

Порядок работы с плагином

  1. Введите apiLogin на странице настроек плагина и точное название метода доставки Самовывоз (при наличии). Нажмите кнопку “Сохранить изменения”.
  2. Перейдите на страницу плагина и нажмите кнопку “Получить организации”.
  3. Выберите нужную организацию и нажмите кнопку “Получить терминалы”.
  4. Выберите нужный терминал и нажмите кнопку “Получить номенклатуру”.
  5. Выберите нужные группы и нажмите кнопку “Импортировать продукты”. На сайт будут загружены выбранные группы и содержащиеся в них продукты.
  6. Экспорт заказов в iiko происходит автоматически при оформлении заказов на сайте.

Примечания

  1. Загружать номенклатуру на сайт можно без выбора терминала, но экспортировать заказы в iiko без указания терминала невозможно.
  2. Группы выделенные зеленым цветом загружать необязательно, так как это группы модификаторов, загружаемые в виде индивидуальных атрибутов товаров.
    Зачеркнутые группы – помечены на удаление в iiko.
  3. В настройках плагина указаны названия и ID выбранных организации, терминала и города, а также количество загруженных улиц.
    Эти поля недоступны для редактирования в настройках плагина и заполняются автоматически:
    • названия и ID организации и терминала – при нажатии на кнопку “Получить номенклатуру”;
    • название и ID города, а также количество загруженных улиц – при нажатии на кнопку “Получить улицы”.
  4. При оформлении заказа, поля “Имя”, “Телефон”, “Адрес”, и “Дополнение к адресу” должны быть обязательными.
  5. Номер телефона должен начинаться с символа “+” и состоять не менее чем из 8 цифр.
  6. Для добавления даты и времени приготовления заказа при экспорте заказов, вы можете использовать фильтр skyweb_wc_iiko_order_complete_before.
  7. Для добавления дополнительных данных адреса при экспорте заказов, вы можете использовать фильтр skyweb_wc_iiko_order_address_fields.
  8. Для добавления дополнительных данных в комментарий при экспорте заказов, вы можете использовать фильтр skyweb_wc_iiko_order_comment.
  9. Поддерживается загрузка списка улиц для одного города.
  10. При экспорте заказа, его ID для iiko генерируется на основе номера заказа WooCommerce. При повторной отравке одного и того же заказа в iiko (например, при обновлении страницы успешного заказа), повторного экспорта iiko не происходит и в примечания заказа добавляются соответствующие уведомления.

Порядок работы с iiko

Поддержка тем

Данный плагин отлично работает с темой доставки Skyweb Delivery

Скриншоты

FAQ

Какие требования к хостингу/серверу?

Для работы плагина должна быть активирована PHP библиотека cURL.

Где взять apiLogin?

Изучите документацию подключение iikoCloud API или обратитесь к личному менеджеру/интегратору iiko.

Поддерживается ли импорт вложенных групп товаров iiko?

Нет, но вы можете создать вложенность категорий товаров WooCommerce вручную, через раздел Товары – Категории.

Поддерживается ли импорт вариативных товаров WooCommerce?

Да, со следующими особенностями:
1. Поддерживается загрузка размеров блюда iiko (одна шкала размеров на блюдо – ограничение iiko), как индивидуальных атрибутов товара WooCommerce.
2. Поддерживается загрузка только групповых модификаторов (одна группа модификаторов – ограничение плагина), как индивидуальных атрибутов товара WooCommerce.
3. Цена/количество/условия модификаторов не учитываются при создании вариаций товара WooCommerce.
Цена вариации формируется следующим образом:
– Если загружаемое блюдо имеет только размеры, то на каждый размер создается своя вариация с ценой размера.
– Если загружаемое блюдо имеет только группу модификаторов, то на каждый модификатор создается своя вариация с ценой блюда.
– Если загружаемое блюдо имеет и размеры и группу модификаторов, то на каждый размер создается несколько вариаций (в зависимости от количества модификаций) с ценой размера.
4. Схема модификаторов не поддерживается в выгрузке меню, т. е. схемы модификаторов не передаются через API iikoCloud. Используйте только индивидуальные модификаторы для блюда.

Поддерживается ли атрибут “По умолчанию” размеров iiko (указывается при создании шкалы размеров)?

Нет.

Поддерживается ли атрибут “Доступен” размеров iiko (указывается при редактировании блюда)?

Да.

Поддерживается ли загрузка модификаторов iiko, как товаров WooCommerce?

Нет, модификаторы товара загружаются только как атрибуты, см. вопрос выше.

Поддерживается ли загрузка товаров iiko, как товаров WooCommerce?

Да.

Какие данные импортируются?

Категории (группы):
– название;
– описание;
– изображение;
– iiko ID;
– СЕО-заголовок (SeoTitle);
– СЕО-описание (SeoText).
Группы модификаторы, удаленные и исключенные из меню группы не импортируются и не обновляются.
СЕО-данные импортируются для плагина Yoast SEO.

Товары (блюда):
– название;
– описание;
– краткое описание (техническая информация);
– главное изображение;
– галерея изображений (не поддерживается iiko API);
– артикул (SKU);
– цена;
– вес;
– теги (метки), заполняются в iiko BackOffice через точку с запятой ; без пробелов;
– iiko ID;
– СЕО-заголовок (SeoTitle);
– СЕО-описание (SeoText).
Удаленные блюда не импортируются и не обновляются.
Исключенные из меню блюда импортируются со статусом “скрытый везде”.
СЕО-данные импортируются для плагина Yoast SEO.

Что означает ошибка ‘Error while getting iiko nomenclature from the cache.’?

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

Что делать если мне нужна доработка данного плагина?

Пишите на почту hi@skyweb.team

Посмотрите другие проекты

4 комментария на «“iikoCloud (Transport) API for WooCommerce”»

  1. Здравствуйте!

    Не нашел в описании плагина информацию про методы оплаты, как осуществляется поддержка плагином методов оплаты?
    У нас несколько методов оплаты – наличными, картой по терминалу, по QR-коду, через Сбербанк Онлайн, и картой на сайте.
    Хотелось бы сохранить все эти методы оплаты.

  2. Добрый день!

    В текущей версии плагина этот функционал не реализован, но могу помочь сделать в частном порядке.

    Алгоритм работы следующий:
    1. Вы создаете типы оплат iiko.
    2. “Забираете” их в админке на сайт.
    3. В настройках плагина (https://prnt.sc/10kjo6r) отображаются все созданные для внешнего использования типы оплат iiko, которым вы сопоставляете свои собственные методы оплат WooCommerce.
    4. Также можете указать, обрабатывается ли платеж вне системы iiko. Это актуально для интернет-эквайринга, например для оплаты заказа картой онлайн на сайте.

    Получается довольно гибкая система без ограничений и костылей.

  3. Добрый день!
    Установил плагин IIKOCLOUD. Получил организации и терминалы, при получении номенклатуры получаю сообщением в терминале “Organization does not have nomenclature groups.” В чем может быть проблема?

  4. Добрый день!
    Это может означать, что:
    1. У Вас не выгружено меню в iiko Office, раздел ‘Обмен данными -> Выгрузка меню’.
    Если меню выгружено, то попробуйте поднять ревизию, поменяв что-то в верхней части выгрузки меню. Например, можете поменять название или где-то поставить тэг. И попробовать получить номенклатуру снова после этого
    2. Не активирован iikoTransport для кассовой точки – опция ‘Включить работу через iikoTransport’ должна быть отмечена в iikoWeb для вашей организации.

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *