DOKUMENTASI

Rate APIDocs

REST API untuk menarik kurs BI harian & kurs pajak mingguan ke sistem ERP Anda — internal EOS maupun integrasi terbuka.

Ringkasan

Dua endpoint baca-saja, format JSON, diautentikasi lewat API key. Data disinkronkan otomatis dari situs resmi Bank Indonesia dan Kementerian Keuangan — bukan API resmi pemerintah, jadi untuk kebutuhan legal/audit tetap verifikasi silang ke sumber asli (link disertakan di setiap response).

Minta API key ke admin EOS Teknologi (info@eosteknologi.com) — sertakan nama sistem/perusahaan Anda.

Autentikasi

Sertakan API key di header X-API-Key pada setiap request:

curl -H "X-API-Key: <api_key_anda>" \
  "https://eosteknologi.com/api/v1/rates/bi?currency=USD"

Key tidak valid/nonaktif/tanpa izin scope tertentu → 401 Unauthorized. Melebihi rate limit → 429 Too Many Requests (limit default 60/menit, bisa disesuaikan per klien).

GET /api/v1/rates/bi

Kurs harian BI (kurs jual/beli) + kurs referensi JISDOR (khusus USD/IDR).

Parameter	Wajib	Keterangan
currency	Tidak	Kode ISO 4217, mis. `USD`. Kosong = semua mata uang.
date	Tidak	Format `YYYY-MM-DD`. Default: tanggal terbaru yang tersedia.
from / to	Tidak	Rentang tanggal — mengesampingkan `date` kalau diisi.
limit	Tidak	Default 500, maksimum 5000.

{
  "success": true,
  "data": [{
    "currency_iso": "USD", "currency_name": "US DOLLAR",
    "rate_date": "2026-07-29", "unit": 1,
    "buy": 17997.56, "sell": 18178.44,
    "bi_avg_rate": 18088.00, "jisdor_rate": 18087.00
  }],
  "meta": {
    "source": "bi.go.id (Kurs Transaksi BI + JISDOR)",
    "count": 1, "latest_available_date": "2026-07-29",
    "stale": false,
    "disclaimer": "..."
  }
}

Pemetaan ke tabel ERP bergaya legacy (kalau sistem Anda memakai skema Rate_Cls/Curr_ID/Date_Start/Date_End/Buy/Sale/Rate): currency_iso → petakan ke Curr_ID via master mata uang Anda sendiri. rate_date → Date_Start = Date_End (berlaku 1 hari). buy/sell → Buy/Sale. bi_avg_rate atau jisdor_rate → Rate, pilih sesuai standar pelaporan internal Anda.

GET /api/v1/rates/pajak

Kurs pajak mingguan Kemenkeu — dasar pelunasan bea masuk, PPN, dan bea cukai. Berlaku Rabu–Selasa.

Parameter	Wajib	Keterangan
currency	Tidak	Kode ISO 4217. Kosong = semua mata uang.
date	Tidak	Cari periode KMK yang mencakup tanggal ini. Default: periode berjalan.
limit	Tidak	Default 100, maksimum 2000.

{
  "success": true,
  "data": [{
    "currency_iso": "JPY", "currency_name": "Yen Jepang",
    "date_start": "2026-07-29", "date_end": "2026-08-04",
    "rate": 137.4250, "change_amount": -1.2, "change_direction": "down",
    "kmk_number": "KMK Nomor 34/MK/EF.2/2026",
    "source_pdf_url": "https://fiskal.kemenkeu.go.id/files/kurs/file/..."
  }],
  "meta": { "source": "fiskal.kemenkeu.go.id (Kurs Pajak DJSEF)", "count": 1, "disclaimer": "..." }
}

Pemetaan ke tabel ERP legacy: date_start/date_end → Date_Start/Date_End (rentang 7 hari, Rabu→Selasa). buy/sale ERP → selalu null (Kemenkeu memang tidak mempublikasikan jual/beli terpisah). rate → Rate. kmk_number → Description.

Kalau situs sumber pemerintah berubah

BI dan Kemenkeu bisa mengubah struktur/tata letak situsnya sewaktu-waktu tanpa pemberitahuan. Kalau itu terjadi: scraper mendeteksi kegagalan parsing, tidak menimpa data lama, dan mengirim notifikasi ke admin EOS untuk penyesuaian. API akan menandai meta.stale: true kalau data tidak lagi diperbarui melebihi batas wajar.

Untuk integrator: kode Anda sebaiknya toleran terhadap field JSON baru yang mungkin ditambahkan di masa depan (mis. mata uang tambahan, atau kolom info baru) — jangan menolak response hanya karena ada field yang belum dikenal.

Minta akses

Hubungi admin EOS Teknologi untuk API key baru atau perubahan scope/rate limit: info@eosteknologi.com.

Minta Akses API