Коннектор
Poster: ИИ-агент для учёта и отчётов общепита
Сервиса нет в каталоге. Подключение по описанию API.
Poster — облачная касса и учёт для общепита: терминал, склад, финансы и аналитика в одном кабинете. Карточка нужна операционному руководителю, который готовит документы к проверке и держит регламенты заведения.
Что такое агент
Агент — программа, которая проходит дело до конца: сама смотрит данные в ваших сервисах и возвращает готовый результат, а не инструкцию.
Три признака: работает в ваших сервисах, доводит до результата, работает без вас. Пакет собирается по расписанию закрытия смены, расхождения называются сами.
Чат-бот подскажет, где лежит отчёт. Агент принесёт собранный пакет и список того, что в нём не сходится.
Что такое коннектор
Коннектор описывает доступ: где взять ключ, что видно, как проверить связь. В Poster два пути. Для своего заведения — токен «Личная интеграция» в разделе Доступ, Интеграции. Для внешнего продукта — приложение на dev.joinposter.com, дальше OAuth2: код со страницы авторизации меняется на access_token.
Это не плагин и не доработка кассы. Пароль сотрудника агенту не нужен: он работает с токеном и правами приложения.
Что это за сервис
Poster — облачная POS-система для ресторанов, кафе, баров, кофеен, пекарен, столовых и сетей. Терминал идёт на планшете и работает без интернета; бэк-офис открывается в браузере.
Разделы кабинета: аналитика, меню, склад, финансы, маркетинг. API повторяет разделы: menu — блюда и техкарты, storage — поставки, списания, остатки, finance — кассовые смены и налоги, dash — статистика по чекам. Ошибки приходят кодами: истёк токен, мало прав, широкий диапазон дат.
Что делает агент с Poster
### Пакет документов к проверке
Агент собирает то, что обычно ищут руками: закрытые кассовые смены за период, поставки с поставщиками, списания с причинами, остатки на складе и итоги по налогам. Каждый документ привязан к дате и точке, всё лежит в одном пакете с описью. Если смена не закрыта или поставка не оприходована, это попадает в список нестыковок.
### Внутренние регламенты и база знаний офиса
Из меню и склада агент достаёт то, на чём держатся регламенты: техкарты, нормы закладки, цеха, категории, поставщиков и причины списаний. Он сводит это в справочник заведения и обновляет, когда меняются техкарты или появляется поставщик. Устаревшие записи помечает: сотрудник видит, где регламент разошёлся с фактом, а не ищет это сам по кабинету.
### Контроль поручений руководителя
Поручение превращается в проверяемое условие: закрыть смену, разобрать списание, свести остатки. Агент сам смотрит данные Poster и отмечает, выполнено условие или нет, а если нет — что мешает и с какого числа висит. Руководитель получает список поручений с состоянием, а не переписку в мессенджере, и видит, где дело стоит больше недели.
Что остаётся человеку
Учётную политику, регламенты и решения по расхождениям принимает сотрудник. Он же подписывает документы перед проверкой.
Как подключить
Возьмите токен «Личная интеграция» в разделе Доступ, Интеграции или заведите приложение на dev.joinposter.com и пройдите OAuth2. Логин заведения участвует в адресе запросов, его нужно знать заранее. Проверка связи — запрос списка точек.
Чего агент не делает
Не закрывает смену и не проводит деньги за сотрудника. Не правит техкарты без подтверждения. Не считает налоги вместо бухгалтерии.
Вопросы
Что такое агент, если коротко? Программа, которая доводит дело до результата: забирает смены, поставки и списания из кассы, собирает пакет и называет расхождения. Чат-бот вернул бы только текст.
Что такое коннектор? Описание подключения: где взять токен, какие разделы API доступны, как проверить связь. Агент работает с выданным доступом.
Подключение
- Шаг 1: для своего заведения возьмите токен «Личная интеграция» в разделе Доступ, Интеграции кабинета Poster.
- Шаг 2: для внешнего продукта заведите приложение на dev.joinposter.com и запомните application_id и application_secret — они нужны для OAuth2.
- Шаг 3: приложение получает код на странице авторизации и меняет его на access_token запросом к api/v2/auth/access_token; проверка связи — запрос списка точек или категорий меню с этим токеном.