CSV naar JSON omzetten

CSV naar JSON omzetten in drie stappen

Plak je CSV in het invoervak of kies een bestand van maximaal 5 MB. De tool herkent zelf of je bestand een komma, puntkomma, tab of pipe als scheidingsteken gebruikt. Klopt de herkenning niet, dan kies je het scheidingsteken handmatig. Het resultaat verschijnt direct: het aantal rijen en kolommen, een voorbeeldtabel met de eerste vijf rijen en de JSON zelf.

Kies daarna de vorm van de uitvoer. Een array van objecten gebruikt de eerste rij als kolomnamen, zodat elke rij een object wordt zoals {"klant": "Jansen BV", "bedrag": "12,50"}. Dit is de vorm die de meeste API's en importfuncties verwachten. Een array van arrays houdt de rijen als lijsten, wat handig is als je CSV geen kolomnamen heeft of als je de data in code verder verwerkt.

Met Kopiëren zet je de JSON op je klembord en met Downloaden sla je hem op als .json-bestand. Je bestand wordt met de FileReader van je browser gelezen en verlaat je computer niet. Exports met klant- of ordergegevens kun je dus zonder zorgen omzetten.

Getallen, ja/nee en de Nederlandse decimale komma

In een CSV is alles tekst. Standaard blijft dat in de JSON ook zo, want dan gaat er niets verloren. Zet je Getallen omzetten aan, dan wordt "42" het getal 42 en "0.5" het getal 0.5. Waarden met een voorloopnul, zoals postcodes, telefoonnummers en artikelcodes, blijven bewust tekst: als getal zou 0612345678 zijn eerste nul kwijtraken.

Nederlandse Excel-exports gebruiken meestal een puntkomma als scheidingsteken en een komma als decimaalteken, dus 12,50 in plaats van 12.50. Zet in dat geval ook Decimale komma aan. Dan wordt 12,50 het getal 12.5 en 1.249,50 het getal 1249.5. Staat die optie uit, dan blijft 12,50 tekst, zodat er nooit ongemerkt een verkeerd bedrag in je JSON komt.

Met de optie voor ja/nee worden true, false, ja, nee, yes en no omgezet naar echte booleans. Lege velden kun je als null laten opnemen, zodat een ontvangend systeem het verschil ziet tussen een lege tekst en een ontbrekende waarde. Welke keuze goed is, hangt af van wat het systeem verwacht waar je de JSON in laadt.

Hoe een CSV-bestand in elkaar zit

CSV staat voor comma-separated values: elke regel is een rij en een scheidingsteken verdeelt de rij in velden. Bevat een veld zelf het scheidingsteken of een regeleinde, dan staat het tussen dubbele aanhalingstekens, zoals "De Vries; Zonen". Een aanhalingsteken binnen zo'n veld wordt verdubbeld: "Levering ""achterom""" betekent Levering "achterom". Deze tool volgt die regels uit de CSV-standaard RFC 4180, ook voor Windows-regeleinden en het onzichtbare BOM-teken dat Excel vooraan een bestand zet.

Het meest voorkomende probleem is een rij met meer of minder velden dan de kopregel. Dat komt meestal door een vergeten aanhalingsteken rond een tekst met een komma, of doordat het verkeerde scheidingsteken is gekozen. De tool zet de data dan toch om, vult ontbrekende velden aan en meldt op welke regels het verschil zit. Zo kun je de bron gericht nakijken.

Zie je vreemde tekens zoals é in plaats van é, dan is het bestand in een andere tekenset opgeslagen. Bij het inlezen van een bestand probeert de tool dat zelf te herkennen en leest hij het zo nodig opnieuw in met de Windows-tekenset die oudere Excel-versies gebruiken.

Wanneer je de conversie beter automatiseert

Een CSV-export omzetten naar JSON is prima om eenmalig data in een systeem te laden of een koppeling te testen. Doe je dit elke week met een export uit je webshop, kassasysteem of boekhouding, dan is het handwerk dat fouten in de hand werkt: een verkeerd geselecteerde kolom, een bestand van de vorige keer of een bedrag dat als tekst binnenkomt.

Een geautomatiseerde import leest de bron op een vast moment uit, controleert elke rij tegen vaste regels en meldt afwijkingen voordat ze in je administratie terechtkomen. Vaak kan de CSV-stap zelfs helemaal weg, omdat beide systemen een API hebben die rechtstreeks met elkaar kan praten.