Настройка модуля обмена Zenky Frontpad Assistant

Расширение устанавливается в браузер Google Chrome и позволяет выполнять тонкую настройку связи между Frontpad и Zenky за счёт того, что оно работает напрямую с Frontpad из браузера оператора.

Для работы расширения требуется:

1. Браузер Google Chrome;

2. API-токен Zenky с полным доступом (создаётся от пользователя-владельца магазина);

3. ID магазина Zenky.

1. Генерация API-токена

Для генерации API-токена необходимо сделать следующее:

1. Зайдите в раздел персональных токенов;

2. Введите название вашего нового токена (например, "Frontpad");

3. В поле «Разрешения» выберите «Полный доступ»;

4. Нажмите на кнопку «Создать токен».

После создания токен будет отображен только один раз. Скопируйте его и сохраните в надёжном месте.

2. Получение ID магазина

Перейдите на страницу API магазина и скопируйте ID магазина (или нажмите на кнопку рядом с ID).

Убедитесь, что вы вошли в нужный магазин (выпадающее меню в верхней части бокового меню).

3. Установка расширения

• Запустите браузер Google Chrome

• Перейдите на страницу расширения Zenky Frontpad Assistant

• Нажмите кнопку “Установить”

4. Настройка расширения

Перейдите на сайт https://app.frontpad.ru, войдите в свой аккаунт администратора и нажмите на иконку расширения Zenky Frontpad Assistant на панели расширений браузера Google Chrome.

Вы должны увидеть следующее окно:

Вставьте в соответствующие поля API-токен и ID магазина и нажмите “Начать работу”.

Если всё прошло успешно, расширение теперь будет открываться с таким окном (пока вы не нажмёте кнопку “Выйти из аккаунта” или не удалите расширение):

4.1. Синхронизация точек продаж

Внимание: синхронизацию точек продаж нужно делать только при первоначальной настройке или если у вас изменились точки продаж. Выполнять синхронизацию точек на каждом компьютере оператора не нужно. Синхронизация должна выполняться пользователем-администратором Frontpad с полным доступом ко всем разделам.

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

1. Если у вас только одна точка продаж (Настройки -> Точки продаж во Фронтпаде), то синхронизацию складов делать не нужно;

2. Если точек продаж несколько, но вам достаточно того, что все заказы с сайта/приложения будут падать на основную точку → синхронизацию складов делать необязательно;

3. Если точек продаж несколько и вы хотите, чтобы заказы распределялись по точкам, в каждом городе магазина нужно отрисовать зоны доставки, привязав к каждой склад. Если адрес доставки будет попадать в одну из зон, заказ уйдёт на указанную точку продаж. Если адрес не попадёт ни в одну зону, заказ уйдёт на точку по умолчанию. Для работы этой функциональности синхронизация точек продаж обязательна.

Чтобы получать заказы с привязкой к точкам продаж, необходимо сопоставить точки Frontpad со складами Zenky.

• Нажмите на иконку расширения Zenky Frontpad Assistant в вашем браузере

• Выберите раздел “Синхронизировать точки продаж”.

• Далее нужно сопоставить точки продаж со складами Zenky.

Обратите внимание, что название, указанное в заголовке, является названием склада Zenky. Названия, которые содержатся во всех выпадающих списках, являются названиями точек продаж Frontpad.

Точку продаж Frontpad можно сопоставить только с одним складом Zenky. Если вы попытаетесь привязать одну точку к нескольким складам, расширение сообщит вам об этой ошибке.

После того, как вы сопоставили склады и точки продаж, нажмите на кнопку “Синхронизировать” и не закрывайте окно расширения, пока не получите либо сообщение об успешной синхронизации, либо сообщение об ошибке.

Не обязательно сопоставлять все точки. Вы можете сопоставить только часть точек продаж.

Синхронизацию точек продаж нужно выполнить только один раз (последующие синхронизации необходимо делать только в случае добавления или удаления точек продаж во Frontpad либо в случае добавления или удаления складов в Zenky).

4.2. Синхронизация статусов заказов

