API de Tipos de Cambio para Software Contable

Usa un tipo para cada hecho contable

Una factura, su pago y el cierre mensual ocurren en fechas distintas. No vuelvas a calcularlos todos con el tipo de hoy. Consulta el tipo de la fecha que marca tu política contable y guarda esa fecha en el asiento. Una factura de 2.400 EUR del 15 de julio debe conservar el mismo valor contabilizado en USD cuando alguien abra el informe en octubre.

El tipo actual sirve para un panel o una estimación que debe reflejar el mercado de ahora. Para operaciones anteriores, usa el endpoint histórico. Si la fecha cae en fin de semana o festivo, la respuesta usa la última referencia publicada y activa is_forward_filled. Tu aplicación puede aceptarla, marcarla o rechazarla según la política de la empresa.

Guarda la prueba junto al importe

Conserva la moneda y el importe originales. Guarda también la moneda de informe, el importe convertido, el tipo completo, la fecha solicitada, la hora de observación en data_updated_at, source e is_forward_filled. No guardes solo el resultado. Sin esos datos, finanzas no podrá explicar por qué un informe antiguo difiere de una calculadora abierta hoy.

Usa un tipo decimal adecuado para el dinero y redondea el importe según las unidades menores de la moneda. Conserva el tipo de cambio con toda su precisión. Si lo recortas antes de tiempo, una diferencia pequeña puede repetirse en miles de líneas y aparecer mucho después durante la conciliación.

Revaloriza los saldos abiertos al cierre

Las cuentas por cobrar, las cuentas por pagar y el efectivo en moneda extranjera suelen revalorizarse en la fecha de cierre. Consulta un solo juego de tipos para esa fecha y úsalo durante todo el proceso. Guarda la fecha o el identificador de la ejecución para poder reproducir el informe.

No sobrescribas el valor original de la operación. Registra el ajuste de revalorización por separado. Cuando se pague la factura, compara el valor contabilizado con el importe real de la liquidación. Así quedan separados el valor inicial, el ajuste del periodo y el resultado del pago.

El software aporta datos; la política elige el tipo contable

exchangerate.dev ofrece tipos indicativos para referencia, análisis e informes. No elige la política contable de tu empresa y no es una fuente oficial de registro. La empresa, el auditor, el contrato o la normativa local determinan qué fecha y qué fuente se pueden usar.

Escribe esa regla en el software: fecha de operación o de registro, tratamiento de festivos y fuente usada al cierre. Con la regla definida, la API puede aplicarla de forma constante y guardar los datos que harán falta en una revisión posterior.

Registrar una operación histórica en el servidor

Guarda la clave de la API en el servidor. Este ejemplo almacena el tipo de cambio y sus datos de origen junto al importe calculado.

import Decimal from 'decimal.js';

type HistoricalRates = {
  date: string;
  rates: Record<string, number>;
  source: 'ecb_daily' | 'fred_daily' | 'nbp_daily';
  data_updated_at: string;
  is_forward_filled: boolean;
  derived_symbols: string[];
};

const entry = {
  id: 'inv_1048',
  accountingDate: '2026-07-15',
  currency: 'EUR',
  amount: '2400.00',
} as const;

const response = await fetch(
  `https://api.exchangerate.dev/v1/${entry.accountingDate}/${entry.currency}?symbols=USD`,
  { headers: { Authorization: `Bearer ${process.env.EXR_API_KEY}` } },
);
if (!response.ok) throw new Error('Could not load the accounting-date FX rate');

const fx = (await response.json()) as HistoricalRates;
const rawRate = fx.rates.USD;
if (!Number.isFinite(rawRate)) throw new Error('Missing EUR/USD rate');

// Decimal arithmetic avoids binary floating-point errors in booked money.
const rate = new Decimal(String(rawRate));
const reportingAmount = new Decimal(entry.amount)
  .mul(rate)
  .toDecimalPlaces(2, Decimal.ROUND_HALF_UP)
  .toFixed(2);

await saveLedgerFx({
  entry_id: entry.id,
  original_currency: entry.currency,
  original_amount: entry.amount,
  reporting_currency: 'USD',
  reporting_amount: reportingAmount,
  fx_rate: rate.toString(),
  fx_requested_date: fx.date,
  fx_source: fx.source,
  fx_observed_at: fx.data_updated_at,
  fx_is_forward_filled: fx.is_forward_filled,
});

¿Quieres probar la API?

Empieza con la guía de inicio, revisa los campos de respuesta y consulta los precios cuando necesites cuota para tu cuenta.

El plan Free es para evaluación y uso interno no comercial. Basic y Pro permiten el uso comercial.