Co to jest format OFX? Wyjaśnienie Open Financial Exchange

Twoje oprogramowanie księgowe prosi o plik OFX. Twój bank dostarczył Ci plik PDF. A teraz wpatrujesz się w format, o którym nigdy nie słyszałeś, zastanawiając się, dlaczego zwykły arkusz kalkulacyjny nie wystarczy.

OFX – Open Financial Exchange – to niewidoczny standard, który napędza nowoczesne oprogramowanie finansowe. Dzięki niemu Xero może importować transakcje bankowe bez konieczności mapowania kolumn. Dzięki niemu GnuCash potrafi wykrywać duplikaty. I to on stanowi podstawę formatu QBO w QuickBooks.

Ten poradnik wyjaśnia, czym właściwie jest OFX, co zawiera, jak wypada w porównaniu z CSV i QBO, jakie oprogramowanie go obsługuje i jak tworzyć pliki OFX z PDF-ów wyciągów bankowych.

OFX w jednym zdaniu

Open Financial Exchange to format danych oparty na XML służący do wymiany informacji finansowych między instytucjami finansowymi, aplikacjami oprogramowania i użytkownikami końcowymi. Jest to otwarty standard, na którym oparty jest format QBO firmy Intuit – i format, który większość oprogramowania księgowego spoza QuickBooks preferuje do importu transakcji bankowych.

Pomyśl o OFX jak o lingua franca danych finansowych. Banki nim mówią. Oprogramowanie księgowe go czyta. I w przeciwieństwie do CSV – który jest tylko wierszami i kolumnami bez żadnego znaczenia – OFX zawiera ustrukturyzowane metadane, które mówią odbierającemu oprogramowaniu dokładnie, co reprezentuje każda część danych.

Historia OFX

OFX powstał w 1997 roku, stworzony przez Microsoft, Intuit i CheckFree. Każda z firm miała swój własny, konkurencyjny standard – Microsoft miał OFC (Open Financial Connectivity), Intuit swój własny format wymiany, a CheckFree swoje protokoły rozliczeń elektronicznych. OFX był kompromisem, który je zjednoczył.

Oś czasu wersji

• OFX 1.0 (1997) – Oryginalna specyfikacja, oparta na SGML (Standard Generalized Markup Language). SGML pozwala na niezamknięte tagi, co sprawia, że pliki OFX 1.x wyglądają inaczej niż nowoczesny XML.
• OFX 1.6 (2002) – Najszerzej wdrożona wersja. Nadal oparta na SGML. Większość banków oferujących pobieranie plików OFX generuje pliki 1.6.
• OFX 2.0 (2005) – Duża przepustka. Przejście z SGML na właściwy XML z zamkniętymi tagami.
• OFX 2.2 (2016) – Ulepszenia bezpieczeństwa i lepsza obsługa transakcji inwestycyjnych.
• OFX 2.3 (Aktualna) – Najnowsza wersja, utrzymywana przez Financial Data Exchange (FDX), konsorcjum branżowe, które przejęło zarządzanie od pierwotnych założycieli.

Przejście z SGML na XML ma znaczenie, ponieważ wpływa na parsowanie. Plik wersji 1.x używa niezamkniętych tagów (<TRNTYPE>DEBIT bez </TRNTYPE>), podczas gdy wersja 2.x używa poprawnego XML z zamkniętymi tagami. Większość nowoczesnych parserów obsługuje oba formaty, ale rozbieżności wersji pozostają częstym błędem importu OFX.

Co może zawierać OFX

OFX to nie tylko format wyciągu bankowego. Specyfikacja obejmuje szeroki zakres danych finansowych:

• Wyciągi z kont bankowych – Transakcje na kontach bieżących, oszczędnościowych i pieniężnych. Najczęstszy przypadek użycia.
• Wyciągi z kart kredytowych – Historia transakcji z obsługą kodów kategorii sprzedawców i szczegółów zakupu.
• Wyciągi inwestycyjne i maklerskie – Zakupy akcji, wypłaty dywidend, przelewy funduszy i pozycje portfelowe z danymi o kosztach nabycia na poziomie partii.
• Informacje o płatnościach rachunków – Listy odbiorców płatności, zaplanowane płatności i potwierdzenia płatności.
• Informacje podatkowe – Formularze 1099 i inne dokumenty podatkowe przesyłane między instytucjami finansowymi a oprogramowaniem podatkowym.
• Wyciągi z pożyczek – Zapisy transakcji i informacje o saldzie kredytów hipotecznych, samochodowych i osobistych.

