Data-import
Bulk-laden van data via CSV/XLSX is een van Frappes sterke punten — voor initiële migratie, doorlopende klant-/artikelupdates of routinematige bulk-operaties.
Het Data Import-DocType
Open Data Import → New. Kies:
- DocType (bv. Klant, Artikel, Verkoopfactuur)
- Actie — Insert New Records of Update Existing Records
- Upload een CSV/XLSX-bestand
- Map kolommen naar velden (auto-gedetecteerd bij matchende labels)
- Klik Start Import — draait op de achtergrond, u krijgt een rapport bij voltooiing
Sjabloon downloaden
Voor een nieuwe import klikt u Download Template op het Data Import-formulier om een CSV met de juiste kolomkoppen en veldtypen te krijgen. Makkelijker dan veldnamen raden.
Child tables
Voor DocTypes met child tables (Verkoopfactuur met regels) wordt het importformaat afgevlakt: één rij per parent, daarna herhaling van de parentnaam voor elke childregel. Het template legt de conventie uit.
Updates op naam
Om bestaande records bij te werken: voeg de kolom ID toe met de recordnaam. Frappe matcht en update. Overgeslagen rijen verschijnen in de log.
Validatie
Elke rij wordt gevalideerd tegen de regels van het DocType — verplichte velden, link-validaties, custom validate-hooks. Mislukte rijen staan in de log met reden; geldige rijen worden alsnog geïmporteerd.
Wanneer toch de API
Data Import is interactief (één DocType per keer). Voor nachtelijke syncs uit een ander systeem: gebruik de API — sneller, scriptbaar, geen UI-overhead.
Grote imports
Voor 100k+ rijen: knip in batches of gebruik directe DB-scripts (via bench --site mysite execute). De Data Import-UI werkt maar verwerkt één record per keer, traag op schaal.