Frontpad — онлайн-сервис для учёта и управления продажами и небольшим производством. Заказ на доставку приходит в Смартомато, а затем, после подтверждения или сразу (зависит от настройки), автоматически уходит во Frontpad.
Шаги на стороне Frontpad
-
Открыть app.frontpad.ru → «Настройки» → «Общие».
-
В блоке «Функции» напротив «API» нажать «Настроить», поставить галочку «Включен» и скопировать код из поля «Секрет». Зачем: это токен, по которому Смартомато обменивается данными с Frontpad.
-
Создать типы оплаты: «Справочники» → «Варианты оплаты» → «Новый вариант». Нужны два дополнительных варианта:
- «Картой курьеру»;
- «Картой на внешнем сервисе».
Коды указаны на этой же странице, в графе «Код API».
-
Создать статусы: «Справочники» → «Статусы». Нужны: подтверждён, готовится, приготовлен, у курьера, доставлен, отменён. Коды берутся из графы «Код API». Зачем: по ним Смартомато принимает статусы заказа из Frontpad, см. Статусы заказа и их смена.
Дополнительно, по задачам клиента
- Платная доставка. Завести во Frontpad блюдо для доставки и сообщить его id. В заказах с платной доставкой оно придёт отдельной позицией с ценой доставки.
- Сервисный сбор. Завести блюдо с ценой 1 ₽ и сообщить код, см. Итоги заказа и сервисный сбор.
- Дополнительные филиалы. Сообщить код API филиала. Зачем: заказ уходит на тот филиал, код которого передан в запросе.
- Модификаторы. Сообщить id модификаторов из Frontpad (см. «Типовые ошибки»).
- Бонусы Frontpad bonus. Запросить у Frontpad токен бонусной системы — он не всегда совпадает с токеном API. Зачем: гость получает единый бонусный счёт в ресторане и в доставке, см. Внешние системы лояльности.
Что передать в Смартомато
- Код из поля «Секрет» (токен API).
- Коды API типов оплаты.
- Коды API статусов заказа.
- При необходимости: id блюда доставки, код блюда сервисного сбора, коды филиалов, id модификаторов, токен Frontpad bonus.
- Если клиентская база во Frontpad уже есть — формат, в котором там записаны телефоны (см. «Типовые ошибки»).
Типовые ошибки и вопросы клиентов
- После импорта все блюда в одной папке. Frontpad не отдаёт по API категории. После первого импорта категории создают в Смартомато вручную и раскладывают по ним блюда. При следующих импортах новые блюда тоже попадают в общую папку, а старые обновляются.
- Модификаторы не подтянулись. Frontpad не отдаёт их по API. Модификаторы создают в Смартомато вручную и привязывают к блюдам по id из Frontpad. Заказ уходит во Frontpad вместе с модификаторами.
- Что приходит из Frontpad при импорте. Id блюд, название, цена, доступность. КБЖУ API не поддерживает.
- Комментарий обрезан. Frontpad принимает в комментарии только 100 символов.
- Какие данные об акциях уходят во Frontpad. Сумма использованных бонусов, общая скидка на заказ (процентные и суммовые акции складываются) и подарочное блюдо по нулевой цене в составе заказа. Название акции не передаётся.
- Статусы. Смартомато их только принимает из Frontpad.
- Постоянный гость распознан как новый. Маска телефона в заказе отличается от той, что в базе Frontpad. Смартомато может передавать номер в нужном формате, поэтому достаточно сообщить, в каком виде телефоны хранятся во Frontpad.