Wat is het QBO-bestandsformaat? Een gids voor accountants

Als u wel eens banktransacties in QuickBooks hebt geïmporteerd, hebt u het advies gehoord: "gebruik gewoon het QBO-formaat." Elk QuickBooks-forum, elke boekhoudersgemeenschap, elke boekhoudblog zegt hetzelfde. QBO is de juiste weg.

Maar wat is een QBO-bestand eigenlijk? Het is geen spreadsheet. Het is geen database. U kunt het niet in Excel openen en rijen en kolommen zien. Als u er dubbel op klikt, weet uw computer misschien niet eens wat hij ermee moet doen.

Deze gids ontleedt het QBO-bestandsformaat van binnenuit --- wat het bevat, hoe het is gestructureerd, waarom QuickBooks het verkiest boven CSV, en hoe QBO-bestanden worden gemaakt als uw bank er geen aanbiedt om te downloaden.

QBO in één zin

Een QBO-bestand is een financieel gegevensbestand op basis van XML dat voldoet aan de Open Financial Exchange (OFX)-specificatie, aangepast voor QuickBooks. Het slaat banktransacties op in een gestructureerd, machineleesbaar formaat --- compleet met unieke transactie-ID's die QuickBooks gebruikt voor automatische detectie van duplicaten.

De extensie .qbo staat voor "QuickBooks Web Connect". Het is het bestandsformaat dat Intuit heeft ontworpen voor het importeren van bankgegevens in QuickBooks zonder dat er een live bankkoppeling nodig is.

Zie het zo: als CSV een platte tekstlijst met transacties is, is QBO een zelfbeschrijvend pakket dat QuickBooks precies vertelt wat elk gegeven betekent --- welk veld de datum is, welk het bedrag is, wie de begunstigde is --- zonder ambiguïteit en zonder handmatige mapping.

De geschiedenis achter QBO

Het verhaal van QBO begint in 1997, toen drie bedrijven --- Microsoft, Intuit en CheckFree --- samenkwamen om de Open Financial Exchange (OFX)-specificatie te creëren. Het doel was eenvoudig: een universele standaard bouwen voor het elektronisch uitwisselen van financiële gegevens tussen banken, consumenten en financiële software.

Vóór OFX gebruikten elke bank en elk softwarepakket zijn eigen propriëtaire formaat. OFX loste dit op door een enkele SGML-gebaseerde (later XML-gebaseerde) structuur te definiëren die elk compatibel systeem kon lezen en schrijven.

Intuit paste OFX aan voor hun producten en creëerde twee merkformaten:

QFX (Quicken Financial Exchange) --- voor import in Quicken
QBO (QuickBooks Web Connect) --- voor import in QuickBooks

Beide zijn in wezen OFX-bestanden met Intuit-specifieke metadata-tags toegevoegd --- met name INTU.BID, een bankidentificatiecode die de software vertelt welke financiële instelling het bestand heeft gegenereerd.

Oorspronkelijk genereerden banken QBO-bestanden rechtstreeks via hun online bankportals. Klanten logden in, kozen "QuickBooks" of "Web Connect" als downloadformaat en kregen een .qbo-bestand klaar voor import. Maar naarmate banken moderniseerden en overstapten op API-gebaseerde verbindingen (Plaid, Yodlee, MX), hebben velen directe QBO-downloads volledig geschrapt.

Vandaag de dag bieden minder banken QBO-exports aan. De transacties bestaan nog steeds --- ze zitten alleen opgesloten in PDF-afschriften. Die verschuiving maakt QBO-converters essentieel voor moderne boekhoudworkflows.

Binnen een QBO-bestand

Open een QBO-bestand in een teksteditor en u ziet gestructureerde markup die lijkt op een kruising tussen XML en HTML. Hier is een compleet, geannoteerd voorbeeld:

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>

Laten we elke sectie doornemen.

Header block --- De eerste negen regels zijn de OFX-header. Ze definiëren het dataformaat van het bestand (OFXSGML), de versie (102), de codering (USASCII) en de tekenset (1252 voor Windows Latin-1). Deze header vertelt QuickBooks hoe de rest van het bestand moet worden geparsed.

SIGNONMSGSRSV1 --- Het antwoordbericht van de aanmelding. Dit bevat de server-timestamp (DTSERVER), taal (ENG) en informatie over de financiële instelling (FI). De tag INTU.BID is de bankidentificatie van Intuit --- deze vertelt QuickBooks van welke bank het bestand afkomstig is en beïnvloedt het banklogo dat tijdens de import wordt weergegeven.

