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
| Endpoint | Descrição |
|---|---|
GET /moedas | Lista moedas disponíveis |
GET /moedas/:code/cotacao | Cotação atual de uma moeda |
POST /moedas/converter | Converte um valor entre moedas |
Tipos de campo relacionados
| Tipo | kind | Descriçã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 |