Resources / Blog /

Pajak

Pengertian CSV, Fungsi, dan Perannya dalam Upload Data Pajak di Coretax

ereg.pajak.go.id

CSV (Comma-Separated Values) adalah format file teks sederhana yang menyimpan data tabular seperti spreadsheet dengan setiap kolom dipisahkan oleh tanda koma dan setiap baris mewakili satu baris data. Format ini banyak digunakan untuk pertukaran data antar sistem karena ukurannya ringan, dapat dibuka di Excel maupun aplikasi teks biasa, dan mudah diproses secara terprogram. Dalam konteks perpajakan Indonesia, CSV berperan penting sebagai tahap perantara sebelum data diunggah secara massal (bulk upload) ke sistem Coretax DJP.

Quick Answer: Apa Itu CSV?

CSV adalah singkatan dari Comma-Separated Values, yaitu format file dengan ekstensi .csv yang menyimpan data dalam bentuk teks polos (plain text), di mana setiap nilai dipisahkan koma dan setiap baris baru mewakili satu record/baris data. Berbeda dari file Excel (.xlsx) yang menyimpan format, rumus, dan styling, file CSV hanya berisi data mentah — sehingga ukurannya jauh lebih kecil dan kompatibel dengan hampir semua sistem, termasuk sistem perpajakan digital seperti Coretax DJP.

Struktur dan Contoh Format File CSV

Berikut contoh struktur data sederhana dalam format CSV:

NPWP,Nama,Penghasilan_Bruto,PPh_21
0123456789000000,Budi Santoso,10000000,150000
0987654321000000,Siti Aminah,8000000,80000

Baris pertama umumnya berisi header (nama kolom), diikuti baris-baris data. Setiap nilai dipisahkan koma, dan file dapat dibuka langsung di Microsoft Excel, Google Sheets, atau teks editor biasa.

Format CSV untuk Upload Data Pajak di Coretax

Penting dipahami: sejak implementasi penuh Coretax DJP per 1 Januari 2025, sistem tidak lagi menerima upload file CSV secara langsung untuk sebagian besar dokumen pajak seperti bukti potong, faktur pajak, dan lampiran SPT Badan. Coretax mewajibkan format XML sebagai standar file impor tapi proses pembuatannya tetap dimulai dari template Excel/CSV yang kemudian dikonversi ke XML.

Alur Konversi Data untuk Upload ke Coretax
Tahap Format Keterangan
1. Input data Template Excel/CSV resmi DJP Diunduh dari situs pajak.go.id atau portal Coretax, diisi sesuai kolom yang tersedia (NPWP, nama, jenis pajak, nominal, dll)
2. Validasi kode Sheet referensi dalam template Kode jenis pajak, kode objek pajak, dan tarif harus sesuai daftar referensi resmi agar tidak ditolak sistem
3. Konversi CSV/Excel → XML Menggunakan fitur Export/Developer di Excel atau converter resmi DJP
4. Upload File XML Diunggah melalui menu Impor Data di Coretax
5. Download hasil (opsional) CSV Fitur Bulk Process memungkinkan unduh data bukti potong/faktur dalam format CSV untuk keperluan arsip/rekonsiliasi

Catatan penting: meskipun proses akhir upload mewajibkan XML, DJP tetap menyediakan opsi download CSV by period melalui fitur Bulk Process di menu e-Bupot dan e-Faktur, sehingga CSV masih relevan untuk mengunduh dan merekonsiliasi data yang sudah tersimpan di Coretax, bukan lagi sebagai format upload utama seperti pada sistem e-SPT/e-Faktur lama.

