Co to jest format pliku QBO? Przewodnik dla księgowych
QBO to natywny format importu wyciągów bankowych QuickBooks. Dowiedz się, co zawiera plik QBO, jak działa i dlaczego jest lepszy od CSV do importu w QuickBooks.
Jeśli poświęciłeś trochę czasu na importowanie transakcji bankowych do QuickBooks, słyszałeś 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 to właściwa droga.
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 na zewnątrz – co zawiera, jak jest ustrukturyzowany, dlaczego QuickBooks preferuje go nad CSV i jak tworzone są pliki QBO, gdy Twój bank nie oferuje ich do pobrania.
QBO w jednym zdaniu
Plik QBO to plik danych finansowych oparty na XML, który jest 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 w ten sposób: jeśli CSV to zwykła lista transakcji w postaci tekstu, 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 niejednoznaczności i 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 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 dostosował 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 specyficznymi dla Intuit – w szczególności INTU.BID, kod identyfikatora 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. Ale 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 QBO.
Dziś mniej banków oferuje eksport QBO. Transakcje nadal istnieją – są po prostu zablokowane 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. Definiuje 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 sygnaturę czasową 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 indywidualna transakcja znajduje się w tym bloku jako element STMTTRN.
STMTTRN – pojedyncza transakcja. Każda z nich zawiera typ transakcji, datę, kwotę, unikalny identyfikator (FITID), nazwę odbiorcy oraz opcjonalne pole na notatkę i numer czeku.
LEDGERBAL – saldo końcowe na dzień zakończenia 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 mają największe znaczenie – i dlaczego.
| Pole | Opis | Przykład | Dlaczego to ważne |
|---|---|---|---|
| FITID | Identyfikator transakcji instytucji finansowej | 202601030001 |
Unikalny identyfikator zapobiegający duplikatom importu. QuickBooks pamięta każdy FITID, który kiedykolwiek widział. |
| TRNTYPE | Typ transakcji | DEBIT, CREDIT, CHECK, DEP, ATM, POS, XFER |
Mówi QuickBooks, jak sklasyfikować transakcję. |
| DTPOSTED | Data transakcji | 20260103 |
Format RRRRMMDD – jednoznaczny, brak regionalnych nieporozumień co do dat. |
| TRNAMT | Kwota transakcji | -85.50 |
Ujemna dla obciążeń (pieniądze wychodzące), dodatnia dla uznania (pieniądze przychodzące). |
| BANKID | Numer rozliczeniowy banku | 021000021 |
Identyfikuje instytucję finansową. Używany do dopasowywania kont. |
| ACCTID | Numer konta | 123456789 |
Identyfikuje, do którego konta należą transakcje. |
| ACCTTYPE | Typ konta | CHECKING, SAVINGS, CREDITLINE |
Określa, jak QuickBooks kategoryzuje konto. |
| NAME | Nazwa odbiorcy | WHOLE FOODS MARKET |
Opis transakcji wyświetlany w QuickBooks. Maksymalnie 32 znaki. |
| MEMO | Dodatkowy opis | Grocery purchase |
Dodatkowe szczegóły. Również ograniczone do 32 znaków w specyfikacji OFX. |
| CHECKNUM | Numer czeku | 4521 |
Opcjonalne. Zachowane dla transakcji czekowych, aby można było dopasować do fizycznych czeków. |
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 po cichu pomija drugą.
Dlaczego QBO jest lepszy od CSV dla QuickBooks
Zarówno QBO, jak i CSV mogą wprowadzać dane transakcji do QuickBooks. Ale doświadczenie jest fundamentalnie inne. Oto porównanie obok siebie:
| Funkcja | QBO | CSV |
|---|---|---|
| Wykrywanie duplikatów | Automatyczne przez FITID | Brak – ponowny import tworzy duplikaty |
| Mapowanie kolumn | Niepotrzebne – pola są predefiniowane | Wymagane – ręcznie przypisujesz datę, opis, kwotę |
| Parsowanie dat | Jednoznaczny format RRRRMMDD | Zależy od ustawień regionalnych – mylące MM/DD lub DD/MM |
| Obsługa kwot | Ustrukturyzowane z jasną konwencją znaków | Należy usunąć symbole walut, poprawić separatory dziesiętne |
| Identyfikacja konta | Wbudowana (numer rozliczeniowy, numer konta, typ) | Brak |
| Weryfikacja salda | Saldo końcowe zawarte do uzgodnienia | Niedostępne |
| Numery czeków | Zachowane w polu CHECKNUM | Mogą zostać utracone lub wymagać osobnej kolumny |
| Przepływ pracy importu | Prześlij, potwierdź, gotowe | Prześlij, mapuj kolumny, wybierz format daty, zweryfikuj, potwierdź |
| QuickBooks Desktop | Pełne wsparcie przez Web Connect | Nieobsługiwane dla importu transakcji bankowych |
Wykrywanie duplikatów to decydująca zaleta. 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 po cichu pomija duplikaty. Żadnych podwójnych wpisów. Żadnego sprzątania.
W przypadku CSV nie ma żadnej ochrony. Zaimportuj ten sam plik dwukrotnie, a będziesz miał zduplikowane wszystkie transakcje. Nawet nie otrzymasz ostrzeżenia. Czyszczenie tych duplikatów oznacza ręczne usuwanie wpisów jeden po drugim, co jest dokładnie tym rodzajem żmudnej pracy, której próbowałeś 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 drastycznie się zmienił w ciągu ostatniej dekady.
Banki (przez 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 teraz 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 na poprawnie ustrukturyzowane pliki QBO z prawidłowym FITID, poprawnym formatowaniem dat i dokładną klasyfikacją obciążeń/uznań. W przypadku księgowości zaległości, zamkniętych kont, banków międzynarodowych i danych historycznych, konwertery są jedyną praktyczną opcją.
Ręczne tworzenie. Teoretycznie można by napisać plik QBO ręcznie w edytorze tekstu. Ale jeden źle umieszczony tag, jeden nieprawidłowy FITID, jeden błąd kodowania, a QuickBooks odrzuci plik. Ręczne tworzenie jest ostatecznością, a nie przepływem pracy.
Odejście od pobierania plików QBO dostarczanych 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
- Przejdź do Bankowość (lub Transakcje, a następnie Transakcje bankowe)
- Kliknij Połącz konto, a następnie wybierz Prześlij z pliku
- Przeglądaj swój plik
.qbolub przeciągnij i upuść go - QuickBooks odczyta plik i zidentyfikuje informacje o koncie
- Dopasuj plik do istniejącego konta bankowego – lub pozwól QuickBooks utworzyć nowe
- Przejrzyj sparsowane transakcje w podglądzie
- 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 swoich ksiąg.
QuickBooks Desktop
- Przejdź do Plik, a następnie Narzędzia, a następnie Importuj, a następnie Pliki Web Connect
- Wybierz swój plik
.qbo - QuickBooks zweryfikuje format pliku
- Dopasuj plik do istniejącego konta bankowego lub utwórz nowe
- Transakcje pojawią się w oknie Kanały bankowe
Kompletny 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 zwracać uwagę.
„Nie można zweryfikować instytucji finansowej”. Tag INTU.BID w pliku nie pasuje do rozpoznawalnego 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ą wspólny FITID, QuickBooks importuje tylko pierwszą i po cichu pomija drugą. Dzieje się tak również, jeśli zaimportujesz 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 zapisywany.
Błędy kodowania i zniekształcone znaki. Znaki spoza ASCII w nazwach odbiorców lub notatkach – litery z akcentami, ampersandy, nawiasy kątowe – mogą zepsuć parser SGML. Ampersandy muszą być zakodowane jako &, a nawiasy kątowe muszą być ucieczką. Dobrze zbudowany konwerter obsługuje to automatycznie.
Błędy „Nie można odczytać pliku”. Zazwyczaj spowodowane błędnym SGML – brakującym tagiem zamykającym, dodatkowym podziałem wiersza w wartości tagu lub nagłówkiem, który nie pasuje do formatu 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 z karty kredytowej jest opakowany w tagi BANKMSGSRSV1 zamiast CREDITCARDMSGSRSV1, QuickBooks tworzy konto jako konto bankowe, a nie kartę kredytową. Plik QBO potrzebuje odpowiedniego 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.
| Format | Rozszerzenie | Oparte na | Oprogramowanie docelowe | Kluczowa różnica |
|---|---|---|---|---|
| OFX | .ofx |
Standard Open Financial Exchange | Uniwersalny – Xero, Wave, GnuCash itp. | Otwarty standard. Brak tagów specyficznych dla dostawcy. |
| QBO | .qbo |
OFX + metadane Intuit | QuickBooks | Dodaje INTU.BID do identyfikacji banku w QuickBooks. |
| QFX | .qfx |
OFX + metadane Intuit | Quicken | Tak samo jak QBO, ale przeznaczone dla Quicken zamiast QuickBooks. |
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 czy Wave. Dane transakcji 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 muszą 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 w QuickBooks działa poprawnie
- Poprawną klasyfikacją TRNTYPE – automatycznie identyfikowane obciążenia, uznania, czeki, wpłaty i przelewy
- Prawidłowym kodowaniem SGML – znaki specjalne ucieczkowe, 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
LEDGERBALwypełniony saldem końcowym z wyciągu
Konwerter działa z wyciągami z ponad 20 000 banków w ponad 130 językach. Cyfrowe pliki PDF (wyciągi tekstowe) są przetwarzane w całości w Twojej przeglądarce – plik nigdy nie opuszcza komputera. Skanowane lub zawierające dużo obrazów pliki PDF wykorzystują ekstrakcję AI po stronie serwera.
Pakiety zaczynają się od 10 USD/miesiąc, z konwersją wyciągów bankowych za 29 USD/miesiąc (plan Business + dodatek BSC, 500 stron). 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?
Prawie identyczne. QBO jest oparty 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ł już wcześniej widziany – z poprzedniego importu lub z kanału bankowego – QuickBooks po cichu go pomija, aby zapobiec duplikatom. To funkcja, a nie błąd. Jeśli chcesz 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 się różni – 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?
Nie ma twardego limitu w specyfikacji OFX. Jednak QuickBooks Online ogranicza przesyłanie plików do około 350 KB, co przekłada się na około 1000 do 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 kalkulacyjnego 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 prawidłowych 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 jest oparty 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 notatki podczas wyświetlania. Jeśli nazwa odbiorcy przekracza 32 znaki, zostanie obcięta. Dobry konwerter obcina na granicach słów, aby zachować najbardziej użyteczną część opisu.