Cara Memperbaiki Kesalahan Impor Laporan Bank Umum di QuickBooks dan Xero

Anda sudah menyiapkan CSV laporan bank Anda. Anda mengunggahnya ke QuickBooks atau Xero. Dan kemudian: pesan kesalahan. Atau lebih buruk - tidak ada kesalahan, tetapi datanya jelas salah. Tanggal tertukar. Jumlah ada di kolom deskripsi. Transaksi dari Januari muncul di Oktober.

Kesalahan impor laporan bank adalah hambatan pembukuan paling umum bagi akuntan yang mengelola banyak klien. Kesalahan biasanya dapat diperbaiki, tetapi hanya jika Anda tahu penyebabnya. Pesan "impor gagal" yang samar tidak memberi tahu Anda apakah masalahnya adalah format tanggal, struktur kolom, pengodean file, atau baris kosong yang salah di baris 847.

Panduan ini mencakup delapan kesalahan impor paling umum di QuickBooks Online dan Xero, dengan perbaikan spesifik untuk masing-masing.

Kesalahan 1: Ketidakcocokan Format Tanggal

Gejalanya: Impor gagal dengan kesalahan "format tanggal tidak dikenali". Atau impor berhasil, tetapi tanggalnya salah - 6 Maret menjadi 3 Juni.

Mengapa ini terjadi: QuickBooks dan Xero menafsirkan tanggal berdasarkan pengaturan lokal akun Anda. Jika akun Anda diatur ke format AS (MM/DD/YYYY) tetapi CSV Anda berisi format Inggris (DD/MM/YYYY), alat tersebut akan menolak tanggal atau secara diam-diam menukar bulan dan hari.

Skenario paling berbahaya adalah ketika tanggal ambigu. 03/06/2026 bisa jadi 6 Maret atau 3 Juni - dan jika nomor hari adalah 12 atau kurang, alat tidak punya cara untuk mengetahui mana yang benar. Alat menebak berdasarkan pengaturan lokal Anda.

Cara memperbaikinya:

Di QuickBooks Online:

1. Buka Pengaturan (ikon roda gigi) > Akun dan Pengaturan > Lanjutan
2. Periksa pengaturan format tanggal - itu harus cocok dengan CSV Anda
3. Jika CSV Anda menggunakan DD/MM/YYYY dan QuickBooks Anda diatur ke MM/DD/YYYY, konversikan tanggal CSV atau ubah sementara pengaturan QuickBooks selama impor

Di Xero:

1. Buka Pengaturan > Pengaturan Umum > Format Tanggal
2. Verifikasi bahwa itu cocok dengan CSV Anda
3. Xero cenderung lebih fleksibel tentang format tanggal selama impor, tetapi tanggal ambigu masih dapat menyebabkan masalah

Praktik terbaik: Gunakan format YYYY-MM-DD (ISO 8601) di CSV Anda. Ini tidak ambigu - tidak ada alat yang dapat salah menafsirkan 2026-03-15. Baik QuickBooks maupun Xero menerima format ini terlepas dari pengaturan lokal.

---

Kesalahan 2: Pemetaan Kolom yang Salah

Gejalanya: Jumlah muncul di kolom deskripsi. Deskripsi muncul di kolom jumlah. Tanggal tersebar di beberapa kolom.

Mengapa ini terjadi: Urutan kolom CSV Anda tidak sesuai dengan yang diharapkan oleh alat impor, dan langkah pemetaan kolom dilakukan secara tidak benar atau dilewati.

QuickBooks Online mengharapkan file CSV dalam format:

• Format 3 kolom: Tanggal, Deskripsi, Jumlah
• Format 4 kolom: Tanggal, Deskripsi, Kredit, Debit

Xero lebih fleksibel tetapi masih memerlukan pemetaan kolom eksplisit selama impor.

Cara memperbaikinya:

Di QuickBooks Online:

1. Selama impor, QuickBooks menampilkan pratinjau pemetaan kolom
2. Gunakan menu tarik-turun untuk menetapkan setiap kolom ke bidang yang benar
3. Jika pratinjau menampilkan data di bidang yang salah, petakan ulang sebelum mengonfirmasi
4. Jika tidak ada pratinjau (file ditolak), periksa apakah CSV Anda memiliki header kolom di baris pertama

Di Xero:

1. Selama impor, layar Peta Kolom Xero menampilkan setiap kolom dan tarik-turun
2. Petakan "Tanggal" ke kolom tanggal Anda, "Payee" atau "Deskripsi" ke kolom teks Anda
3. Petakan "Jumlah" atau "Debit"/"Kredit" ke kolom jumlah Anda
4. Gunakan baris pratinjau untuk memverifikasi bahwa pemetaan sudah benar

Praktik terbaik: Selalu sertakan header yang jelas di baris pertama CSV Anda: Tanggal, Deskripsi, Jumlah. Baik QuickBooks maupun Xero menggunakan header untuk mendeteksi pemetaan kolom secara otomatis. Tanpa header, Anda mengandalkan deteksi berbasis posisi, yang rapuh.

---

Kesalahan 3: Transaksi Duplikat

Gejalanya: Setelah impor, Anda melihat transaksi yang sama dua kali - sekali dari umpan bank dan sekali dari impor manual.

Mengapa ini terjadi: Anda mengimpor CSV yang mencakup tanggal yang sudah ada di perangkat lunak akuntansi Anda dari koneksi umpan bank. Baik umpan maupun impor membuat entri untuk transaksi yang sama.

Ini adalah masalah impor paling umum untuk akun yang sedang berjalan. Mudah diperbaiki tetapi membosankan - Anda perlu menemukan dan menghapus duplikat tanpa sengaja menghapus transaksi yang sah.

Cara memperbaikinya:

Di QuickBooks Online:

1. Buka Perbankan > Umpan Bank
2. Cari transaksi yang muncul di umpan dan set impor
3. QuickBooks mungkin menandai beberapa duplikat secara otomatis - tinjau dan konfirmasikan
4. Untuk duplikat yang tidak terdeteksi, urutkan berdasarkan jumlah dan tanggal untuk menemukan kecocokan
5. Hapus versi yang diimpor secara manual (pertahankan versi umpan bank, karena berisi ID transaksi bank)

Di Xero:

1. Tampilan rekonsiliasi Xero menyoroti potensi duplikat
2. Buka Akun Bank > [Akun] > Laporan Bank
3. Cari baris laporan duplikat
4. Hapus duplikat yang diimpor dari laporan, bukan dari entri yang direkonsiliasi

Praktik terbaik: Sebelum mengimpor, periksa rentang tanggal mana yang sudah dicakup oleh umpan bank. Hanya impor tanggal di luar rentang itu. Jika ada tumpang tindih, gunakan spreadsheet untuk menghapus tanggal yang tumpang tindih dari CSV Anda sebelum mengunggah.

---

Kesalahan Pengodean Karakter

Gejalanya: Impor gagal dengan kesalahan samar, atau deskripsi berisi karakter rusak seperti é bukan e atau â€" bukan tanda hubung em.

Mengapa ini terjadi: File CSV Anda disimpan dalam pengodean (seperti Windows-1252 atau ISO-8859-1) yang tidak cocok dengan yang diharapkan oleh alat impor (biasanya UTF-8). Karakter internasional, huruf beraksen, dan simbol khusus menjadi rusak selama konversi pengodean.

Ini sangat umum terjadi pada laporan bank dari negara berbahasa non-Inggris, atau dari sistem perbankan lama yang mengekspor dalam pengodean lama.

Cara memperbaikinya:

1. Buka CSV di editor teks yang menampilkan pengodean (seperti Notepad++ atau VS Code)
2. Periksa pengodean saat ini (ditampilkan di bilah status)
3. Jika bukan UTF-8, simpan ulang file sebagai UTF-8 tanpa BOM
4. BOM (Byte Order Mark) adalah karakter tak terlihat di awal file yang ditambahkan oleh beberapa sistem tetapi tidak diharapkan oleh alat impor - menghapusnya mencegah kesalahan umum "kolom pertama tidak dikenali"

Di aplikasi spreadsheet:

1. Buka CSV
2. Gunakan "Simpan Sebagai" dan secara eksplisit pilih "CSV UTF-8" sebagai format
3. Jika aplikasi Anda tidak menawarkan CSV UTF-8, coba "Teks Unicode" atau gunakan aplikasi yang berbeda

Praktik terbaik: Selalu gunakan pengodean UTF-8 untuk CSV. Ini menangani setiap karakter dari setiap bahasa. PDFSub mengekspor CSV dalam UTF-8 secara default.

---

Kesalahan 5: Kolom Hilang atau Ekstra

Gejalanya: Kesalahan "Tidak ada data laporan yang valid ditemukan" atau "Tidak dapat membaca file".