Cara Menyiapkan File CSV/Excel yang Valid untuk Bulk Upload

  1. Unduh template resmi dari situs pajak.go.id atau portal Coretax sesuai jenis dokumen (bukti potong PPh 21, faktur pajak, dll) — jangan gunakan template dari sumber tidak resmi karena struktur kolom bisa berbeda.
  2. Isi data sesuai format yang ditentukan — misalnya NPWP 16 digit dalam format teks (bukan angka, agar tidak kehilangan digit nol di depan), tanggal dalam format dd/mm/yyyy, dan nominal hanya berupa angka tanpa titik/koma pemisah ribuan.
  3. Gunakan kode referensi yang benar — kode objek pajak (misalnya 21-100-01 untuk pegawai tetap), kode jenis transaksi faktur, dan kode barang/jasa harus mengacu pada sheet referensi dalam template.
  4. Hapus baris/kolom kosong yang tidak terisi agar tidak memicu error validasi saat konversi ke XML.
  5. Konversi ke XML menggunakan fitur Developer > Export di Excel, atau converter resmi DJP, sebelum diunggah ke Coretax.
  6. Unggah melalui menu Impor Data di Coretax dan periksa notifikasi hasil validasi — jika muncul pesan error, perbaiki baris data yang ditandai lalu unggah ulang.

Apakah Format CSV Coretax Berbeda dari Sistem Lama?

Ya, cukup signifikan. Pada sistem e-SPT dan e-Faktur Desktop sebelumnya, banyak dokumen pajak (bukti potong, faktur) diunggah langsung dalam format CSV tanpa perlu konversi tambahan. Sejak migrasi ke Coretax, seluruh dokumen tersebut kini wajib berformat XML. Perubahan ini bertujuan agar validasi dan audit data lebih terstruktur, meski di sisi pengguna prosesnya menjadi satu langkah lebih panjang (isi Excel/CSV → konversi XML → upload).

Kegunaan CSV di Luar Konteks Pajak

Di luar administrasi perpajakan, format CSV banyak dipakai untuk:

  • Ekspor-impor data antar software — misalnya memindahkan data pelanggan dari satu sistem CRM ke sistem lain.
  • Backup data spreadsheet — karena ukuran file kecil dan tidak bergantung pada versi aplikasi tertentu.
  • Analisis data — banyak tools analitik dan bahasa pemrograman (Python, R) membaca CSV secara native sebagai format input standar.
  • Bulk import data bisnis — seperti mengunggah daftar produk, invoice massal, atau data karyawan ke sistem HR/akuntansi.

FAQ Seputar CSV

Bagaimana format CSV yang benar untuk upload data pajak?

Gunakan template Excel/CSV resmi dari pajak.go.id, isi NPWP dalam format teks 16 digit, tanggal format dd/mm/yyyy, dan nominal angka murni tanpa pemisah ribuan. File kemudian harus dikonversi ke XML sebelum diunggah ke Coretax.

Apakah format CSV Coretax berbeda dari sistem lama?

Ya. Sistem lama (e-SPT, e-Faktur Desktop) menerima upload langsung dalam format CSV, sedangkan Coretax mewajibkan format XML — sehingga file CSV/Excel perlu dikonversi terlebih dahulu sebelum diunggah.

Apakah CSV masih digunakan sama sekali di Coretax?

Masih, terutama untuk mengunduh data yang sudah tersimpan (misalnya melalui fitur Bulk Process “Download CSV by period” pada e-Bupot dan e-Faktur) dan sebagai tahap awal input data sebelum dikonversi ke XML untuk diunggah.

Apa perbedaan file CSV dan Excel (.xlsx)?

CSV hanya menyimpan data mentah dalam format teks tanpa rumus atau styling, sehingga ukurannya lebih kecil dan kompatibel luas. Excel (.xlsx) menyimpan format, rumus, dan beberapa sheet sekaligus, namun ukurannya lebih besar dan spesifik untuk aplikasi spreadsheet.

Kenapa NPWP di file CSV sering hilang angka nolnya?

Karena Excel secara default membaca kolom angka panjang sebagai angka, bukan teks, sehingga digit nol di depan (misalnya pada NPWP) bisa hilang. Solusinya, format kolom NPWP sebagai teks sebelum mengisi data.

Menyiapkan file CSV/Excel yang valid dan mengonversinya ke XML untuk setiap jenis dokumen pajak cukup memakan waktu jika dilakukan manual berulang kali. OnlinePajak menyediakan fitur bulk-upload data pajak dan invoice yang otomatis diproses sesuai format yang dibutuhkan Coretax, sehingga tim finance tidak perlu lagi mengelola konversi file secara manual.

Share

Related articles

Pajak
Pajak
Pajak