Dla większości księgowych i biegłych rewidentów OFX oznacza jedno: importowanie transakcji bankowych i kart kredytowych do oprogramowania księgowego bez mapowania kolumn ani zgadywania formatu daty.

Wewnątrz pliku OFX

Oto jak wygląda kompletny plik wyciągu bankowego OFX 1.6. Jest to format, z którym będziesz się najczęściej spotykać – wersja oparta na SGML, którą generuje większość banków i narzędzi konwersji:

OFXHEADER:100
DATA:OFXSGML
VERSION:160
SECURITY:NONE
ENCODING:USASCII
CHARSET:1252
COMPRESSION:NONE
OLDFILEUID:NONE
NEWFILEUID:NONE
 
<OFX> <SIGNONMSGSRSV1> <SONRS> <STATUS> <CODE>0 <SEVERITY>INFO </STATUS> <DTSERVER>20260228120000 <LANGUAGE>ENG </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>20260201120000 <DTEND>20260228120000 <STMTTRN> <TRNTYPE>CREDIT <DTPOSTED>20260201120000 <TRNAMT>3500.00 <FITID>20260201001 <NAME>DIRECT DEP PAYROLL <MEMO>ACME CORP PAYROLL </STMTTRN> <STMTTRN> <TRNTYPE>DEBIT <DTPOSTED>20260203120000 <TRNAMT>-87.50 <FITID>20260203001 <NAME>POS PURCHASE GROCERY <MEMO>WHOLE FOODS #10847 </STMTTRN> <STMTTRN> <TRNTYPE>CHECK <DTPOSTED>20260210120000 <TRNAMT>-1200.00 <FITID>20260210001 <NAME>CHECK 1045 <CHECKNUM>1045 </STMTTRN> </BANKTRANLIST> <LEDGERBAL> <BALAMT>4712.50 <DTASOF>20260228120000 </LEDGERBAL> <AVAILBAL> <BALAMT>4712.50 <DTASOF>20260228120000 </AVAILBAL> </STMTRS> </STMTTRNRS> </BANKMSGSRSV1>
</OFX>

Anatomia pliku

Plik ma trzy główne sekcje:

1. Blok nagłówka – Linie zwykłego tekstu na górze (przed <OFX>) deklarują wersję OFX, kodowanie i ustawienia bezpieczeństwa. To nie jest XML – to prosty nagłówek klucz-wartość, który parser odczytuje przed przetworzeniem treści SGML/XML.

2. Odpowiedź na logowanie (SIGNONMSGSRSV1) – Dane uwierzytelniające i metadane serwera. CODE równy 0 oznacza sukces. Większość importowanych plików używa tutaj wartości zastępczych.

3. Odpowiedź na wyciąg (BANKMSGSRSV1) – Właściwe dane finansowe:

• BANKACCTFROM – Konto, do którego należą transakcje (numer rozliczeniowy, numer konta, typ konta)
• BANKTRANLIST – Lista transakcji, ograniczona datą początkową i końcową
• STMTTRN – Poszczególne rekordy transakcji
• LEDGERBAL i AVAILBAL – Salda końcowe i dostępne na określoną datę

Zwróć uwagę na składnię SGML: tagi takie jak <TRNTYPE>CREDIT nie mają zamknięcia </TRNTYPE>. Parser wnioskuje koniec wartości na podstawie początku następnego tagu – poprawny SGML, ale niepoprawny XML, dlatego OFX 2.x dodał zamknięte tagi.

Kluczowe tagi OFX

Oto tabela referencyjna tagów, z którymi najczęściej będziesz się spotykać w plikach OFX z wyciągami bankowymi:

FITID – Dlaczego jest ważny

FITID (Financial Institution Transaction ID) to najważniejszy tag w pliku OFX z punktu widzenia księgowości. Jest to unikalny identyfikator przypisany do każdej transakcji, który umożliwia wykrywanie duplikatów.

Kiedy importujesz plik OFX do Xero, GnuCash lub innego kompatybilnego oprogramowania, zapisuje ono każdy napotkany FITID. Ponowny import tego samego pliku powoduje, że oprogramowanie sprawdza każdy FITID w swojej bazie danych, cicho pomijając duplikaty.

To główna zaleta OFX nad CSV. W przypadku CSV nie ma unikalnego identyfikatora – ponowny import tego samego pliku spowoduje podwójne wpisy do ręcznego poprawienia.

OFX vs CSV

Oba formaty mogą przenieść transakcje bankowe do oprogramowania księgowego. OFX wygrywa strukturą; CSV wygrywa elastycznością.

