Taxa de câmbio das configurações do Bitrix24
O robô retorna a taxa de câmbio registrada nas configurações de moedas do próprio Bitrix24 (Alaio) (CRM → Configurações → Moedas), diretamente em um processo de negócios ou robô. Recebe um código de moeda, como USD, EUR ou CNY, e retorna a taxa por uma unidade na moeda base do portal, o código da moeda base e um indicador de encontrado. Útil quando a empresa trabalha com sua própria taxa, e não com a taxa de um banco.
O robô lê a lista de moedas do portal — a mesma que o administrador preenche em CRM → Configurações → Moedas. A taxa é retornada por uma unidade da moeda, considerando o nominal: se as configurações indicam "100 JPY = 60", o robô retorna 0.6. Para a moeda base, a taxa é 1. Se a moeda não estiver nas configurações, o indicador de encontrado é N. O robô sempre retorna a taxa atual, pois o portal não guarda histórico de taxas. Casos típicos: converter o valor de um negócio pela taxa interna da empresa com uma fórmula no designer de processos e gravar a taxa em um campo do negócio ou do processo inteligente no momento da emissão da fatura.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Código da moeda (USD, EUR, CNY...) | string | sim |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Taxa por 1 unidade na moeda base | string |
| Moeda base do portal | string |
| Moeda encontrada (Y/N) | string |
Quais erros o robô pode retornar?
O robô grava essas mensagens no histórico do processo de negócios quando não consegue concluir uma etapa. O texto mostra o que corrigir nas configurações ou nos dados.
- Erro: informe o código da moeda
- A moeda "{currency}" não está nas configurações de moedas do Bitrix24
- Erro: nenhuma moeda base encontrada nas configurações de moedas do Bitrix24
Cenário: taxa interna da empresa no negócio
- Um negócio em dólares americanos passa para a etapa «Fatura»
- O robô obtém a taxa do USD nas configurações de moedas do Bitrix24
- A taxa é gravada em um campo do negócio
- O valor na moeda base é calculado com uma fórmula: valor × taxa