Pular para o conteúdo principal

Módulo Multi-moedas

Cotações em tempo real do Banco Central do Brasil com conversão automática. Ative em central.config.js:

modules: { currencies: true }

Como usar nos models

Declare os campos com os tipos dedicados:

src/models/Cotacao.js
const { defineModel, fields } = require("@oondemand/oon-core-back");

defineModel({
name: "Cotacao",
schema: {
descricao: fields.string({ required: true, label: "Descrição" }),
valor: fields.currency({ required: true, label: "Valor original" }),
moeda: fields.currencyCode({ label: "Moeda" }), // ex.: "USD"
valorEmBRL: fields.currencyConverted({ base: "BRL", label: "Valor em BRL" }),
},
});

Quando um registro é salvo, o Core consulta a cotação vigente e preenche valorEmBRL automaticamente via trigger interno do módulo.

Endpoints gerados

EndpointDescrição
GET /moedasLista moedas disponíveis
GET /moedas/:code/cotacaoCotação atual de uma moeda
POST /moedas/converterConverte um valor entre moedas

Tipos de campo relacionados

TipokindDescrição
fields.currency"currency"Valor monetário (Number ≥ 0)
fields.currencyCode"currencyCode"Código ISO 4217 (3 letras)
fields.currencyConverted"currencyConverted"Valor convertido para moeda base