BANKMSGSRSV1 --- De bankberichtenset. Dit omvat alle bankrekeninggegevens. Creditcardafschriften gebruiken in plaats daarvan CREDITCARDMSGSRSV1.

STMTRS --- Het afschriftantwoord. Het specificeert de valuta (CURDEF), de rekeninginformatie (BANKACCTFROM met routeringsnummer, rekeningnummer en rekeningtype), en bevat de transactielijst.

BANKTRANLIST --- De transactielijst met een datumbereik (DTSTART en DTEND). Elke individuele transactie bevindt zich in dit blok als een STMTTRN-element.

STMTTRN --- Een enkele transactie. Elk bevat het transactietype, de datum, het bedrag, een unieke identificatie (FITID), de begunstigde naam en een optioneel memo en chequenummer.

LEDGERBAL --- Het slotbedrag per de einddatum van het afschrift. QuickBooks gebruikt dit voor reconciliatieverificatie.

Belangrijke velden uitgelegd

Niet alle QBO-velden zijn even belangrijk. Hier zijn de velden die er het meest toe doen --- en waarom.

Veld	Beschrijving	Voorbeeld	Waarom het ertoe doet
FITID	Financiële Instelling Transactie ID	`202601030001`	De unieke identificatie die dubbele imports voorkomt. QuickBooks onthoudt elke FITID die het ooit heeft gezien.
TRNTYPE	Transactietype	`DEBIT`, `CREDIT`, `CHECK`, `DEP`, `ATM`, `POS`, `XFER`	Vertelt QuickBooks hoe de transactie moet worden geclassificeerd.
DTPOSTED	Transactiedatum	`20260103`	YYYYMMDD-formaat --- ondubbelzinnig, geen regionale datumverwarring.
TRNAMT	Transactiebedrag	`-85.50`	Negatief voor debet (geld uit), positief voor credit (geld in).
BANKID	Bank routeringsnummer	`021000021`	Identificeert de financiële instelling. Gebruikt voor rekeningkoppeling.
ACCTID	Rekeningnummer	`123456789`	Identificeert tot welke rekening de transacties behoren.
ACCTTYPE	Rekeningtype	`CHECKING`, `SAVINGS`, `CREDITLINE`	Bepaalt hoe QuickBooks de rekening categoriseert.
NAME	Begunstigde naam	`WHOLE FOODS MARKET`	De transactiebeschrijving die in QuickBooks wordt weergegeven. Maximaal 32 tekens.
MEMO	Extra beschrijving	`Grocery purchase`	Aanvullende details. Ook beperkt tot 32 tekens in de OFX-specificatie.
CHECKNUM	Chequenummer	`4521`	Optioneel. Behoudt voor checktransacties, zodat u kunt matchen met fysieke checks.

Het meest kritieke veld is FITID. Zonder unieke, consistente FITID's valt het hele systeem voor detectie van duplicaten uit elkaar. Elke FITID moet uniek zijn binnen een bankrekening --- als twee transacties dezelfde FITID delen, behandelt QuickBooks ze als dezelfde transactie en slaat de tweede stilzwijgend over.

Waarom QBO beter is dan CSV voor QuickBooks

Zowel QBO als CSV kunnen transactiegegevens in QuickBooks krijgen. Maar de ervaring is fundamenteel anders. Hier is een vergelijking:

Functie	QBO	CSV
Detectie van duplicaten	Automatisch via FITID	Geen --- opnieuw importeren creëert duplicaten
Kolommapping	Niet nodig --- velden zijn vooraf gedefinieerd	Vereist --- u wijst handmatig Datum, Beschrijving, Bedrag toe
Datumverwerking	Ondubbelzinnig YYYYMMDD-formaat	Afhankelijk van regionale instellingen --- MM/DD of DD/MM verwarring
Bedragverwerking	Gestructureerd met duidelijke tekenconventie	Valutasymbolen moeten worden verwijderd, decimale scheidingstekens worden gecorrigeerd
Rekeningidentificatie	Ingebouwd (routeringsnummer, rekeningnummer, type)	Niet inbegrepen
Saldo verificatie	Slotbedrag inbegrepen voor reconciliatie	Niet beschikbaar
Chequenumbers	Behoud in CHECKNUM-veld	Kan verloren gaan of een aparte kolom vereisen
Import workflow	Uploaden, bevestigen, klaar	Uploaden, kolommen mappen, datumformaat selecteren, verifiëren, bevestigen
QuickBooks Desktop	Volledige ondersteuning via Web Connect	Niet ondersteund voor import van banktransacties

