API Kurs untuk Software Akuntansi

Gunakan satu kurs untuk setiap peristiwa akuntansi

Faktur, pembayaran, dan penutupan bulan terjadi pada tanggal yang berbeda. Jangan mengubah semuanya memakai kurs hari ini. Ambil kurs untuk tanggal kebijakan akuntansi Anda, lalu simpan tanggal tersebut pada entri jurnal. Faktur EUR 2.400 dari 15 Juli harus tetap memiliki nilai USD tercatat yang sama saat laporan dibuka lagi pada Oktober.

Kurs terkini cocok untuk dashboard atau perkiraan yang memang perlu mencerminkan pasar sekarang. Untuk transaksi lama, gunakan endpoint historis. Jika tanggalnya jatuh pada akhir pekan atau hari libur, respons membawa fixing terakhir dan menandainya dengan is_forward_filled. Aplikasi Anda dapat menerima, menandai, atau menolak nilai tersebut sesuai kebijakan perusahaan.

Simpan bukti di samping angka

Simpan mata uang dan jumlah asli. Setelah itu simpan mata uang pelaporan, jumlah hasil konversi, kurs penuh, tanggal yang diminta, waktu observasi pada data_updated_at, source, dan is_forward_filled. Jangan hanya menyimpan angka akhir. Tanpa detail ini, tim keuangan tidak dapat menjelaskan mengapa nilai pada laporan lama berbeda dari hasil kalkulator hari ini.

Gunakan desimal yang tepat untuk nilai uang dan bulatkan jumlah sesuai minor unit mata uang. Kurs tetap disimpan dengan presisi penuh. Memotong kurs terlalu cepat dapat membuat selisih kecil pada ribuan baris. Selisih itu biasanya baru terlihat saat rekonsiliasi, ketika perbaikannya sudah lebih sulit.

Revaluasi saldo terbuka pada akhir bulan

Piutang, utang, dan saldo kas dalam mata uang asing sering perlu dinilai kembali pada tanggal penutupan. Ambil satu set kurs untuk tanggal tersebut dan gunakan set yang sama pada seluruh proses. Simpan ID proses atau tanggal penutupan bersama setiap hasil agar laporan dapat dibuat ulang.

Jangan menimpa nilai transaksi awal. Simpan penyesuaian revaluasi sebagai catatan terpisah. Saat faktur akhirnya dibayar, bandingkan nilai tercatat dengan jumlah penyelesaian yang sebenarnya. Cara ini menjaga riwayat transaksi tetap jelas dan memisahkan nilai awal, penyesuaian periode, serta hasil pembayaran.

Software menyediakan data; kebijakan menentukan kurs tercatat

exchangerate.dev menyediakan kurs indikatif untuk referensi, analitik, dan pelaporan. API ini tidak memilih kebijakan akuntansi untuk bisnis Anda dan bukan sumber resmi pencatatan. Perusahaan, auditor, kontrak, atau aturan setempat menentukan tanggal dan sumber yang boleh digunakan.

Tulis aturan itu di software: tanggal transaksi atau tanggal posting, cara menangani hari libur, dan sumber yang dipakai untuk penutupan bulan. Setelah aturan jelas, API dapat menjalankannya secara konsisten dan menyimpan detail yang dibutuhkan untuk pemeriksaan berikutnya.

Mencatat transaksi historis di server

Simpan key API di server. Contoh ini menyimpan kurs dan detail sumber bersama nilai yang dihitung aplikasi.

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

Siap mencoba API?

Mulai dari quickstart, periksa field respons, lalu lihat harga saat Anda membutuhkan kuota akun.

Paket Free hanya untuk evaluasi dan penggunaan internal nonkomersial. Basic dan Pro mencakup penggunaan komersial.