Halo, Apa yang dapat kami bantu?

Mengatasi Error Saat Melakukan Transaksi atau Membuat Faktur

By cahya at OnlinePajak
Updated March 24, 2026

Ketika Anda melakukan transaksi, membuat faktur, atau menjalankan aktivitas lainnya di aplikasi, mungkin Anda akan menemui pesan error.
Hal ini bisa terjadi karena berbagai alasan, baik dari sisi sistem internal maupun faktor eksternal seperti koneksi internet atau integrasi pihak ketiga.

Untuk membantu Anda menyelesaikan kendala tersebut, berikut daftar error yang umum terjadi beserta penyebab dan solusinya.

🟥 Error Code 400 – Client Input Errors

MasaPajak tidak valid
→ Perbaiki periode pajak sesuai format yang benar.

NpwpPembeli nilai non-kosong / non-null diperlukan
→ Isi NPWP pembeli, jangan dibiarkan kosong atau null.

UserId nilai non-kosong / non-null diperlukan
→ Isi User ID sesuai ketentuan sistem Coretax.

NpwpPenerbit / NpwpPenjual nilai non-kosong / non-null diperlukan
→ Lengkapi NPWP penerbit atau penjual.

TempatPenandatangan nilai non-kosong / non-null diperlukan
→ Lengkapi data penandatangan di profil wajib pajak.

TotalDpp nilai non-kosong diperlukan
→ Isi nilai DPP pada level item.

nikPaspPembeli invalid
→ Isi field otherId jika jenis identitas menggunakan paspor.


🟥 Error Code 500 – Server & Validation Errors

Status Dokumen & Duplikasi

Dokumen / Faktur sudah dibatalkan
→ Faktur tersebut tidak dapat digunakan kembali.

Status harus Approved
→ Ubah status dokumen menjadi Approved sebelum diproses.

Duplicate Invoice Number
→ Nomor dokumen sudah ada di sistem.

Faktur tidak ditemukan
→ Nomor faktur tidak terdaftar dalam sistem DJP.

Tax invoice already amended
→ Faktur sudah pernah dilakukan perubahan.

TotalDppLain harus xxx 
→ Ini terjadi untuk skema Uang Muka dan/atau Pelunasan. Sehingga terdapat selisih 1 rupiah yang disebabkan oleh pembulatan. Untuk penyesuaian tersebut Anda dapat menghubungi kami, sehingga amount total DPP Lainnya sama. Setelah mendapatkan konfirmasi kami, Anda dapat secara langsung approve dan tidak perlu di edit & save draft tersebut.

ERR_POSITIVE_MAX_TWO_DECIMAL_PLACE
→ Amount pada file XML dibulatkan, contoh harga item 258629.02 quantity 2160, seharusnya DPPnya adalah 558638683.2 tidak dibulatkan menjadi 558638683. Jika ada decimal untuk DPP, DPP Nilai Lain dan PPN, tidak perlu dibulatkan pada file XML tersebut.

Not authorised to perform this operation
→ DJP sedang mengalami gangguan, silakan coba approval kembali beberapa saat kedepan.

java.io.IOException
→ DJP sedang mengalami gangguan, jika dalam waktu 1-2 jam status faktur belum berubah, Anda hubungi tim support kami.

internal server error from POST
→ DJP sedang maintenance. Anda dapat cek terlebih dahulu pada sistem coretax, jika pada sistem coretax belum muncul, silakan kembali ke OP untuk approve kembali.

Index and lenght must refer to a location within the string
→ Server DJP maintenance, Approve kembali secara berkala.


Validasi Data Pembeli / Penjual

npwpPembeli is not found
→ Pastikan NPWP pembeli/penjual valid dan sesuai data DJP.

NPWPNikPenandatangan tidak memiliki hak membuat dokumen
→ Ganti NPWP penandatangan sesuai wajib pajak yang berwenang dan samakan dengan yang terdaftar pada sistem coretax..

NamaPembeli harus sama (Kongsi VAT)
→ Samakan nama pembeli dengan data tampilan DJP.

NationalID / Passport tidak valid
→ NIK tersebut tidak ditemukan di dalam database DJP. Penyebab tidak ditemukannya NIK tersebut belum melakukan pemadanan NIK-NPWP

Alamat pembeli harus sesuai
→ Gunakan alamat yang berasal dari data pemerintah.


Kesalahan Perhitungan (DPP, PPN, PPNBM, Tarif, Diskon)

JumlahDpp tidak valid
→ Koreksi nilai DPP agar sesuai perhitungan detail item.

JumlahPpn harus … (nilai tertentu)
→ Sesuaikan nilai PPN dengan jumlah yang ditampilkan.

TarifPpn tidak sesuai
→ Gunakan tarif PPN yang berlaku (mis. 12%).

TarifPpnbm / nilai PPNBM tidak sesuai
→ Samakan nilai PPNBM dengan perhitungan sistem.

Discount over limit
→ Nilai diskon tidak boleh melebihi total DPP.

Only max two decimal places allowed
→ Gunakan maksimal 2 angka desimal.


Error pada Return / Retur

ReturnTaxBase & ReturnVAT harus ≤ 0
→ Nilai retur tidak boleh lebih besar dari transaksi awal.

