Kurs BI Harian untuk Reimbursement Perjalanan Dinas

Klaim reimbursement USD/EUR sering menimbulkan debat: karyawan pakai kurs Google, finance pakai kurs bank, hasilnya selisih. Kebijakan yang adil: kurs resmi BI pada tanggal nota (atau tanggal transaksi kartu).

Pola Implementasi

1. Karyawan upload nota + tanggal transaksi.
2. Sistem panggil /kurs-bi/history untuk tanggal tersebut.
3. IDR = nominal asing × sell_rate (atau mid — sesuai kebijakan HR).

async function convertExpense(amountUsd, transactionDate) {
  const url = new URL('https://use.apiindonesia.id/api/v1/kurs-bi/history');
  url.searchParams.set('currency', 'USD');
  url.searchParams.set('start', transactionDate);
  url.searchParams.set('end', transactionDate);
  const res = await fetch(url, {
    headers: { 'x-api-key': process.env.API_INDONESIA_KEY },
  });
  const { data } = await res.json();
  const rate = data[0]?.sell_rate ?? data[0]?.mid_rate;
  return { idr: amountUsd * rate, rate, date: transactionDate };
}

curl "https://use.apiindonesia.id/api/v1/kurs-bi/latest?currencies=USD" \
  -H "x-api-key: aip_live_xxx"

Gunakan /latest untuk estimasi real-time di form; /history untuk finalisasi setelah tanggal pasti.

Manfaat HR/Finance

• Satu sumber kurs yang bisa dijelaskan ke auditor.
• Mengurangi tiket "kurs salah" di helpdesk.
• Atribusi BI memenuhi ekspektasi data pemerintah.

FAQ

Weekend/tanggal merah? Gunakan kurs hari kerja terakhir yang tersedia di history — dokumentasikan kebijakan ini di SOP.

Mulai Sekarang

Dapatkan API key gratis di dashboard.apiindonesia.id/register dan pelajari parameter lengkap di docs.apiindonesia.id.