Currency rate from Bitrix24 settings
The robot returns the exchange rate stored in the currency settings of Bitrix24 (Alaio) itself (CRM → Settings → Currencies), right inside a business process or robot. It takes a currency code such as USD, EUR or CNY and returns the rate per one unit in the portal base currency, the base currency code and a found flag. Use it when the company works with its own rate rather than a bank rate.
The robot reads the portal currency list — the same one an administrator fills in under CRM → Settings → Currencies. The rate is returned per one unit of the currency, taking the nominal into account: if the settings say "100 JPY = 60", the robot returns 0.6. For the base currency the rate is 1. If the currency is not in the settings, the found flag is N. The robot always returns the current rate, because the portal keeps no rate history. Typical cases: converting a deal amount at the company internal rate with a formula in the workflow designer, and writing the rate to a deal or smart process field when an invoice is issued.
What gap it closes
Many companies price deals at their own exchange rate, not a bank rate. An administrator enters that rate in Bitrix24 (Alaio) under CRM → Settings → Currencies, but the workflow designer has no ready way to read it. This robot returns the rate from that section by currency code.
How to set it up
Put a three-letter code in "Currency code (USD, EUR, CNY...)". Case and spaces do not matter: " usd " is read as USD. The robot returns the rate per one unit in the portal base currency, the base currency code, and a found flag (Y or N). Typical cases:
- Rate in a deal at invoicing: add the robot to the Invoice stage and write the rate to a custom deal field.
- Amount in the base currency: multiply the deal amount by the rate with a formula in the designer.
The nominal is handled for you: if the settings say "100 JPY = 60", the robot returns 0.6. For the base currency the rate is 1.
If the robot returns an error
"Currency is not in the Bitrix24 currency settings": there is no such code under CRM → Settings → Currencies. The found flag is N and the base currency code is still filled in.
Access rights. The robot reads the currency settings on behalf of the administrator who installed Roboteka. Bitrix24 returns the currency list only to a user with read access to CRM settings, which a portal administrator has. If that account loses the right or is deactivated, access is denied and the robot ends with an error. The found flag then comes back empty, not N, so a "found = N" condition will not catch it.
The rate is always the current one: the portal keeps no rate history.
Works together with
- Round number (to N decimal places): bring the converted amount to two decimals.
- Customer LTV: the customer's total purchases in the base currency, at the same portal rates.
What input parameters does the robot accept?
| Parameter | Type | Required? | Default |
|---|---|---|---|
| Currency code (USD, EUR, CNY...) | string | yes |
What does the robot return?
| Parameter | Type |
|---|---|
| Rate per 1 unit in the base currency | string |
| Portal base currency | string |
| Currency found (Y/N) | string |
What errors can the robot return?
The robot writes these messages to the business process log when it cannot complete a step. The text tells you what to fix in the settings or the data.
- Error: please specify a currency code
- Currency "{currency}" is not in the Bitrix24 currency settings
- Error: no base currency found in the Bitrix24 currency settings
Scenario: the company internal rate in a deal
- A deal in US dollars moves to the Invoice stage
- The robot gets the USD rate from the Bitrix24 currency settings
- The rate is written to a deal field
- The amount in the base currency is calculated with a formula: amount × rate