Resources / Blog /

e-Faktur

ETAX-API-10001 Upload Faktur Corrupt: Penyebab, Solusi, dan Daftar Error e-Faktur Lengkap

Upload Faktur Corrupt: Penyebab, Kode Error dan Solusi

Error ETAX-API-10001: Upload Faktur Corrupt, Lakukan Upload Ulang adalah salah satu kode error yang paling sering ditemui pengguna aplikasi e-Faktur DJP. Error ini muncul saat proses upload faktur pajak gagal karena adanya masalah pada database aplikasi e-Faktur. Artikel ini membahas penyebab lengkap, langkah solusi, daftar error e-Faktur umum, dan checklist pencegahan sebelum upload.

Apa Itu Error ETAX-API-10001?

ETAX-API-10001 adalah kode error yang menandakan kegagalan upload faktur pajak akibat file database e-Faktur yang rusak (corrupt) atau tidak dapat diakses. Ketika error ini muncul, pengguna tidak dapat mengunggah faktur pajak ke server DJP sehingga status faktur tetap belum approval.

Error ini berbeda dari penolakan (reject) faktur oleh DJP. ETAX-API-10001 adalah masalah teknis pada sisi aplikasi atau database pengguna, bukan masalah validasi data faktur oleh sistem DJP.

Penyebab Error ETAX-API-10001

Terdapat tiga penyebab utama munculnya kode error ini:

  1. File database hilang atau corrupt. Biasanya terjadi karena pengguna menyalin (copy) folder database saat aplikasi e-Faktur masih berjalan, atau karena infeksi virus/malware pada komputer.
  2. Versi e-Faktur tidak sesuai dengan versi database. Terjadi ketika pengguna menggunakan versi aplikasi e-Faktur yang lebih lama atau lebih baru dari versi database yang tersimpan.
  3. PC server tidak aktif atau tidak terhubung. Jika e-Faktur dijalankan dalam mode multi-user, PC yang berfungsi sebagai server harus selalu aktif dan terhubung ke jaringan.

Cara Mengatasi Error ETAX-API-10001

Langkah 1: Periksa Folder Database

Buka folder database e-Faktur Anda dan pastikan hanya ada satu folder bernama ETaxInvoice. Jika terdapat lebih dari satu folder, hapus folder yang lebih lama (lihat tanggal modified). Folder ETaxInvoice yang valid harus memuat file-file berikut: log, seg0, tmp, db.lck, README_DO_NOT_TOUCH_FILES, service.properties.

Langkah 2: Update Versi Aplikasi dan Database

Jalankan aplikasi e-Faktur dalam kondisi terhubung ke internet, lalu lakukan update database melalui menu yang tersedia. Pastikan versi aplikasi e-Faktur yang digunakan sudah merupakan versi terbaru.

Langkah 3: Aktifkan PC Server

Jika menggunakan konfigurasi server, pastikan PC server menyala dan aplikasi e-Faktur berjalan di komputer tersebut. Alternatifnya, jalankan database sebagai server melalui menu File > Administrasi DB > Start DB sebagai Server.

Langkah 4: Buat Database Baru (Jika Diperlukan)

Jika langkah di atas tidak berhasil dan database dipastikan corrupt, solusi terakhir adalah membuat database baru, kemudian menggunakan metode export–import untuk memindahkan data dari database lama ke database baru. Untuk database faktur keluaran yang hilang, pengguna dapat mengajukan permintaan ke KPP dengan membawa flashdisk kosong.

Cara Mengatasi Error ETAX-API-20001

Error ETAX-API-20001: Upload Faktur Corrupt, Lakukan Upload Ulang memiliki notifikasi yang sama dengan ETAX-API-10001, tetapi penyebab dan solusinya berbeda:

  1. Lakukan upload ulang terlebih dahulu. Jika masih gagal, lanjutkan ke langkah berikut.
  2. Periksa data faktur yang sudah diinput — cek apakah terdapat karakter khusus (seperti underscore “_”, tanda kutip, atau karakter non-alfanumerik) dalam nama BKP/JKP.
  3. Periksa alamat lawan transaksi — hapus karakter khusus yang tidak biasa dalam penulisan alamat.
  4. Setelah memperbaiki data, lakukan upload ulang.