Detectie van duplicaten is het doorslaggevende voordeel. Elke transactie in een QBO-bestand heeft een unieke FITID. QuickBooks slaat elke FITID op die het ooit heeft verwerkt in een permanent register. Als u per ongeluk hetzelfde bestand twee keer importeert --- of overlappende datumbereiken uit twee verschillende bestanden importeert --- slaat QuickBooks de duplicaten stilzwijgend over. Geen dubbele vermeldingen. Geen opschoning nodig.

Met CSV is er geen enkele bescherming. Importeer hetzelfde bestand twee keer en u krijgt elke transactie gedupliceerd. U krijgt niet eens een waarschuwing. Het opschonen van die duplicaten betekent handmatig vermeldingen één voor één verwijderen, wat precies het soort vervelend werk is dat u wilde vermijden.

QuickBooks Desktop is alleen QBO. Als u werkt met QuickBooks Desktop (Pro, Premier of Enterprise), is CSV niet eens een optie voor het importeren van banktransacties. Web Connect --- wat QBO-bestanden betekent --- is het primaire importpad. Dit alleen al maakt QBO essentieel voor elk bedrijf dat Desktop-klanten ondersteunt.

Waar QBO-bestanden vandaan komen

Er zijn drie bronnen voor QBO-bestanden, en het landschap is de afgelopen tien jaar dramatisch verschoven.

Banken (via Web Connect-downloads). Dit was de oorspronkelijke bron. Banken genereerden QBO-bestanden rechtstreeks vanuit hun online bankportals. Dit wordt steeds zeldzamer --- nu banken overstappen op API-gebaseerde gegevensdeling, hebben velen directe bestandsdownloads volledig verwijderd. Degenen die het nog aanbieden, beperken exports vaak tot 90 dagen.

Bankafschrift converters. Dit is nu de primaire bron voor de meeste boekhoudprofessionals. Hulpmiddelen zoals PDFSub nemen PDF-bankafschriften --- het formaat dat elke bank nog steeds levert --- en converteren ze naar correct gestructureerde QBO-bestanden met geldige FITID's, correcte datumformattering en nauwkeurige debet/credit-classificatie. Voor inhaalboekhouding, gesloten rekeningen, internationale banken en historische gegevens zijn converters de enige praktische optie.

Handmatige creatie. U zou theoretisch een QBO-bestand met de hand kunnen schrijven in een teksteditor. Maar één verkeerd geplaatste tag, één ongeldige FITID, één coderingfout, en QuickBooks wijst het bestand af. Handmatige creatie is een laatste redmiddel, geen workflow.

De verschuiving weg van door banken verstrekte QBO-downloads maakt converters onmisbaar. De banken van uw klanten produceren PDF-afschriften. QuickBooks heeft QBO-bestanden nodig. De converter overbrugt die kloof.

Een QBO-bestand importeren in QuickBooks

Het importproces is eenvoudig --- een van de belangrijkste voordelen van het gebruik van QBO boven CSV.

QuickBooks Online

Ga naar Bankzaken (of Transacties dan Banktransacties)
Klik op Account koppelen en selecteer Uploaden vanaf bestand
Blader naar uw .qbo-bestand of sleep het erheen
QuickBooks leest het bestand en identificeert de rekeninginformatie
Koppel het bestand aan een bestaande bankrekening --- of laat QuickBooks een nieuwe aanmaken
Bekijk de geparsede transacties in de preview
Klik op Klaar om de import te voltooien

Transacties verschijnen in het tabblad Te beoordelen. Vanaf daar categoriseert u elke transactie, koppelt u deze aan bestaande vermeldingen of voegt u deze toe aan uw boekhouding.

QuickBooks Desktop

Ga naar Bestand dan Hulpprogramma's dan Importeren dan Web Connect-bestanden
Selecteer uw .qbo-bestand
QuickBooks valideert het bestandsformaat
Koppel het bestand aan een bestaande bankrekening of maak een nieuwe aan
Transacties verschijnen in het venster Bankfeeds

Voor een complete handleiding met screenshots en probleemoplossing, zie onze volledige gids: Bankafschriften importeren in QuickBooks.

Veelvoorkomende QBO-problemen en oplossingen

