Apa Itu Format File QBO? Panduan untuk Akuntan
QBO adalah format impor laporan bank asli QuickBooks. Berikut isi file QBO, cara kerjanya, dan mengapa format ini lebih baik daripada CSV untuk impor QuickBooks.
Jika Anda pernah mengimpor transaksi bank ke QuickBooks, Anda pasti pernah mendengar saran: "gunakan saja format QBO." Setiap forum QuickBooks, setiap komunitas pembukuan, setiap blog akuntansi mengatakan hal yang sama. QBO adalah cara yang tepat.
Tetapi apa sebenarnya file QBO itu? Ini bukan spreadsheet. Ini bukan database. Anda tidak dapat membukanya di Excel dan melihat baris dan kolom. Jika Anda mengkliknya dua kali, komputer Anda mungkin bahkan tidak tahu harus berbuat apa dengannya.
Panduan ini menguraikan format file QBO secara mendalam --- apa isinya, bagaimana strukturnya, mengapa QuickBooks lebih menyukainya daripada CSV, dan bagaimana file QBO dibuat ketika bank Anda tidak menawarkannya untuk diunduh.
QBO dalam Satu Kalimat
File QBO adalah file data keuangan berbasis XML yang mengikuti spesifikasi Open Financial Exchange (OFX), yang disesuaikan untuk QuickBooks. File ini menyimpan transaksi bank dalam format terstruktur yang dapat dibaca mesin --- lengkap dengan ID transaksi unik yang digunakan QuickBooks untuk deteksi duplikat otomatis.
Ekstensi .qbo adalah singkatan dari "QuickBooks Web Connect." Ini adalah format file yang dirancang Intuit untuk mengimpor data bank ke QuickBooks tanpa memerlukan koneksi umpan bank langsung.
Pikirkan seperti ini: jika CSV adalah daftar transaksi teks biasa, QBO adalah paket yang menjelaskan dirinya sendiri yang memberi tahu QuickBooks persis apa arti setiap bagian data --- kolom mana yang merupakan tanggal, mana yang merupakan jumlah, mana yang merupakan penerima pembayaran --- tanpa ambiguitas dan tanpa pemetaan manual yang diperlukan.
Sejarah di Balik QBO
Kisah QBO dimulai pada tahun 1997, ketika tiga perusahaan --- Microsoft, Intuit, dan CheckFree --- bersatu untuk menciptakan spesifikasi Open Financial Exchange (OFX). Tujuannya lugas: membangun standar universal untuk pertukaran data keuangan secara elektronik antara bank, konsumen, dan perangkat lunak keuangan.
Sebelum OFX, setiap bank dan setiap paket perangkat lunak menggunakan format kepemilikannya sendiri. OFX memecahkan masalah ini dengan mendefinisikan satu struktur berbasis SGML (kemudian berbasis XML) yang dapat dibaca dan ditulis oleh sistem yang kompatibel.
Intuit mengadaptasi OFX untuk produk mereka, menciptakan dua format bermerek:
- QFX (Quicken Financial Exchange) --- untuk impor ke Quicken
- QBO (QuickBooks Web Connect) --- untuk impor ke QuickBooks
Keduanya pada dasarnya adalah file OFX dengan tag metadata khusus Intuit yang ditambahkan --- terutama INTU.BID, kode pengenal bank yang memberi tahu perangkat lunak institusi keuangan mana yang menghasilkan file tersebut.
Awalnya, bank menghasilkan file QBO langsung melalui portal perbankan online mereka. Pelanggan akan masuk, memilih "QuickBooks" atau "Web Connect" sebagai format unduhan, dan mendapatkan file .qbo siap untuk diimpor. Tetapi ketika bank memodernisasi dan beralih ke koneksi berbasis API (Plaid, Yodlee, MX), banyak yang sepenuhnya menghentikan unduhan QBO langsung.
Saat ini, semakin sedikit bank yang menawarkan ekspor QBO. Transaksi tersebut masih ada --- hanya saja terkunci di dalam laporan PDF. Pergeseran inilah yang membuat konverter QBO penting untuk alur kerja akuntansi modern.
Di Dalam File QBO
Buka file QBO di editor teks apa pun dan Anda akan melihat markup terstruktur yang terlihat seperti gabungan antara XML dan HTML. Berikut adalah contoh lengkap yang dianotasi:
OFXHEADER:100
DATA:OFXSGML
VERSION:102
SECURITY:NONE
ENCODING:USASCII
CHARSET:1252
COMPRESSION:NONE
OLDFILEUID:NONE
NEWFILEUID:NONE
<OFX>
<SIGNONMSGSRSV1>
<SONRS>
<STATUS>
<CODE>0
<SEVERITY>INFO
</STATUS>
<DTSERVER>20260215120000
<LANGUAGE>ENG
<FI>
<ORG>First National Bank
<FID>12345
</FI>
<INTU.BID>12345
</SONRS>
</SIGNONMSGSRSV1>
<BANKMSGSRSV1>
<STMTTRNRS>
<TRNUID>0
<STATUS>
<CODE>0
<SEVERITY>INFO
</STATUS>
<STMTRS>
<CURDEF>USD
<BANKACCTFROM>
<BANKID>021000021
<ACCTID>123456789
<ACCTTYPE>CHECKING
</BANKACCTFROM>
<BANKTRANLIST>
<DTSTART>20260101
<DTEND>20260131
<STMTTRN>
<TRNTYPE>DEBIT
<DTPOSTED>20260103
<TRNAMT>-85.50
<FITID>202601030001
<NAME>WHOLE FOODS MARKET
<MEMO>Grocery purchase
</STMTTRN>
<STMTTRN>
<TRNTYPE>CREDIT
<DTPOSTED>20260115
<TRNAMT>3500.00
<FITID>202601150001
<NAME>ACME CORP PAYROLL
<MEMO>Direct deposit
</STMTTRN>
<STMTTRN>
<TRNTYPE>CHECK
<DTPOSTED>20260120
<TRNAMT>-1200.00
<FITID>202601200001
<CHECKNUM>4521
<NAME>LANDLORD PROPERTIES LLC
<MEMO>January rent
</STMTTRN>
</BANKTRANLIST>
<LEDGERBAL>
<BALAMT>4214.50
<DTASOF>20260131
</LEDGERBAL>
</STMTRS>
</STMTTRNRS>
</BANKMSGSRSV1>
</OFX>
Mari kita bahas setiap bagian.
Blok Header --- Sembilan baris pertama adalah header OFX. Mereka mendefinisikan format data file (OFXSGML), versi (102), pengkodean (USASCII), dan set karakter (1252 untuk Windows Latin-1). Header ini memberi tahu QuickBooks cara mengurai sisa file.
SIGNONMSGSRSV1 --- Respons pesan masuk. Ini berisi stempel waktu server (DTSERVER), bahasa (ENG), dan informasi institusi keuangan (FI). Tag INTU.BID adalah pengenal bank Intuit --- ini memberi tahu QuickBooks bank mana file berasal dan memengaruhi logo bank yang ditampilkan selama impor.
BANKMSGSRSV1 --- Set pesan perbankan. Ini membungkus semua data rekening bank. Laporan kartu kredit menggunakan CREDITCARDMSGSRSV1 sebagai gantinya.
STMTRS --- Respons laporan. Ini menentukan mata uang (CURDEF), informasi rekening (BANKACCTFROM dengan nomor routing, nomor rekening, dan jenis rekening), dan berisi daftar transaksi.
BANKTRANLIST --- Daftar transaksi dengan rentang tanggal (DTSTART dan DTEND). Setiap transaksi individu berada di dalam blok ini sebagai elemen STMTTRN.
STMTTRN --- Satu transaksi. Masing-masing menyertakan jenis transaksi, tanggal, jumlah, pengenal unik (FITID), nama penerima pembayaran, dan memo serta nomor cek opsional.
LEDGERBAL --- Saldo penutupan pada tanggal akhir laporan. QuickBooks menggunakan ini untuk verifikasi rekonsiliasi.
Kolom Penting Dijelaskan
Tidak semua kolom QBO memiliki bobot yang sama. Berikut adalah yang paling penting --- dan alasannya.
| Kolom | Deskripsi | Contoh | Mengapa Penting |
|---|---|---|---|
| FITID | ID Transaksi Institusi Keuangan | 202601030001 |
Pengenal unik yang mencegah impor duplikat. QuickBooks mengingat setiap FITID yang pernah dilihatnya. |
| TRNTYPE | Jenis Transaksi | DEBIT, CREDIT, CHECK, DEP, ATM, POS, XFER |
Memberi tahu QuickBooks cara mengklasifikasikan transaksi. |
| DTPOSTED | Tanggal Transaksi | 20260103 |
Format YYYYMMDD --- tidak ambigu, tidak ada kebingungan tanggal regional. |
| TRNAMT | Jumlah Transaksi | -85.50 |
Negatif untuk debit (uang keluar), positif untuk kredit (uang masuk). |
| BANKID | Nomor Routing Bank | 021000021 |
Mengidentifikasi institusi keuangan. Digunakan untuk pencocokan rekening. |
| ACCTID | Nomor Rekening | 123456789 |
Mengidentifikasi rekening mana transaksi tersebut termasuk. |
| ACCTTYPE | Jenis Rekening | CHECKING, SAVINGS, CREDITLINE |
Menentukan bagaimana QuickBooks mengkategorikan rekening. |
| NAME | Nama Penerima Pembayaran | WHOLE FOODS MARKET |
Deskripsi transaksi yang ditampilkan di QuickBooks. Maksimal 32 karakter. |
| MEMO | Deskripsi Tambahan | Grocery purchase |
Detail tambahan. Juga dibatasi hingga 32 karakter dalam spesifikasi OFX. |
| CHECKNUM | Nomor Cek | 4521 |
Opsional. Dipertahankan untuk transaksi cek sehingga Anda dapat mencocokkan dengan cek fisik. |
Kolom yang paling penting adalah FITID. Tanpa FITID yang unik dan konsisten, seluruh sistem deteksi duplikat akan berantakan. Setiap FITID harus unik dalam rekening bank tertentu --- jika dua transaksi memiliki FITID yang sama, QuickBooks memperlakukannya sebagai transaksi yang sama dan diam-diam melewati yang kedua.
Mengapa QBO Lebih Baik dari CSV untuk QuickBooks
Baik QBO maupun CSV dapat memasukkan data transaksi ke QuickBooks. Tetapi pengalamannya secara fundamental berbeda. Berikut perbandingan berdampingan:
| Fitur | QBO | CSV |
|---|---|---|
| Deteksi duplikat | Otomatis melalui FITID | Tidak ada --- impor ulang menciptakan duplikat |
| Pemetaan kolom | Tidak perlu --- kolom sudah ditentukan | Diperlukan --- Anda secara manual menetapkan Tanggal, Deskripsi, Jumlah |
| Penguraian tanggal | Format YYYYMMDD yang tidak ambigu | Bergantung pada pengaturan regional --- kebingungan MM/DD atau DD/MM |
| Penanganan jumlah | Terstruktur dengan konvensi tanda yang jelas | Harus menghapus simbol mata uang, memperbaiki pemisah desimal |
| Identifikasi rekening | Terpasang (nomor routing, nomor rekening, jenis) | Tidak termasuk |
| Verifikasi saldo | Saldo penutupan disertakan untuk rekonsiliasi | Tidak tersedia |
| Nomor cek | Dipertahankan di kolom CHECKNUM | Mungkin hilang atau memerlukan kolom terpisah |
| Alur kerja impor | Unggah, konfirmasi, selesai | Unggah, petakan kolom, pilih format tanggal, verifikasi, konfirmasi |
| QuickBooks Desktop | Dukungan penuh melalui Web Connect | Tidak didukung untuk impor transaksi bank |
Deteksi duplikat adalah keuntungan yang menentukan. Setiap transaksi dalam file QBO membawa FITID unik. QuickBooks menyimpan setiap FITID yang pernah diprosesnya dalam registri permanen. Jika Anda secara tidak sengaja mengimpor file yang sama dua kali --- atau mengimpor rentang tanggal yang tumpang tindih dari dua file berbeda --- QuickBooks diam-diam melewati duplikatnya. Tidak ada entri ganda. Tidak perlu pembersihan.
Dengan CSV, tidak ada perlindungan sama sekali. Impor file yang sama dua kali dan Anda akan memiliki setiap transaksi yang terduplikasi. Anda bahkan tidak akan mendapatkan peringatan. Membersihkan duplikat tersebut berarti menghapus entri satu per satu secara manual, yang persis seperti pekerjaan membosankan yang ingin Anda hindari.
QuickBooks Desktop hanya mendukung QBO. Jika Anda bekerja dengan QuickBooks Desktop (Pro, Premier, atau Enterprise), CSV bahkan bukan pilihan untuk impor transaksi bank. Web Connect --- yang berarti file QBO --- adalah jalur impor utama. Ini saja membuat QBO penting bagi setiap firma yang mendukung klien Desktop.
Dari Mana File QBO Berasal
Ada tiga sumber untuk file QBO, dan lanskapnya telah bergeser secara dramatis selama dekade terakhir.
Bank (melalui unduhan Web Connect). Ini adalah sumber aslinya. Bank menghasilkan file QBO langsung dari portal perbankan online mereka. Ini menjadi semakin jarang --- karena bank beralih ke berbagi data berbasis API, banyak yang sepenuhnya menghapus unduhan file langsung. Yang masih menawarkannya seringkali membatasi ekspor hingga 90 hari.
Konverter laporan bank. Ini sekarang menjadi sumber utama bagi sebagian besar profesional akuntansi. Alat seperti PDFSub mengambil laporan bank PDF --- format yang masih disediakan oleh setiap bank --- dan mengonversinya menjadi file QBO yang terstruktur dengan benar dengan FITID yang valid, format tanggal yang benar, dan klasifikasi debit/kredit yang akurat. Untuk pembukuan susulan, rekening yang ditutup, bank internasional, dan data historis, konverter adalah satu-satunya pilihan praktis.
Pembuatan manual. Secara teori Anda dapat menulis file QBO secara manual di editor teks. Tetapi satu tag yang salah tempat, satu FITID yang tidak valid, satu kesalahan pengkodean, dan QuickBooks akan menolak file tersebut. Pembuatan manual adalah upaya terakhir, bukan alur kerja.
Pergeseran dari unduhan QBO yang disediakan bank inilah yang membuat konverter sangat diperlukan. Bank klien Anda menghasilkan laporan PDF. QuickBooks membutuhkan file QBO. Konverter menjembatani kesenjangan itu.
Cara Mengimpor File QBO ke QuickBooks
Proses impor cukup mudah --- salah satu keuntungan utama menggunakan QBO daripada CSV.
QuickBooks Online
- Buka Banking (atau Transactions lalu Bank Transactions)
- Klik Link account lalu pilih Upload from file
- Jelajahi file
.qboAnda atau seret dan lepas - QuickBooks membaca file dan mengidentifikasi informasi rekening
- Petakan file ke rekening bank yang ada --- atau biarkan QuickBooks membuat yang baru
- Tinjau transaksi yang diurai di pratinjau
- Klik Done untuk menyelesaikan impor
Transaksi muncul di tab For Review. Dari sana, kategorikan setiap transaksi, cocokkan dengan entri yang ada, atau tambahkan ke pembukuan Anda.
QuickBooks Desktop
- Buka File lalu Utilities lalu Import lalu Web Connect Files
- Pilih file
.qboAnda - QuickBooks memvalidasi format file
- Petakan file ke rekening bank yang ada atau buat yang baru
- Transaksi muncul di jendela Bank Feeds
Untuk panduan lengkap dengan tangkapan layar dan pemecahan masalah, lihat panduan lengkap kami: Cara Mengimpor Laporan Bank ke QuickBooks.
Masalah dan Perbaikan Umum QBO
File QBO dapat diandalkan, tetapi masalah tertentu sering muncul. Berikut adalah hal-hal yang perlu diperhatikan.
"Tidak dapat memverifikasi institusi keuangan." Tag INTU.BID dalam file tidak cocok dengan bank yang dikenali di direktori Intuit. Ini kosmetik --- memengaruhi logo bank yang ditampilkan selama impor tetapi tidak mencegah transaksi diimpor. Terima prompt dan lanjutkan.
FITID duplikat menyebabkan transaksi dilewati. Jika dua transaksi dalam file yang sama berbagi FITID, QuickBooks hanya mengimpor yang pertama dan diam-diam melewati yang kedua. Ini juga terjadi jika Anda mengimpor file dengan FITID yang sudah dilihat QuickBooks dari impor sebelumnya. Setiap FITID harus unik dalam rekening tertentu, dan setelah terlihat, itu dicatat secara permanen.
Kesalahan pengkodean dan karakter rusak. Karakter non-ASCII dalam nama penerima pembayaran atau memo --- huruf beraksen, ampersand, tanda kurung siku --- dapat merusak pengurai SGML. Ampersand harus dikodekan sebagai &, dan tanda kurung siku harus di-escape. Konverter yang dibuat dengan baik menangani ini secara otomatis.
Kesalahan "File tidak dapat dibaca". Biasanya disebabkan oleh SGML yang cacat --- tag penutup yang hilang, baris baru ekstra di dalam nilai tag, atau header yang tidak cocok dengan format isi. Buka file di editor teks dan periksa masalah struktural. Versi header (VERSION:102) harus cocok dengan versi OFX isi.
Kompatibilitas versi QuickBooks. Versi QuickBooks Desktop yang lebih tua dari tiga tahun kehilangan fungsionalitas Web Connect. Jika klien Anda menjalankan QuickBooks Desktop 2022, mereka mungkin tidak dapat mengimpor file QBO sama sekali. Solusinya adalah meningkatkan QuickBooks atau beralih ke QuickBooks Online.
Kartu kredit diimpor sebagai rekening bank. Jika laporan kartu kredit dibungkus dalam tag BANKMSGSRSV1 alih-alih CREDITCARDMSGSRSV1, QuickBooks membuat rekening sebagai rekening bank alih-alih kartu kredit. File QBO membutuhkan pembungkus pesan yang benar untuk jenis rekening.
QBO vs. QFX vs. OFX: Apa Perbedaannya?
Ketiga format ini menyebabkan kebingungan terus-menerus karena secara mendasar hampir identik.
| Format | Ekstensi | Berbasis Pada | Perangkat Lunak Target | Perbedaan Utama |
|---|---|---|---|---|
| OFX | .ofx |
Standar Open Financial Exchange | Universal --- Xero, Wave, GnuCash, dll. | Standar terbuka. Tidak ada tag spesifik vendor. |
| QBO | .qbo |
OFX + metadata Intuit | QuickBooks | Menambahkan INTU.BID untuk identifikasi bank di QuickBooks. |
| QFX | .qfx |
OFX + metadata Intuit | Quicken | Sama seperti QBO tetapi ditujukan untuk Quicken alih-alih QuickBooks. |
Struktur transaksi yang mendasarinya identik di ketiga format tersebut. Anda dapat mengganti nama file .ofx menjadi .qbo dan QuickBooks hampir selalu akan membacanya. Tag INTU.BID adalah satu-satunya tambahan Intuit yang berarti --- ini mengontrol logo bank yang ditampilkan selama impor.
Dalam praktiknya: Gunakan .qbo untuk QuickBooks, .qfx untuk Quicken, dan .ofx untuk platform akuntansi lain seperti Xero atau Wave. Data transaksi di dalamnya sama.
Membuat File QBO dari Laporan Bank PDF
Sebagian besar akuntan menemui file QBO dalam satu konteks: mereka memiliki laporan bank PDF dan perlu memasukkan data ke QuickBooks. PDF perlu menjadi file QBO.
Konverter Laporan Bank PDFSub menangani konversi ini dari awal hingga akhir. Unggah laporan bank PDF, dan PDFSub mengekstrak transaksi --- tanggal, jumlah, deskripsi, saldo berjalan --- dan menghasilkan file QBO yang diformat dengan benar dengan:
- FITID yang valid dan unik untuk setiap transaksi --- sehingga deteksi duplikat QuickBooks berfungsi dengan benar
- Klasifikasi TRNTYPE yang benar --- debit, kredit, cek, deposit, dan transfer diidentifikasi secara otomatis
- Pengkodean SGML yang tepat --- karakter khusus di-escape, tanggal dalam format YYYYMMDD, jumlah dengan tanda yang benar
- Metadata rekening --- deteksi jenis rekening (checking, savings, credit card) dengan pembungkus pesan QBO yang sesuai
- Saldo penutupan --- tag
LEDGERBALdiisi dari saldo akhir laporan
Konverter bekerja dengan laporan dari lebih dari 20.000 bank dalam 130+ bahasa. PDF digital (laporan berbasis teks) diproses sepenuhnya di browser Anda --- file tidak pernah meninggalkan komputer Anda. PDF yang dipindai atau kaya gambar menggunakan ekstraksi AI sisi server.
Paket dimulai dari $10/bulan, dengan konversi laporan bank seharga $29/bulan (Paket Bisnis + add-on BSC, 500 halaman). Semua paket berbayar termasuk uji coba gratis 7 hari.
Pertanyaan yang Sering Diajukan
Bisakah saya membuka file QBO untuk melihat isinya?
Ya. File QBO adalah teks biasa. Buka di editor teks apa pun --- Notepad di Windows, TextEdit di Mac, VS Code, atau Sublime Text --- dan Anda akan melihat data transaksi berformat SGML. Setiap kolom dapat dibaca manusia: tanggal, jumlah, nama penerima pembayaran, FITID, nomor rekening, dan saldo penutupan.
Apakah file QBO sama dengan file OFX?
Hampir identik. QBO didasarkan pada standar OFX dengan tag khusus Intuit ditambahkan (terutama INTU.BID untuk identifikasi bank). Struktur transaksi, nama kolom, dan pemformatan data sama. Anda dapat mengganti nama .ofx menjadi .qbo dan QuickBooks biasanya akan menerimanya.
Mengapa QuickBooks melewati beberapa transaksi saat saya mengimpor file QBO?
QuickBooks melacak setiap FITID yang pernah diprosesnya. Jika FITID transaksi telah terlihat sebelumnya --- dari impor sebelumnya atau dari umpan bank --- QuickBooks diam-diam melewatinya untuk mencegah duplikat. Ini adalah fitur, bukan bug. Jika Anda perlu mengimpor ulang transaksi, Anda memerlukan file dengan FITID baru yang unik.
Apakah file QBO yang sama berfungsi untuk QuickBooks Online dan Desktop?
Ya. Format file QBO identik untuk kedua versi. Proses impor berbeda --- Online menggunakan Banking lalu Upload from file, sedangkan Desktop menggunakan File lalu Utilities lalu Import lalu Web Connect Files --- tetapi filenya sendiri sama.
Berapa banyak transaksi yang dapat ditampung oleh satu file QBO?
Tidak ada batasan keras dalam spesifikasi OFX. Namun, QuickBooks Online membatasi unggahan file hingga sekitar 350 KB, yang setara dengan sekitar 1.000 hingga 1.500 transaksi tergantung pada panjang deskripsi. Untuk impor yang lebih besar, pisahkan file berdasarkan bulan atau kuartal.
Bisakah saya membuat file QBO dari spreadsheet CSV atau Excel?
Ya, tetapi Anda memerlukan alat konversi. Format QBO memerlukan markup SGML tertentu, FITID yang valid, pemformatan tanggal yang sesuai dengan OFX, dan informasi header yang benar. Mengonversi secara manual rawan kesalahan. PDFSub dan alat serupa menangani pemformatan secara otomatis.
Apakah file QBO berfungsi dengan perangkat lunak akuntansi selain QuickBooks?
File QBO terutama dirancang untuk QuickBooks. Namun, karena QBO didasarkan pada standar OFX, beberapa perangkat lunak akuntansi lain dapat membaca file .qbo atau akan menerimanya jika diganti namanya menjadi .ofx. Untuk perangkat lunak non-QuickBooks seperti Xero atau Wave, ekstensi .ofx standar direkomendasikan.
Berapa panjang karakter maksimum untuk nama penerima pembayaran dalam file QBO?
Spesifikasi OFX membatasi kolom NAME hingga 32 karakter dan kolom MEMO hingga 255 karakter, meskipun QuickBooks dapat memotong nilai memo yang lebih panjang saat ditampilkan. Jika nama penerima pembayaran melebihi 32 karakter, nama itu akan terpotong. Konverter yang baik memotong pada batas kata untuk mempertahankan bagian deskripsi yang paling berguna.