Kesalahan Upload XML Coretax dan Cara Mencegahnya

Masalah yang sering terjadi adalah file XML gagal diunggah, data tidak terbaca, muncul error validasi, atau hasil impor tidak sesuai dengan kertas kerja internal. Dalam banyak kasus, penyebabnya bukan sekadar sistem sedang bermasalah, tetapi karena data sumber belum dibersihkan sebelum diubah menjadi XML.

DJP menjelaskan bahwa Coretax menggunakan skema impor berbeda dari sistem sebelumnya, yaitu menggunakan format file XML. Perubahan ini mencakup dokumen yang sebelumnya berbasis CSV atau PDF menjadi XML, termasuk bukti potong, faktur, dan beberapa lampiran SPT Badan. Karena itu, perusahaan perlu memahami cara kerja XML, jenis data yang divalidasi, dan kesalahan umum yang harus dicegah sebelum upload.

Apa itu XML Coretax?

XML adalah format data terstruktur yang digunakan agar sistem dapat membaca informasi secara konsisten. Dalam konteks Coretax, XML digunakan untuk mengimpor data tertentu ke sistem, misalnya data bukti potong, faktur, atau lampiran SPT Badan.

Berbeda dengan Excel yang mudah dibaca manusia, XML lebih banyak dibaca oleh sistem. Kesalahan kecil seperti format tanggal salah, NPWP tidak sesuai, kode objek pajak tidak valid, kolom wajib kosong, atau karakter tidak standar dapat membuat file gagal diproses.

Dalam halaman template XML, DJP menyebut penambahan validasi data seperti NPWP, NITKU, kode objek pajak, tarif pajak, serta elemen lain sesuai dokumen XML masing-masing. Untuk daftar penyusutan dan amortisasi fiskal, contoh validasi juga mencakup kode, jenis dan kelompok harta, serta metode penyusutan atau amortisasi.

Mengapa upload XML Coretax bisa gagal?

Upload XML Coretax bisa gagal karena dua kelompok masalah besar. Pertama, masalah teknis format file, seperti struktur XML tidak sesuai template, karakter tidak terbaca, format tanggal tidak konsisten, atau file dibuat dari template lama. Kedua, masalah substansi data, seperti NPWP lawan transaksi salah, NITKU tidak sesuai, kode objek pajak keliru, tarif tidak sesuai kode objek, atau total dalam XML tidak cocok dengan kertas kerja.

Kesalahan 1: menggunakan template XML yang tidak terbaru

Kesalahan paling umum adalah memakai template lama. Ini sering terjadi karena tim pajak menyimpan template dari periode sebelumnya, lalu menggunakannya kembali tanpa mengecek pembaruan.

DJP menampilkan daftar template XML dan converter Excel ke XML dengan tanggal pembaruan masing-masing. Untuk kategori SPT Tahunan Badan, halaman DJP mencantumkan lampiran seperti PPh dipotong atau dipungut pihak lain, daftar penyusutan dan amortisasi, daftar transaksi hubungan istimewa, daftar biaya promosi, daftar biaya entertainment, daftar piutang tak tertagih, daftar debitur kredit kurang lancar, dan pencatatan. Pada halaman tersebut, template dan converter SPT Tahunan Badan ditampilkan dengan pembaruan 8 April 2026.

• cek template terbaru dari DJP sebelum mulai mengisi;
• hindari memakai file tahun lalu tanpa validasi;
• simpan nama file dengan tanggal versi;
• gunakan satu sumber template di internal perusahaan;
• catat PIC yang bertanggung jawab memperbarui template.

Kesalahan 2: data NPWP tidak valid

NPWP adalah salah satu elemen yang divalidasi dalam Coretax. Jika NPWP lawan transaksi, vendor, pelanggan, pemotong, atau pihak terkait salah, file XML dapat gagal divalidasi atau datanya tidak terbaca dengan benar.

Masalah NPWP biasanya muncul karena digit kurang atau lebih, format masih memakai data lama, ada spasi tersembunyi, tanda baca tidak konsisten, data lawan transaksi belum diperbarui, atau NPWP tidak cocok dengan nama pihak.

