Co to jest format pliku QBO? Przewodnik dla księgowych

Jeśli poświęciłeś/aś trochę czasu na importowanie transakcji bankowych do QuickBooks, słyszałeś/aś radę: „po prostu użyj formatu QBO”. Każde forum QuickBooks, każda społeczność księgowych, każdy blog księgowy mówi to samo. QBO jest najlepszym rozwiązaniem.

Ale czym właściwie jest plik QBO? To nie jest arkusz kalkulacyjny. To nie jest baza danych. Nie można go otworzyć w Excelu i zobaczyć wierszy i kolumn. Jeśli klikniesz go dwukrotnie, Twój komputer może nawet nie wiedzieć, co z nim zrobić.

Ten przewodnik rozkłada format pliku QBO od środka – co zawiera, jak jest skonstruowany, dlaczego QuickBooks preferuje go nad CSV i jak tworzone są pliki QBO, gdy Twój bank ich nie udostępnia do pobrania.

QBO w jednym zdaniu

Plik QBO to plik danych finansowych oparty na XML, zgodny ze specyfikacją Open Financial Exchange (OFX), dostosowany do QuickBooks. Przechowuje transakcje bankowe w ustrukturyzowanym, czytelnym dla maszyn formacie – wraz z unikalnymi identyfikatorami transakcji, których QuickBooks używa do automatycznego wykrywania duplikatów.

Rozszerzenie .qbo oznacza „QuickBooks Web Connect”. Jest to format pliku zaprojektowany przez Intuit do importowania danych bankowych do QuickBooks bez konieczności połączenia na żywo z bankiem.

Pomyśl o tym tak: jeśli CSV to zwykła lista transakcji w formacie tekstowym, QBO to pakiet samopisujący, który dokładnie mówi QuickBooks, co oznacza każda część danych – które pole to data, które to kwota, które to odbiorca – bez dwuznaczności i bez ręcznego mapowania.

Historia QBO

Historia QBO zaczyna się w 1997 roku, kiedy trzy firmy – Microsoft, Intuit i CheckFree – połączyły siły, aby stworzyć specyfikację Open Financial Exchange (OFX). Cel był prosty: zbudować uniwersalny standard do elektronicznej wymiany danych finansowych między bankami, konsumentami i oprogramowaniem finansowym.

Przed OFX każdy bank i każde oprogramowanie używało własnego, zastrzeżonego formatu. OFX rozwiązał ten problem, definiując jedną strukturę opartą na SGML (później XML), którą każdy zgodny system mógł odczytywać i zapisywać.

Intuit zaadaptował OFX do swoich produktów, tworząc dwa markowe formaty:

• QFX (Quicken Financial Exchange) – do importu do Quicken
• QBO (QuickBooks Web Connect) – do importu do QuickBooks

Oba są zasadniczo plikami OFX z dodanymi tagami metadanych specyficznych dla Intuit – w szczególności INTU.BID, kod identyfikacyjny banku, który informuje oprogramowanie, która instytucja finansowa wygenerowała plik.

Pierwotnie banki generowały pliki QBO bezpośrednio za pośrednictwem swoich portali bankowości internetowej. Klienci logowali się, wybierali „QuickBooks” lub „Web Connect” jako format pobierania i otrzymywali plik .qbo gotowy do importu. Jednak w miarę modernizacji banków i przechodzenia na połączenia oparte na API (Plaid, Yodlee, MX), wiele z nich całkowicie zaprzestało bezpośredniego pobierania plików QBO.

Obecnie mniej banków oferuje eksport QBO. Transakcje nadal istnieją – są po prostu zamknięte w wyciągach PDF. Ta zmiana sprawia, że konwertery QBO są niezbędne w nowoczesnych przepływach pracy księgowej.

Wewnątrz pliku QBO

Otwórz plik QBO w dowolnym edytorze tekstu, a zobaczysz ustrukturyzowany znacznik, który wygląda jak krzyżówka XML i HTML. Oto kompletny, opatrzony adnotacjami przykład:

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>

