# Настройка модуля обмена Zenky Frontpad Assistant Расширение устанавливается в браузер Google Chrome и позволяет выполнять тонкую настройку связи между Frontpad и Zenky за счёт того, что оно работает напрямую с Frontpad из браузера оператора. Для работы расширения требуется: 1. Браузер Google Chrome; 2. API-токен Zenky с **полным доступом** (создаётся от **пользователя-владельца** магазина); 3. ID магазина Zenky. ## **1. Генерация API-токена** Для генерации API-токена необходимо сделать следующее: 1. Зайдите в [раздел персональных токенов](https://my.zenky.io/dashboard/profile/api/personal-tokens); 2. Введите название вашего нового токена (например, "Frontpad"); 3. В поле **«Разрешения»** выберите **«Полный доступ»**; 4. Нажмите на кнопку **«Создать токен»**. ![Форма создания персонального API-токена.](https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2Fx8IFkyZOhJ0bYKKnSGj8%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-01-22%20%D0%B2%2020.12.17.png?alt=media\&token=915024eb-2cd9-481c-9417-2d23ad8e8bc6) После создания токен будет отображен только один раз. Скопируйте его и сохраните в надёжном месте. ## **2. Получение ID магазина** Перейдите на страницу [API магазина](https://my.zenky.io/dashboard/api) и скопируйте ID магазина (или нажмите на кнопку рядом с ID). ![Раздел API с ID магазина.](https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FlZigxxzDhfPwD19spfBI%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-01-22%20%D0%B2%2020.14.41.png?alt=media\&token=f44aabb4-ee31-4c7e-b659-2258089bafa8) Убедитесь, что вы вошли в нужный магазин (выпадающее меню в верхней части бокового меню). ## **3. Установка расширения** * Запустите браузер Google Chrome * Перейдите на страницу расширения [Zenky Frontpad Assistant](https://chrome.google.com/webstore/detail/zenky-frontpad-assistant/oojjhojonnegfbcfoncjfigiddmablhg?hl=ru) * Нажмите кнопку “Установить” ![](https://lh4.googleusercontent.com/2qfySz7FJO7Ukbmb_69qoLeBbK4phfZUB2xc3pS26awpScZWOEyWuvYupzt1QHjSfkYU4jkqGITMeqPW7cDk5A52Vspi4lqUjGJRuFJTn19AeScZnnmipDjN5nsQ1DomXIeDCj63) ## **4. Настройка расширения** Перейдите на сайт , войдите в свой аккаунт администратора и нажмите на иконку расширения Zenky Frontpad Assistant на панели расширений браузера Google Chrome. ![](https://lh5.googleusercontent.com/EjaA97tvjefFOIl8pX_MM9ptnQFkiF82hTT7lbsYS1NXVFATR-gHJHRwUUF7WfEI_BPUVeHSd0zaKXiQ7vc9Au_CTXa93-5XyMOkPps2E6o42ZOBuIIxzkrYukP51U--KNSwZ4oU) Вы должны увидеть следующее окно: ![](https://lh6.googleusercontent.com/wKvU5ur_hHXd2hGVzZxHDgj5FWxAYuC2CBvznirbH53WCgVOR40R4lyRLkQVRUvWskIvSGHm6JRQGnSNCOSBbJ-0bodOJBLKI8IUsK1ln-o9tabtmmcOqyP1RsfKeIlnDFGwyIoT) Вставьте в соответствующие поля API-токен и ID магазина и нажмите “Начать работу”. Если всё прошло успешно, расширение теперь будет открываться с таким окном (пока вы не нажмёте кнопку “Выйти из аккаунта” или не удалите расширение):
![](https://lh4.googleusercontent.com/yBALiLeuLNXQuHbDO7HuRS7JkPMG00aOy0pxuCUqKwovUW3RXdE2aRrwhFzG8cgKOWrovOuMJC1rwYymaxDtMn-AVMzUzK_IHYNztSyDp58TJuDbdsedKzSRjSRvQ8g9nw5IzBYF) ### **4.1. Синхронизация точек продаж** **Внимание: синхронизацию точек продаж нужно делать только при первоначальной настройке или если у вас изменились точки продаж. Выполнять синхронизацию точек на каждом компьютере оператора не нужно. Синхронизация должна выполняться пользователем-администратором Frontpad с полным доступом ко всем разделам.** По умолчанию заказы с сайта или мобильного приложения отправляются во Frontpad с привязкой к Основной точке продаж. 1. Если у вас только одна точка продаж (Настройки -> Точки продаж во Фронтпаде), то синхронизацию складов делать **не нужно**; 2. Если точек продаж несколько, но вам достаточно того, что все заказы с сайта/приложения будут падать на основную точку → синхронизацию складов делать **необязательно**; 3. Если точек продаж несколько и вы хотите, чтобы заказы распределялись по точкам, в каждом городе магазина нужно отрисовать зоны доставки, привязав к каждой склад. Если адрес доставки будет попадать в одну из зон, заказ уйдёт на указанную точку продаж. Если адрес не попадёт ни в одну зону, заказ уйдёт на точку по умолчанию. Для работы этой функциональности синхронизация точек продаж обязательна. Чтобы получать заказы с привязкой к точкам продаж, необходимо сопоставить точки Frontpad со складами Zenky. * Нажмите на иконку расширения Zenky Frontpad Assistant в вашем браузере * Выберите раздел “Синхронизировать точки продаж”. * Далее нужно сопоставить точки продаж со складами Zenky. ![](https://lh4.googleusercontent.com/P32bWKts-lTB400qKIOfjsZFoDVvDcIT-QdgY7Q4WDXF-CtVJc6bkE_NmMx9MYRJojGNd8M8TkxNsu7cstOunnFvsZTM4PHwhoKNFXrC1Mw5m4lNM3qcqblr04jZ6ppieoNkj1GF) Обратите внимание, что название, указанное в заголовке, является названием склада Zenky. Названия, которые содержатся во всех выпадающих списках, являются названиями точек продаж Frontpad. Точку продаж Frontpad можно сопоставить только с одним складом Zenky. Если вы попытаетесь привязать одну точку к нескольким складам, расширение сообщит вам об этой ошибке. После того, как вы сопоставили склады и точки продаж, нажмите на кнопку “Синхронизировать” и не закрывайте окно расширения, пока не получите либо сообщение об успешной синхронизации, либо сообщение об ошибке. ![](https://lh4.googleusercontent.com/UjLSwh4-8clUl4ik6kM8mtnblpEw5o0l873-fF8eGvfnAlRwdEaq2Aj8oA4DsP1ZXdYM97T7d8--t_8f8aa6v0ozKe7z1t7tyjZTp5heQizUH6D3QaeSFUvIyzrUzQCDoU7Andur) Не обязательно сопоставлять все точки. Вы можете сопоставить только часть точек продаж. Синхронизацию точек продаж нужно выполнить только один раз (последующие синхронизации необходимо делать только в случае добавления или удаления точек продаж во Frontpad либо в случае добавления или удаления складов в Zenky). ### **4.2. Синхронизация статусов заказов** **Внимание: синхронизацию статусов заказов нужно делать только при первоначальной настройке или если у вас изменились статусы заказов. Выполнять синхронизацию статусов на каждом компьютере оператора не нужно. Синхронизация должна выполняться пользователем-администратором Frontpad с полным доступом ко всем разделам.** Для того, чтобы при изменении заказа в интерфейсе Frontpad заказ так же обновлялся в базе Zenky, необходимо сначала выполнить сопоставление статусов заказов. * Кликните на иконку расширения Zenky Frontpad Assistant * Выберите раздел “Синхронизировать статусы заказов”. * После загрузки данных вы сможете сопоставить статусы заказов Frontpad со статусами заказов Zenky. ![](https://lh3.googleusercontent.com/lz8_f7sbGB4IDYkv3tpess50uN0a2t84gd0S0zOgm1VKfTmEfpcuG4VyOYN2Ic18aYyV9fhmicZLBBxeC9Bxf9Mu8rVzNtzCVOjRyIaBhea3-cfofC1xztzoVC6UW2PQTEiiPQRS) Обратите внимание, что название, указанное в заголовке, является названием статуса заказа Zenky. Названия, которые содержатся во всех выпадающих списках, являются названиями статусов заказов Frontpad. Один статус заказов Frontpad можно сопоставить только с одним статусом заказов Zenky. Если вы попытаетесь сопоставить один статус с несколькими, расширение сообщит вам об этой ошибке. После того, как вы сопоставили статусы, нажмите на кнопку “Синхронизировать” и не закрывайте окно расширения, пока не получите либо сообщение об успешной синхронизации, либо сообщение об ошибке. Вы можете сопоставить часть статусов, а не обязательно все. Синхронизацию статусов нужно выполнить только один раз (последующие синхронизации необходимо делать только в случае добавления или удаления статусов заказов во Frontpad либо в случае добавления или удаления статусов заказов в Zenky). ### **4.3 Синхронизация заказов** **Внимание: ручная выгрузка заказов должна выполняться пользователем-администратором Frontpad с полным доступом ко всем разделам.** Вы можете в любое время выгрузить в Zenky заказы из Frontpad за последние 30 дней. Это позволит выполнить массовое изменение статусов устаревших заказов (если таковые будут найдены). Для выгрузки заказов в Zenky нажмите на иконку расширения Zenky Frontpad Assistant и в открывшемся окне выберите пункт “Синхронизировать заказы”. ![](https://lh4.googleusercontent.com/tq2HZNvTPpEeVdekP08NKxdk18IdkLWBkmpwtWth3iEUxmHQNLUlk2_R2X2v56zlLxMw7LWs1hUdFG1R0GfC28Y41wl7nPB88AB0c7MfS9crU6eYB-BnJbv95jgr64s8-VrqPdV6) После того, как вы нажмёте на кнопку “Синхронизировать”, начнётся выгрузка всех заказов за последние 30 дней. Не закрывайте это окно, пока выгрузка не завершится. ![](https://lh5.googleusercontent.com/YcGWcVoM0dCubXZhTSzzIyEyrtAF1D-c45N3ykgEry4Hq0J3b6Tc9wHfiFs_klSHZASDddOyLFmu6vuXVmLMYvvS4927xU9dVFutA8Nbk-6ijxO2YA-Dom2LtOU-p1RsZrGYcFKs) После окончания выгрузки вы можете закрыть окно расширения. ![](https://lh6.googleusercontent.com/QtMPpkZ4aV21vdZEnMKpU-vUJBCi_ipnjIXTfKhJTHFMcXjUdIuX9mB3R3PDhClbRLrAPjNiBF2P3QI4UdKoq-pYoLkan-VbmsY__xbLkP-btEkA3UZY2uXkT39o0pcIJMbgPFB1) ### **4.4 Синхронизация покупателей** **Внимание: синхронизация покупателей должна выполняться пользователем-администратором Frontpad с полным доступом ко всем разделам.** Внимание: эта функция доступна начиная с версии 1.1.1. Ваш браузер должен обновить расширение автоматически. В связи с тем, что 100% заказов проводится через Frontpad (заказы по телефону, заказы напрямую в заведениях), бонусные счета ваших покупателей в Zenky могут отличаться от счетов во Frontpad. Чтобы минимизировать такие расхождения, вы можете воспользоваться выгрузкой покупателей из Frontpad в Zenky. Для этого нажмите на иконку расширения Zenky Frontpad Assistant и в открывшемся окне выберите пункт “Синхронизировать клиентов”. ![](https://lh5.googleusercontent.com/TuItMnZd6Kfg_6GWHMGcnvzGdp27zeQVqFKC4rTJ0f984EMT0XKKrQ82TavFDf0mkUPa4-S7j1VMPxHGmHbe294Mmsc6XvXLapjYFECvWSWUit8RJ2Xmt7GKEwGkQPxKi6PerESr) После того, как вы нажмёте на кнопку “Синхронизировать”, начнётся выгрузка всех клиентов в Zenky. Не закрывайте это окно, пока выгрузка не завершится. ![](https://lh3.googleusercontent.com/QLAYGjikd2jtQIDFq72E0wm8VfVuhqSO5KfpXiXdnGEmcd2RMtkkzUc9VSlJFQytq5s1YLfNlJw49uUd8T_925MkmEHiGGQvZm-KPRTOZ2d-2nwC3-SZcP93VjaMxtE2QBdYmieQ) После окончания выгрузки вы можете закрыть окно расширения. ![](https://lh6.googleusercontent.com/1plcUa9bW6bwOwwCmjLI_yGVcd-RQUgasgi-Z6SLIo7XBaiZ_royZqE06GNX9Hn5N2x_H1OEZqLYjaLaunCBirhnXlKiCkoqIiI9D4sGRdkdkecqR7pj5EZy7ChZmcFW2nHC4UsW) #### 4.4.1 Автоматическая выгрузка покупателей В зависимости от базы ваших клиентов, время выгрузки может занять долгое время. Чтобы не делать полную выгрузку на постоянной основе, расширение позволяет выгружать покупателей по мере необходимости. Расширение отслеживает действия операторов и в моменты, когда оператор работает с профилем покупателя, расширение пытается получить баланс бонусного счета покупателя и отправить его в Zenky. Автоматическая отправка срабатывает в следующих случаях: 1. Покупатель был прикреплён к заказу с помощью поиска по номеру дисконтной карты; 2. Покупатель был прикреплён к заказу с помощью поиска по номеру телефона; 3. Оператор открыл окно статистики покупателя; 4. Оператор вручную начислил бонусы покупателю (в профиле покупателя); 5. Оператор вручную списал бонусы покупателя (в профиле покупателя). ## **5. Работа с расширением** После того, как вы закончили настройку расширения, его необходимо установить на все рабочие места вашей компании, из которых ведётся работа с Frontpad. API токен и ID магазина можно переиспользовать для всех сотрудников. **Повторную синхронизацию точек продаж и статусов выполнять НЕ нужно.** Кассиру не нужно выполнять никаких дополнительных действий при работе с Frontpad. Расширение будет само реагировать на изменение статуса заказа и отправлять необходимые данные в Zenky