API de Tipos de Cambio para Facturación Multidivisa

Fija el tipo en la fecha de la factura

Una factura debe conservar sus cifras después de enviarla. Si muestras un valor de referencia en una segunda moneda, consulta el tipo de la fecha de la factura y guarda el resultado. No recalcules un documento antiguo con el tipo de hoy. El cliente, soporte y finanzas deben ver el mismo número.

La fecha del tipo depende de tu regla de negocio. Algunos sistemas usan la fecha de emisión; otros, la fecha del servicio o de registro. La API devuelve la observación de la fecha solicitada. El contrato y la política de la empresa siguen decidiendo qué fecha se aplica.

Conserva el importe original y la conversión

Guarda currency y amount como datos principales. Añade reporting_currency, converted_amount, rate, la fecha solicitada, data_updated_at, source e is_forward_filled. Con esa estructura puedes volver a crear el PDF, responder al cliente o exportar la operación al sistema contable sin adivinar qué tipo se usó.

Redondea el importe convertido según las unidades menores de la moneda de destino. JPY suele usar cero decimales; muchas otras monedas usan dos. Guarda el tipo con toda su precisión y no redondees cada línea más de una vez. Si tu regla se aplica al total, calcula primero el subtotal de la factura.

Aplica una regla clara a las notas de crédito

La nota de crédito debe apuntar a la factura original e indicar qué regla de cambio usa. Si anula toda la factura, reutilizar el tipo original suele invertir bien el valor de informe. Si tu política exige el tipo de la fecha de la nota, guarda la nueva observación por separado.

No cambies el registro de la factura para introducir la corrección. Conserva el documento correctivo, su importe original, el importe convertido y la relación con la factura. Ese historial se concilia mejor que una sola línea que cambia cada vez que alguien edita el documento.

Separa el valor de la factura del resultado del pago

El tipo de la factura es indicativo y sirve para mostrar o informar. El banco o el procesador de pagos decide el importe liquidado, las comisiones y el tipo aplicado. Cuando llegue el pago, guarda su registro y compáralo con el valor de la factura. La diferencia se contabiliza según tu política.

Esta separación importa en cualquier factura internacional. exchangerate.dev ayuda al software a mostrar cifras y preparar informes coherentes, pero no garantiza lo que recibirá el vendedor ni lo que pagará el cliente. Para la liquidación, usa el registro del proveedor de pagos.

Crear una factura en JPY con un tipo fechado

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;
};

const invoice = {
  id: 'invoice_2207',
  issuedOn: '2026-07-15',
  currency: 'USD',
  total: '2400.00',
  displayCurrency: 'JPY',
} as const;

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

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

// JPY is a zero-decimal currency. Keep rate at full precision.
const rate = new Decimal(String(rawRate));
const displayTotal = new Decimal(invoice.total)
  .mul(rate)
  .toDecimalPlaces(0, Decimal.ROUND_HALF_UP)
  .toFixed(0);

await saveInvoiceFx({
  invoice_id: invoice.id,
  original_currency: invoice.currency,
  original_total: invoice.total,
  display_currency: invoice.displayCurrency,
  display_total: displayTotal,
  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.