Przejdźmy przez każdą sekcję.

Blok nagłówka – pierwsze dziewięć linii to nagłówek OFX. Definiują one format danych pliku (OFXSGML), wersję (102), kodowanie (USASCII) i zestaw znaków (1252 dla Windows Latin-1). Ten nagłówek mówi QuickBooks, jak sparsować resztę pliku.

SIGNONMSGSRSV1 – odpowiedź na komunikat logowania. Zawiera znaczniki czasowe serwera (DTSERVER), język (ENG) i informacje o instytucji finansowej (FI). Tag INTU.BID to identyfikator banku Intuit – informuje QuickBooks, z którego banku pochodzi plik i wpływa na logo banku wyświetlane podczas importu.

BANKMSGSRSV1 – zestaw komunikatów bankowych. Opakowuje wszystkie dane konta bankowego. Wyciągi kart kredytowych używają zamiast tego CREDITCARDMSGSRSV1.

STMTRS – odpowiedź na wyciąg. Określa walutę (CURDEF), informacje o koncie (BANKACCTFROM z numerem rozliczeniowym, numerem konta i typem konta) oraz zawiera listę transakcji.

BANKTRANLIST – lista transakcji z zakresem dat (DTSTART i DTEND). Każda pojedyncza transakcja znajduje się w tym bloku jako element STMTTRN.

STMTTRN – pojedyncza transakcja. Każda zawiera typ transakcji, datę, kwotę, unikalny identyfikator (FITID), nazwę odbiorcy i opcjonalny opis oraz numer czeku.

LEDGERBAL – saldo końcowe na koniec okresu wyciągu. QuickBooks używa tego do weryfikacji uzgodnienia.

Kluczowe pola wyjaśnione

Nie wszystkie pola QBO mają równe znaczenie. Oto te, które są najważniejsze – i dlaczego.

Najważniejszym polem jest FITID. Bez unikalnych, spójnych FITID cały system wykrywania duplikatów zawodzi. Każdy FITID musi być unikalny w ramach danego konta bankowego – jeśli dwie transakcje mają ten sam FITID, QuickBooks traktuje je jako tę samą transakcję i cicho pomija drugą.

Dlaczego QBO jest lepszy od CSV dla QuickBooks

Zarówno QBO, jak i CSV mogą przesyłać dane transakcyjne do QuickBooks. Ale doświadczenie jest fundamentalnie inne. Oto porównanie obok siebie:

Wykrywanie duplikatów jest decydującą zaletą. Każda transakcja w pliku QBO zawiera unikalny FITID. QuickBooks przechowuje każdy FITID, który kiedykolwiek przetworzył, w trwałym rejestrze. Jeśli przypadkowo zaimportujesz ten sam plik dwukrotnie – lub zaimportujesz nakładające się zakresy dat z dwóch różnych plików – QuickBooks cicho pomija duplikaty. Żadnych podwójnych wpisów. Żadnego sprzątania.

W przypadku CSV nie ma żadnej ochrony. Zaimportuj ten sam plik dwukrotnie, a każda transakcja zostanie zduplikowana. Nawet nie otrzymasz ostrzeżenia. Czyszczenie tych duplikatów oznacza ręczne usuwanie wpisów jeden po drugim, co jest dokładnie tym żmudnym zadaniem, którego chciałeś/aś uniknąć.

QuickBooks Desktop jest tylko dla QBO. Jeśli pracujesz z QuickBooks Desktop (Pro, Premier lub Enterprise), CSV nie jest nawet opcją importu transakcji bankowych. Web Connect – czyli pliki QBO – to główna ścieżka importu. To samo w sobie czyni QBO niezbędnym dla każdej firmy wspierającej klientów Desktop.

Skąd pochodzą pliki QBO

Istnieją trzy źródła plików QBO, a krajobraz zmienił się dramatycznie w ciągu ostatniej dekady.