Dlaczego OFX jest lepszy do importu księgowego

Sam format daty oszczędza godziny rozwiązywania problemów. W przypadku CSV 01/02/2026 jest niejednoznaczne – 1 lutego czy 2 stycznia? OFX eliminuje to za pomocą RRRRMMDDGGMMSS. 20260201120000 to zawsze 1 lutego 2026 roku.

Kiedy CSV jest lepszym wyborem

CSV ma uzasadnione zalety:

• Edycja danych – Możesz otworzyć plik CSV w Excelu, poprawić błędy, dodać kategoryzacje i ponownie zapisać. Pliki OFX wymagają edytora tekstu i znajomości struktury tagów.
• Analiza w Excelu – Jeśli potrzebujesz uruchomić formuły, tabele przestawne lub wykresy na danych transakcyjnych, CSV jest naturalnym formatem pośrednim.
• Przetwarzanie niestandardowe – Skrypty programistyczne i potoki danych łatwiej przetwarzają CSV niż zagnieżdżoną strukturę tagów OFX.
• Uniwersalna kompatybilność – Każda aplikacja odczytująca dane tabelaryczne odczytuje CSV. Nie każda aplikacja odczytuje OFX.

Praktyczna rada: używaj OFX do importu do oprogramowania księgowego, a CSV do wszystkiego innego.

OFX vs QBO

To pytanie, które najbardziej myli większość ludzi – a odpowiedź jest prostsza, niż można by się spodziewać.

QBO (QuickBooks Web Connect) to OFX z innym rozszerzeniem pliku i kilkoma tagami specyficznymi dla Intuit. Podstawowa struktura danych jest identyczna. Plik QBO to plik OFX, który QuickBooks rozpoznaje jako swój własny.

Kluczowe różnice

Tag INTU.BID to główny dodatek Intuit – kod identyfikatora banku, który informuje QuickBooks, z której instytucji finansowej pochodzi plik, umożliwiając automatyczne dopasowanie do właściwego konta bankowego podczas importu.

W praktyce możesz zmienić nazwę pliku .ofx na .qbo, a QuickBooks zazwyczaj go odczyta. W drugą stronę również działa – większość oprogramowania odczytującego OFX przetworzy plik .qbo. Ale dla czystych importów używaj formatu, którego oczekuje każda aplikacja.

Istnieje również QFX (Quicken Financial Exchange) – ta sama podstawa OFX, inna marka, inne rozszerzenie pliku, skierowane do Quicken.

Oprogramowanie obsługujące OFX

OFX cieszy się szerokim wsparciem w oprogramowaniu księgowym i finansowym:

Xero (Preferowany format)

Xero wyraźnie zaleca OFX zamiast CSV do ręcznego importu wyciągów bankowych. Pliki OFX są automatycznie mapowane bez konfiguracji kolumn, zawierają wykrywanie duplikatów oparte na FITID i przenoszą metadane konta.

Aby zaimportować: Przejdź do Księgowość > Konta bankowe, wybierz konto, kliknij Zarządzaj kontem > Importuj wyciąg i wybierz plik .ofx. Maksymalnie 1000 transakcji na plik.

MYOB (Pełne wsparcie)

MYOB akceptuje OFX do importu kanałów bankowych. Proces jest podobny do Xero – prześlij plik na odpowiednie konto bankowe, a transakcje pojawią się w kanale bankowym do dopasowania i kategoryzacji.

GnuCash (Darmowy, Open Source)

GnuCash ma wbudowany import OFX za pośrednictwem biblioteki libofx. Jest to jedna z najlepszych darmowych opcji przetwarzania plików OFX.

Aby zaimportować: Przejdź do Plik > Importuj > Importuj OFX/QFX, wybierz plik i dopasuj go do właściwego konta. Wykrywanie duplikatów w GnuCash wykorzystuje FITID, aby zapobiec podwójnym wpisom.

Inne kompatybilne oprogramowanie

• Wave – Darmowe oprogramowanie księgowe z obsługą importu OFX
• Sage Business Cloud – Akceptuje OFX do importu transakcji bankowych
• FreeAgent – Obsługuje przesyłanie plików OFX i QIF
• Moneydance – Oprogramowanie finansowe dla użytkowników indywidualnych z bezpośrednim połączeniem OFX i importem plików
• KMyMoney – Menedżer finansowy dla użytkowników indywidualnych typu open-source z obsługą OFX przez libofx
• Microsoft Money – Wycofane, ale nadal używane przez niektórych; wbudowana obsługa OFX była jedną z jego kluczowych funkcji
• Reckon (Australia) – Akceptuje pliki OFX w swoim przepływie pracy importu kanałów bankowych

