Mengekspor laporan royalti ke CSV

Unduh laporan royalti Anda sebagai file CSV untuk menganalisis pendapatan di spreadsheet, mempersiapkan musim pajak, atau menyimpan catatan keuangan terperinci.

Sebelum mulai

• Anda harus memiliki minimal satu laporan royalti yang sudah dibayar (laporan muncul setelah pencairan pertama Anda diproses)
• Aplikasi spreadsheet seperti Excel, Google Sheets, atau Numbers untuk membuka file CSV

---

Mengunduh laporan

1. Buka Royalti dari menu utama
2. Masuk ke tab Laporan
3. Cari periode laporan yang ingin Anda unduh
4. Klik tombol unduh (ikon panah) di samping laporan

Sistem akan membuat file CSV Anda. Untuk laporan berukuran kecil, unduhan langsung dimulai. Untuk laporan yang lebih besar, Anda akan melihat indikator progres selama file sedang disiapkan.

Tips

Gunakan menu Unduh Per Tahun di bagian atas untuk mengekspor seluruh laporan satu tahun penuh dalam satu file. Ini berguna untuk persiapan pajak tahunan.

---

Apa yang terjadi selama ekspor

Unduhan instan

Untuk sebagian besar laporan, CSV langsung siap. Sebuah dialog akan muncul dengan tombol Unduh untuk menyimpan file.

Pemrosesan laporan besar

Untuk laporan dengan banyak baris data, sistem memproses ekspor di latar belakang:

1. Dialog “Menyiapkan Ekspor” muncul
2. Sistem membuat file (proses ini mungkin memerlukan beberapa saat)
3. Setelah siap, tombol Unduh muncul
4. Klik Unduh untuk menyimpan file

Catatan

Hanya satu ekspor yang dapat berjalan dalam satu waktu. Jika Anda melihat pesan “Ekspor Sedang Berlangsung”, tunggu hingga ekspor saat ini selesai sebelum memulai ekspor lain.

Yang Anda terima

Unduhan berupa arsip ZIP yang berisi:

• file CSV (atau beberapa file CSV, jika ekspornya cukup besar sehingga perlu dipecah)
• COLUMNS.txt, referensi teks biasa yang menjelaskan setiap kolom dalam file tersebut

Setiap ekspor yang sudah dibuat disimpan selama 24 jam. Jika Anda meminta ekspor lagi dengan akun, rentang tanggal, dan pengelompokan yang sama dalam kurun 24 jam tersebut, sistem mengirimkan file yang sudah jadi, bukan membuatnya ulang.

---

Referensi kolom CSV

Setiap baris dalam CSV mewakili satu baris data dari laporan royalti Anda. Berikut arti masing-masing kolom.

Kolom dasar

Kolom	Keterangan	Contoh
pay_period	Periode pembayaran dalam format YYYYMM	202601
label	Nama label Anda	Midnight Records
retailer	Nama platform	Spotify
territory	Kode negara atau wilayah	US, GB, DE
type	Jenis transaksi	Stream, Download, UGC
cat	Nomor katalog	MR-2026-001
upc	Barcode UPC rilis	840123456789
release	Judul rilis	Neon Skyline
isrc	Kode ISRC trek (pengenal unik untuk setiap trek)	USRC12400001
track_artist	Nama artis	Luna Rivera
track_title	Judul trek	Golden Hour
track_version	Informasi versi atau remix (kosong jika tidak ada)	Acoustic Version
track_count	Jumlah trek	1
purchase_qty	Jumlah pemutaran atau penjualan	4523
dsp_transaction_date	Tanggal transaksi dari platform	2026-01-15
dsp_statement_id	ID referensi laporan	SP-2026-0001

Kolom pendapatan

Contoh di bawah menampilkan baris streaming standar dan baris UGC.

Kolom	Keterangan	Baris streaming	Baris UGC
gross_usd	Pendapatan kotor baris tersebut dalam USD, sebelum biaya LabelGrid	18.09000000	4.63000000

Kolom biaya LabelGrid

Kolom	Keterangan	Baris streaming	Baris UGC
platform_fee_rate	Tarif biaya platform sesuai paket Anda	0.05000000 (5%)	0.00000000
platform_fee_usd	Jumlah biaya platform (ditampilkan sebagai nilai negatif)	-0.90450000	0.00000000
ugc_fee_rate	Tarif biaya UGC / Content ID sesuai paket Anda	0.00000000	0.20000000 (20%)
ugc_fee_usd	Jumlah biaya UGC / Content ID (ditampilkan sebagai nilai negatif)	0.00000000	-0.92600000
total_labelgrid_fee	Kedua biaya tersebut dijumlahkan (nilai negatif)	-0.90450000	-0.92600000
net_revenue_usd	Pendapatan akhir Anda setelah seluruh biaya LabelGrid	17.18550000	3.70400000