Mengapa ini terjadi: CSV Anda memiliki kolom tambahan (saldo, nomor referensi, nomor cek, kategori) yang tidak diharapkan oleh alat impor, atau kolom yang diperlukan hilang.

QuickBooks Online sangat ketat: ia mengharapkan 3 kolom (Tanggal, Deskripsi, Jumlah) atau 4 kolom (Tanggal, Deskripsi, Kredit, Debit). Kolom tambahan dapat menyebabkan seluruh impor gagal.

Xero lebih pemaaf - Anda dapat memetakan kolom yang Anda butuhkan dan mengabaikan yang ekstra - tetapi jika kolom yang diperlukan hilang, impor tetap gagal.

Cara memperbaikinya:

Hapus kolom tambahan:

1. Buka CSV di aplikasi spreadsheet
2. Hapus kolom apa pun yang bukan Tanggal, Deskripsi, atau Jumlah (atau Debit/Kredit)
3. Kolom umum untuk dihapus: Saldo, Total Berjalan, Nomor Cek, Referensi, Kategori, Tipe
4. Simpan dan unggah ulang

Tambahkan kolom yang hilang: Jika CSV Anda hanya memiliki Tanggal dan Jumlah (tanpa Deskripsi), tambahkan kolom Deskripsi dengan teks placeholder seperti "Transaksi Bank". Baik QuickBooks maupun Xero memerlukan deskripsi teks untuk setiap transaksi.

Praktik terbaik: Format CSV Anda agar sesuai persis dengan target: Tanggal, Deskripsi, Jumlah. Tidak lebih, tidak kurang. Ekspor CSV PDFSub memberi Anda kendali atas kolom mana yang akan disertakan.

---

Masalah Pemformatan Jumlah Kesalahan 6

Gejalanya: Jumlah diurai secara tidak benar - $1.234,56 menjadi $1,23 atau $123.456. Atau jumlah ditolak sama sekali.

Mengapa ini terjadi: Beberapa masalah pemformatan dapat merusak jumlah selama impor:

• Simbol mata uang di kolom jumlah ($1.234,56 bukan 1234.56)
• Pemisah ribuan ditafsirkan sebagai titik desimal (koma Eropa vs titik AS)
• Tanda kurung untuk jumlah negatif tidak dikenali - (500,00) bukan -500,00
• Spasi di bidang jumlah
• Teks bercampur dengan angka - 1234,56 KREDIT atau DEBET 500,00

Cara memperbaikinya:

1. Buka CSV di spreadsheet
2. Di kolom jumlah, hapus: - Semua simbol mata uang ($, EUR, GBP, dll.) - Semua pemisah ribuan (koma dalam format AS, titik dalam format Eropa) - Semua spasi - Label teks apa pun (KREDIT, DEBET, Kredit, Debit)
3. Konversikan negatif dalam tanda kurung menjadi negatif tanda minus: (500,00) menjadi -500,00
4. Pastikan pemisah desimal cocok dengan lokal perangkat lunak akuntansi Anda (biasanya titik)
5. Simpan dan unggah ulang

Untuk angka format Eropa (koma sebagai desimal, titik sebagai pemisah ribuan):

• Hapus semua pemisah ribuan titik: 1.234,56 menjadi 1234,56
• Ganti desimal koma dengan titik: 1234,56 menjadi 1234.56
• Ini akan dikonversi ke format AS yang diharapkan QuickBooks dan Xero (dengan asumsi lokal AS)

Praktik terbaik: Ekspor CSV dengan jumlah yang bersih - hanya digit, titik desimal, dan tanda minus. Tanpa simbol, tanpa pemisah, tanpa teks.

---

Kesalahan 7: Baris Kosong dan Spasi

Gejalanya: Kesalahan "Tidak ada data laporan yang valid", atau impor berhenti di tengah file.

Mengapa ini terjadi: CSV Anda berisi baris kosong - baik di atas (sebelum header), di tengah (di antara blok transaksi), atau di bawah (setelah transaksi terakhir). Beberapa CSV juga berisi karakter spasi tak terlihat yang tampak seperti sel kosong tetapi sebenarnya tidak kosong.

Laporan bank PDF sering kali memiliki header halaman, pembatas bagian, dan blok ringkasan yang menjadi baris kosong saat dikonversi ke CSV oleh alat dasar.

Cara memperbaikinya:

1. Buka CSV di aplikasi spreadsheet
2. Gulir seluruh file mencari baris kosong
3. Hapus semua baris kosong - terutama yang ada sebelum baris header
4. Periksa baris yang tampak kosong tetapi berisi spasi tersembunyi (pilih sel dan periksa bilah rumus)
5. Hapus baris ringkasan apa pun di akhir (total, baris saldo pembukaan/penutupan)
6. Pastikan baris pertama berisi header kolom, bukan nama bank atau judul laporan
7. Simpan dan unggah ulang

Di editor teks:

1. Buka CSV di editor teks biasa
2. Cari baris yang hanya berisi koma (,,,) - ini adalah baris kosong
3. Hapus
4. Juga cari baris di atas yang bukan data transaksi (nama bank, nomor akun, periode laporan)
5. Hapus semua yang bukan baris header atau data transaksi

Praktik terbaik: CSV yang bersih dimulai dengan baris header di baris 1, diikuti segera oleh data transaksi, tanpa baris kosong di mana pun. PDFSub menghapus konten non-transaksi selama ekstraksi.

---

Kesalahan 8: Batas Ukuran File atau Jumlah Transaksi

Gejalanya: "File terlalu besar" atau impor tampaknya selesai tetapi hanya mengimpor sebagian transaksi.

Mengapa ini terjadi: Baik QuickBooks maupun Xero memiliki batas pada ukuran file impor dan jumlah transaksi:

• QuickBooks Online: Sekitar 1.000 transaksi per file impor
• Xero: Tidak ada batas publikasi yang keras, tetapi file yang sangat besar mungkin mengalami batas waktu

Jika Anda mengimpor transaksi harian selama setahun penuh untuk akun yang aktif, Anda kemungkinan akan melebihi batas ini.

Cara memperbaikinya:

1. Pisahkan CSV Anda menjadi file bulanan
2. Impor setiap bulan secara terpisah
3. Verifikasi jumlah transaksi setelah setiap impor

Untuk memisahkan di spreadsheet:

1. Buka CSV besar
2. Urutkan berdasarkan tanggal
3. Pilih semua baris untuk satu bulan, salin ke file baru
4. Simpan dengan baris header yang sama
5. Ulangi untuk setiap bulan

Praktik terbaik: Impor bulanan. Ini bukan hanya tentang menghindari batas - impor bulanan lebih mudah diverifikasi, lebih mudah direkonsiliasi, dan lebih mudah dipecahkan masalahnya jika terjadi kesalahan.

---

Bagaimana PDFSub Mencegah Kesalahan Ini

Sebagian besar kesalahan impor ini berasal selama langkah konversi PDF ke CSV - bukan selama impor itu sendiri. Alat konversi yang menghasilkan output yang bersih dan terformat dengan benar menghilangkan sebagian besar masalah sebelum dimulai.

Konverter Laporan Bank PDFSub mengatasi setiap sumber kesalahan:

Kesalahan	Cara PDFSub Mencegahnya
Ketidakcocokan format tanggal	Otomatis mendeteksi format tanggal dari templat bank; mengekspor dalam format pilihan Anda
Pemetaan kolom yang salah	Menghasilkan kolom Tanggal, Deskripsi, Jumlah standar
Transaksi duplikat	Menyertakan tanggal transaksi untuk pemfilteran mudah sebelum impor
Kesalahan pengodean	Mengekspor sebagai UTF-8 secara default
Kolom hilang/ekstra	Hanya menghasilkan kolom yang dibutuhkan perangkat lunak akuntansi Anda
Pemformatan jumlah	Angka bersih: tanpa simbol, tanpa pemisah, desimal titik
Baris kosong	Menghapus konten non-transaksi selama ekstraksi
Batas ukuran file	Dapat mengekspor dalam segmen bulanan

Untuk QuickBooks, Anda juga dapat mengekspor langsung ke format QBO, yang melewati masalah pemformatan CSV sepenuhnya. File QBO dipetakan secara otomatis oleh QuickBooks tanpa konfigurasi kolom.

Untuk Xero, ekspor CSV dengan header kolom standar bekerja lancar dengan sistem impor Xero yang fleksibel.

---

Daftar Periksa Pemecahan Masalah Referensi Cepat

Ketika impor gagal, ikuti daftar periksa ini:

• Header: Apakah CSV memiliki header kolom yang jelas di baris 1?
• Format Tanggal: Apakah tanggal cocok dengan lokal perangkat lunak akuntansi Anda?
• Format Jumlah: Hanya angka bersih? Tanpa simbol, pemisah, atau teks?
• Jumlah Kolom: Apakah CSV memiliki jumlah kolom yang tepat?
• Pengodean: Apakah file disimpan sebagai UTF-8?
• Baris Kosong: Ada baris kosong di atas, tengah, atau bawah?
• Jumlah Baris: Di bawah 1.000 transaksi (untuk QuickBooks)?
• Rentang Tanggal: Ada tumpang tindih dengan transaksi umpan bank yang ada?
• Nama File: Pendek dan sederhana (tanpa karakter khusus)?
• Format File: CSV (dipisahkan koma), bukan titik koma atau tab?

Jika Anda telah memverifikasi semua sepuluh item dan impor masih gagal, masalahnya kemungkinan ada pada data mentah itu sendiri - transaksi tertentu dengan karakter atau pemformatan yang tidak biasa yang menyebabkan parser macet. Coba impor hanya 50 baris pertama untuk mengisolasi masalah.

---

Pertanyaan yang Sering Diajukan

Mengapa QuickBooks menolak CSV saya padahal Xero menerimanya?

QuickBooks Online memiliki persyaratan CSV yang lebih ketat daripada Xero. QuickBooks mengharapkan tepat 3 atau 4 kolom, kurang fleksibel tentang format tanggal, dan lebih sensitif terhadap masalah pengodean. Impor Xero memungkinkan lebih banyak kolom (Anda cukup memetakan yang Anda butuhkan) dan menangani lebih banyak variasi format tanggal. Jika CSV Anda berfungsi di Xero tetapi tidak di QuickBooks, periksa jumlah kolom dan format tanggal terlebih dahulu.

Bisakah saya mengimpor file yang sama ke QuickBooks dan Xero?

Ya, jika file tersebut memenuhi persyaratan kedua alat. CSV dengan kolom Tanggal, Deskripsi, dan Jumlah dalam format YYYY-MM-DD, pengodean UTF-8, dan angka bersih akan berfungsi di kedua platform. Ekspor CSV default PDFSub dirancang untuk kompatibilitas lintas platform.

Bagaimana cara mencegah transaksi duplikat saat mengimpor?

Sebelum mengimpor, periksa tanggal mana yang sudah ada di perangkat lunak akuntansi Anda dari umpan bank. Filter CSV Anda untuk menyertakan hanya tanggal di luar rentang umpan. Baik QuickBooks maupun Xero memiliki beberapa deteksi duplikat, tetapi tidak sempurna - pemfilteran tanggal manual sebelum impor lebih andal.

Bagaimana jika hanya beberapa transaksi yang gagal selama impor?

Baik QuickBooks maupun Xero melaporkan baris mana yang dilewati atau gagal. Periksa laporan kesalahan untuk nomor baris tertentu, lalu periksa baris tersebut di CSV Anda. Penyebab umum kegagalan baris individual: tanggal hilang, jumlah non-numerik, atau karakter khusus yang tidak dapat ditangani oleh parser.

Haruskah saya menggunakan format QBO alih-alih CSV untuk QuickBooks?

Jika Anda mengimpor ke QuickBooks, QBO biasanya merupakan pilihan yang lebih baik. QBO adalah format terstruktur yang dibaca QuickBooks tanpa pemetaan kolom, tebakan format tanggal, atau masalah pengodean. Ini termasuk ID transaksi yang membantu mencegah duplikat, dan secara eksplisit menandai transaksi sebagai debit atau kredit. PDFSub dapat mengekspor langsung ke format QBO dari laporan bank PDF.

---

Ringkasan

Kesalahan impor laporan bank di QuickBooks dan Xero hampir selalu disebabkan oleh pemformatan: format tanggal yang salah, struktur kolom yang buruk, masalah pengodean, atau masalah pemformatan jumlah. Kesalahan dapat diperbaiki - setelah Anda mengetahui penyebabnya - tetapi membuang waktu dan menciptakan frustrasi, terutama ketika Anda memproses banyak klien.

Pendekatan yang paling efisien adalah mencegah kesalahan di sumbernya. Konverter Laporan Bank PDFSub mengekstrak transaksi dari laporan PDF dan mengekspornya dalam format yang diterima dengan bersih oleh QuickBooks dan Xero - tanggal yang benar, jumlah yang bersih, pengodean yang tepat, dan struktur kolom yang benar.

Konversi laporan bank ke format QuickBooks atau Xero - lewati pemecahan masalah dan impor data yang bersih.