Перейти к содержимому
Внешний API
Внешний API

Вебхуки и как отслеживать события сегодня

Исходящих вебхуков пока нет. Чтобы реагировать на события, регулярно опрашивайте эндпоинты чтения, не выходя за лимит 100 запросов в минуту.

Что есть сегодня

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

Отслеживание через опрос

Чтобы узнать, когда период был утверждён или выплачен, регулярно опрашивайте GET /payroll/periods и сравнивайте статус с тем, что вы сохранили в прошлый раз; та же логика подходит для новых и изменённых сотрудников (GET /employees) и для отметок времени (GET /time-entries с фильтром по дате).

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

Идемпотентность на вашей стороне

Храните идентификатор и статус каждого обработанного периода и сотрудника и обрабатывайте только изменившееся. Avos ничего не отправляет повторно и не гарантирует порядок между опросами, поэтому дедупликация лежит на системе, которая использует API.

Впервые в Avos?

Зарплата, учёт времени и расчётные листки для каждой страны, где вы нанимаете, в одном месте.

Начать бесплатный период

Не нашли нужное?

Связаться с поддержкой