Аналитика и отчёты
Внешние программы: сайт, CRM, своя аналитика
Ключ доступа с правами и точками: другая программа создаёт заказы в АмиФло и берёт каталог, остатки, оплаты и показатели; журнал каждого запроса.
«Внешние программы» — чтобы другая программа работала с АмиФло сама: сайт создавал заказы, CRM видела клиентов и заказы, своя аналитика брала оплаты и показатели. Для этого программе выдают ключ доступа — с правами и точками, а о новых заказах и оплатах АмиФло может сообщать ей сама.
amoCRM и Битрикс24 подключаются проще — без ключа доступа и своей программы: заказы сами становятся сделками, а этапы и статусы идут в обе стороны. См. amoCRM и Битрикс24.
Коротко. Меню → «Настройки» → «Интеграции» → «Внешние программы» → «Выдать ключ»: название, что можно, какие точки → скопируйте ключ и передайте программисту вместе со страницей «Описание для программиста». Ключ показывается один раз.
Что можно ключу
| Право | Что программа сможет |
|---|---|
| Заказы — смотреть | Брать заказы: состав, получатель, срок, суммы, статус — и новые, и изменённые |
| Заказы — создавать | Создавать заказы — например, с сайта: цены берутся из каталога точки, как на кассе |
| Клиенты — смотреть | Брать клиентов: имя, телефон, почту, бонусы, покупки. Без этого права в заказах не видно телефона и имени заказчика |
| Каталог и цены — смотреть | Брать товары, рецепты, услуги, цены точек и штрихкоды |
| Остатки — смотреть | Брать остатки на точках |
| Показатели и оплаты — смотреть | Брать оплаты и показатели за даты — те же цифры, что в «Аналитике» |
Давайте только нужное: сайту для заказов хватит «Заказы — создавать» и «Каталог и цены — смотреть». Точки — все (и новые тоже) или только выбранные: другие программа не увидит.
Ключ
- Ключ показывается один раз — сразу после выдачи. Скопируйте его и передайте программисту. В АмиФло хранится только его отпечаток: посмотреть ключ потом нельзя ни вам, ни поддержке.
- Потеряли ключ или с программой расстались — «Отозвать»: она сразу перестанет получать данные. Вернуть отозванный ключ нельзя — только выдать новый.
- Заказ, созданный программой, появляется на кассах и в кабинете, а в истории заказа видно: «Из внешней программы — сайта или CRM».
Журнал
У каждого ключа — «Журнал»: что программа спрашивала, что ей ответили и сколько это заняло — последние 100 запросов, хранятся 90 дней. В списке ключей видно, когда ключом пользовались последний раз и сколько было запросов за сутки, с ошибками — красным. Если программа пишет, что не может войти, — в журнале будет причина.
Одна программа делает не больше 120 запросов в минуту — так она не замедлит кассы.
Уведомления о событиях
Чтобы программа не спрашивала АмиФло каждые пять минут «что нового?», АмиФло может сама сообщать ей о событиях: заказ создан, оплачен, собран или передан курьеру, доставлен, выдан, отменён, возврат, смена закрыта.
- «Добавить адрес»: название, адрес программы (его даёт программист — только https), о чём сообщать и по каким точкам. Имя, телефон и почту заказчика АмиФло передаёт, только если отметить «Передавать имя, телефон и почту заказчика».
- После сохранения один раз показывается секрет подписи — передайте его программисту: по нему программа проверяет, что сообщение пришло от АмиФло, а не от кого-то другого.
- «Проверить» — АмиФло сразу отправит пробное сообщение и покажет, что ответил адрес.
- Программа не ответила — АмиФло повторит через 1, 5, 30 минут, 2 и 12 часов. В «Журнале» — каждая отправка: доставлено или нет, сколько попыток, что ответил адрес; не дошедшее можно «Повторить».
- Если адрес сутки подряд не принимает сообщения (и неудач за это время не меньше 50), уведомления выключаются сами, чтобы не копиться, — на странице будет видно почему. Короткий перебой у программы их не выключает: недошедшее повторится само. Почините программу и нажмите «Включить».
- Отправлять во внутреннюю сеть серверов АмиФло нельзя — такой адрес не сохранится.
Кто выдаёт ключи
Тот, кому в кабинете можно всё в организации: владелец и администратор. Каждая выдача и отзыв — в «Журнале действий».
Выдать ключ, добавить адрес уведомлений или поменять его можно, только снова введя свой пароль: ключ и уведомления отдают данные магазина наружу, и за чужим открытым кабинетом (компьютер в магазине) их себе не выпустить. Если пароль вводили недавно (в последние три часа), АмиФло его не спросит.
Обновлено 29 октября 2026