• bersihkan kolom NPWP dari spasi dan karakter tambahan;
• gunakan format yang konsisten;
• cocokkan NPWP dengan database vendor, pelanggan, atau bukti potong;
• lakukan validasi sebelum data diubah menjadi XML;
• pisahkan data yang belum valid agar tidak ikut diunggah.

Kesalahan 3: NITKU kosong atau tidak sesuai

NITKU atau Nomor Identitas Tempat Kegiatan Usaha menjadi salah satu elemen penting dalam struktur dan validasi data Coretax. Masalah NITKU biasanya muncul pada perusahaan yang memiliki cabang, beberapa lokasi usaha, atau transaksi yang perlu dikaitkan dengan tempat kegiatan usaha tertentu.

• petakan transaksi berdasarkan lokasi atau cabang;
• pastikan NITKU sesuai transaksi;
• jangan mengisi NITKU manual tanpa kontrol;
• buat master data NITKU untuk finance dan tax;
• cek konsistensi NITKU di semua file impor.

Kesalahan 4: kode objek pajak tidak sesuai

Coretax juga memvalidasi kode objek pajak. Jika kode objek pajak salah, tarif yang digunakan bisa ikut salah, atau file gagal diproses. Kesalahan ini sering terjadi pada data bukti potong atau transaksi PPh karena tim hanya menyalin data dari file lama.

• jangan mengisi kode objek pajak berdasarkan kebiasaan;
• cocokkan jenis transaksi dengan kode objek yang benar;
• buat mapping internal transaksi dan kode objek pajak;
• lakukan review oleh tax reviewer sebelum upload;
• periksa ulang jika ada jenis transaksi baru.

Kesalahan 5: tarif pajak tidak sesuai kode objek

Tarif pajak sebaiknya tidak diisi sembarangan. Jika kode objek pajak dan tarif tidak konsisten, file XML bisa bermasalah atau menghasilkan angka yang tidak sesuai. Transaksi jasa, sewa, royalti, hadiah, transaksi final, atau transaksi tertentu dapat memiliki perlakuan berbeda.

• gunakan mapping kode objek dan tarif;
• hindari input manual berulang;
• kunci formula pada file kerja;
• buat kolom pengecekan tarif;
• lakukan sample review untuk transaksi bernilai besar.

Kesalahan 6: kolom wajib kosong

File XML biasanya memiliki elemen wajib. Jika data wajib kosong, file bisa gagal diproses. Kesalahan ini sering muncul ketika data Excel belum lengkap tetapi sudah langsung dikonversi menjadi XML.

Kolom yang sering bermasalah antara lain NPWP, NITKU, nama lawan transaksi, tanggal transaksi, nomor dokumen, kode objek pajak, nilai dasar pengenaan pajak, tarif, nilai pajak, jenis transaksi, kelompok harta untuk penyusutan, serta metode penyusutan atau amortisasi.

• buat kolom status lengkap atau belum lengkap;
• gunakan conditional formatting di Excel;
• jangan konversi data yang masih memiliki field kosong;
• pisahkan data yang belum lengkap;
• buat checklist sebelum export XML.

Kesalahan 7: format tanggal tidak konsisten

Format tanggal sering terlihat sederhana, tetapi bisa menjadi penyebab error. Sebagian data mungkin memakai format DD/MM/YYYY, sebagian MM/DD/YYYY, dan sebagian lain berupa teks. Masalah tanggal juga dapat membuat transaksi terbaca pada masa atau tahun pajak yang salah.

• gunakan satu format tanggal yang konsisten;
• hindari tanggal berbentuk teks;
• cek tanggal transaksi, tanggal faktur, tanggal bukti potong, dan tanggal dokumen;
• pastikan tahun pajak sudah benar;
• filter tanggal kosong atau tidak wajar.

Kesalahan 8: karakter khusus dan spasi tersembunyi

File XML sensitif terhadap karakter tertentu. Data dari copy-paste, sistem accounting, atau file vendor sering membawa karakter tersembunyi, seperti spasi berlebih, line break, simbol tidak standar, atau tanda kutip yang tidak sesuai.

