A plataforma permite configurar e atualizar a taxa de câmbio utilizada na conversão de moedas. Essa atualização pode ser feita de duas formas:
- Manual, importando a cotação no painel;
- Automática, por meio de uma importação agendada, executada por um Trabalho Cron.
Acesso à configuração #
Para acessar o gerenciamento da taxa de câmbio:
- Acesse o menu lateral do painel
- Clique em Sistema
- Acesse Gerenciamento de Moedas
- Clique em Gerenciar Taxa de Câmbio
Atualização manual da Taxa de Câmbio #
Ao acessar a tela de Gerenciar Taxa de Câmbio, você poderá atualizar a cotação manualmente utilizando uma das APIs disponíveis.
Nesta tela:
- Selecione uma API de conversão disponível
- Clique em Importar
- Em seguida, clique em Salvar o Câmbio
Após salvar, a plataforma passará a utilizar os valores atualizados para conversão de moeda.
Como habilitar as APIs de conversão #
Para que as APIs apareçam na tela de importação, é necessário habilitá-las previamente.
Siga o caminho abaixo:
- Acesse o menu lateral do painel
- Clique em Sistema
- Selecione Configurações
- Acesse Configuração de Moeda
Nesta área, você poderá:
- Selecionar uma das APIs disponíveis (ex: FxRates API, $API, entre outras)
- Habilitar a API desejada
Após habilitar, ela ficará disponível para importação manual na tela de taxa de câmbio.
Importação agendada (automática) da Taxa de Câmbio #
Além da importação manual, a plataforma permite configurar uma atualização automática, que ocorrerá conforme uma programação definida.
Para configurar a importação agendada:
- Acesse Configuração de Importação Agendada
- Selecione o tipo de API desejada
- Defina o horário da atualização
- Defina a frequência:
- Diário
- Semanal
- Mensal
- Informe o e-mail que receberá alertas caso ocorra algum erro na conversão
O que é um Trabalho Cron? #
Um Trabalho Cron é uma tarefa automática do sistema, executada em segundo plano em horários programados.
Na plataforma, ele é responsável por executar rotinas automáticas, como:
- Atualização diária de taxa de câmbio
- Processos agendados de sincronização
- Execução de tarefas internas do sistema
Ou seja: quando a importação está configurada como “agendada”, o Trabalho Cron é quem executa essa atualização automaticamente.
Observação sobre testes em ambientes de desenvolvimento e homologação #
Em alguns ambientes, a importação agendada pode não funcionar corretamente para testes, pois os Trabalhos Cron podem estar desabilitados.
Nestes casos, a recomendação é:
- Realizar a importação de forma manual
- Ou executar o Trabalho Cron manualmente (quando disponível)
Executando o Trabalho Cron manualmente (para validação) #
Caso seja necessário validar a atualização como se fosse uma importação agendada:
- Acesse a área de Trabalhos Cron
- Localize o trabalho chamado CurrencyRatesUpdate
- Selecione a opção Executar agora
- Confirme a execução
Após isso, volte em Sistema > Gerenciamento de Moedas e valide se a taxa foi atualizada corretamente.
Como validar se a cotação foi aplicada na loja #
Após atualizar a taxa de câmbio, recomenda-se validar o impacto no valor final exibido na loja:
- Acesse um produto na vitrine
- Verifique o preço exibido
- Adicione o produto ao carrinho
- Confirme se os valores refletem corretamente a conversão configurada
Precisa de Ajuda? #
Se tiver dúvidas ou dificuldades para configurar ou atualizar a taxa de câmbio, entre em contato com nossa equipe através do Painel de Suporte. Estamos à disposição para ajudar!