Ключевая ставка ЦБ РФ
Робот возвращает официальную ключевую ставку ЦБ РФ на указанную дату в бизнес-процессах и роботах Битрикс24. Принимает дату в формате ДД.ММ.ГГГГ или ГГГГ-ММ-ДД, по умолчанию — сегодня; для выходных и праздников берёт последнюю действующую ставку. Возвращает ставку в процентах, дату записи ЦБ РФ и признак «найдено» для условий и расчётов в бизнес-процессе.
Робот запрашивает ключевую ставку Банка России через официальный сервис ЦБ РФ и возвращает её значение на нужную дату. Если на запрошенный день публикации нет (выходной или праздник), берётся последняя действующая запись не позднее этой даты — так же, как в деловой практике: ставка действует до следующего изменения. Типовые случаи применения: расчёт пени или неустойки по договору на дату платежа и автоматическая фиксация ставки в поле сделки при подготовке документов. Робот возвращает ставку в процентах, дату применимой записи ЦБ РФ и признак «найдено» (Y/N); значения можно подставлять в формулы следующих шагов бизнес-процесса, записывать в поля сделки или смарт-процесса и проверять в условиях.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Дата ставки (ДД.ММ.ГГГГ, по умолчанию сегодня) | string | — |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Ключевая ставка, % (например: 21.00) | string |
| Дата применимой записи ЦБ (ДД.ММ.ГГГГ) | string |
| Ставка найдена (Y/N) | string |
Какие ошибки может вернуть робот?
Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.
- Ошибка: некорректная дата «{date}» (ожидается ДД.ММ.ГГГГ или ГГГГ-ММ-ДД)
- Ошибка: не удалось получить ключевую ставку ЦБ РФ
- Ключевая ставка на дату {date} не найдена
Сценарий: расчёт пени по ключевой ставке
- Сделка переходит на стадию «Просрочка платежа»
- Робот получает ключевую ставку ЦБ РФ на дату платежа
- Ставка записывается в поле сделки
- Следующий шаг бизнес-процесса считает пени по формуле