• bersihkan data sebelum konversi;
• gunakan fungsi trim atau clean di spreadsheet;
• hindari karakter yang tidak diperlukan;
• cek nama pihak yang terlalu panjang;
• standarkan penulisan vendor dan pelanggan.

Kesalahan 9: nilai pajak tidak cocok dengan kertas kerja

Upload XML tidak boleh dipisahkan dari kertas kerja pajak. Jika total dalam XML tidak sama dengan rekap internal, perusahaan akan kesulitan mencocokkan hasil impor. Penyebabnya bisa berupa baris tertinggal, baris duplikat, nilai negatif yang tidak diperlakukan benar, pembulatan tidak konsisten, pembetulan tercampur dengan data normal, atau retur yang belum dipisahkan.

• buat rekap total sebelum konversi;
• cocokkan total per masa, per jenis pajak, dan per lawan transaksi;
• cek duplikasi nomor dokumen;
• pisahkan transaksi normal, pembetulan, retur, dan pembatalan;
• simpan kertas kerja final yang sama dengan XML yang diunggah.

Kesalahan 10: data faktur tidak sinkron dengan SPT

Untuk data PPN, risiko yang perlu diperhatikan adalah ketidaksinkronan antara daftar faktur dan pelaporan SPT. Dari sisi internal perusahaan, masalah ini sering berawal dari data yang belum direkonsiliasi.

• cocokkan faktur keluaran dengan penjualan;
• cocokkan faktur masukan dengan pembelian;
• pisahkan retur dan pembatalan;
• cek tanggal faktur dan masa pajak;
• rekonsiliasi DPP dan PPN sebelum upload;
• pastikan data XML sama dengan rekap PPN.

Kesalahan 11: lampiran SPT Badan tidak sesuai formulir induk

Untuk SPT Tahunan Badan, lampiran yang wajib diisi dapat bergantung pada jawaban di formulir induk. Jika perusahaan menjawab tanpa memetakan transaksi lebih dulu, lampiran yang diperlukan bisa terlewat. Misalnya ada transaksi hubungan istimewa, tetapi daftar transaksi afiliasi belum disiapkan. Atau ada penyusutan fiskal, tetapi daftar aset belum siap.

• jawab formulir induk berdasarkan data, bukan asumsi;
• petakan transaksi afiliasi sejak awal;
• siapkan daftar penyusutan dan amortisasi;
• cek biaya promosi, entertainment, dan piutang tak tertagih;
• cocokkan setiap jawaban Ya dengan lampiran pendukung.

Kesalahan 12: mengubah file XML secara manual

Ada kalanya tim mencoba membuka dan mengubah file XML secara manual. Ini berisiko jika dilakukan tanpa memahami struktur XML, karena satu tanda atau elemen yang berubah bisa membuat file tidak valid.

• lakukan koreksi di file sumber, bukan langsung di XML;
• generate ulang XML setelah data diperbaiki;
• simpan versi final dengan nama file yang jelas;
• jangan mengedit XML manual kecuali benar-benar memahami strukturnya;
• uji file sebelum upload final.

Kesalahan 13: tidak memiliki alur review sebelum upload

Banyak error XML sebenarnya bisa dicegah dengan alur review sederhana. Masalah muncul karena file langsung dibuat dan diunggah tanpa pemeriksaan berlapis.

1. Data dikumpulkan dari accounting, sales, procurement, HR, atau sistem pajak.
2. Data dibersihkan dari format yang tidak konsisten.
3. Data divalidasi terhadap master data.
4. Total dicocokkan dengan kertas kerja.
5. File dikonversi menjadi XML.
6. XML diuji atau diperiksa.
7. Hasil upload dicocokkan kembali dengan rekap internal.
8. File final dan bukti proses disimpan.

Sedang menyiapkan file XML untuk Coretax?Gunakan converter XML Coretax bantupajak.id sebagai pemeriksaan awal, lalu lakukan review data sebelum upload final.

Checklist sebelum upload XML Coretax

