QBO Dosya Formatı Nedir? Muhasebeciler İçin Bir Rehber
QBO, QuickBooks'in yerel banka ekstresi içe aktarma biçimidir. Bir QBO dosyasının içinde ne olduğunu, nasıl çalıştığını ve neden QuickBooks içe aktarımları için CSV'den daha iyi olduğunu öğrenin.
Tek Cümlede QBO
QBO dosyası, QuickBooks için özelleştirilmiş, Açık Finansal Borsa (OFX) spesifikasyonunu izleyen XML tabanlı bir finansal veri dosyasıdır. Banka işlemlerini yapılandırılmış, makine tarafından okunabilir bir biçimde saklar --- QuickBooks'un otomatik kopya tespiti için kullandığı benzersiz işlem kimlikleriyle birlikte.
.qbo uzantısı "QuickBooks Web Connect" anlamına gelir. Intuit'in, canlı bir banka beslemesi bağlantısı gerektirmeden banka verilerini QuickBooks'a aktarmak için tasarladığı dosya biçimidir.
Bunu şöyle düşünün: CSV işlemleri düz metin listesiyse, QBO, QuickBooks'a verinin her parçasının ne anlama geldiğini tam olarak söyleyen kendi kendini açıklayan bir pakettir --- hangi alanın tarih, hangisinin tutar, hangisinin lehtar olduğunu --- belirsizlik olmadan ve manuel eşleme gerektirmeden.
QBO'nun Arkasındaki Tarihçe
QBO'nun hikayesi, üç şirket olan Microsoft, Intuit ve CheckFree'nin Açık Finansal Borsa (OFX) spesifikasyonunu oluşturmak için bir araya geldiği 1997 yılında başlar. Amaç basitti: bankalar, tüketiciler ve finansal yazılımlar arasında elektronik olarak finansal veri alışverişi için evrensel bir standart oluşturmak.
OFX'ten önce, her banka ve her yazılım paketi kendi özel biçimini kullanıyordu. OFX, uyumlu herhangi bir sistemin okuyup yazabileceği tek bir SGML tabanlı (daha sonra XML tabanlı) yapı tanımlayarak bu sorunu çözdü.
Intuit, OFX'i ürünleri için uyarlayarak iki markalı biçim oluşturdu:
- QFX (Quicken Finansal Borsa) --- Quicken'a aktarma için
- QBO (QuickBooks Web Connect) --- QuickBooks'a aktarma için
Her ikisi de temelde Intuit'e özgü meta veri etiketleri eklenmiş OFX dosyalarıdır --- en önemlisi, yazılıma dosyanın hangi finansal kuruluşu tarafından oluşturulduğunu söyleyen bir banka tanımlayıcı kodu olan INTU.BID.
Başlangıçta, bankalar QBO dosyalarını doğrudan çevrimiçi bankacılık portalları aracılığıyla oluşturuyordu. Müşteriler oturum açar, indirme formatı olarak "QuickBooks" veya "Web Connect"i seçer ve içe aktarmaya hazır bir .qbo dosyası alırdı. Ancak bankalar modernleştikçe ve API tabanlı bağlantılara (Plaid, Yodlee, MX) doğru ilerledikçe, birçoğu doğrudan QBO indirmelerini tamamen kaldırdı.
Bugün, daha az banka QBO dışa aktarma sunuyor. İşlemler hala mevcut --- sadece PDF ifadelerinin içinde kilitli kalmış durumda. Bu değişim, modern muhasebe iş akışları için QBO dönüştürücülerini vazgeçilmez kılıyor.
QBO Dosyasının İçinde
Herhangi bir metin düzenleyicide bir QBO dosyasını açtığınızda, XML ve HTML arasında bir çapraz gibi görünen yapılandırılmış işaretlemeler göreceksiniz. İşte eksiksiz, açıklanmış bir örnek:
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>
Hergün bölümü inceleyelim.
Başlık bloğu --- İlk dokuz satır OFX başlığıdır. Dosyanın veri formatını (OFXSGML), sürümünü (102), kodlamasını (USASCII) ve karakter setini (Windows Latin-1 için 1252) tanımlarlar. Bu başlık, QuickBooks'a dosyanın geri kalanını nasıl ayrıştıracağını söyler.
SIGNONMSGSRSV1 --- Oturum açma mesajı yanıtı. Bu, sunucu zaman damgasını (DTSERVER), dili (ENG) ve finansal kuruluş bilgilerini (FI) içerir. INTU.BID etiketi, Intuit'in banka tanımlayıcısıdır --- QuickBooks'a dosyanın hangi bankadan geldiğini söyler ve içe aktarma sırasında gösterilen banka logosunu etkiler.
BANKMSGSRSV1 --- Bankacılık mesaj seti. Tüm banka hesabı verilerini kapsar. Kredi kartı ekstreleri bunun yerine CREDITCARDMSGSRSV1 kullanır.
STMTRS --- Ekstre yanıtı. Para birimini (CURDEF), hesap bilgilerini (Yönlendirme numarası, hesap numarası ve hesap türü ile BANKACCTFROM) ve işlem listesini içerir.
BANKTRANLIST --- Tarih aralığı (DTSTART ve DTEND) ile işlem listesi. Her bireysel işlem bu blok içinde bir STMTTRN öğesi olarak bulunur.
STMTTRN --- Tek bir işlem. Her biri işlem türünü, tarihi, tutarı, benzersiz bir tanımlayıcıyı (FITID), lehtar adını ve isteğe bağlı bir not ve çek numarasını içerir.
LEDGERBAL --- Ekstre bitiş tarihi itibarıyla kapanış bakiyesi. QuickBooks bunu mutabakat doğrulaması için kullanır.
Anahtar Alanlar Açıklaması
Her QBO alanı eşit derecede önemli değildir. İşte en çok önem taşıyanlar --- ve nedenleri.
| Alan | Açıklama | Örnek | Neden Önemli |
|---|---|---|---|
| FITID | Finansal Kurum İşlem Kimliği | 202601030001 |
Yinelenen içe aktarmaları önleyen benzersiz tanımlayıcı. QuickBooks, şimdiye kadar gördüğü her FITID'yi hatırlar. |
| TRNTYPE | İşlem türü | DEBIT, CREDIT, CHECK, DEP, ATM, POS, XFER |
QuickBooks'a işlemi nasıl sınıflandıracağını söyler. |
| DTPOSTED | İşlem tarihi | 20260103 |
YYYYMMDD formatı --- belirsiz, bölgesel tarih karmaşası yok. |
| TRNAMT | İşlem tutarı | -85.50 |
Borçlar (para çıkışı) için negatif, krediler (para girişi) için pozitif. |
| BANKID | Banka yönlendirme numarası | 021000021 |
Finansal kurumu tanımlar. Hesap eşleştirmesi için kullanılır. |
| ACCTID | Hesap numarası | 123456789 |
İşlemlerin hangi hesaba ait olduğunu tanımlar. |
| ACCTTYPE | Hesap türü | CHECKING, SAVINGS, CREDITLINE |
QuickBooks'un hesabı nasıl kategorize ettiğini belirler. |
| NAME | Lehtar adı | WHOLE FOODS MARKET |
QuickBooks'ta gösterilen işlem açıklaması. Maksimum 32 karakter. |
| MEMO | Ek açıklama | Grocery purchase |
Ek ayrıntı. OFX spesifikasyonunda da 32 karakter ile sınırlıdır. |
| CHECKNUM | Çek numarası | 4521 |
İsteğe bağlı. Çek işlemleri için saklanır, böylece fiziksel çeklerle eşleştirebilirsiniz. |
En kritik alan FITID'dir. Benzersiz, tutarlı FITID'ler olmadan, tüm kopya tespit sistemi çöker. Her FITID, belirli bir banka hesabı içinde benzersiz olmalıdır --- iki işlem aynı FITID'yi paylaşırsa, QuickBooks onları aynı işlem olarak ele alır ve ikinciyi sessizce atlar.
QBO'nun CSV'den QuickBooks İçin Neden Daha İyi Olduğu
Hem QBO hem de CSV, QuickBooks'e işlem verisi aktarabilir. Ancak deneyim temelde farklıdır. İşte yan yana bir karşılaştırma:
| Özellik | QBO | CSV |
|---|---|---|
| Tekil tespit | FITID aracılığıyla otomatik | Yok --- yeniden içe aktarma çoğaltmalara neden olur |
| Sütun eşleştirme | Gerekli değil --- alanlar önceden tanımlanmış | Gerekli --- Tarih, Açıklama, Tutar'ı manuel olarak atarsınız |
| Tarih ayrıştırma | Belirsiz YYYYMMDD formatı | Bölgesel ayarlara bağlı --- MM/GG veya GG/AA kafa karışıklığı |
| Tutar işleme | Açık işaret kuralıyla yapılandırılmış | Para birimi sembollerini kaldırmalı, ondalık ayırıcıları düzeltmeli |
| Hesap tanımlama | Dahili (yönlendirme numarası, hesap numarası, türü) | Dahil değil |
| Bakiye doğrulama | Mutabakat için kapanış bakiyesi dahil | Mevcut değil |
| Çek numaraları | CHECKNUM alanında korunur | Kaybolabilir veya ayrı bir sütun gerektirebilir |
| İçe aktarma iş akışı | Yükle, onayla, bitti | Yükle, sütunları eşleştir, tarih formatını seç, doğrula, onayla |
| QuickBooks Desktop | Web Connect aracılığıyla tam destek | Banka işlem içe aktarmaları için desteklenmez |
Tekil tespit belirleyici avantajdır. Bir QBO dosyasındaki her işlem benzersiz bir FITID taşır. QuickBooks, şimdiye kadar işlediği her FITID'yi kalıcı bir kayıt defterinde saklar. Yanlışlıkla aynı dosyayı iki kez içe aktarırsanız --- veya iki farklı dosyadan örtüşen tarih aralıklarını içe aktarırsanız --- QuickBooks tekilleri sessizce atlar. Çift giriş yok. Temizlik gerekmez.
CSV ile sıfır koruma vardır. Aynı dosyayı iki kez içe aktarırsanız her işlem çoğaltılır. Bir uyarı bile almazsınız. Bu çoğaltmaları temizlemek, tek tek girişleri manuel olarak silmek anlamına gelir, ki bu da kaçınmaya çalıştığınız sıkıcı işin ta kendisidir.
QuickBooks Desktop yalnızca QBO'yu destekler. QuickBooks Desktop (Pro, Premier veya Enterprise) ile çalışıyorsanız, banka işlem içe aktarmaları için CSV bile bir seçenek değildir. Web Connect --- yani QBO dosyaları --- birincil içe aktarma yoludur. Bu tek başına, Desktop müşterilerini destekleyen herhangi bir firma için QBO'yu vazgeçilmez kılar.
QBO Dosyaları Nereden Gelir?
QBO dosyaları için üç kaynak vardır ve manzara son on yılda dramatik bir şekilde değişmiştir.
Bankalar (Web Connect indirmeleri aracılığıyla). Bu orijinal kaynaktı. Bankalar, çevrimiçi bankacılık portallarından doğrudan QBO dosyaları üretiyordu. Bu giderek nadirleşiyor --- bankalar API tabanlı veri paylaşımına doğru ilerledikçe, birçoğu doğrudan dosya indirmelerini tamamen kaldırdı. Hala sunanlar genellikle indirmeleri 90 günle sınırlar.
Banka ekstresi dönüştürücüler. Bu artık çoğu muhasebe profesyoneli için birincil kaynaktır. PDFSub gibi araçlar, PDF banka ekstrelerini --- her bankanın hala sağladığı format --- alır ve bunları geçerli FITID'ler, doğru tarih formatı ve doğru borç/alacak sınıflandırması ile düzgün biçimlendirilmiş QBO dosyalarına dönüştürür. Yakalama muhasebesi, kapalı hesaplar, uluslararası bankalar ve geçmiş veriler için dönüştürücüler tek pratik seçenektir.
Manuel oluşturma. Teorik olarak bir QBO dosyasını bir metin düzenleyicide elle yazabilirsiniz. Ancak tek bir yanlış etiket, tek bir geçersiz FITID, tek bir kodlama hatası ve QuickBooks dosyayı reddeder. Manuel oluşturma bir iş akışı değil, son çaredir.
Bankaların sağladığı QBO indirmelerinden uzaklaşma eğilimi, dönüştürücüleri vazgeçilmez kılar. Müşterilerinizin bankaları PDF ekstreler üretir. QuickBooks'in QBO dosyalarına ihtiyacı vardır. Dönüştürücü bu boşluğu doldurur.
QBO Dosyasını QuickBooks'e Nasıl İçe Aktarılır?
İçe aktarma işlemi basittir --- CSV yerine QBO kullanmanın temel avantajlarından biri budur.
QuickBooks Online
- Bankacılık (veya İşlemler ardından Banka İşlemleri) bölümüne gidin
- Hesap bağla'ya tıklayın, ardından Dosyadan yükle'yi seçin
.qbodosyanız için göz atın veya sürükleyip bırakın- QuickBooks dosyayı okur ve hesap bilgilerini tanımlar
- Dosyayı mevcut bir banka hesabına eşleştirin --- veya QuickBooks'in yeni bir tane oluşturmasına izin verin
- Önizlemedeki ayrıştırılmış işlemleri gözden geçirin
- İçe aktarmayı tamamlamak için Bitti'ye tıklayın
İşlemler İnceleme İçin sekmesinde görünür. Oradan, her işlemi kategorize edin, mevcut girişlerle eşleştirin veya defterinize ekleyin.
QuickBooks Desktop
- Dosya ardından Yardımcı Programlar ardından İçe Aktar ardından Web Bağlantı Dosyaları'na gidin
.qbodosyanızı seçin- QuickBooks dosya formatını doğrular
- Dosyayı mevcut bir banka hesabına eşleştirin veya yeni bir tane oluşturun
- İşlemler Banka Akışları penceresinde görünür
Ekran görüntüleri ve sorun giderme ile eksiksiz bir rehber için tam kılavuzumuza bakın: Banka Ekstrelerini QuickBooks'e İçe Aktarma.
Yaygın QBO Sorunları ve Çözümleri
QBO dosyaları güvenilirdir, ancak belirli sorunlar düzenli olarak ortaya çıkar. İşte dikkat etmeniz gerekenler.
"Finansal kurum doğrulanamıyor." Dosyadaki INTU.BID etiketi, Intuit'in dizinindeki tanınmış bir bankayla eşleşmiyor. Bu kozmetiktir --- içe aktarma sırasında gösterilen banka logosunu etkiler ancak işlemlerin içe aktarılmasını engellemez. İstem'i kabul edin ve devam edin.
Çoğaltılan FITID'ler nedeniyle atlanan işlemler. Aynı dosyadaki iki işlem bir FITID paylaşırsa, QuickBooks yalnızca ilkini içe aktarır ve ikincisini sessizce atlar. Bu, QuickBooks'in daha önce başka bir içe aktarmadan gördüğü FITID'lere sahip bir dosyayı içe aktarırsanız da olur. Her FITID, belirli bir hesap içinde benzersiz olmalı ve görüldükten sonra kalıcı olarak kaydedilir.
Kodlama hataları ve bozuk karakterler. Alıcı adlarındaki veya açıklamalardaki ASCII olmayan karakterler --- aksanlı harfler, ampersandler, açısal parantezler --- SGML ayrıştırıcısını bozabilir. Ampersandler & olarak kodlanmalı ve açısal parantezler kaçırılmalıdır. İyi oluşturulmuş bir dönüştürücü bunu otomatik olarak halleder.
"Dosya okunamıyor" hataları. Genellikle bozuk SGML'den kaynaklanır --- eksik bir kapanış etiketi, bir etiket değeri içinde fazladan satır sonu veya gövde formatıyla eşleşmeyen bir başlık. Yapısal sorunları kontrol etmek için dosyayı bir metin düzenleyicide açın. Başlık sürümü (VERSION:102), gövdenin OFX sürümüyle eşleşmelidir.
QuickBooks sürüm uyumluluğu. Üç yıldan eski QuickBooks Desktop sürümleri Web Connect işlevselliğini kaybeder. Müşteriniz QuickBooks Desktop 2022 kullanıyorsa, QBO dosyalarını hiç içe aktaramayabilir. Çözüm QuickBooks'i yükseltmek veya QuickBooks Online'a geçmektir.
Kredi kartı banka hesabı olarak içe aktarıldı. Bir kredi kartı ekstresi CREDITCARDMSGSRSV1 yerine BANKMSGSRSV1 etiketleriyle sarılmışsa, QuickBooks hesabı kredi kartı yerine banka hesabı olarak oluşturur. QBO dosyasının hesap türü için doğru mesaj sarmalayıcısına ihtiyacı vardır.
QBO vs. QFX vs. OFX: Fark Nedir?
Bu üç format, altta yatan yapıları neredeyse aynı olduğu için sürekli kafa karışıklığına neden olur.
| Format | Uzantı | Temel Aldığı | Hedef Yazılım | Ana Fark |
|---|---|---|---|---|
| OFX | .ofx |
Open Financial Exchange standardı | Evrensel --- Xero, Wave, GnuCash, vb. | Açık standart. Satıcıya özel etiket yok. |
| QBO | .qbo |
OFX + Intuit meta verileri | QuickBooks | QuickBooks'te banka tanımlaması için INTU.BID ekler. |
| QFX | .qfx |
OFX + Intuit meta verileri | Quicken | QBO ile aynı ancak QuickBooks yerine Quicken için tasarlanmıştır. |
Altta yatan işlem yapısı üçü arasında aynıdır. Bir .ofx dosyasını .qbo olarak yeniden adlandırabilirsiniz ve QuickBooks neredeyse her zaman okuyacaktır. INTU.BID etiketi, içe aktarma sırasında gösterilen banka logosunu kontrol eden tek anlamlı Intuit eklemesidir.
Pratikte: QuickBooks için .qbo, Quicken için .qfx ve Xero veya Wave gibi diğer muhasebe platformları için .ofx kullanın. İçindeki işlem verileri aynıdır.
Sıkça Sorulan Sorular
QBO dosyasını içeriğini görmek için açabilir miyim?
Evet. QBO dosyaları düz metindir. İçindeki SGML biçimli işlem verilerini görmek için herhangi bir metin düzenleyicide açın: Windows'ta Not Defteri, Mac'te TextEdit, VS Code veya Sublime Text. Tarihler, tutarlar, lehtar adları, FITID'ler, hesap numaraları ve kapanış bakiyesi gibi her alan okunabilir durumdadır.
QBO dosyası OFX dosyasıyla aynı mıdır?
Neredeyse aynıdır. QBO, Intuit'e özel etiketler (öncelikle banka tanımlaması için INTU.BID) eklenmiş OFX standardına dayanmaktadır. İşlem yapısı, alan adları ve veri biçimlendirmesi aynıdır. .ofx dosyasını .qbo olarak yeniden adlandırırsanız QuickBooks genellikle kabul eder.
QuickBooks bir QBO dosyasını içe aktarırken neden bazı işlemleri atlıyor?
QuickBooks, şimdiye kadar işlediği her FITID'yi takip eder. Bir işlemin FITID'si daha önce (önceki bir içe aktarmadan veya banka akışından) görülmüşse, yinelenmeleri önlemek için QuickBooks sessizce atlar. Bu bir hata değil, bir özelliktir. İşlemleri yeniden içe aktarmanız gerekiyorsa, yeni ve benzersiz FITID'lere sahip bir dosyaya ihtiyacınız olacaktır.
Aynı QBO dosyası hem QuickBooks Online hem de Desktop için çalışır mı?
Evet. QBO dosya biçimi her iki sürüm için de aynıdır. İçe aktarma işlemi farklıdır --- Online, Banking (Bankacılık) ardından Upload from file (Dosyadan yükle) kullanırken, Desktop ise File (Dosya) ardından Utilities (Yardımcı Programlar) ardından Import (İçe Aktar) ardından Web Connect Files (Web Bağlantı Dosyaları) kullanır --- ancak dosyanın kendisi aynıdır.
Tek bir QBO dosyası kaç işlem içerebilir?
OFX spesifikasyonunda kesin bir sınır yoktur. Ancak, QuickBooks Online dosya yüklemelerini yaklaşık 350 KB ile sınırlar, bu da açıklama uzunluklarına bağlı olarak kabaca 1.000 ila 1.500 işlem anlamına gelir. Daha büyük içe aktarmalar için dosyayı ay veya çeyrek bazında bölün.
Bir CSV veya Excel elektronik tablosundan QBO dosyası oluşturabilir miyim?
Evet, ancak bir dönüştürme aracına ihtiyacınız olacaktır. QBO biçimi belirli SGML işaretlemesi, geçerli FITID'ler, OFX uyumlu tarih biçimlendirmesi ve uygun başlık bilgisi gerektirir. Manuel dönüştürme hataya açıktır. PDFSub ve benzeri araçlar biçimlendirmeyi otomatik olarak halleder.
QBO dosyaları QuickBooks dışındaki muhasebe yazılımlarıyla çalışır mı?
QBO dosyaları öncelikle QuickBooks için tasarlanmıştır. Ancak, QBO OFX standardına dayandığı için, diğer bazı muhasebe yazılımları .qbo dosyalarını okuyabilir veya .ofx olarak yeniden adlandırıldıklarında kabul edebilir. Xero veya Wave gibi QuickBooks dışı yazılımlar için standart .ofx uzantısı önerilir.
QBO dosyalarındaki lehtar adları için maksimum karakter uzunluğu nedir?
OFX spesifikasyonu NAME alanı için 32 karakter ve MEMO alanı için 255 karakter ile sınırlar, ancak QuickBooks daha uzun memo değerlerini görüntüleme sırasında kesebilir. Bir lehtar adı 32 karakteri aşarsa, kesilecektir. İyi bir dönüştürücü, açıklamanın en kullanışlı kısmını korumak için kelime sınırlarında kesme yapar.