Error Import Faktur Coretax: Penyebab dan Cara Mengatasinya
Sebagian besar error import faktur Coretax berasal dari tiga hal: data identitas pembeli yang tidak valid, format isian template yang tidak sesuai, dan converter atau template versi lama. Kabar baiknya, hampir semuanya bisa dicegah dengan pengecekan sebelum upload.
Sejak Coretax berlaku, faktur dalam jumlah banyak diunggah sekaligus lewat file XML. Coretax juga menambahkan validasi data yang lebih ketat, antara lain untuk NPWP dan NITKU (DJP). Data yang dulu masih lolos di e-Faktur lama kini bisa langsung ditolak.
Artikel ini membahas cara kerja import faktur di Coretax, error yang paling sering muncul beserta solusinya, checklist sebelum upload, dan cara mencegah error berulang setiap bulan.
Faktur pajak hanyalah ujung dari proses keuangan perusahaan. Kalau datanya rapi sejak pencatatan transaksi, error di Coretax jauh berkurang. Baca juga fungsi sistem keuangan dalam perusahaan untuk memahami alurnya dari awal.
Cara kerja import faktur di Coretax
PKP bisa membuat faktur pajak di Coretax dengan dua cara: input manual satu per satu lewat menu Pajak Keluaran, atau sekaligus dengan file XML (DDTCNews). Alur import XML terdiri dari lima langkah:
Unduh template dan converter terbaru dari laman Template XML dan Converter Excel ke XML milik DJP. Per laman tersebut, converter Faktur Keluaran terakhir diperbarui 23 Januari 2026.
Isi template Excel di sheet Faktur (data per faktur) dan DetailFaktur (data per barang atau jasa).
Konversi Excel ke XML dengan converter dari DJP.
Upload file XML di modul e-Faktur Coretax.
Pantau hasilnya di XML Monitoring. Di sini terlihat apakah import berhasil, masih diproses, atau ada baris yang error.
Empat langkah import faktur ke Coretax, dari template Excel sampai pengecekan di XML Monitoring.
Error bisa muncul di langkah 3 (saat konversi) atau langkah 5 (saat divalidasi Coretax). Pesan error di XML Monitoring menyebutkan nomor baris di file XML yang bermasalah.
Bagi perusahaan yang sudah memakai ERP, langkah 2 dan 3 sebenarnya bisa dilewati. Dengan integrasi Coretax Host-to-Host, data faktur dikirim langsung dari sistem tanpa menyusun Excel dan mengonversi XML.
Error yang paling sering muncul dan cara mengatasinya
Gejala atau pesan error | Penyebab | Cara mengatasi |
|---|---|---|
NITKU pembeli tidak valid | Jenis ID Pembeli diisi NIK, tetapi kolom ID TKU Pembeli dikosongkan atau diisi tanda strip | Jika jenis ID pembeli TIN (NPWP), isi ID TKU dengan 22 digit NITKU. Jika jenis ID selain NPWP, isi ID TKU dengan 0000 (DDTCNews) |
NPWP atau NIK pembeli tidak ditemukan | Identitas pembeli belum terdaftar atau belum aktif di Coretax, misalnya NIK belum diaktivasi sebagai NPWP | Minta pembeli memastikan statusnya di Coretax. Untuk transaksi mendesak, keluarkan baris tersebut dari file XML dan buat fakturnya secara manual (DJP, kasus serupa pada bukti potong) |
Ada baris error, padahal jumlah baris di Excel sedikit | Baris kosong atau berwarna di template ikut terekspor ke XML | Hapus baris template yang tidak terisi sebelum konversi |
Format tanggal atau angka tidak valid | Kolom tanggal di Excel tersimpan sebagai teks, sehingga urutan tanggal di XML tidak sesuai format yang diminta | Pastikan kolom tanggal di Excel berformat tanggal, lalu cek ulang hasilnya di file XML sebelum upload |
File ditolak atau struktur XML tidak dikenali | Template atau converter versi lama, karena DJP memperbarui keduanya mengikuti perkembangan sistem | Unduh ulang template dan converter dari laman resmi DJP setiap kali menyiapkan file baru |
Import berhasil, tetapi faktur tidak muncul | Coretax masih membentuk faktur di belakang layar | Cek XML Monitoring. Bila status masih CREATING INVOICE, tunggu sampai CREATING INVOICE FINISHED, lalu klik tombol refresh |
Error muncul tanpa sebab yang jelas | Gangguan sistem atau browser | Hapus cache dan cookies, coba jendela incognito, atau ganti browser, koneksi, atau perangkat, lalu impor ulang |
Cara menemukan baris yang error. Nomor baris di XML Monitoring merujuk ke nomor baris di file XML, bukan di Excel. Buka file XML dengan editor teks yang menampilkan nomor baris, seperti Notepad++ atau VS Code, lalu lompat ke baris tersebut untuk melihat data mana yang bermasalah. Setelah ketemu, perbaiki di file Excel sumber, konversi ulang, lalu upload lagi.
Checklist sebelum upload file XML
Centang semua poin ini sebelum menekan tombol upload. Lima menit pengecekan lebih cepat daripada mencari baris error satu per satu.
Template dan converter yang dipakai adalah versi terbaru dari laman DJP.
Setiap pembeli dengan NPWP sudah punya NITKU 22 digit di kolom ID TKU Pembeli.
Pembeli dengan NIK atau identitas lain diisi 0000 di kolom ID TKU Pembeli.
NIK dan NPWP pembeli sudah dicek aktif di Coretax, terutama untuk pelanggan baru.
Tidak ada baris kosong atau baris berwarna sisa template yang ikut terekspor.
Kolom tanggal berformat tanggal, bukan teks, dan terbaca benar setelah dikonversi.
Jumlah faktur di sheet Faktur sesuai dengan detail barang di sheet DetailFaktur.
File XML dibuka sekilas di editor teks untuk memastikan isinya tidak kosong atau terpotong.
Kalau checklist ini terasa berat setiap bulan, itu tanda data pelanggan dan transaksi perlu dipusatkan di satu sistem, misalnya modul akuntansi ERP yang menyimpan NPWP dan NITKU pelanggan secara rapi.
Kalau import sudah gagal: langkah perbaikan
Jangan langsung mengunggah ulang file yang sama berkali-kali. Ikuti urutan ini:
Buka XML Monitoring dan catat pesan error serta nomor barisnya.
Cek status proses. Kalau statusnya masih CREATING INVOICE, tunggu sampai selesai sebelum mengulang, supaya faktur tidak terbentuk dua kali.
Temukan baris yang bermasalah di file XML dengan editor teks yang menampilkan nomor baris.
Perbaiki di Excel sumber, bukan langsung di XML, supaya kesalahan yang sama tidak terulang bulan depan.
Pisahkan data yang belum bisa diperbaiki. Misalnya pembeli yang NIK-nya belum aktif: keluarkan dari file dan buat fakturnya secara manual, supaya faktur lain tetap bisa terbit.
Konversi ulang dan upload file yang sudah diperbaiki.
Kalau error tetap muncul padahal data sudah benar, coba langkah teknis dari DJP: hapus cache dan cookies, gunakan jendela incognito, atau ganti browser dan perangkat. Bila masih gagal, hubungi Kring Pajak dengan menyertakan screenshot XML Monitoring.
Mencegah error berulang dari sumbernya
Kalau error yang sama muncul setiap bulan, masalahnya bukan di file XML, melainkan di data master yang dipakai untuk membuatnya. Tiga kebiasaan ini paling berdampak:
Rapikan data master pelanggan. Simpan NPWP 16 digit, NITKU 22 digit, dan jenis ID setiap pelanggan di satu tempat, lalu perbarui saat ada pelanggan baru atau cabang baru.
Hentikan salin-tempel manual dari sistem lain ke Excel. Setiap kali data dipindahkan manual, ada peluang format tanggal berubah, angka terpotong, atau baris tertinggal.
Tetapkan satu orang dan satu jadwal untuk mengunduh ulang template dan converter dari DJP, misalnya awal setiap masa pajak.
Untuk perusahaan dengan volume faktur tinggi, solusi paling tuntas adalah menghubungkan sistem ERP langsung ke Coretax. Data faktur diambil otomatis dari transaksi penjualan, divalidasi sebelum dikirim, dan status dari Coretax dikembalikan ke ERP. Tim pajak tidak perlu lagi menyusun Excel dan mengonversi XML setiap bulan.
Karena faktur dibentuk dari transaksi yang sama dengan pencatatan keuangan, data pajak juga selalu cocok dengan modul akuntansi ERP. Bagi perusahaan di Kawasan Berikat, integrasi yang sama bisa disambungkan dengan API ke Portal CEISA 4.0, sehingga dokumen pajak dan dokumen bea cukai berasal dari satu sumber data.
EOS Teknologi menyediakan integrasi Coretax Host-to-Host untuk ERP bagi perusahaan manufaktur, sebagai bagian dari paket ERP EOS. Hubungi tim kami untuk konsultasi gratis lewat WhatsApp.
FAQ
Apa itu NITKU, dan kenapa wajib diisi? NITKU adalah Nomor Identitas Tempat Kegiatan Usaha, kode 22 digit yang membedakan lokasi usaha atau cabang sebuah wajib pajak. Penambahan NITKU termasuk perubahan struktur data di Coretax, dan nomor ini ikut divalidasi saat import (DJP).
Pembeli tidak punya NPWP. ID TKU diisi apa? Untuk jenis ID selain NPWP, seperti NIK atau identitas lain, kolom ID TKU Pembeli diisi 0000.
Kenapa nomor baris error di XML Monitoring tidak cocok dengan baris di Excel? Karena nomor itu merujuk ke baris di file XML, bukan Excel. Satu faktur di Excel bisa menjadi belasan baris di XML. Buka file XML dengan editor teks yang menampilkan nomor baris.
Apakah file Excel bisa langsung diupload ke Coretax? Tidak. Excel harus dikonversi dulu ke XML dengan converter resmi DJP.
Apakah perlu mengunduh converter baru setiap bulan? Tidak harus setiap bulan, tetapi cek laman DJP sebelum menyiapkan file. DJP memperbarui template dan converter mengikuti perkembangan sistem, dan versi lama bisa memicu error.
Apakah ERP bisa langsung mengirim faktur ke Coretax tanpa Excel? Bisa, kalau ERP sudah terintegrasi dengan Coretax. Data faktur diambil langsung dari transaksi penjualan, sehingga tidak ada lagi proses isi template dan konversi XML. Lihat cara kerjanya di halaman Coretax Host-to-Host ERP. Untuk perusahaan di kawasan industri, baca juga ERP terintegrasi CEISA 4.0 untuk kawasan industri.
Untuk publikasi di eosteknologi.com
Hapus bagian ini sebelum artikel diterbitkan.
Elemen | Isi |
|---|---|
Judul SEO (maks. ~60 karakter) | Error Import Faktur Coretax: Penyebab dan Solusinya |
Meta description (maks. ~155 karakter) | NITKU tidak valid, baris error, atau faktur tidak muncul? Ini penyebab error import faktur XML di Coretax dan cara mengatasinya. |
Slug URL | /error-import-faktur-coretax/ |
Kata kunci utama | error import faktur coretax |
Kata kunci pendukung | nitku pembeli tidak valid, xml monitoring coretax, converter excel ke xml coretax, gagal import xml coretax |
Link internal | /coretax-host-to-host-erp/ (sudah ada di bagian pencegahan) |
Catatan: tambahkan FAQ schema untuk bagian FAQ, dan perbarui artikel bila DJP merilis converter atau template versi baru.
Baca juga
Sumber
Template XML dan Converter Excel ke XML, Direktorat Jenderal Pajak
Terkendala Impor XML Coretax, Wajib Pajak Kunjungi KP2KP Takalar, Direktorat Jenderal Pajak
Muncul Error NITKU Pembeli Tidak Valid, Apa yang Harus Dilakukan?, DDTCNews, 21 Januari 2025
Was this article helpful?
// Your feedback helps us improve our content engine.