Внимание: синхронизацию статусов заказов нужно делать только при первоначальной настройке или если у вас изменились статусы заказов. Выполнять синхронизацию статусов на каждом компьютере оператора не нужно. Синхронизация должна выполняться пользователем-администратором Frontpad с полным доступом ко всем разделам.

Для того, чтобы при изменении заказа в интерфейсе Frontpad заказ так же обновлялся в базе Zenky, необходимо сначала выполнить сопоставление статусов заказов.

• Кликните на иконку расширения Zenky Frontpad Assistant

• Выберите раздел “Синхронизировать статусы заказов”.

• После загрузки данных вы сможете сопоставить статусы заказов Frontpad со статусами заказов Zenky.

Обратите внимание, что название, указанное в заголовке, является названием статуса заказа Zenky. Названия, которые содержатся во всех выпадающих списках, являются названиями статусов заказов Frontpad.

Один статус заказов Frontpad можно сопоставить только с одним статусом заказов Zenky. Если вы попытаетесь сопоставить один статус с несколькими, расширение сообщит вам об этой ошибке.

После того, как вы сопоставили статусы, нажмите на кнопку “Синхронизировать” и не закрывайте окно расширения, пока не получите либо сообщение об успешной синхронизации, либо сообщение об ошибке.

Вы можете сопоставить часть статусов, а не обязательно все.

Синхронизацию статусов нужно выполнить только один раз (последующие синхронизации необходимо делать только в случае добавления или удаления статусов заказов во Frontpad либо в случае добавления или удаления статусов заказов в Zenky).

4.3 Синхронизация заказов

Внимание: ручная выгрузка заказов должна выполняться пользователем-администратором Frontpad с полным доступом ко всем разделам.

Вы можете в любое время выгрузить в Zenky заказы из Frontpad за последние 30 дней. Это позволит выполнить массовое изменение статусов устаревших заказов (если таковые будут найдены).

Для выгрузки заказов в Zenky нажмите на иконку расширения Zenky Frontpad Assistant и в открывшемся окне выберите пункт “Синхронизировать заказы”.

После того, как вы нажмёте на кнопку “Синхронизировать”, начнётся выгрузка всех заказов за последние 30 дней. Не закрывайте это окно, пока выгрузка не завершится.

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

4.4 Синхронизация покупателей

Внимание: синхронизация покупателей должна выполняться пользователем-администратором Frontpad с полным доступом ко всем разделам.

Внимание: эта функция доступна начиная с версии 1.1.1. Ваш браузер должен обновить расширение автоматически.

В связи с тем, что 100% заказов проводится через Frontpad (заказы по телефону, заказы напрямую в заведениях), бонусные счета ваших покупателей в Zenky могут отличаться от счетов во Frontpad.

Чтобы минимизировать такие расхождения, вы можете воспользоваться выгрузкой покупателей из Frontpad в Zenky. Для этого нажмите на иконку расширения Zenky Frontpad Assistant и в открывшемся окне выберите пункт “Синхронизировать клиентов”.

После того, как вы нажмёте на кнопку “Синхронизировать”, начнётся выгрузка всех клиентов в Zenky. Не закрывайте это окно, пока выгрузка не завершится.

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

4.4.1 Автоматическая выгрузка покупателей

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

Расширение отслеживает действия операторов и в моменты, когда оператор работает с профилем покупателя, расширение пытается получить баланс бонусного счета покупателя и отправить его в Zenky.

Автоматическая отправка срабатывает в следующих случаях:

1. Покупатель был прикреплён к заказу с помощью поиска по номеру дисконтной карты;

2. Покупатель был прикреплён к заказу с помощью поиска по номеру телефона;

3. Оператор открыл окно статистики покупателя;

4. Оператор вручную начислил бонусы покупателю (в профиле покупателя);

5. Оператор вручную списал бонусы покупателя (в профиле покупателя).

5. Работа с расширением

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

API токен и ID магазина можно переиспользовать для всех сотрудников. Повторную синхронизацию точек продаж и статусов выполнять НЕ нужно.

Кассиру не нужно выполнять никаких дополнительных действий при работе с Frontpad.

Расширение будет само реагировать на изменение статуса заказа и отправлять необходимые данные в Zenky