Roboteka
Roboteka · Robôs · Taxa de câmbio das configurações do Bitrix24

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

  1. Um negócio em dólares americanos passa para a etapa «Fatura»
  2. O robô obtém a taxa do USD nas configurações de moedas do Bitrix24
  3. A taxa é gravada em um campo do negócio
  4. O valor na moeda base é calculado com uma fórmula: valor × taxa