03: Datenmigration am Beispiel der Debitoren 

Video Headline

Logo, Branding & Title

Main Video

Interactive Guide

# Datenmigration am Beispiel der Debitoren

## Kontext

Die Datenmigration ist meist eine der ersten Projektanforderungen. Importiert werden Stammdaten (Kunden, Lieferanten), anschließend Zahlungsmethoden und Bankverbindungen mit Matching.

Die Datenmigration läuft immer über den gleichen **3-Schritte-Prozess**:

- **Datenlieferant** — Datei und Schema einlesen
- **Importszenario** — Felder zwischen Excel und Haufe-Maske mappen
- **Import** — gemäß Szenario importieren

**Empfehlung:** alle drei Komponenten identisch benennen (z.B. `Import Kunden`), damit zusammengehörige Objekte schnell wiederzufinden sind.

### 

### Hinweis zur Datenqualität

Kunden gehen oft davon aus, ihre Daten seien sauber. In der Praxis kommen häufig doppelte oder uneinheitliche Datensätze vor. Teil der Consultant-Aufgabe ist die Datenbereinigung in ein importfähiges Format — immer in Absprache mit dem Kunden. Datenmigration ist deshalb oft ein größerer Kostenpunkt im Projekt.

## 

## Schritt 1 — Datenlieferant anlegen

**Pfad:** Datenlieferant (zentraler Screen)

**1.1** Plus-Symbol klicken → neuen Datenlieferanten anlegen

**1.2** Name vergeben — Standard: `Import Kunden`

**1.3** **Provider Typ** auswählen: **Excel** (der oberste Excel-Bereitsteller)

**1.4** Speichern — zwingend, bevor eine Datei hinzugefügt werden kann

**1.5** Reiter **Dateien** → Excel-Datei aus dem Drive-Ordner des Onboarding-Projekts per Drag-and-Drop einfügen → Speichern

**1.6** Reiter **Schema und Objekte** öffnen — alle Tabellenblätter der Excel werden angezeigt

**1.6.1** Das Haupttabellenblatt (z.B. Kunden) aktivieren

**1.7** Button **Schema Felder Füllen** klicken

**1.7.1** Die Spalten der Excel werden als Felder mit Datentyp (meist `String` bei Buchstaben/Zahlen-Kombinationen) ins Schema übernommen

**1.8** Speichern

# 

## Schritt 2 — Importszenario aufbauen

**Pfad:** Importszenario → Plus → neuen Import anlegen

**2.1** Name eingeben — identisch zum Datenlieferanten: `Import Kunden`

**2.2** Bildschirmname (Screen-Auswahl):

**2.2.1** Im Suchfeld "Kunden" eingeben

**2.2.2** Den richtigen Screen wählen — auf Titel und Kategorie achten. Gesucht ist der Stammdaten-Screen, **nicht** Kunden-Details oder Kundenklassen

**2.2.3** Nach Auswahl über **Bildschirm anzeigen** verifizieren, dass der richtige Screen gewählt wurde

**2.3** **Provider** auswählen — der zuvor angelegte Datenlieferant `Import Kunden`. Speichern.

### Tipp: geteilte Ansicht zum Mappen

Tab teilen und im zweiten Tab den Ziel-Screen (z.B. neuen Kundendatensatz) öffnen. Beim Mappen von oben nach unten herab durch alle Felder der Maske gehen — so wird kein Reiter und kein Pflichtfeld übersehen.

**2.4** Felder mappen (immer von oben nach unten arbeiten):

**2.4.1** Erstes Feld im **Header-Bereich (grau hinterlegt)** beginnen — Zielobjekt = Kundenübersicht, Reiter **Allgemein**

**2.4.2** **Feldaktion**: Zielfeld auswählen (z.B. Kunden-ID — neuer Datensatz braucht immer eine neue ID)

**2.4.3** **Quellfeld**: Spalte aus der Excel auswählen. Haufe ergänzt die zugehörige Schlüsseltabelle automatisch (Haufe ist tabellarisch aufgebaut, mehr dazu im Abfragen-Video)

**2.4.4** **Status**: standardmäßig wird der Kunde auf "aktiv" gesetzt. Soll der Kunde initial inaktiv sein, das Feld Status mit ansprechen — ansonsten weglassen

