Appearance
Error Umum — Dokumen BC
Kumpulan error yang sering muncul saat bekerja dengan dokumen BC beserta solusinya.
Error saat Submit
| Error | Penyebab | Solusi |
|---|---|---|
| Nomor Aju belum diisi | Tombol Buat Nomor Aju belum diklik | Klik Buat di field Nomor Aju pada section Dasar |
| CIF header ≠ total CIF barang | Nilai CIF di header tidak sesuai dengan jumlah CIF semua barang | Sesuaikan nilai CIF header setelah semua barang diisi |
| Dokumen Invoice wajib ada | Tab Dokumen tidak ada dokumen kode 380 | Tambah dokumen Invoice (kode 380) di Tab Dokumen |
| Dokumen B/L atau AWB wajib ada | Tidak ada B/L (kode 705) atau AWB (kode 740) | Tambah salah satu di Tab Dokumen |
| Tab Barang kosong | Belum ada barang ditambahkan | Tambah minimal 1 barang di Tab Barang |
| Tab Kemasan kosong | Belum ada kemasan | Tambah minimal 1 kemasan di Tab Kemasan |
| Berat Kotor harus > 0 | Field Berat Kotor kosong atau 0 | Isi Berat Kotor di section header |
| Kekurangan belum di-resolve | Tab Kekurangan Bahan Baku masih ada item merah | Resolve semua kekurangan atau klik Urai Semua |
| Tarif belum dihitung | Tombol Hitung Ulang belum diklik | Klik Hitung Ulang di section Pungutan |
| Entitas tidak lengkap | NITKU/NPWP/Nama kosong di salah satu entitas | Pilih ulang entitas dari master akun (klik ikon Search) |
Error CEISA 4.0
| Error | Penyebab | Solusi |
|---|---|---|
| Validasi gagal di CEISA | Data tidak memenuhi standar CEISA | Baca pesan error dari CEISA → perbaiki field terkait di DocFast → ulangi Validasi |
| Transfer gagal / timeout | Koneksi ke CEISA terputus atau server CEISA down | Cek koneksi internet → klik Tarik JSON untuk lihat detail error → coba Transfer ulang |
| Transfer berhasil tapi Nomor Daftar tidak muncul | Sistem masih menunggu respons CEISA | Tunggu sampai 1 jam — sistem menarik Nomor Daftar otomatis setiap 1 jam |
| Tombol Tarik Perbaikan muncul | CEISA 4.0 mengembalikan catatan perbaikan | Klik Tarik Perbaikan → baca catatan → perbaiki data di DocFast → Transfer ulang |
| API CEISA mati | Server CEISA sedang maintenance | Gunakan Tarik Excel → upload manual ke portal CEISA 4.0 sebagai alternatif |
| "BAHAN BAKU IMPOR SERI X TARIF BM SALAH. SEHARUSNYA Y" | Tarif Bea Masuk bahan baku yang dikirim ≠ tarif yang divalidasi CEISA. Sering karena tarif diturunkan otomatis dari dokumen CO (lihat detail di bawah) | Sesuaikan Tarif BM bahan baku ke nilai Y (mis. 15), atau pastikan dokumen CO valid & ter-referensi → Hitung Ulang → kirim ulang |
| "GAGAL MELAKUKAN PENGECEKAN NPWP KE DJA" | Masalah di sisi Bea Cukai/CEISA — saat Validasi, CEISA gagal mengecek NPWP ke sistem DJA (Ditjen Anggaran/Pajak). Bukan kesalahan data Anda | Coba lagi beberapa saat — klik CEISA 4.0 → Validasi ulang. Masalah ini akan diperbaiki dari sisi CEISA; tidak ada yang perlu diubah di dokumen |
| "KURS TIDAK SESUAI" | Kurs (NDPBM) di dokumen tidak sama dengan kurs yang berlaku di CEISA saat validasi (kurs sudah berubah) | Revise dokumen (status kembali ke Draft) → klik Tarik Kurs untuk ambil kurs terbaru → Submit ulang → Validasi lagi (lihat detail di bawah) |
Pesan ber-nomor seperti di atas adalah respon penolakan dari CEISA 4.0 (muncul saat CEISA 4.0 → Validasi, atau lewat Tarik Respon), bukan validasi DocFast.
Detail: "GAGAL MELAKUKAN PENGECEKAN NPWP KE DJA"
Error ini muncul saat CEISA 4.0 → Validasi. Penyebabnya di sisi aplikasi Bea Cukai (CEISA) via API — CEISA tidak berhasil memverifikasi NPWP ke sistem DJA. Bukan karena data NPWP di dokumen Anda salah.
Solusi: cukup coba Validasi lagi beberapa saat kemudian. Gangguan ini bersifat sementara dan diperbaiki dari sisi CEISA — tidak perlu mengubah data dokumen. Jika muncul berkali-kali dalam waktu lama, laporkan ke Bea Cukai / tim DocFast.
Detail: "KURS TIDAK SESUAI"
Error ini muncul saat Validasi karena kurs (NDPBM) yang tersimpan di dokumen sudah tidak sama dengan kurs yang berlaku di CEISA (kurs KMK diperbarui, biasanya mingguan).
Solusi (langkah berurutan):
- Klik Revise pada dokumen → status BC kembali ke Draft.
- Di header, bagian Data Perdagangan, klik Tarik Kurs → sistem mengambil kurs terbaru dan menghitung ulang nilai (NDPBM, CIF, tarif, pungutan).
- Submit ulang dokumen.
- Jalankan CEISA 4.0 → Validasi lagi.
Detail: "TARIF BM SALAH" karena Dokumen CO (Certificate of Origin)
Gejala: Saat BC 2.5 dikirim, CEISA menolak dengan "BAHAN BAKU IMPOR SERI X TARIF BM SALAH. SEHARUSNYA 15" padahal di DocFast tarif bahan baku tertera lebih rendah (mis. 5%).
Penyebab: DocFast punya aturan tarif preferensi otomatis pada BC 2.5 (tipe Harga Masuk) — berlaku generic (semua tenant), bukan khusus modul tertentu:
- Jika BC asal bahan baku (BC 2.3 impor) memiliki dokumen CO — e-CO (kode 860) atau CO (kode 861) — maka DocFast mengambil tarif BM dari BC asal tersebut.
- Jika tarif CO (mis. 5%) lebih kecil dari tarif HS normal (mis. 15%), DocFast memakai yang lebih kecil → tarif jadi 5%.
CEISA dapat menolak tarif preferensi 5% untuk pengeluaran BC 2.5 ke TLDDP dan menuntut tarif normal 15% — biasanya karena fasilitas preferensi CO berlaku di sisi impor, atau dokumen CO belum diakui/ter-referensi dengan benar pada BC 2.5.
Solusi:
- Jika preferensi CO tidak berlaku untuk pengeluaran ini → koreksi Tarif BM bahan baku ke nilai yang diminta CEISA (mis. 15%), klik Hitung Ulang, lalu kirim ulang.
- Jika preferensi CO seharusnya berlaku → pastikan dokumen CO valid dan ter-referensi dengan benar di BC, lalu kirim ulang.
- Jika ragu apakah tarif CO seharusnya dipakai pada BC 2.5 pengeluaran, konfirmasikan ke tim Bea Cukai / DocFast — ini menyangkut interpretasi aturan preferensi.
Error Kekurangan Bahan Baku
| Error | Penyebab | Solusi |
|---|---|---|
| Badge merah di tab Kekurangan | Stok BC Asal tidak cukup untuk memenuhi kebutuhan bahan baku | Klik Urai Semua untuk breakdown otomatis atau resolve manual per item |
| Urai Semua tidak mengubah kekurangan | BOM tidak ditemukan untuk barang tersebut | Periksa BOM di menu BOM — pastikan ada BOM aktif untuk kode barang tersebut |
| CIF bahan baku = 0 | BC Asal (BC 2.3) tidak memiliki nilai CIF | Buka BC Asal → isi nilai CIF barang yang kosong → simpan |
Error Umum Aplikasi
| Error | Penyebab | Solusi |
|---|---|---|
| Halaman tidak bisa disimpan | Validasi field gagal | Scroll halaman — cari field yang berwarna merah → isi dengan nilai yang benar |
| Data lookup tidak muncul | Master data belum diisi atau tidak aktif | Cek master terkait (Master Akun, Master Barang, Master Valuta) — pastikan data aktif |
| Nomor Aju duplikat | Nomor Aju sudah digunakan di dokumen lain | Generate ulang Nomor Aju dengan klik Buat lagi |
| Kurs tidak ditemukan | Valuta dipilih tapi kurs belum diisi | Buka Master Valuta → tambah kurs untuk tanggal yang sesuai, atau klik Tarik Kurs di form |