Banki (poprzez pobieranie Web Connect). To było pierwotne źródło. Banki generowały pliki QBO bezpośrednio z portali bankowości internetowej. Staje się to coraz rzadsze – w miarę jak banki przechodzą na udostępnianie danych oparte na API, wiele z nich całkowicie usunęło bezpośrednie pobieranie plików. Te, które nadal je oferują, często ograniczają eksport do 90 dni.

Konwertery wyciągów bankowych. To obecnie główne źródło dla większości profesjonalistów księgowych. Narzędzia takie jak PDFSub pobierają PDF-y wyciągów bankowych – format, który każdy bank nadal udostępnia – i konwertują je do prawidłowo ustrukturyzowanych plików QBO z prawidłowym FITID, poprawnym formatowaniem dat i dokładną klasyfikacją obciążeń/uznań. Do księgowości zaległej, zamkniętych kont, banków międzynarodowych i danych historycznych, konwertery są jedyną praktyczną opcją.

Ręczne tworzenie. Teoretycznie można by ręcznie napisać plik QBO w edytorze tekstu. Ale jeden błędny tag, jeden nieprawidłowy FITID, jeden błąd kodowania, a QuickBooks odrzuci plik. Ręczne tworzenie to ostateczność, a nie przepływ pracy.

Odejście od pobierania plików QBO udostępnianych przez banki sprawia, że konwertery stają się niezbędne. Banki Twoich klientów generują wyciągi PDF. QuickBooks potrzebuje plików QBO. Konwerter wypełnia tę lukę.

Jak zaimportować plik QBO do QuickBooks

Proces importu jest prosty – jedna z kluczowych zalet korzystania z QBO zamiast CSV.

QuickBooks Online

1. Przejdź do Bankowość (lub Transakcje, a następnie Transakcje bankowe)
2. Kliknij Połącz konto, a następnie wybierz Prześlij z pliku
3. Przeglądaj swój plik .qbo lub przeciągnij i upuść go
4. QuickBooks odczytuje plik i identyfikuje informacje o koncie
5. Dopasuj plik do istniejącego konta bankowego – lub pozwól QuickBooks utworzyć nowe
6. Przejrzyj sparsowane transakcje w podglądzie
7. Kliknij Gotowe, aby zakończyć import

Transakcje pojawią się w zakładce Do przejrzenia. Stamtąd kategoryzuj każdą transakcję, dopasuj ją do istniejących wpisów lub dodaj do swojej księgowości.

QuickBooks Desktop

1. Przejdź do Plik, a następnie Narzędzia, a następnie Importuj, a następnie Pliki Web Connect
2. Wybierz swój plik .qbo
3. QuickBooks weryfikuje format pliku
4. Dopasuj plik do istniejącego konta bankowego lub utwórz nowe
5. Transakcje pojawią się w oknie Kanały bankowe

Kompleksowy przewodnik ze zrzutami ekranu i rozwiązywaniem problemów znajdziesz w naszym pełnym przewodniku: Jak importować wyciągi bankowe do QuickBooks.

Typowe problemy z QBO i ich rozwiązania

Pliki QBO są niezawodne, ale pewne problemy pojawiają się regularnie. Oto, na co należy zwrócić uwagę.

„Nie można zweryfikować instytucji finansowej”. Tag INTU.BID w pliku nie pasuje do rozpoznanego banku w katalogu Intuit. Jest to kosmetyczne – wpływa na logo banku wyświetlane podczas importu, ale nie uniemożliwia importu transakcji. Zaakceptuj monit i kontynuuj.

Duplikaty FITID powodujące pominięcie transakcji. Jeśli dwie transakcje w tym samym pliku mają ten sam FITID, QuickBooks importuje tylko pierwszą i cicho pomija drugą. Dzieje się tak również wtedy, gdy importujesz plik z FITID, które QuickBooks już widział z poprzedniego importu. Każdy FITID musi być unikalny w ramach danego konta, a raz widziany, jest trwale rejestrowany.

