Analyseren en toetsen · gereedschapAnalyse and test · tool

Van auditfile naar één bruikbare tabel

From audit file to one usable table

De XAF Auditfile Converter, kortweg Auditfile Converter, zet XML-auditfiles Financieel (XAF), zoals boekhoudpakketten die exporteren, om naar Excel, CSV, Parquet, SQLite of JSON. Het herkent zelf de versie, converteert wat er werkelijk in het bestand staat en levert desgewenst één verrijkte grootboekmutatietabel waarin de stamgegevens al zijn aangesloten.The Auditfile Converter turns XML audit files Financial (XAF), as exported by accounting packages, into Excel, CSV, Parquet, SQLite or JSON. It detects the version itself, converts what is actually in the file and, if you wish, delivers one enriched general ledger transactions table in which the master data is already joined.

Wat het doetWhat it does

Twee uitvoermodi, één wizard

Two output modes, one wizard

Een auditfile (versie 3.x) is een XML-bestand met tien secties die naar elkaar verwijzen: het grootboekschema, de relaties, de periodes, de btw-codes, de openingsbalans en de mutaties. Wie ermee wil analyseren, moet die verwijzingen eerst zelf aansluiten. De converter doet dat voor je of geeft je de secties los als je dat liever hebt.An audit file (version 3.x) is an XML file with ten sections that refer to each other: the chart of accounts, the relations, the periods, the VAT codes, the opening balance and the transactions. Anyone who wants to analyse it first has to join those references themselves. The converter does that for you or gives you the sections separately if you prefer.

Uitvoermodus 1Output mode 1

GrootboekmutatiesGeneral ledger transactions

