CBR exchange rate
The robot fetches the official Russian Central Bank (CBR) exchange rate for a given currency and date inside Bitrix24 business processes and robots. It accepts a currency code (USD, EUR, CNY and others) and an optional date, defaulting to today, and returns the rate to RUB, per-unit rate, nominal, rate date and a found flag.
The robot requests the official Central Bank of Russia exchange rate list for the specified date (today by default) and returns the rate for the requested currency. All currencies from the daily CBR reference are supported, including USD, EUR, CNY and GBP; for RUB the rate is 1. Typical cases: writing the current rate to a deal field when an invoice is issued, and fixing the contract-date rate in a smart process field. The robot returns the rate to the ruble, the per-unit rate that accounts for the nominal (the Japanese yen is quoted per 100 units), the nominal itself, the rate date and a found flag (Y/N). The outputs are available in the workflow designer and can be used in formulas, conditions and field updates in the next steps of the business process.
What input parameters does the robot accept?
| Parameter | Type | Required? | Default |
|---|---|---|---|
| Currency (USD, EUR, CNY, GBP...) | string | yes | |
| Rate date (DD.MM.YYYY, default today) | string | — |
What does the robot return?
| Parameter | Type |
|---|---|
| Rate to RUB (e.g. 91.4500) | string |
| Rate per 1 unit (rate / nominal) | string |
| Nominal (for JPY = 100, others = 1) | string |
| Rate date (DD.MM.YYYY) | string |
| Currency found (Y/N) | string |
Scenario: exchange rate into a deal at invoicing
- A deal moves to the Invoice stage
- The robot fetches the CBR USD rate for today
- The rate is written to a deal field and the amount is recalculated in rubles