Błędy kodowania i zniekształcone znaki. Znaki spoza ASCII w nazwach odbiorców lub opisach – litery z akcentami, ampersand, nawiasy kątowe – mogą uszkodzić parser SGML. Ampersand musi być zakodowany jako &, a nawiasy kątowe muszą być odpowiednio zamaskowane. Dobrze zbudowany konwerter obsługuje to automatycznie.

Błędy „Nie można odczytać pliku”. Zwykle spowodowane błędnym SGML – brakującym tagiem zamykającym, dodatkowym podziałem wiersza w wartości tagu lub nagłówkiem niezgodnym z formatem ciała. Otwórz plik w edytorze tekstu i sprawdź problemy strukturalne. Wersja nagłówka (VERSION:102) musi pasować do wersji OFX ciała.

Kompatybilność wersji QuickBooks. Wersje QuickBooks Desktop starsze niż trzy lata tracą funkcjonalność Web Connect. Jeśli Twój klient używa QuickBooks Desktop 2022, może w ogóle nie być w stanie importować plików QBO. Rozwiązaniem jest aktualizacja QuickBooks lub przejście na QuickBooks Online.

Karta kredytowa zaimportowana jako konto bankowe. Jeśli wyciąg karty kredytowej jest opakowany w tagi BANKMSGSRSV1 zamiast CREDITCARDMSGSRSV1, QuickBooks tworzy konto jako konto bankowe, a nie kartę kredytową. Plik QBO potrzebuje poprawnego opakowania komunikatów dla typu konta.

QBO vs. QFX vs. OFX: Jaka jest różnica?

Te trzy formaty powodują ciągłe zamieszanie, ponieważ pod maską są prawie identyczne.

Podstawowa struktura transakcji jest identyczna we wszystkich trzech. Możesz zmienić nazwę pliku .ofx na .qbo, a QuickBooks prawie zawsze go odczyta. Tag INTU.BID jest jedynym znaczącym dodatkiem Intuit – kontroluje logo banku wyświetlane podczas importu.

W praktyce: Używaj .qbo dla QuickBooks, .qfx dla Quicken i .ofx dla innych platform księgowych, takich jak Xero lub Wave. Dane transakcyjne wewnątrz są takie same.

Tworzenie plików QBO z PDF-ów wyciągów bankowych

Większość księgowych spotyka się z plikami QBO w jednym kontekście: mają PDF wyciągu bankowego i potrzebują wprowadzić dane do QuickBooks. PDF musi stać się plikiem QBO.

Konwerter wyciągów bankowych PDFSub obsługuje tę konwersję od początku do końca. Prześlij PDF wyciągu bankowego, a PDFSub wyodrębni transakcje – daty, kwoty, opisy, salda bieżące – i wygeneruje poprawnie sformatowany plik QBO z:

• Prawidłowym, unikalnym FITID dla każdej transakcji – dzięki czemu wykrywanie duplikatów QuickBooks działa poprawnie
• Poprawną klasyfikacją TRNTYPE – automatycznie identyfikowane obciążenia, uznania, czeki, wpłaty i przelewy
• Prawidłowym kodowaniem SGML – znaki specjalne zamaskowane, daty w formacie RRRRMMDD, kwoty z poprawnymi znakami
• Metadanymi konta – wykrywanie typu konta (czekowe, oszczędnościowe, karta kredytowa) z odpowiednim opakowaniem komunikatów QBO
• Salda końcowego – tag LEDGERBAL wypełniony saldem końcowym z wyciągu

Konwerter działa z wyciągami z ponad 20 000 banków w 130+ językach. Cyfrowe PDF-y (wyciągi tekstowe) są przetwarzane w całości w Twojej przeglądarce – plik nigdy nie opuszcza Twojego komputera. PDF-y skanowane lub zawierające dużo obrazów wykorzystują ekstrakcję AI po stronie serwera.