Eén geïntegreerd bestand waarin elke boekingsregel is verrijkt met de stamgegevens waarnaar hij verwijst.One integrated file in which every posting line is enriched with the master data it refers to.

  • Openingsbalans omgezet naar boekingsregels (journaal „OPB").Opening balance converted into posting lines (journal "OPB").
  • Kopgegevens aan elke regel gekoppeld.Header data attached to every line.
  • Grootboekschema, debiteuren en crediteuren, periodes en btw-codes aangesloten.Chart of accounts, debtors and creditors, periods and VAT codes joined.
  • Ontbreekt een koppeling, dan blijft de regel staan en blijft het gekoppelde veld leeg; niets breekt.If a link is missing, the line stays and the joined field stays empty; nothing breaks.
debetdebitcreditsaldobalancebtw-saldoVAT balancejournaalpost-idjournal entry idjaar · maand · kwartaalyear · month · quarterdag van weekday of weekboekjaar · periode · halfjaarfinancial year · period · half-year
Uitvoermodus 2Output mode 2

Ruwe dataRaw data

Per sectie een aparte tabel, precies zoals het auditfile is opgebouwd. Voor wie de koppelingen zelf wil leggen of één sectie nodig heeft.A separate table per section, exactly as the audit file is structured. For those who want to make the joins themselves or need just one section.

  • In Excel: één werkblad per sectie, met tabelopmaak en bevroren kopregel.In Excel: one worksheet per section, with table formatting and a frozen header row.
  • Lege secties worden overgeslagen.Empty sections are skipped.
  • Na afloop een samenvatting: aantal secties en records per sectie.Afterwards a summary: number of sections and records per section.
De sectie-uitlezerThe section reader

Tien secties uit elkaar, één tabel bij elkaar

Ten sections apart, one table together

Het schema toont de route door het programma. Links het auditfile zoals het binnenkomt; in het midden de secties die de converter eruit haalt; rechts de grootboekmutatietabel waarin de mutaties (groen) met de stamgegevens worden samengebracht.The diagram shows the route through the programme. On the left the audit file as it comes in; in the middle the sections the converter extracts from it; on the right the general ledger transactions table in which the transactions (green) are brought together with the master data.

De conversie loopt in zeven stappen die je op het scherm ziet afvinken: structuren laden, XML opschonen, XML verwerken, data platslaan, secties extraheren, uitvoer genereren en bestand schrijven. Bij bestanden groter dan 100 MB krijg je vooraf een waarschuwing.The conversion runs in seven steps you see ticked off on screen: load structures, clean XML, process XML, flatten data, extract sections, generate output and write file. For files larger than 100 MB you get a warning beforehand.

  • structuren ladenload structures
  • XML opschonenclean XML
  • XML verwerkenprocess XML
  • data platslaanflatten data
  • secties extraherenextract sections
  • uitvoer genererengenerate output
  • bestand schrijvenwrite file
Schema · van bestand naar tabelDiagram · from file to table
auditfile .xaf · XML 1.0 t/m 3.21.0 to 3.2 header company generalledger customerssuppliers periods vatcodes openingbalance transactions obsubledgers subledgers grootboekmutatiesgl transactions regel + stamgegevensline + master data regel + stamgegevensline + master data regel + stamgegevensline + master data regel + stamgegevensline + master data Excel · CSV · ParquetExcel · CSV · Parquet SQLite · JSON

Schuif opzij om het hele schema te zien.Scroll sideways to see the whole diagram.

Versies en afwijkingenVersions and deviations

Het converteert wat er staat, niet wat er zou moeten staan

It converts what is there, not what should be there

1.0XAF
2.0CLAIR
3.0XAF
3.1XAF
3.2XAF

„De applicatie moet converteren wat er daadwerkelijk in het bestand staat, niet wat er volgens de specificaties zou moeten staan.""The application must convert what is actually in the file, not what should be there according to the specifications."Robuustheidseis uit de functionele specificatieRobustness requirement from the functional specification

Boekhoudpakketten houden zich niet allemaal even strikt aan de norm van het auditfile. De converter oordeelt daar niet over: afwijkingen worden gelogd, de conversie gaat door en ongeldige tekens worden genegeerd. Een ontbrekende datum wordt 1900-01-01, een ontbrekend bedrag 0,00, zodat elke regel in de uitvoer terechtkomt en je in de analyse zelf ziet waar het bestand tekortschoot.Accounting packages do not all follow the audit file standard equally strictly. The converter does not judge that: deviations are logged, the conversion continues and invalid characters are ignored. A missing date becomes 1900-01-01, a missing amount 0.00, so every line ends up in the output and you see in the analysis itself where the file fell short.

VersieherkenningVersion detection

Het programma leest de eerste tien regels van het bestand en herkent daaraan de versie; bij twijfel krijg je een keuzelijst. Versie 2.0 (CLAIR) wordt intern als 1.0 behandeld, versie 3.0 als 3.1.The programme reads the first ten lines of the file and recognises the version from them; when in doubt you get a pick list. Version 2.0 (CLAIR) is handled internally as 1.0, version 3.0 as 3.1.

  • Alleen auditfile-type Financieel.Only audit file type Financial.
  • Bestanden .xaf en .xml.Files .xaf and .xml.
  • Automatische herkenning uit te zetten in de instellingen.Automatic detection can be switched off in the settings.
UitvoerformatenOutput formats

Vijf formaten, volledig op je eigen pc

Five formats, entirely on your own PC

.xlsx
ExcelEén werkblad per sectie, tabelopmaak, bevroren kopregel, valutakolommen, automatische kolombreedte.One worksheet per section, table formatting, frozen header row, currency columns, automatic column width.
.csv · zip
CSVTab-gescheiden, verpakt in één ZIP. Boven 1.000.000 regels kiest het programma dit formaat vanzelf.Tab-separated, packed in one ZIP. Above 1,000,000 lines the programme picks this format by itself.
.parquet
ParquetKolomgericht en gecomprimeerd (Snappy).Columnar and compressed (Snappy).
.db
SQLiteEén databasebestand met alle tabellen, direct te bevragen met SQL.One database file with all tables, ready to query with SQL.
.json
JSONAlle secties als JSON.All sections as JSON.

Alles blijft op je eigen schijfEverything stays on your own drive

De converter is een desktopprogramma voor Windows. Er is geen server, geen account en geen upload: het auditfile en de uitvoer staan op de schijf van de gebruiker en nergens anders. Je kiest zelf de uitvoermap en de bestandsnaam (met of zonder tijdstempel); het dashboard onthoudt je recente conversies zodat je een bestand met één klik terugvindt.The converter is a desktop programme for Windows. There is no server, no account and no upload: the audit file and the output live on the user's drive and nowhere else. You choose the output folder and the file name yourself (with or without timestamp); the dashboard remembers your recent conversions so you find a file back with one click.

Ingebouwd is ook een viewer: een .xaf opent in een XML-weergave met zoeken en „ga naar regel", een .csv, .parquet of .db in een tabelweergave met zoekfunctie; een .xlsx start gewoon Excel.A viewer is built in too: a .xaf opens in an XML view with search and "go to line", a .csv, .parquet or .db in a table view with search; an .xlsx simply starts Excel.

HerkomstOrigin

De converter is de opvolger van een Python-module die zich vele jaren in de praktijk heeft bewezen; de eis bij de herbouw was dat de nieuwe versie minimaal diezelfde functionaliteit biedt. Het programma draagt het merk Aviseo („Made by Aviseo”), onze AI-gedreven analyseoplossing.The converter is the successor of a Python module that proved itself in practice for many years; the requirement for the rebuild was that the new version offers at least that same functionality. The programme carries the Aviseo brand (“Made by Aviseo”), our AI-driven analysis solution.

Aan de slagGet started

Een auditfile dat op analyse wacht?

An audit file waiting for analysis?

Vraag de converter aan of vraag ons naar Aviseo voor de analyse na de conversie.Request the converter or ask us about Aviseo for the analysis after the conversion.