Cara kerja penagihan

Vibes to Bucks melacak biaya token AI Cursor Anda dan mengubahnya menjadi jam yang dapat ditagih dalam perangkat lunak pelacakan waktu Anda (Moneybird atau Harvest). Konversi ini didasarkan pada tarif per jam Anda — sehingga ekstensi ini menghitung berapa jam waktu Anda yang diwakili oleh biaya AI, dan membuat entri waktu untuk jumlah tersebut.

Untuk setiap pemetaan klien, Anda mengendalikan tiga hal:

Dapat ditagih atau tidak — centang Billable untuk menghasilkan entri waktu bagi klien. Hapus centang untuk melacak biaya secara internal tanpa menagih klien (berguna untuk proyek Anda sendiri atau biaya overhead yang diserap).
Cara menghitung waktu yang dapat ditagih — pilih antara Multiply AI cost (menambahkan margin Anda) atau Pass through at face value (hanya pemulihan biaya).
Tarif per jam — tarif klien yang digunakan untuk mengonversi biaya euro menjadi jam.

Multiply AI cost (direkomendasikan)

Gunakan ini ketika Anda ingin menagih pekerjaan yang dibantu AI dengan margin keuntungan. Anda menetapkan Cost to Profit Multiplier yang mengukur biaya AI mentah sebelum dikonversi menjadi jam. Ini menangkap nilai nyata yang Anda berikan — pembuatan prompt, peninjauan dan iterasi pada output, integrasi hasil, dan tanggung jawab atas produk akhir.

Perhitungan:

cost_eur = cost_usd × multiplier × fx_rate
hours    = cost_eur / hourly_rate

Contoh: €10 biaya AI, multiplier 5, tarif per jam €120/jam:

cost_eur = €10 × 5 = €50
hours    = €50 / €120 = 0.42h (≈ 25 minutes billed)

Multiplier 5 berarti setiap €1 pengeluaran AI menjadi €5 pendapatan yang dapat ditagih — margin yang mencerminkan keahlian dan waktu yang Anda investasikan di sekitar output AI. Mulailah dengan 5 dan sesuaikan untuk mencocokkan kesepakatan klien Anda.

Pass through at face value

Gunakan ini untuk penagihan pemulihan biaya — biaya AI mentah diteruskan ke klien dengan nilai nominal, dikonversi menjadi jam pada tarif per jam Anda. Tidak ada margin yang ditambahkan.

Perhitungan:

cost_eur = cost_usd × fx_rate
hours    = cost_eur / hourly_rate

Contoh: $12.00 biaya AI, kurs EUR/USD 0.92, tarif per jam €120/jam:

cost_eur = $12.00 × 0.92 = €11.04
hours    = €11.04 / €120  = 0.092h (≈ 6 minutes billed)

Tidak dapat ditagih

Hapus centang Billable pada pemetaan untuk melacak biaya AI untuk klien atau proyek tersebut tanpa menghasilkan entri waktu apa pun. Biaya muncul di dasbor Anda sehingga Anda dapat melihat pengeluaran, tetapi tidak ada yang disinkronkan ke Moneybird atau Harvest. Berguna untuk proyek internal, R&D, atau pekerjaan apa pun di mana Anda menyerap biaya AI sendiri.

Kurs pertukaran

Konversi USD→EUR menggunakan Frankfurter API, yang menyediakan kurs referensi Bank Sentral Eropa yang diterbitkan setiap hari sekitar pukul 16:00 CET. Kurs disimpan secara lokal untuk menghindari panggilan API yang berlebihan. Ketika API tidak dapat dijangkau, ekstensi menggunakan fallback_rate dari konfigurasi Anda.

Untuk pengisian ulang, ekstensi mengambil kurs historis untuk setiap hari tertentu, sehingga Anda mendapatkan konversi yang akurat bahkan untuk tanggal yang lalu.

Pembulatan dan minimum

Entri waktu disimpan sebagai stempel waktu mulai/akhir. Ekstensi mengonversi jam ke menit dan membulatkan ke menit terdekat, dengan minimum 1 menit:

0.001h → 1 menit (minimum)
0.092h → 6 menit
2.25h → 2 jam 15 menit

Semua entri dimulai pada pukul 09:00 UTC. Waktu akhir dihitung dari durasi yang dibulatkan. Stempel waktu ini adalah persyaratan API dan tidak mencerminkan jam kerja yang sebenarnya.

Satu entri per klien per proyek per hari

Mesin sinkronisasi menghasilkan paling banyak satu entri waktu per klien per proyek per hari. Jika lebih banyak acara tiba di hari yang sama, sinkronisasi berikutnya memperbarui entri yang ada daripada membuat yang baru. Ini menjaga lembar waktu Anda tetap rapi dan menghindari entri yang terfragmentasi.

Sinkronisasi idempoten

Sebelum membuat entri, ekstensi memeriksa apakah sudah ada entri untuk kombinasi (hari, kontak, proyek) yang sama:

Tidak ada entri yang ada → buat
Entri yang ada, total berubah → perbarui
Entri yang ada, total tidak berubah → lewati (tidak ada panggilan API)

Menjalankan “Sync Now” dua kali berturut-turut tidak menghasilkan duplikat.

Batas anggaran mingguan

Tetapkan batas biaya AI mingguan per pemetaan (Pro). Ekstensi melacak pengeluaran per repositori dan mengirimkan notifikasi Cursor pada tonggak: 25%, 50%, 75%, 85%, 95% sebagai peringatan informasi, meningkat menjadi peringatan pada 100% dan setiap 10% setelahnya. Setiap tonggak diaktifkan sekali per minggu per repositori.

Ini adalah batas lunak — tidak pernah memblokir penggunaan AI, hanya membuat Anda tetap terinformasi sebelum melebihi batas. Status anggaran juga terlihat di Usage Dashboard dengan pengukur yang menunjukkan pengeluaran vs. batas.