Plan All-In-One kosztuje 20 USD/użytkownik/miesiąc (rocznie) lub 25 USD/użytkownik/miesiąc (miesięcznie), obejmując 500 stron wyciągów bankowych na użytkownika. Wszystkie płatne plany obejmują 7-dniowy bezpłatny okres próbny.

Często zadawane pytania

Czy mogę otworzyć plik QBO, aby zobaczyć, co jest w środku?

Tak. Pliki QBO są zwykłym tekstem. Otwórz go w dowolnym edytorze tekstu – Notatnik w systemie Windows, TextEdit na Macu, VS Code lub Sublime Text – a zobaczysz dane transakcji w formacie SGML. Każde pole jest czytelne dla człowieka: daty, kwoty, nazwy odbiorców, FITID, numery kont i saldo końcowe.

Czy plik QBO to to samo co plik OFX?

Niemal identyczne. QBO opiera się na standardzie OFX z dodanymi tagami specyficznymi dla Intuit (głównie INTU.BID do identyfikacji banku). Struktura transakcji, nazwy pól i formatowanie danych są takie same. Możesz zmienić nazwę pliku .ofx na .qbo, a QuickBooks zazwyczaj go zaakceptuje.

Dlaczego QuickBooks pomija niektóre transakcje podczas importu pliku QBO?

QuickBooks śledzi każdy FITID, który kiedykolwiek przetworzył. Jeśli FITID transakcji został wcześniej widziany – z poprzedniego importu lub z kanału bankowego – QuickBooks cicho go pomija, aby zapobiec duplikatom. Jest to funkcja, a nie błąd. Jeśli musisz ponownie zaimportować transakcje, potrzebujesz pliku z nowymi, unikalnymi FITID.

Czy ten sam plik QBO działa zarówno dla QuickBooks Online, jak i Desktop?

Tak. Format pliku QBO jest identyczny dla obu wersji. Proces importu jest inny – Online używa Bankowość, a następnie Prześlij z pliku, podczas gdy Desktop używa Plik, a następnie Narzędzia, a następnie Importuj, a następnie Pliki Web Connect – ale sam plik jest taki sam.

Ile transakcji może zawierać pojedynczy plik QBO?

Specyfikacja OFX nie określa ścisłego limitu. Jednak QuickBooks Online ogranicza przesyłanie plików do około 350 KB, co przekłada się na około 1000-1500 transakcji, w zależności od długości opisów. W przypadku większych importów podziel plik według miesiąca lub kwartału.

Czy mogę utworzyć plik QBO z arkusza CSV lub Excel?

Tak, ale będziesz potrzebować narzędzia do konwersji. Format QBO wymaga specyficznego znacznika SGML, prawidłowego FITID, formatowania dat zgodnego z OFX i odpowiednich informacji nagłówka. Ręczna konwersja jest podatna na błędy. PDFSub i podobne narzędzia automatycznie obsługują formatowanie.

Czy pliki QBO działają z oprogramowaniem księgowym innym niż QuickBooks?

Pliki QBO są przeznaczone głównie dla QuickBooks. Jednak ponieważ QBO opiera się na standardzie OFX, niektóre inne oprogramowania księgowe mogą odczytywać pliki .qbo lub zaakceptują je po zmianie nazwy na .ofx. W przypadku oprogramowania innego niż QuickBooks, takiego jak Xero czy Wave, zalecane jest standardowe rozszerzenie .ofx.

Jaka jest maksymalna długość nazwy odbiorcy w plikach QBO?

Specyfikacja OFX ogranicza pole NAME do 32 znaków, a pole MEMO do 255 znaków, chociaż QuickBooks może obcinać dłuższe opisy podczas wyświetlania. Jeśli nazwa odbiorcy przekracza 32 znaki, zostanie ona obcięta. Dobry konwerter obcina na granicach słów, aby zachować najbardziej użyteczną część opisu.