Cara Mengatasi Error ETAXSERVICE-20021

Error ETAXSERVICE-20021: Upload Faktur Corrupt muncul ketika pengguna melakukan input data menggunakan metode impor file CSV. Langkah mengatasinya:

  1. Buka file .csv yang akan di-upload menggunakan Notepad++.
  2. Masuk ke menu Encoding > Encode in UTF-8.
  3. Hapus karakter yang tidak biasa atau tidak dikenal dalam file.
  4. Simpan file, lalu coba impor dan upload ulang.

Daftar Error e-Faktur Umum dan Solusinya

Kode Error Keterangan Penyebab Umum Solusi
ETAX-API-10001 Upload Faktur Corrupt Database corrupt / versi tidak sesuai / server mati Periksa folder ETaxInvoice, update aplikasi, aktifkan server
ETAX-API-20001 Upload Faktur Corrupt Karakter khusus dalam nama BKP/JKP atau alamat Hapus karakter khusus, upload ulang
ETAXSERVICE-20021 Upload Faktur Corrupt (impor CSV) Encoding file CSV tidak UTF-8 Konversi ke UTF-8 di Notepad++, hapus karakter aneh
ETAX-10001 Error database saat login Database corrupt saat copy ketika aplikasi berjalan Pastikan satu folder ETaxInvoice, jalankan update DB
ETAX-40001 Tidak dapat menghubungi server Internet tidak stabil / firewall / antivirus Periksa koneksi, nonaktifkan firewall sementara, perbarui sertifikat
ETAX-60001 Error database (virus/sertifikat) Database corrupt akibat virus; sertifikat belum dipatch Minta DB ke KPP; patch ulang sertifikat elektronik
ETAX-20017 Faktur pengganti reject Tanggal faktur pengganti lebih awal dari faktur normal Pastikan tanggal faktur pengganti ≥ tanggal faktur normal
ETAX-20027 NPWP error Penggantian NPWP lawan transaksi yang berulang Verifikasi NPWP lawan transaksi, hindari ganti-ganti NPWP
ETAX-22002 Faktur masukan pengganti reject Input faktur masukan normal padahal hanya perlu pengganti terakhir Hapus PM normal; input hanya faktur masukan pengganti terakhir
ETAX-30011 Profil belum diregistrasi PKP belum melakukan update profil Lakukan update profil di menu Update Profil

Checklist Sebelum Upload Faktur Pajak

Mencegah selalu lebih baik daripada memperbaiki. Sebelum melakukan upload faktur pajak ke server DJP, pastikan semua poin berikut telah terpenuhi:

  • ☑ Versi aplikasi e-Faktur sudah diperbarui ke versi terbaru
  • ☑ Koneksi internet stabil dan tidak terputus
  • ☑ Sertifikat elektronik masih berlaku (belum expired)
  • ☑ Data BKP/JKP tidak mengandung karakter khusus (_, “, ‘, &)
  • ☑ Alamat lawan transaksi bersih dari karakter aneh
  • ☑ NPWP lawan transaksi sudah terverifikasi dan benar
  • ☑ Tanggal faktur sudah sesuai — tidak mendahului tanggal transaksi
  • ☑ Hanya ada satu folder ETaxInvoice dalam folder database
  • ☑ PC server aktif (untuk konfigurasi multi-user)
  • ☑ File CSV menggunakan encoding UTF-8 (jika menggunakan metode impor)
  • ☑ Backup database telah dilakukan sebelum proses upload massal

Panduan Validasi File CSV Sebelum Upload