• template XML sudah versi terbaru;
• NPWP sudah valid dan konsisten;
• NITKU sudah sesuai;
• kode objek pajak sudah benar;
• tarif sesuai kode objek pajak;
• kolom wajib tidak kosong;
• format tanggal konsisten;
• tidak ada karakter aneh atau spasi tersembunyi;
• tidak ada baris duplikat;
• total XML cocok dengan kertas kerja;
• transaksi normal, pembetulan, retur, dan pembatalan sudah dipisahkan;
• data faktur cocok dengan rekap PPN;
• lampiran SPT Badan sesuai jawaban formulir induk;
• file sumber dan file XML final disimpan dengan rapi.

Cara mencegah error upload XML Coretax

1. Buat master data pajak

Master data membantu mencegah kesalahan berulang. Minimal perusahaan perlu memiliki master data vendor, pelanggan, NPWP, NITKU, alamat, jenis transaksi, kode objek pajak, tarif, status PKP, serta cabang atau tempat kegiatan usaha.

2. Standarkan template internal

Jangan biarkan setiap staf membuat format sendiri. Buat satu template internal yang mengikuti kebutuhan Coretax, lalu gunakan secara konsisten. Template internal sebaiknya memiliki kolom wajib, format tanggal standar, validasi NPWP, validasi NITKU, mapping kode objek pajak, kontrol total, kolom status data, dan kolom catatan error.

3. Lakukan rekonsiliasi sebelum konversi

Sebelum file diubah menjadi XML, cocokkan dulu dengan pembukuan dan kertas kerja. Contohnya faktur keluaran vs penjualan, faktur masukan vs pembelian, bukti potong vs pendapatan, payroll vs PPh 21, penyusutan fiskal vs daftar aset, transaksi afiliasi vs buku besar, serta biaya promosi atau entertainment vs daftar nominatif.

4. Pisahkan data bermasalah

Jangan memaksakan semua data masuk ke satu file jika sebagian belum valid. Pisahkan data menjadi siap upload, perlu perbaikan, menunggu dokumen, perlu konfirmasi pihak ketiga, dan tidak digunakan.

5. Simpan riwayat versi

Setiap file perlu punya penamaan yang jelas, misalnya SPT_Badan_Lampiran9_Penyusutan_2025_v2_reviewed_2026-03-12.xml. Dengan versioning, tim bisa tahu file mana yang terakhir direview dan file mana yang sudah dipakai untuk upload.

Kapan perusahaan perlu bantuan review XML?

Perusahaan sebaiknya mempertimbangkan review tambahan jika file XML berulang kali gagal upload, vendor atau pelanggan banyak, perusahaan memiliki banyak cabang atau NITKU, data PPN tidak cocok dengan pembukuan, bukti potong banyak dan belum direkap, ada transaksi afiliasi, ada lampiran SPT Badan seperti penyusutan, promosi, entertainment, atau piutang tak tertagih, deadline sudah dekat, atau tim internal belum familiar dengan format XML Coretax.

Dalam kondisi seperti ini, yang perlu direview bukan hanya file XML, tetapi juga data sumbernya.

Rujukan DJP

Untuk memastikan template dan alur teknis yang digunakan masih sesuai versi terbaru, cek halaman Template XML dan Converter Excel ke XML DJP, halaman Coretax DJP, dan panduan pembuatan XML SPT Tahunan PPh Badan.

Kesimpulan

Kesalahan upload XML Coretax biasanya terjadi karena data sumber belum siap, template tidak terbaru, NPWP atau NITKU tidak valid, kode objek pajak salah, tarif tidak sesuai, kolom wajib kosong, format tanggal tidak konsisten, atau total tidak cocok dengan kertas kerja.

Coretax membantu proses impor data, tetapi tidak menggantikan kebutuhan review pajak. XML hanya format. Kualitas hasil upload tetap bergantung pada kualitas data yang dimasukkan.

bantupajak.id membantu perusahaan menyiapkan dan mengecek data pajak, lampiran SPT Badan, bukti potong, faktur, rekonsiliasi, dan file XML agar lebih siap sebelum digunakan di Coretax.

Review XML Coretax

Butuh review data XML, faktur, bukti potong, atau lampiran SPT Badan sebelum upload Coretax?

Diskusikan dengan bantupajak.id