---
title: "Data-import"
space: "Frappe Framework"
url: "https://www.prilk.com/nl/docs/frappe-framework/data-import"
updated: "2026-05-14"
---

## 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:
1. DocType (bv. Klant, Artikel, Verkoopfactuur)
2. Actie — **Insert New Records** of **Update Existing Records**
3. Upload een CSV/XLSX-bestand
4. Map kolommen naar velden (auto-gedetecteerd bij matchende labels)
5. 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](/nl/docs/frappe-ecosystem/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.
