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. Нажмите кнопку «Получить города».
  7. Выберите город для которого нужно загрузить улицы и нажмите кнопку «Получить улицы».
  8. Нажмите кнопку «Получить типы оплат».
  9. Введите в настройках плагина название улицы по-умолчанию. Оно будет использоваться, когда клиент введет название улицы отсутствующее в iiko. Данная улица должна быть добавлена в iiko.
  10. Заполните в настройках плагина обозначения методов оплаты WooCommerce соответствующие типам оплат iiko. Например, настройки стандартного метода оплаты “Наличными” доступны по адресу /wp-admin/admin.php?page=wc-settings&tab=checkout&section=cod, где cod — это обозначение метода оплаты “Наличными”.
  11. Экспорт заказов в iiko происходит автоматически при оформлении заказов на сайте.

Примечания

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

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

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

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

Скриншоты

FAQ

Где взять 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

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

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

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

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

    • Добрый день!

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

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

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

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

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

  3. Здравствуйте. Не отправляются заказы с доставкой (не доходят до айко), пробовал также с темой skywebdelivery и с обычным storefront. В айко настроено транспорт апи. Уже не представляю, куда копать

      • Спасибо за ответ!
        В моем случае ошибка была на стороне бэкофиса айко: типам доставки нужно обязательно выставлять галочку «может приниматься извне». (Возможно кому-то еще поможет)

  4. Здравствуйте! Еще хотел уточнить возможность указания стоимости доставки. В айко приходят без учета стоимости доставки – возможно, так и задумано, а возможно, я что-то не настроил?

  5. 1. Не получается загрузить номенклатуру на сайт без выбора терминала, получаю ошибки:
    Terminal ID is empty.
    Organization does not have nomenclature groups.
    Или это означает, что у организации нет ни терминалов, ни блюд?

    2. Будет ли плагин обновлять на сайте категории, блюда, цены, граммовку, их картинки и описания автоматически при изменении на стороне iiko или нужно это делать вручную?

    • 1. Это ошибка, номенклатура должна импортироваться без выбора терминала. Исправлю.
      Но при выборе терминала номенклатура загружается.
      2. В данной бесплатной версии автообновления нет. Она есть в платной версии.

        • Добрый день!
          Автообновление готово.
          Премиум версию пока можно приобрести напсав на hi@skyweb.team
          Позже будет более подробная информация на данной странице и на странице плагина на wordpress.org

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

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