QBO-bestanden zijn betrouwbaar, maar bepaalde problemen komen regelmatig voor. Hier is waar u op moet letten.

"Financiële instelling kan niet worden geverifieerd." De tag INTU.BID in het bestand komt niet overeen met een erkende bank in de directory van Intuit. Dit is cosmetisch --- het beïnvloedt het banklogo dat tijdens de import wordt weergegeven, maar voorkomt niet dat transacties worden geïmporteerd. Accepteer de prompt en ga verder.

Dubbele FITID's die leiden tot overgeslagen transacties. Als twee transacties in hetzelfde bestand een FITID delen, importeert QuickBooks alleen de eerste en slaat de tweede stilzwijgend over. Dit gebeurt ook als u een bestand importeert met FITID's die QuickBooks al eerder heeft gezien bij een eerdere import. Elke FITID moet uniek zijn binnen een bepaalde rekening, en zodra deze is gezien, wordt deze permanent geregistreerd.

Coderingfouten en onleesbare tekens. Niet-ASCII-tekens in begunstigde namen of memo's --- accenttekens, ampersands, punthaken --- kunnen de SGML-parser breken. Ampersands moeten worden gecodeerd als &, en punthaken moeten worden ontsnapt. Een goed gebouwde converter regelt dit automatisch.

"Bestand kan niet worden gelezen"-fouten. Meestal veroorzaakt door onjuiste SGML --- een ontbrekende afsluitende tag, een extra regeleinde binnen een tagwaarde, of een header die niet overeenkomt met het lichaamsformaat. Open het bestand in een teksteditor en controleer op structurele problemen. De headerversie (VERSION:102) moet overeenkomen met de OFX-versie van de body.

Compatibiliteit met QuickBooks-versies. QuickBooks Desktop-versies die ouder zijn dan drie jaar, verliezen de Web Connect-functionaliteit. Als uw klant QuickBooks Desktop 2022 gebruikt, kunnen ze mogelijk helemaal geen QBO-bestanden importeren. De oplossing is het upgraden van QuickBooks of overstappen op QuickBooks Online.

Creditcard geïmporteerd als bankrekening. Als een creditcardafschrift is verpakt in BANKMSGSRSV1-tags in plaats van CREDITCARDMSGSRSV1, maakt QuickBooks de rekening aan als een bankrekening in plaats van een creditcard. Het QBO-bestand heeft de juiste berichtwrapper nodig voor het rekeningtype.

QBO vs. QFX vs. OFX: Wat is het verschil?

Deze drie formaten veroorzaken constante verwarring omdat ze onder de motorkap bijna identiek zijn.

Formaat	Extensie	Gebaseerd op	Doelsoftware	Belangrijkste verschil
OFX	`.ofx`	Open Financial Exchange-standaard	Universeel --- Xero, Wave, GnuCash, etc.	De open standaard. Geen leverancierspecifieke tags.
QBO	`.qbo`	OFX + Intuit metadata	QuickBooks	Voegt `INTU.BID` toe voor bankidentificatie in QuickBooks.
QFX	`.qfx`	OFX + Intuit metadata	Quicken	Hetzelfde als QBO, maar bedoeld voor Quicken in plaats van QuickBooks.

De onderliggende transactiestructuur is identiek voor alle drie. U kunt een .ofx-bestand hernoemen naar .qbo en QuickBooks zal het bijna altijd lezen. De INTU.BID-tag is de enige zinvolle Intuit-toevoeging --- deze bepaalt het banklogo dat tijdens de import wordt weergegeven.

In de praktijk: Gebruik .qbo voor QuickBooks, .qfx voor Quicken, en .ofx voor andere boekhoudplatforms zoals Xero of Wave. De transactiegegevens erin zijn hetzelfde.

QBO-bestanden maken van PDF-bankafschriften

De meeste accountants komen QBO-bestanden tegen in één context: ze hebben een PDF-bankafschrift en moeten de gegevens in QuickBooks krijgen. De PDF moet een QBO-bestand worden.

PDFSub's Bank Statement Converter regelt deze conversie van begin tot eind. Upload een PDF-bankafschrift, en PDFSub extraheert de transacties --- datums, bedragen, beschrijvingen, lopende saldi --- en genereert een correct geformatteerd QBO-bestand met:

Geldige, unieke FITID's voor elke transactie --- zodat de detectie van duplicaten van QuickBooks correct werkt
Correcte TRNTYPE-classificatie --- debet-, credit-, check-, stortings- en overschrijdingstransacties worden automatisch geïdentificeerd
Correcte SGML-codering --- speciale tekens ontsnapt, datums in YYYYMMDD-formaat, bedragen met de juiste tekens
Rekeningmetadata --- detectie van rekeningtype (checking, savings, credit card) met de juiste QBO-berichtwrapper
Slotbedrag --- de LEDGERBAL-tag gevuld met het eindsaldo van het afschrift

De converter werkt met afschriften van meer dan 20.000 banken in 130+ talen. Digitale PDF's (tekstgebaseerde afschriften) worden volledig in uw browser verwerkt --- het bestand verlaat uw computer nooit. Gescande of beeldintensieve PDF's gebruiken server-side AI-extractie.

Plannen beginnen bij $10/maand, met conversie van bankafschriften voor $29/maand (Business plan + BSC add-on, 500 pagina's). Alle betaalde plannen zijn inclusief een gratis proefperiode van 7 dagen.

Veelgestelde vragen

Kan ik een QBO-bestand openen om te zien wat erin zit?

Ja. QBO-bestanden zijn platte tekst. Open er een in een teksteditor --- Kladblok op Windows, TextEdit op Mac, VS Code of Sublime Text --- en u ziet de SGML-geformatteerde transactiegegevens. Elk veld is leesbaar voor mensen: datums, bedragen, begunstigde namen, FITID's, rekeningnummers en het slotbedrag.

Is een QBO-bestand hetzelfde als een OFX-bestand?

Bijna identiek. QBO is gebaseerd op de OFX-standaard met toegevoegde Intuit-specifieke tags (voornamelijk INTU.BID voor bankidentificatie). De transactiestructuur, veldnamen en dataformattering zijn hetzelfde. U kunt .ofx hernoemen naar .qbo en QuickBooks zal het meestal accepteren.

Waarom slaat QuickBooks sommige transacties over wanneer ik een QBO-bestand importeer?

QuickBooks houdt elke FITID bij die het ooit heeft verwerkt. Als de FITID van een transactie eerder is gezien --- van een eerdere import of van een bankkoppeling --- slaat QuickBooks deze stilzwijgend over om duplicaten te voorkomen. Dit is een functie, geen bug. Als u transacties opnieuw moet importeren, heeft u een bestand nodig met nieuwe, unieke FITID's.

Werkt hetzelfde QBO-bestand voor zowel QuickBooks Online als Desktop?

Ja. Het QBO-bestandsformaat is identiek voor beide versies. Het importproces verschilt --- Online gebruikt Bankzaken dan Uploaden vanaf bestand, terwijl Desktop Bestand dan Hulpprogramma's dan Importeren dan Web Connect-bestanden gebruikt --- maar het bestand zelf is hetzelfde.

Hoeveel transacties kan één QBO-bestand bevatten?

Er is geen harde limiet in de OFX-specificatie. QuickBooks Online beperkt echter het uploaden van bestanden tot ongeveer 350 KB, wat neerkomt op ongeveer 1.000 tot 1.500 transacties, afhankelijk van de lengte van de beschrijvingen. Splits voor grotere imports het bestand per maand of kwartaal.

Kan ik een QBO-bestand maken van een CSV- of Excel-spreadsheet?

Ja, maar u hebt een conversietool nodig. Het QBO-formaat vereist specifieke SGML-markup, geldige FITID's, OFX-compatibele datumformattering en correcte headerinformatie. Handmatig converteren is foutgevoelig. PDFSub en vergelijkbare tools regelen de opmaak automatisch.

Werken QBO-bestanden met boekhoudsoftware anders dan QuickBooks?

QBO-bestanden zijn primair ontworpen voor QuickBooks. Omdat QBO echter gebaseerd is op de OFX-standaard, kan sommige andere boekhoudsoftware .qbo-bestanden lezen of accepteert deze als ze worden hernoemd naar .ofx. Voor software anders dan QuickBooks, zoals Xero of Wave, wordt de standaard .ofx-extensie aanbevolen.

Wat is de maximale tekengrootte voor begunstigde namen in QBO-bestanden?

De OFX-specificatie beperkt het NAME-veld tot 32 tekens en het MEMO-veld tot 255 tekens, hoewel QuickBooks langere memo-waarden tijdens de weergave kan afkappen. Als een begunstigde naam langer is dan 32 tekens, wordt deze afgekapt. Een goede converter kapt af op woordgrenzen om het meest bruikbare deel van de beschrijving te behouden.