Se a empresa trabalha com contratos em dólares, euros ou yuans, mas emite faturas em rublos, o gerente abre toda vez o site do Banco Central, copia a taxa e recalcula o valor manualmente — com erros de digitação e valores desatualizados. Os robôs da Roboteka buscam a taxa oficial do Banco Central da Rússia direto no processo de negócios: gravam a taxa da data desejada no campo do negócio, convertem o valor entre moedas e retornam a taxa básica para o cálculo de multas.

Onde a taxa de câmbio é necessária no negócio?

Cenários típicos: contrato em moeda estrangeira — fatura em rublos pela taxa do Banco Central na data do pagamento; lista de preços do fornecedor em yuans — custo de aquisição em rublos no campo do negócio; contrato com multa — percentual da taxa básica por dia de atraso. O requisito comum é um só: a taxa deve ser oficial, de uma data específica, e cair no campo do negócio automaticamente — assim o valor na fatura, na forma impressa e no relatório coincide, e, em caso de disputa com o cliente, há a data e a fonte da taxa. Sobre a inserção dos campos do negócio em formas impressas, veja o artigo sobre modelos de documentos.

Por que isso é difícil de forma nativa?

Nas configurações do CRM do Bitrix24 há uma lista de moedas e suas taxas, mas é um único valor geral que alguém precisa atualizar manualmente; a taxa «na data do negócio» não dá para obter dele. Não existe robô nativo «pegar a taxa do Banco Central na data». Integrações caseiras via webhooks e serviços de terceiros exigem um desenvolvedor e quebram quando o formato da resposta muda. Os robôs do catálogo são instalados como um aplicativo comum e aparecem na lista de ações do designer de processos de negócios: na entrada a moeda e a data, na saída valores prontos para gravação em campos e variáveis.

Como obter a taxa do Banco Central da Rússia na data?

«Taxa de câmbio do Banco Central da Rússia». Entrada: código da moeda — USD, EUR, CNY, GBP e outras da lista do Banco Central; data da taxa no formato DD.MM.AAAA ou AAAA-MM-DD, por padrão hoje. Saídas: a taxa em relação ao rublo, a taxa por uma unidade da moeda, o nominal, a data da taxa e o indicador «moeda encontrada» Y/N. Para fórmulas, use justamente a «taxa por 1 unidade»: o iene tem nominal 100, e a sua «taxa em relação ao rublo» é indicada por cem. O Banco Central define as taxas em dias úteis — num fim de semana retorna a taxa vigente. Vale verificar o indicador Y/N com uma condição: na indisponibilidade dos dados, o processo segue para o ramo com notificação, em vez de gravar um vazio no negócio. Onde gravar: o campo numérico do negócio «Taxa na data da fatura», e em seguida o valor é calculado pelo próximo robô.

Como converter o valor de uma moeda para outra?

«Conversão de moedas pela taxa do Banco Central» faz o cálculo inteiro. Entrada: o valor, de qual moeda (por padrão USD), para qual (por padrão RUB) e a data da taxa (por padrão hoje). A conversão passa pelo rublo segundo as taxas oficiais, por isso também funcionam taxas cruzadas: USD → EUR é calculado sem fórmulas manuais. Saídas: o resultado com duas casas decimais, a taxa utilizada e a data da taxa. Exemplo de processo: o negócio passa para a etapa «Emitir fatura» → o robô converte o valor do contrato de USD para rublos para hoje → o resultado é gravado no campo «Valor da fatura» e segue para a aprovação de fatura.

Como obter a taxa básica para multas?

«Taxa básica do Banco Central da Rússia» retorna a taxa oficial do Banco da Rússia. A entrada é uma só — a data, por padrão hoje. Se na data solicitada não houver publicação — fim de semana ou feriado —, o robô pega a última taxa vigente. Saídas: a taxa em percentual, a data do registro do Banco Central na qual ela foi definida e o indicador «encontrada» Y/N. Cálculo típico: multa por atraso como 1/300 da taxa básica por cada dia — a combinação «taxa básica → percentual do número → gravação no campo» resolve a tarefa sem tabelas e sem controle manual das mudanças da taxa. A data do registro na resposta mostra a partir de que dia o valor vigora — vale guardá-la junto ao cálculo das multas.

Conclusão

Taxa na data — «Taxa de câmbio do Banco Central da Rússia»; conversão do valor — «Conversão de moedas pela taxa do Banco Central»; taxa para multas — «Taxa básica do Banco Central da Rússia». As três retornam também a data em que o valor vigora — grave-a no negócio junto ao valor, para que o cálculo possa ser verificado. Os robôs financeiros estão reunidos na categoria finanças. Não há o de que você precisa — descreva a tarefa, fazemos o robô de graça.