Свой сайт и другие программы

Зачем это

У магазина свой сайт, бот или учётная программа — и хочется, чтобы заказы с сайта сами появлялись на кассе, а своя аналитика брала оплаты из АмиФло. Для этого программе выдают ключ доступа: в нём сказано, что ей можно и по каким точкам. А о новых заказах и оплатах АмиФло может сообщать ей сама.

Своего сайта нет — подойдёт онлайн-витрина АмиФло. amoCRM и Битрикс24 подключаются проще, без ключа и программиста, — см. урок amoCRM и Битрикс24.

Что понадобится

• Программист, который настроит вашу программу.
• Права владельца или администратора и свой пароль от кабинета.

Пошагово: выдать ключ

1. Откройте «Настройки» → «Интеграции» и нажмите на карточку «Внешние программы».
2. Нажмите «Выдать ключ».
3. Впишите «Название», например «Сайт магазина».
4. В «Что можно» отметьте только нужное — сайту для заказов хватит «Заказы — создавать» и «Каталог и цены — смотреть».
5. В «Точки» оставьте «Все точки — и новые тоже» или отметьте нужные: другие программа не увидит.
6. Нажмите «Выдать ключ» и, если АмиФло попросит, введите свой пароль.
7. Нажмите «Скопировать» — ключ показывается только один раз.
8. Передайте программисту ключ и страницу «Описание для программиста».

Что можно ключу

• «Заказы — смотреть» и «Заказы — создавать» — брать заказы и создавать их, например с сайта. Цены берутся из каталога точки, как на кассе.
• «Клиенты — смотреть» — имя, телефон, почта, бонусы и покупки.
• «Каталог и цены — смотреть», «Остатки — смотреть» — товары, рецепты, цены и остатки на точках.
• «Показатели и оплаты — смотреть» — те же цифры, что в «Аналитике».

Пошагово: уведомления о событиях

Чтобы программа не спрашивала каждые пять минут «что нового?», АмиФло сама сообщит ей, что заказ создан, оплачен, собран, передан курьеру, доставлен, выдан или отменён, что был возврат или закрыта смена.

1. В блоке «Уведомления о событиях» нажмите «Добавить адрес».
2. Впишите «Название» и «Адрес программы» — его даст программист.
3. В «О чём сообщать» отметьте нужные события и выберите точки.
4. Галочку «Передавать имя, телефон и почту заказчика» ставьте, только если программе это правда нужно.
5. Нажмите «Сохранить» и передайте программисту секрет подписи — он тоже показывается один раз.
6. Нажмите «Проверить» — АмиФло отправит пробное сообщение и покажет ответ.

Программа не ответила — АмиФло повторит сама. Если адрес не принимает сообщения сутки подряд, уведомления выключатся сами, а на странице будет видно почему. Почините программу и нажмите «Включить».

Как проверить, что всё получилось

Нажмите «Журнал» у ключа — там видно, что программа спрашивала и что ей ответили. Заказ с сайта появится на кассах и в кабинете, а в его истории будет «Из внешней программы — сайта или CRM».

Частые вопросы

Потеряли ключ — где его посмотреть?

Нигде: в АмиФло хранится только его отпечаток, ключ не увидит ни владелец, ни поддержка. Нажмите «Отозвать» и выдайте новый.

Расстались с подрядчиком — что сделать?

Отзовите его ключ: программа сразу перестанет получать данные. Вернуть отозванный ключ нельзя — только выдать новый.

Почему АмиФло спрашивает пароль?

Ключ и уведомления отдают данные магазина наружу. Пароль не даст выпустить их за чужим открытым кабинетом, например на компьютере в магазине. Если вы вводили пароль в последние три часа, его не спросят.

Кто может выдавать ключи?

Владелец и администратор. Каждая выдача и отзыв записываются в «Журнал действий».