Total retur tidak sesuai
→ Pastikan nilai retur sama dengan perhitungan per item.

Status Faktur tidak valid untuk retur
→ Hanya faktur berstatus UNCREDITED atau CREDITED yang dapat diretur.


Kode Barang/Jasa / Transaksi

KdBrgJasa should be 990000 / 990100 / blank
→ Gunakan kode barang/jasa sesuai ketentuan.

Rincian transaksi tidak memiliki kode yang benar
→ Gunakan kode barang dan unit yang sesuai untuk transaksi ekspor.

Tidak dapat diganti menjadi Kode Transaksi 03
→ Transaksi tersebut tidak mendukung perubahan ke kode 03.


Dokumen Pendukung

Tidak dapat menemukan dokumen pendukung / refDoc tidak valid
→ Pastikan nomor dokumen pendukung sesuai dengan data DJP.

Custom document not allowed
→ Untuk transaksi tertentu, nomor supporting document wajib diisi.


PIC (Person in Charge) Issues

Pengguna memiliki lebih dari 1 PIC / tidak memiliki PIC
→ Pilih PIC tunggal melalui admin DJP.


Tanggal Dokumen

TanggalDokumen tidak sesuai masa pajak / tahun pajak
→ Sesuaikan tanggal dokumen dengan periode pajak.


Validasi Umum

Nullable object must have a value / Object reference error
→ Pastikan semua field wajib terisi dan tidak null.

Value cannot be null (source)
→ Isi field source dengan nilai yang benar.

Kesalahan pada ESign
→ Gangguan koneksi atau file tidak ditemukan. Coba ulang atau hubungi support.

Timeout from DJP
→ Sistem DJP tidak merespons. Coba lagi setelah beberapa saat.

Status e-Faktur Stuck “In Progress”

→ Status e-Faktur masih In Progress karena DJP belum mengirimkan respons sukses atau PDF belum berhasil diambil, meskipun NSFP sudah terbentuk.
→ Silakan tunggu atau lakukan re-approve / retry get status. Jika sudah maksimum retry, tim internal akan melakukan republish status.


e-Faktur Ditolak oleh DJP

→ Penolakan terjadi karena timeout DJP, DC kedaluwarsa, atau data pendukung tidak lengkap (kode pajak 07).
→ Periksa status di Coretax terlebih dahulu, lalu perbaiki data atau perbarui DC sebelum melakukan re-approve.


e-Faktur Gagal Dibuat di Coretax

→ Terjadi timeout dari DJP saat proses approval.
→ Silakan lakukan re-approve untuk melanjutkan pembuatan e-Faktur.


Import e-Faktur / e-Bupot Gagal atau Stuck

→ Proses import tertunda karena antrian tinggi, format XML tidak valid, atau field wajib tidak diisi.
→ Pastikan format file sesuai ketentuan dan tunggu hingga antrian selesai.


Perbedaan Nilai DPP / PPN / PPh

→ Terjadi karena perbedaan logika pembulatan (legacy vs Coretax) atau penggunaan DPP Nilai Lain tidak sesuai kode faktur.
→ Ikuti aturan pembulatan Coretax (0,5 dibulatkan ke atas) dan pastikan kode faktur sesuai.


Email Tidak Muncul / Salah di PDF e-Faktur

→ Email tidak tampil karena tidak diisi di kolom buyer atau format file salah.
→ Pastikan email diinput dengan benar pada data pembeli.


OTP Verifikasi Tidak Diterima

→ OTP tidak diterima, namun verifikasi email dan nomor HP sudah berhasil.
→ Tidak diperlukan tindakan lanjutan.


FPM / FPK Tidak Muncul atau Stuck

→ Terjadi karena periode pajak tidak sesuai, prepopulated DJP nonaktif, atau validasi internal OP.
→ Pastikan periode pajak benar dan tunggu jika layanan DJP sedang maintenance.


Pembayaran / Top Up Stuck atau Saldo Tidak Masuk

→ Disebabkan timeout payment gateway, pembayaran ditolak bank, atau ID Billing kedaluwarsa.
→ Buat ID Billing baru atau hubungi bank terkait. Dana gagal akan direversal.


OPoint Tidak Masuk / Gagal Redeem

→ Terjadi karena perubahan syarat redeem atau kendala dari vendor voucher.
→ Tim internal akan membantu redeem manual atau menunggu proses vendor selesai.


Role & Permission Tidak Memadai

→ Aksi approve/edit gagal karena role pengguna tidak memiliki akses atau fitur belum tersedia.
→ Hubungi admin akun atau CS untuk penyesuaian akses.


Halaman Stuck Loading / Tombol Tidak Berfungsi

→ Masalah UI akibat cache browser atau bug tampilan.
→ Silakan clear cache, gunakan incognito, atau browser lain.


Jika setelah mengikuti langkah-langkah di atas masalah masih terjadi, silakan hubungi Tim Support OnlinePajak melalui email [email protected] 

Tim kami akan membantu melakukan pengecekan lebih lanjut dan memberikan solusi yang sesuai dengan kondisi Anda.

Digitalization is here.

It's simple, just click below on the button, ya.