Untuk PKP yang melakukan upload faktur dalam jumlah besar menggunakan metode impor CSV, berikut panduan validasi yang perlu dilakukan:

  1. Buka file CSV menggunakan Notepad++ (bukan Excel, karena Excel bisa mengubah format angka).
  2. Periksa encoding — pastikan menggunakan UTF-8 tanpa BOM.
  3. Cari dan hapus karakter yang tidak biasa menggunakan fitur Find & Replace di Notepad++.
  4. Pastikan kolom NPWP terisi dengan 15 digit tanpa tanda titik atau strip.
  5. Pastikan format tanggal sesuai dengan format yang diminta aplikasi (YYYY-MM-DD atau DD/MM/YYYY tergantung versi).
  6. Simpan ulang file dengan encoding UTF-8 sebelum diimpor ke e-Faktur.

FAQ Error Upload Faktur e-Faktur

Apa penyebab error etax-api-10001?

Error ETAX-API-10001 disebabkan oleh tiga hal: (1) file database e-Faktur hilang atau corrupt — biasanya akibat penyalinan database saat aplikasi masih berjalan; (2) versi aplikasi e-Faktur berbeda dengan versi database; atau (3) PC server tidak aktif dalam konfigurasi multi-user. Solusinya: pastikan hanya ada satu folder ETaxInvoice, perbarui aplikasi, dan aktifkan PC server.

Bagaimana cara memperbaiki faktur corrupt?

Langkah perbaikannya: (1) Periksa folder database — pastikan hanya ada satu folder ETaxInvoice yang berisi file log, seg0, tmp, db.lck, dan README. (2) Update versi aplikasi e-Faktur. (3) Jika database benar-benar corrupt, buat database baru dan gunakan metode export-import dari database lama. (4) Untuk database yang hilang total, minta data ke KPP setempat.

Apa saja error umum saat upload e-Faktur?

Error yang paling sering muncul adalah: ETAX-API-10001 dan ETAX-API-20001 (upload corrupt), ETAXSERVICE-20021 (encoding CSV salah), ETAX-40001 (masalah koneksi), ETAX-60001 (database rusak akibat virus), ETAX-30011 (profil belum diregistrasi), dan ETAX-20017 (tanggal faktur pengganti salah). Setiap error memiliki penyebab dan solusi yang berbeda — pastikan Anda membaca kode error dengan saksama sebelum mengambil tindakan.

Bagaimana cara mencegah error upload faktur?

Lakukan backup database secara rutin (copy folder DB ke flashdisk atau HDD eksternal). Selalu update aplikasi e-Faktur ke versi terbaru. Jangan menyalin database saat aplikasi sedang berjalan. Pastikan sertifikat elektronik selalu aktif. Gunakan koneksi internet yang stabil saat upload. Hindari penggunaan karakter khusus dalam pengisian data BKP/JKP dan alamat lawan transaksi.

Hindari Error Upload Faktur dengan OnlinePajak

Salah satu keunggulan menggunakan OnlinePajak sebagai platform e-Faktur adalah validasi data otomatis sebelum proses upload ke DJP. OnlinePajak mendeteksi potensi error lebih awal — termasuk karakter tidak valid, NPWP yang salah, dan inkonsistensi data — sehingga Anda tidak perlu menghadapi proses troubleshooting yang memakan waktu.

Sebagai Penyedia Jasa Aplikasi Perpajakan (PJAP) resmi mitra DJP, OnlinePajak terintegrasi penuh dengan sistem Coretax DJP untuk penerbitan e-Faktur, upload otomatis, dan pelaporan SPT Masa PPN. Pelajari fitur e-Faktur OnlinePajak untuk pengalaman upload faktur yang lebih andal.

Referensi

Baca juga:
Daftar Lengkap Kode Error e-Faktur
Cara Mendapatkan Nomor Seri Faktur Pajak
Masa Berlaku Faktur Pajak
Sanksi Tidak Menerbitkan Faktur Pajak

Share

Related articles

e-Faktur
e-Faktur
e-Faktur