Catatan

Tarif ditentukan per laporan. Semua baris yang termasuk dalam satu laporan yang sama membawa platform_fee_rate dan ugc_fee_rate yang sama.

---

Spesifikasi teknis

Jika Anda mengintegrasikan CSV ini ke perangkat lunak akuntansi atau sistem keuangan, berikut detail format yang persis.

Properti	Nilai
Encoding	UTF-8
Pemisah	Koma (,)
Karakter kutip	Tanda kutip ganda (")
Karakter escape	Garis miring terbalik (\)
Akhir baris	LF (\n)
Baris header	Selalu ada sebagai baris pertama
Total kolom	23 (urutan tetap, lihat referensi kolom di atas)
Format unduhan	Arsip ZIP yang berisi file CSV beserta file referensi COLUMNS.txt

Tipe data dan presisi

Kelompok kolom	Tipe	Presisi
pay_period	String	YYYYMM (6 karakter)
dsp_transaction_date	String	YYYY-MM-DD (10 karakter)
purchase_qty	Integer	Bilangan bulat
gross_usd, *_fee_usd, net_revenue_usd	Desimal	Hingga 8 angka di belakang koma
platform_fee_rate, ugc_fee_rate	Desimal	Hingga 8 angka di belakang koma (mis. 0.05000000 = 5%)
Semua kolom lainnya	String	Panjang bervariasi

Tips

Jumlah biaya selalu bernilai negatif (karena merupakan potongan). Kolom tarif berupa pecahan desimal, bukan persentase. Kalikan dengan 100 untuk mendapatkan persentasenya.

Rumus pendapatan

total_labelgrid_fee = platform_fee_usd + ugc_fee_usd
net_revenue_usd     = gross_usd + total_labelgrid_fee

Catatan untuk pemrosesan otomatis

• Kolom kosong: track_version dan cat bisa kosong (dua koma berurutan)
• Pengutipan teks: Kolom yang berisi koma atau tanda kutip diapit dengan tanda kutip ganda. Tanda kutip ganda di dalam nilai kolom dihapus selama ekspor.
• Ekspor besar: Ekspor di atas 150 MB dipecah menjadi beberapa file CSV (masing-masing dengan baris header tersendiri) dan dikirim sebagai arsip ZIP
• Pengurutan: Baris diurutkan berdasarkan pay_period menurun, lalu berdasarkan dsp_transaction_date menurun

---

Memahami biaya dalam CSV

Cara perhitungan pendapatan bersih

net_revenue_usd = gross_usd + total_labelgrid_fee

Karena biaya bernilai negatif, biaya akan mengurangi jumlah kotor Anda. Berikut satu baris streaming lengkap dari file contoh, dengan biaya platform 5%:

	Jumlah
Pendapatan kotor (gross_usd)	$18.09000000
Biaya platform (5%)	-$0.90450000
Biaya UGC / Content ID	$0.00000000
Pendapatan bersih	$17.18550000

Biaya platform dan biaya UGC adalah kategori terpisah yang tidak dihitung bertingkat

Bagian inilah yang paling penting Anda pahami dengan benar jika Anda menyusun pembukuan berdasarkan ekspor ini.

• Kedua tarif dikenakan pada jumlah yang sama.
• Tidak ada biaya yang dihitung dari sisa setelah biaya lainnya dipotong. Biaya UGC tidak dikenakan pada sisa setelah biaya platform, dan biaya platform tidak dikenakan pada sisa setelah biaya UGC.
• Kedua besarannya dijumlahkan: total_labelgrid_fee = platform_fee_usd + ugc_fee_usd.

Contoh perhitungan untuk baris pada laporan yang memuat kedua jenis biaya, dengan tarif platform 5% dan tarif UGC 20% atas jumlah yang sama sebesar $100.00000000:

Perhitungan	Benar (dijumlahkan)	Keliru (bertingkat)
Biaya platform	-$5.00000000	-$5.00000000
Biaya UGC / Content ID	-$20.00000000 (20% dari $100.00)	-$19.00000000 (20% dari $95.00)
Total biaya LabelGrid	-$25.00000000	-$24.00000000

Kolom kirilah yang akan cocok ketika Anda merekonsiliasi. Tarif platform 5% dan tarif UGC 20% menghasilkan potongan 25% dari jumlah tersebut, bukan 24% yang muncul bila satu tarif dikenakan pada sisa setelah tarif lainnya.

Kapan masing-masing biaya muncul

Biaya UGC / Content ID berlaku untuk pendapatan User-Generated Content dari platform seperti YouTube, TikTok, dan SoundCloud. Pada baris dari platform streaming standar seperti Spotify atau Apple Music, ugc_fee_rate dan ugc_fee_usd menampilkan 0.00.

Karena tarif ditentukan per laporan, pada sebagian besar baris hanya satu tarif yang terisi dan satunya bernilai nol: satu laporan biasanya hanya memuat satu jenis pendapatan. Jika sebuah laporan memang memuat kedua jenisnya, kedua tarif akan muncul di setiap baris laporan itu, dan aturan penjumlahan di atas yang berlaku. Jangan berasumsi bahwa selalu tepat satu dari kedua kolom tarif yang tidak nol; baca kolom mana pun yang terisi lalu jumlahkan.

Pemberitahuan tentang pencantuman biaya

Biaya dicantumkan dalam ekspor CSV mulai dari periode laporan Oktober 2024. Laporan sebelumnya menampilkan data pendapatan tanpa kolom rincian biaya.

Biaya pada API laporan

Jika Anda membaca laporan melalui API publik alih-alih ekspor CSV, endpoint laporan mengembalikan rincian yang sama dalam tiga bidang tambahan:

Bidang	Deskripsi
platform_fee_usd	Biaya distribusi standar yang dikenakan pada laporan tersebut
ugc_fee_usd	Biaya UGC / Content ID yang dikenakan pada laporan tersebut
labelgrid_ugc_rate	Tarif biaya UGC / Content ID yang berlaku saat laporan dibuat

Kedua jumlah tersebut bernilai negatif dan totalnya sama dengan labelgrid_fee. Biaya dihitung dari seluruh jumlah yang diselesaikan pada laporan tersebut, termasuk saldo apa pun yang dibawa dari periode sebelumnya, sehingga mengalikan tarif hanya dengan pendapatan periode itu tidak selalu sama dengan jumlahnya. Gunakan jumlah tersebut sebagai angka yang berlaku.

Ketiga bidang bernilai null pada laporan yang dibuat sebelum rincian ini mulai dicatat. Perlakukan null sebagai “tidak dirinci”, bukan nol, dan tetap gunakan labelgrid_fee sebagai total biaya dalam semua kasus.

---

Mengunduh contoh CSV

Ingin melihat tampilan hasil ekspor sebelum mengunduh milik Anda sendiri? Unduh file contoh kami:

Unduh contoh CSV

Contoh ini berisi data placeholder yang menampilkan baris data umum dari berbagai platform dan teritori, dalam susunan 23 kolom yang dijelaskan di atas. Setiap barisnya memenuhi rumus dalam artikel ini, jadi Anda bisa memakainya sebagai data uji saat membangun parser.

---

Tips bekerja dengan data

Membuka di Google Sheets

1. Buka Google Sheets
2. Klik File → Impor
3. Unggah file CSV Anda
4. Pilih “Koma” sebagai pemisah
5. Klik Impor data

Membuka di Excel

1. Buka Excel
2. Klik File → Buka dan pilih file CSV
3. Excel akan otomatis mendeteksi format yang dipisahkan koma

Ide analisis umum

• Filter berdasarkan retailer untuk melihat pendapatan per platform
• Tabel pivot berdasarkan teritori untuk menemukan pasar terkuat Anda
• Jumlahkan net_revenue_usd untuk memverifikasi total jumlah laporan Anda
• Urutkan berdasarkan purchase_qty untuk menemukan trek yang paling banyak diputar
• Kelompokkan berdasarkan rilis untuk membandingkan performa album

---

Pemecahan masalah

Ekspor terlalu lama

Laporan besar dengan banyak baris data mungkin perlu waktu lebih lama untuk dibuat. Sistem melakukan polling hingga 5 menit. Jika ekspor mengalami waktu habis:

1. Tutup dialog
2. Tunggu beberapa menit
3. Coba unduh lagi

Galat “Ekspor Sedang Berlangsung”

Hanya satu ekspor yang dapat diproses dalam satu waktu. Tunggu hingga ekspor yang sedang berjalan selesai, lalu coba lagi.

CSV menampilkan karakter yang tidak terduga

Pastikan aplikasi spreadsheet Anda diatur ke encoding UTF-8 saat mengimpor. Ini memastikan nama artis dan judul trek yang mengandung karakter khusus ditampilkan dengan benar.

Kolom biaya tidak ada

Kolom biaya (platform_fee_rate, platform_fee_usd, dan sebagainya) hanya tersedia untuk periode laporan sejak Oktober 2024 dan setelahnya. Periode sebelumnya menampilkan data pendapatan tanpa rincian biaya.

---

Panduan terkait

• Memahami Laporan Royalti - Cara membaca data royalti Anda
• Jadwal Pembayaran - Kapan royalti dibayarkan
• Informasi Pajak - Menggunakan data ekspor untuk persiapan pajak

---

Butuh bantuan dengan ekspor Anda? Hubungi tim dukungan kami.