Bestandsformaten bepalen hoe Zero Friction CSV-bestanden leest en verwerkt tijdens importjobs. Ze leggen vast hoe kolommen zijn gescheiden, hoe datums en getallen worden geïnterpreteerd en hoe kolommen worden gekoppeld aan metingen en attributen (zoals meter-serial, eenheid en utiliteitstype).
U vindt dit onderdeel via Configuratie → Jobs → Bestandsformaten.
Een correcte configuratie is essentieel om:
meetdata betrouwbaar te importeren
migraties (klanten, contracten, facturen) foutloos uit te voeren
automatische en geplande imports stabiel te laten draaien
Wat toont dit onderdeel?
De pagina Bestandsformaten toont een overzicht van alle beschikbare formaten:
Naam – De naam van het bestandsformaat
Omschrijving – Korte toelichting
Categorie – Metering of Migratie
Formaat – Specifiek type (bijv. Elvaco 1104, Custom Csv, ZF BulkImport)
Type – Ingebouwd (systeem) of Aangepast (door u aangemaakt)
Ingebouwde formaten worden bovenaan getoond; aangepaste formaten volgen alfabetisch.
Indeling
Ingebouwde vs. aangepaste formaten
Ingebouwde formaten
Vooraf geconfigureerd voor veelvoorkomende meters (o.a. Elvaco, Cadis, Kamstrup)
Alleen-lezen (niet te bewerken of te verwijderen)
Direct te gebruiken in importjobs
Aangepaste formaten
Door u aangemaakt, meestal via Custom Csv
Volledig configureerbaar
Geschikt voor maatwerk CSV-structuren
Categorieën
Metering – Voor import van meterstanden (meerdere ingebouwde types + Custom Csv)
Migratie – Voor bulkimport van klanten, contracten en facturen (ZF BulkImport)
De categorie en het formaattype kunnen na aanmaak niet worden gewijzigd.
Acties
Gebruikers met de juiste rechten kunnen:
aangepaste bestandsformaten aanmaken
aangepaste formaten bewerken
aangepaste formaten verwijderen (soft delete)
Ingebouwde formaten kunnen alleen worden bekeken.
Gedragingen & Logica
Parameters (basis)
Bij het aanmaken/bewerken van een aangepast formaat configureert u:
Tijdzone – Context voor datum/tijd in het bestand
Datum-/tijdformaat – Bijv.
dd/MM/yyyy,yyyy-MM-ddScheidingsteken (Delimiter) – Komma, puntkomma of Tab
Decimaal scheidingsteken –
.of,Duizendtalscheiding – Optioneel (bijv.
,of spatie)Cultuur – Regionale parsing (bijv.
nl-NL,en-US)
Custom Csv – Metering
Kopregel
Eerste regel is header: aanvinken als kolomnamen aanwezig zijn
Waarden
Value Path – Kolomindex (0-gebaseerd) met de meetwaarde
End Date Path – Kolomindex met datum/tijd
Attributen
Koppeling van kolommen aan attributen zoals:
Meter-serial
Eenheid
Utiliteitstype
Per attribuut:
Path (kolomindex), of
Fixed Value (vaste waarde voor alle rijen)
Voorbeeld
CSV:
MeterID,Date,Value,Unit,Utility 12345,01/01/2024,1250.5,kWh,Electricity
Configuratie:
Delimiter:
,Datumformaat:
dd/MM/yyyyHeader: aan
Value Path:
2End Date Path:
1Attributen:
Meter-serial: Path
0Eenheid: Path
3Utiliteitstype: Path
4
Migratieformaten (ZF BulkImport)
Specifiek voor bulkimport van administratieve data.
Instellingen omvatten o.a.:
Factuurdatum-afhandeling
Niets doen
Factuurperioden herberekenen
Koppelen aan bestaande perioden
Voorschotten periodiek verwacht – Aangeven of voorschotten regelmatig worden geïmporteerd
Gebruik in Jobs
Bestandsformaten worden gebruikt bij:
Import Jobs (migratie)
Metering Imports (meterstanden)
Geplande imports via dataproviders
Belangrijk: Verwijdert u een formaat dat in gebruik is, dan falen bestaande jobs met een foutmelding. Maak in dat geval een nieuw formaat aan en upload de bestanden opnieuw.
Waarom kan ik een ingebouwd formaat niet bewerken?
Omdat deze door het systeem wordt beheerd. Maak een aangepast formaat aan.
Hoe kies ik het juiste formaat?
Start met een ingebouwd formaat dat bij uw meter past. Lukt dat niet, gebruik Custom Csv.
Mijn CSV gebruikt tabs i.p.v. komma’s. Wat nu?
Selecteer Tab als scheidingsteken.
Kan ik een formaat later aanpassen?
Ja, voor aangepaste formaten. Categorie en formaattype zijn vast.
Wat gebeurt er bij verwijderen van een formaat?
Het wordt soft-deleted; jobs die het gebruiken falen.
Waarom zie ik niet alle formaattype-opties?
Sommige types zijn verborgen voor UI-gebruik (historisch/API).
Hoe werken kolom-paden?
0-gebaseerd: eerste kolom = 0, tweede = 1, enz.
Path vs. Fixed Value?
Path leest uit een kolom; Fixed Value gebruikt één vaste waarde voor alle rijen.
Ingebouwd formaat – Vooraf geconfigureerd systeemformaat (alleen-lezen)
Aangepast formaat – Door de gebruiker geconfigureerd formaat
Delimiter – Scheidingsteken tussen kolommen
Formaattype – Concrete implementatie (bijv. Custom Csv)
Meteringformaat – Voor import van meterstanden
Migratieformaat – Voor bulkimport van administratieve data
Path – 0-gebaseerde kolomindex
Value Path – Kolom met de meetwaarde
End Date Path – Kolom met de einddatum/-tijd
Attribuut – Extra metadata bij een meting
Fixed Value – Vaste waarde i.p.v. kolomwaarde
Cultuur – Regels voor parsing van datum/getal
Tijdzone – Context voor datum/tijd in bestanden