QuickBooks jest godnym uwagi wyjątkiem – preferuje swoją wariantową markę QBO i działa bardziej niezawodnie z plikami .qbo, które zawierają identyfikator INTU.BID.

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

Większość banków nie oferuje bezpośredniego pobierania plików OFX. Dostarczają PDF – sformatowany do druku, a nie do wymiany danych. Niektóre oferują eksport CSV dla ostatnich transakcji (zazwyczaj z ostatnich 90 dni), ale dla danych historycznych, zamkniętych kont lub banków bez opcji cyfrowego eksportu, jesteś zdany na PDF-y.

Konwerter wyciągów bankowych PDFSub wyodrębnia transakcje z PDF-ów wyciągów bankowych i generuje poprawne pliki OFX z odpowiednią strukturą. Wynik zawiera unikalne identyfikatory FITID dla każdej transakcji, poprawne formatowanie daty RRRRMMDD, kwoty ze znakiem i odpowiednie typy transakcji oraz metadane konta – wszystko, czego potrzebuje oprogramowanie księgowe do czystego importu.

Konwerter działa z wyciągami z ponad 20 000 banków w ponad 130 językach. Cyfrowe PDF-y (wyciągi tekstowe) są przetwarzane w przeglądarce – plik nigdy nie opuszcza Twojego urządzenia. Wyciągi skanowane lub zawierające dużo obrazów są przetwarzane za pomocą ekstrakcji 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), w tym 500 stron wyciągów bankowych na użytkownika. Wszystkie płatne plany obejmują 7-dniowy bezpłatny okres próbny. Szczegółowy przewodnik po imporcie uzyskanych plików OFX do Xero można znaleźć w poradniku importu wyciągów bankowych do Xero.

Typowe problemy z OFX i jak je rozwiązać

Pliki OFX są ustrukturyzowane, ale nie są nieomylne. Oto najczęstsze problemy i sposoby ich rozwiązania:

1. Nieprawidłowa składnia XML/SGML

Objaw: Oprogramowanie odrzuca plik z błędem parsowania.

Przyczyna: Nieprawidłowe tagi, brakujące tagi zamykające (w plikach 2.x) lub niedozwolone znaki w opisach. Amperzandy (&) są najczęstszym winowajcą – muszą być zakodowane jako & w XML, ale często pozostają surowe w nazwach takich jak „AT&T”.

Rozwiązanie: Otwórz plik w edytorze tekstu i zamień surowe & na &. Sprawdź również brakujące tagi zamykające, jeśli plik jest w wersji 2.x.

2. Brakujące lub zduplikowane FITID

Objaw: Import tworzy zduplikowane transakcje lub oprogramowanie zgłasza brakujące identyfikatory.

Przyczyna: Niektóre narzędzia konwersji generują ten sam FITID dla każdej transakcji (np. 0 lub 1) lub całkowicie pomijają tag.

Rozwiązanie: Każdy FITID musi być unikalny w pliku. Powszechnym wzorcem jest połączenie daty i sekwencyjnego licznika: 20260215001, 20260215002 itd. Edytuj zastępcze FITID w edytorze tekstu przed importem.

3. Nieprawidłowy format daty

Objaw: Transakcje pojawiają się w niewłaściwych datach lub oprogramowanie pokazuje daty z 1900 lub 2099 roku.

Przyczyna: Wartość DTPOSTED nie jest zgodna z formatem RRRRMMDDGGMMSS. RRRRMMDD (bez czasu) jest w porządku, ale DD/MM/RRRR lub MM-DD-RRRR spowoduje błędy parsowania.

Rozwiązanie: Upewnij się, że wszystkie wartości DTPOSTED używają formatu RRRRMMDD lub RRRRMMDDGGMMSS. Zarówno 20260215, jak i 20260215120000 są poprawne.

4. Problemy z kodowaniem znaków

Objaw: Opisy transakcji pokazują zniekształcone znaki, znaki zapytania lub brakujące akcenty.

Przyczyna: Nagłówek pliku deklaruje jedno kodowanie (zazwyczaj USASCII lub UTF-8), ale rzeczywista zawartość używa innego kodowania. Jest to szczególnie częste w przypadku międzynarodowych wyciągów bankowych zawierających znaki spoza ASCII.