**2.4.5** **Kundenklasse**: Zielobjekt = Kundenübersicht → Kundenklassen-ID → Excel-Spalte Kundenklasse zuordnen

**2.4.6** Wechsel auf Reiter **Allgemein → Kontoinfo** für den **Namen**

**2.4.7** Wechsel auf Reiter **Kontoadresse** für Straße, Hausnummer, PLZ, Stadt

**2.4.7.1** Bundesland und Land werden in den meisten Fällen automatisch gezogen — bei deutschen Kunden nicht nötig zu mappen

**2.4.8** Wechsel auf Reiter **Konto Zusätzliche Infos** für E-Mail (analog Telefon, sofern vorhanden)

**2.4.9** Reiter **Hauptbuchkonten**:

**2.4.9.1** Plus → Position hinzufügen

**2.4.9.2** Zielobjekt: **Hauptbuchkonten** eingeben

**2.4.9.3** Auswahl: **Debitorenkonto** → Excel-Spalte Debitorenkonto

**2.4.9.4** Position für **Erlöskonto** ergänzen — analog

### 

### Hinweis zu Eigenschaftsfeldern und Zahlungen

Felder wie **Vertragsgebiet** sind Eigenschaftsfelder(separates Video). 

Auch **Zahlungsbedingungen** und **Zahlungsart** werden in einem eigenen Importszenario importiert.

**2.5** **Letzte Zeile — Aktion "Speichern"** (zwingend!):

**2.5.1** Zielobjekt zurück auf **Kundenübersicht** setzen

**2.5.2** Als Aktion **Speichern** auswählen

**2.5.3** **Kein Quellfeld** setzen

**2.5.4** Speichern

### Häufiger Fehler

Wird die abschließende **Aktion "Speichern"** vergessen, läuft der Import zwar durch, aber es wird **kein Datensatz tatsächlich gespeichert** — es kommt zu Fehlermeldungen. Haufe arbeitet das Importszenario von oben nach unten ab und braucht den expliziten Speichern-Befehl, um jeden Datensatz nach Abarbeitung der Felder festzuschreiben.

## 

## Schritt 3 — Import durchführen

**Pfad:** Gemäß Importszenario importieren → Suche nach "Kunden" → das angelegte Importszenario öffnen

**3.1** Im Reiter **Dateien** liegt die Excel-Tabelle bereits — sie wird automatisch vom Datenlieferanten durchgereicht

**3.2** Button **Vorbereiten** klicken

**3.2.1** Die gesamten Daten werden geladen und tabellarisch angezeigt

**3.2.2** Bei Fehlermeldungen (z.B. unsaubere Daten, Umlaut-Probleme, Format-Konflikte) lassen sich Werte hier händisch anpassen

**3.3** **Testimport mit erster Zeile** (Empfehlung — immer durchführen):

**3.3.1** Button **Wechsel zur Aktivierung** klicken → alle Häkchen entfernen

**3.3.2** Nur die erste Zeile aktivieren

**3.3.3** Speichern

**3.4** Button **Importieren** klicken — Vorgang startet

**3.5** Ergebnis prüfen:

**3.5.1** In den Kunden-Screen wechseln → der erste Kunde sollte angelegt sein

**3.5.2** Kunden-ID, Name, Straße, Hausnummer und übrige gemappte Felder verifizieren

**3.5.3** Reiter **Hauptbuchkonten** kontrollieren — Debitorenkonto und Erlöskonto müssen übernommen worden sein

**3.6** Vollimport (nach erfolgreichem Test):

**3.6.1** Zurück ins Importszenario

**3.6.2** **Wechsel zur Aktivierung** klicken → alle Datensätze anhaken

**3.6.3** Den **Testimport-Datensatz manuell deaktivieren** (Haken raus), sonst wird er ein zweites Mal angelegt

**3.6.4** Speichern → **Importieren**


## Abschluss

Standardimporte wie **Kunden**, **Lieferanten** und **Artikel** sind nach wenigen Wiederholungen schnell aufgebaut — der 3-Schritte-Prozess (Datenlieferant → Importszenario → Import) bleibt immer gleich.

Komplexere Importe in Modulen wie **Produktion**, **Service Management** oder **Qualitätsmanagement** folgen demselben Prinzip, erfordern aber mehr Spezialwissen und werden im weiteren Onboarding behandelt.




03: Datenmigration am Beispiel der Debitoren

Feedback