slen.ai
Почати

Задати стелю витрат на період

Створіть бюджет, виберіть його період і те, що він охоплює, дивіться, скільки від нього лишилося, змінюйте його й відправляйте в архів.

4 хв читання

Бюджет — це стеля того, що можна витратити за період. Кожен холд, який бере виклик моделі, перевіряється за бюджетами, які його охоплюють, і виклик, який не вміщується, відхиляється до звернення до провайдера. Ця сторінка — про сторінку бюджетів у консолі; сам холд пояснює стаття Як працює резервування бюджету.

Де розташовані бюджети

Відкрийте Бюджети. Сторінка показує бюджети проєкту, вибраного в шапці, і бюджети всієї організації. Рахунки клієнтів — в окремому розділі Клієнти бічного меню.

Бюджети читає кожна роль. Для створення, зміни й відправлення бюджету в архів потрібен management:write: у консолі він є в ролей Власник і Адміністратор — Організації, проєкти й ролі. Журнал аудиту записує кожну з цих змін.

Створити бюджет

1. Почніть новий бюджет

Натисніть Створити.

2. Назвіть його

Назва необов’язкова, і саме її показує список. Без назви список показує період і те, що охоплює бюджет.

3. Виберіть період

У полі Період виберіть Щодня, Щотижня, Щомісяця або За весь час. Бюджет на день, тиждень або місяць починається знову з наступним, і рядок каже коли. Бюджет За весь час знову не починається ніколи.

4. Виберіть, що він охоплює

У полі Застосовується до виберіть Цей проєкт або Уся організація. Другий варіант пропонується лише учасникові, якому доступний кожен проєкт. Бюджет усієї організації рахує витрати кожного її проєкту.

5. Задайте ліміт

Заповніть Ліміт — суму у валюті організації, не більше восьми знаків після крапки: 3000 або 12.50.

6. Звузьте його до однієї операції

Щоб обмежити лише виклики однієї операції, відкрийте Додатково і заповніть код операції. Залиште його порожнім для бюджету на всі виклики.

7. Створіть бюджет

Натисніть Створити бюджет. Наступний холд перевіряється вже за ним.

Період, те, що охоплює бюджет, і його код операції потім змінити не можна: витрати, враховані під ними, за зміною не підуть. Замість цього створіть інший бюджет.

Прочитати список

  • Смуга в рядку заповнюється тим, що ще доступно, поруч із лімітом.

  • Крапка в рядку зелена, поки використано менше 80 % ліміту, жовта — від 80 %, і червона, коли бюджет вичерпано. Сума холдів вважається використаною, як і списане.

  • На операцію і Одночасні резерви — бюджети ще двох видів, вони створюються через API. Перший відхиляє один холд, більший за свій ліміт, другий рахує холди, відкриті одночасно, — Як працює резервування бюджету.

Виклик, який не вміщується в бюджет, відхиляється з кодом budget_exceeded. Виклик, зроблений у флоу, перевіряється за тими самими бюджетами, тож відмова може закінчити виконання або повести його іншою гілкою.

Змінити, відправити в архів або відновити бюджет

Натисніть на рядок, щоб відкрити бюджет. Списано, У резерві і Доступно показують, як використовується ліміт у поточному періоді.

  • Змініть назву або Ліміт і натисніть Зберегти. Новий ліміт діє з наступного холду. Ліміт, нижчий за те, що період уже використав, приймається, і тоді жоден новий холд не вміщується, поки період не почнеться знову або ліміт не піднімуть.

  • В архів після підтвердження виключає бюджет із нових холдів. Уже взяті холди, як і раніше, розраховуються.

  • Бюджети в архіві згорнуто внизу списку. Відновити в рядку повертає бюджет.

Бюджет усієї організації змінює лише той, кому доступний кожен проєкт. API-ключ діє у своєму проєкті, тому така зміна через API відхиляється з кодом project_access_restricted.

Дізнатися заздалегідь, що бюджет закінчується

  • Slen надсилає подію вебхука budget.threshold_reached, коли холд доводить використання бюджету до 50 % і до 80 % його ліміту, і budget.exceeded, коли воно доходить до всього ліміту. Про кожен рівень повідомляється не більше одного разу за період, а холд, який проходить одразу два рівні, повідомляє лише про вищий. Бюджети видів На операцію і Одночасні резерви таких подій не надсилають.

  • Правило сповіщення типу Поріг бюджету стежить за часткою, яку ви вибираєте, — Сповіщення.

Що читати далі