Rozwiązanie: Zmień nagłówek ENCODING na zgodny z rzeczywistym kodowaniem pliku. W przypadku międzynarodowych wyciągów ze znakami diakrytycznymi UTF-8 jest najbezpieczniejszym wyborem. Niektóre starsze oprogramowania wymagają USASCII bez znaków specjalnych.

5. Kompatybilność wersji (1.x vs 2.x)

Objaw: Oprogramowanie oczekujące OFX 2.x odrzuca plik 1.x lub odwrotnie.

Przyczyna: OFX 1.x używa SGML (tagi nie muszą być zamykane), podczas gdy 2.x używa poprawnego XML (wszystkie tagi muszą być otwarte i zamknięte). Parsery zbudowane dla jednej wersji mogą mieć problemy z drugą.

Rozwiązanie: Większość nowoczesnego oprogramowania księgowego obsługuje obie wersje. Jeśli Twoje tego nie robi, konwertuj między wersjami, dodając tagi zamykające (1.x do 2.x) lub usuwając je (2.x do 1.x). Edytor tekstu z funkcją znajdź i zamień radzi sobie z tym w przypadku małych plików.

Często zadawane pytania

Co oznacza skrót OFX?

OFX oznacza Open Financial Exchange – otwarty standard elektronicznej wymiany danych finansowych między instytucjami finansowymi a aplikacjami użytkowników końcowych, utrzymywany przez Financial Data Exchange (FDX).

Czy OFX to to samo co QBO?

Prawie. QBO to markowa wersja OFX firmy Intuit dla QuickBooks. Struktura danych jest identyczna – QBO dodaje tag INTU.BID do identyfikacji banku i używa rozszerzenia .qbo. Często można zmienić nazwę pliku .ofx na .qbo, a QuickBooks go zaakceptuje.

Czy mogę otworzyć plik OFX w Excelu?

Nie bezpośrednio jako dane strukturalne. Excel otworzy plik jako plik tekstowy, pokazując surowe znaczniki SGML/XML. Aby wyświetlić dane OFX w Excelu, musisz albo najpierw przekonwertować je do CSV lub XLSX, albo użyć dodatku innej firmy, który analizuje tagi OFX do kolumn arkusza kalkulacyjnego.

Co jest lepsze dla Xero – OFX czy CSV?

OFX jest lepszy dla Xero. Importuje się automatycznie bez mapowania kolumn, zawiera wykrywanie duplikatów oparte na FITID, używa jednoznacznego formatu daty i przenosi metadane konta. Dokumentacja Xero zaleca OFX zamiast CSV do ręcznego importu wyciągów bankowych.

Czy banki udostępniają pobieranie plików OFX?

Niektóre tak, ale jest to niespójne. Główne banki w USA, Wielkiej Brytanii i Australii mogą oferować pobieranie plików OFX lub QFX dla ostatnich transakcji (zazwyczaj z ostatnich 90 dni). Wiele mniejszych banków, spółdzielczych kas kredytowych i instytucji międzynarodowych udostępnia tylko wyciągi PDF. W przypadku danych historycznych przekraczających okres pobierania, konwersja PDF jest zazwyczaj jedyną opcją.

Czy OFX jest bezpieczny?

Specyfikacja OFX zawiera postanowienia dotyczące szyfrowania SSL/TLS podczas transmisji i uwierzytelniania opartego na certyfikatach dla bezpośrednich połączeń. Jednak plik OFX zapisany na dysku jest zwykłym tekstem – zawiera numery kont i szczegóły transakcji w czytelnej formie. Traktuj pliki OFX z taką samą ostrożnością, jak każdy dokument finansowy.

Jaka jest różnica między OFX 1.x a 2.x?

OFX 1.x używa znaczników SGML (tagi nie muszą być zamykane), podczas gdy OFX 2.x używa poprawnego XML (wszystkie tagi muszą być otwarte i zamknięte). Zawartość danych jest taka sama – różnica jest składniowa. Wersja 1.6 pozostaje najczęściej generowanym formatem. Większość nowoczesnego oprogramowania księgowego analizuje obie wersje bez problemów.

Czy mogę edytować plik OFX ręcznie?

Tak. Pliki OFX są zwykłym tekstem i można je edytować w dowolnym edytorze tekstu. Możesz poprawić opisy, skorygować kwoty, dodać brakujące FITID lub dostosować daty. Po prostu zachowaj strukturę tagów – niezamknięty lub niedopasowany tag spowoduje błędy importu. W przypadku plików OFX 2.x upewnij się, że każdy tag otwierający ma odpowiadający mu tag zamykający.