Тема

Подключение Frontpad ​

Плагин поддерживает интеграцию с Frontpad: импорт товаров, экспорт заказов с сайта и обновление статусов заказов через вебхуки. Часть данных Frontpad не отдаёт через АПИ — их нужно перенести в настройки плагина вручную.

1. Подготовка в Frontpad ​

Перед настройкой плагина выполните на стороне Frontpad:

  1. Включите АПИ в общих настройках Frontpad и сохраните секретный код (secret) — он понадобится в плагине.
  2. Присвойте артикулы товарам, которые будут продаваться в интернет-магазине. Без цифрового артикула товар не попадёт в заказ при экспорте.
  3. Подготовьте справочники, ID которых понадобятся в плагине:
    • Варианты оплаты — код каждого способа (наличные, карта, онлайн и т. д.).
    • Филиал, точка продаж и канал продаж — если используются в вашем аккаунте.
    • Отметки заказов (статусы) — числовые ID для сопоставления с WooCommerce.

ВАЖНО

Метод get_products в АПИ Frontpad официально ограничен одним запросом в час. Планируйте импорт меню с учётом этого лимита.

2. Выбор провайдера и подключение ​

  1. Перейдите в WooCommerce ➔ Настройки ➔ MAXPOS Integration ➔ Общие.
  2. В поле Провайдер выберите Frontpad.
  3. В поле API-ключ / секрет вставьте secret из настроек АПИ Frontpad.
  4. Нажмите Сохранить изменения.

TODO - screenshot. Вкладка Общие: Провайдер — Frontpad, заполнено поле API-ключ / секрет.

Поля App ID и Client Secret используются только для iiko и Syrve — при работе с Frontpad их заполнять не нужно.

3. Настройка экспорта заказов ​

На вкладке Экспорт укажите идентификаторы из справочников Frontpad:

  1. ID филиала (организация) — код филиала (affiliate), куда уходит заказ.
  2. ID точки продаж (терминал) — код точки продаж (point).
  3. ID канала продаж — код канала продаж, если вы используете каналы в Frontpad.

TODO - screenshot. Вкладка Экспорт при провайдере Frontpad: поля ID филиала (организация), ID точки продаж (терминал) и ID канала продаж.

ИНФОРМАЦИЯ

Frontpad не отдаёт списки филиалов и точек через АПИ. На главной странице плагина кнопки Получить организации и Получить терминалы при выборе Frontpad не отображаются — ID вводятся вручную.

4. Импорт товаров ​

  1. Перейдите на главную страницу плагина.
  2. Нажмите Получить номенклатуру — плагин загрузит плоский список товаров из Frontpad.
  3. Выберите нужные позиции и запустите импорт, как описано в Шаг 3. Первый импорт.

Frontpad не передаёт структуру категорий через АПИ. Импортированные товары попадают в каталог WooCommerce без иерархии групп из POS — при необходимости распределите их по категориям на сайте вручную.

5. Методы оплаты ​

  1. Перейдите в WooCommerce ➔ Настройки ➔ MAXPOS Integration ➔ Методы оплаты.
  2. В блоке Методы оплаты Frontpad для каждого активного метода WooCommerce укажите код оплаты Frontpad из справочника «Варианты оплаты» (например, 1, 2, 590).

TODO - screenshot. Вкладка Методы оплаты: блок Методы оплаты Frontpad с текстовыми полями кодов для каждого шлюза WooCommerce.

Кнопка Получить типы оплат на главной странице плагина для Frontpad не показывается — список типов оплаты через АПИ недоступен.

Что будет, если не указать код оплаты?

При экспорте заказа плагин передаёт в Frontpad код оплаты, сопоставленный с методом WooCommerce. Если код не задан, заказ может уйти без отметки оплаты или экспорт завершится ошибкой — проверьте настройки для каждого активного способа оплаты на сайте.

6. Экспорт заказов ​

После настройки secret, ID филиала/точки/канала, сопоставления оплат и импорта товаров заказы с сайта отправляются в Frontpad автоматически (в MAXPOS Integration Pro) или вручную по кнопке экспорта (в бесплатной версии).

При успешной отправке в заказе WooCommerce появится служебная заметка с номером заказа Frontpad.

Проверьте полный цикл на тестовом заказе: Шаг 5. Тестовый заказ.

7. Вебхуки и статусы заказов ​

Плагин передаёт в Frontpad URL для вебхука при каждом экспорте заказа. Когда статус заказа меняется в Frontpad, система отправляет уведомление на сайт, и плагин обновляет статус заказа WooCommerce.

Сопоставление статусов ​

  1. Перейдите в WooCommerce ➔ Настройки ➔ MAXPOS Integration ➔ Вебхуки.
  2. В блоке Сопоставление статусов Frontpad для каждого статуса WooCommerce укажите ID статуса Frontpad из справочника программы.
  3. Оставьте поле пустым, если этот статус WooCommerce не нужно обновлять из Frontpad.

TODO - screenshot. Вкладка Вебхуки при провайдере Frontpad: блок Сопоставление статусов Frontpad с числовыми полями для статусов WooCommerce.

ИНФОРМАЦИЯ

При провайдере Frontpad на вкладке Вебхуки отображается только Сопоставление статусов Frontpad. Настройки вебхуков iiko (стоп-лист, токен авторизации и т. д.) для Frontpad не используются.

Если Frontpad прислал статус, для которого сопоставление не задано, плагин добавит в заказ заметку с полученным ID — заказ останется в текущем статусе WooCommerce.

Что пока недоступно для Frontpad ​

Следующие возможности плагина рассчитаны на iiko и Syrve и для Frontpad не применяются:

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

См. также ​