Kontakt-Feld-Mapping
Buchungsfelder mit sevDesk-Kontaktfeldern verknuepfen
Kontakt-Feld-Mapping
Uebersicht
Das Kontakt-Feld-Mapping ermoeglicht die automatische Uebertragung von Buchungsdaten zu sevDesk-Kontakten. Konfigurieren Sie, welche Buchungsfelder welchen sevDesk-Kontaktfeldern entsprechen.
Pfad: WordPress-Admin → Kurs-Booking → Einstellungen → sevDesk → Tab: Kontakte
Warum Feld-Mapping?
| Problem ohne Mapping | Loesung mit Mapping |
|---|---|
| Telefonnummer landet nicht im Kontakt | Telefon → sevDesk "Telefon" |
| Mobilnummer geht verloren | Mobil → sevDesk "Mobil" |
| Adresse wird nicht uebertragen | Strasse/PLZ/Ort → sevDesk Adresse |
| Manuelle Nacharbeit in sevDesk | Automatische, korrekte Zuordnung |
Verfuegbare sevDesk-Felder
Personendaten
| Feld | API-Key | Beschreibung |
|---|---|---|
| Anrede (m/w) | gender |
Herr = m, Frau = f |
| Titel | academicTitle |
Dr., Prof., etc. |
| Vorname | surename |
Kontakt-Vorname |
| Nachname | familyname |
Kontakt-Nachname |
| Namenszusatz | name2 |
z.B. "von", "van der" |
Firmendaten
| Feld | API-Key | Beschreibung |
|---|---|---|
| Organisation/Firma | organisation |
Firmenname fuer B2B |
| Position | position |
Berufsbezeichnung |
| Beschreibung | description |
Freitext-Notizen |
| USt-IdNr. | vatNumber |
Umsatzsteuer-ID |
Kommunikation
| Feld | API-Key | Beschreibung |
|---|---|---|
| Telefon | phone |
Festnetznummer |
| Mobil | mobile |
Handynummer |
| Fax | fax |
Faxnummer |
Adresse
| Feld | API-Key | Beschreibung |
|---|---|---|
| Strasse | street |
Strasse und Hausnummer |
| PLZ | zip |
Postleitzahl |
| Ort | city |
Stadt/Gemeinde |
| Land | country |
ISO-Code (DE, AT, CH) |
Einrichtung
1. Mapping-Bereich oeffnen
- Navigieren Sie zu Kurs-Booking → Einstellungen → sevDesk
- Scrollen Sie zum Bereich "Kontakt-Feld-Mapping"
2. Auto-Erkennung nutzen (empfohlen)
- Klicken Sie auf "Auto-Erkennung"
- Das System erkennt automatisch passende Zuordnungen basierend auf Feldnamen
- Vorschlaege werden in den Dropdowns vorausgewaehlt
Erkannte Muster:
- telefon, phone, tel → Telefon
- mobil, mobile, handy → Mobil
- strasse, street, adresse → Strasse
- plz, zip, postleitzahl → PLZ
- ort, city, stadt → Ort
- anrede, salutation, gender → Anrede
3. Manuelle Zuordnung
- In der Tabelle das gewuenschte Buchungsfeld finden
- Im Dropdown das passende sevDesk-Feld auswaehlen
- Status-Icon wechselt von grau zu gruen
4. Mappings speichern
- Klicken Sie auf "Mappings speichern"
- Meldung "Gespeichert!" bestaetigt den Erfolg
- Statistik wird aktualisiert
Status-Anzeige
| Symbol | Bedeutung |
|---|---|
| ✅ gruen | Mapping konfiguriert |
| 💡 gelb | Auto-Erkennung hat Vorschlag |
| ➖ grau | Kein Mapping, kein Vorschlag |
Statistik-Zeile:
Status: ✅ 5 gemappt | 💡 2 Vorschlaege | ➖ 3 ohne Mapping
Standard-Felder (kein Mapping noetig)
ℹ️ Wichtig: E-Mail und Name werden automatisch uebertragen und erscheinen NICHT in der Mapping-Tabelle. Diese Felder sind in sevDesk fest verdrahtet und benoetigen keine Konfiguration.
| Buchungsfeld | sevDesk-Feld | Verhalten |
|---|---|---|
e_mail |
Pflichtfeld! Dient als Kontakt-Identifikator in sevDesk | |
name |
Name | Wird automatisch in Vor-/Nachname aufgeteilt |
Warum kein E-Mail-Mapping?
- sevDesk verwendet die E-Mail-Adresse zur eindeutigen Identifikation von Kontakten
- Bei jeder Buchung wird geprueft, ob bereits ein Kontakt mit dieser E-Mail existiert
- Existiert der Kontakt: Daten werden aktualisiert
- Existiert er nicht: Neuer Kontakt wird angelegt
Empfohlene Mappings
Fuer die Standard-Buchungsfelder empfehlen wir:
| Buchungsfeld | sevDesk-Feld |
|---|---|
telefon |
Telefon |
mobil |
Mobil |
adresse |
Strasse |
plz |
PLZ |
ort |
Ort |
Spezialfall: Anrede-Konvertierung
Die Anrede wird automatisch konvertiert:
| Eingabe | sevDesk-Wert |
|---|---|
| "Herr", "Herr.", "Mr", "Mr." | m |
| "Frau", "Frau.", "Ms", "Mrs" | f |
| Sonstiges | Keine Zuordnung |
Funktionsweise bei Buchungen
1. Kunde fuellt Buchungsformular aus
↓
2. Buchung wird bestaetigt (Double-Opt-In)
↓
3. sevDesk-Integration wird ausgeloest
↓
4. System liest konfigurierte Mappings
↓
5. Buchungsfelder werden auf sevDesk-Felder gemappt
↓
6. Kontakt wird angelegt/aktualisiert
↓
7. Kommunikationswege (Tel, Mobil, Fax) werden erstellt
↓
8. Adresse wird als Rechnungsadresse angelegt
Hinweise und Einschraenkungen
Textarea-Felder
Wenn Ihr "Adresse"-Feld ein Textarea ist (mehrzeiliger Text), wird der gesamte Inhalt als Strasse uebertragen.
Empfehlung: Verwenden Sie separate Felder fuer Strasse, PLZ und Ort fuer eine saubere Trennung.
Vor-/Nachname
Wenn Sie keine expliziten Vorname/Nachname-Felder haben: - Das System nimmt das "Name"-Feld - Teilt es automatisch beim ersten Leerzeichen - Erster Teil = Vorname, Rest = Nachname
Bei explizitem Mapping: Erstellen Sie separate Felder und mappen Sie:
- vorname → Vorname
- nachname → Nachname
Mehrfach-Mappings
Jedes Buchungsfeld kann nur einem sevDesk-Feld zugeordnet werden. Umgekehrt kann jedes sevDesk-Feld nur von einem Buchungsfeld befuellt werden.
Fehlerbehebung
Mapping wird nicht angewendet
Pruefen Sie: 1. Ist das sevDesk-Modul aktiviert? 2. Ist ein API-Token konfiguriert? 3. Wurden die Mappings gespeichert? 4. Hat das Buchungsfeld einen Wert?
Kontaktdaten fehlen in sevDesk
Pruefen Sie: 1. Mapping-Tabelle: Ist das Feld korrekt zugeordnet? 2. Buchung: Hat der Kunde das Feld ausgefuellt? 3. sevDesk: Wurde der Kontakt gefunden/erstellt?
Auto-Erkennung findet nichts
Die Auto-Erkennung basiert auf Feldnamen. Wenn Ihre Felder anders benannt sind (z.B. "Rufnummer" statt "Telefon"), muessen Sie manuell zuordnen.
Technische Details
| Aspekt | Wert |
|---|---|
| Modul-Klasse | Kurs_Booking_SevDesk_Fields |
| Option-Key | kurs_booking_sevdesk_field_mappings |
| AJAX-Actions | kurs_booking_sevdesk_save_field_mappings, kurs_booking_sevdesk_auto_detect_mappings |
| Seit Version | 2.9.0 |
Tipp: Testen Sie das Mapping mit einer Test-Buchung und pruefen Sie den erstellten Kontakt in sevDesk, bevor Sie live gehen.