Schnellerfassung (CRM12)

Transaktion: CRM12 Schnellerfassung
UI-Pfad: /quickInformationEnter

Business-Zweck

Die Schnellerfassung ermöglicht die kombinierte Neuanlage von Kontakt, CRM-Aktion und Ansprechpartner in einem Schritt – typisch für Telefon-Leads, Messen oder schnelle manuelle Erfassung durch den Vertrieb.

Technisch entspricht dies dem Endpoint POST /api/crm/crmMask (CrmApiService.saveCrmMask). Partner automatisieren diesen Flow für Lead-Capture-Formulare oder Call-Center-Integrationen.

Kernbegriffe

Begriff	Bedeutung
crmMask	API-Payload für Schnellerfassung (Kunde + Aktion + optional Ansprechpartner)
crmMaskDefaultValues	Standardwerte für UI/API (User, Land, Währung, ActionKind)
copyToContactPerson	Kontaktdaten vom Mitarbeiter-Eintrag auf Ansprechpartner kopieren
customerEmployee	Verknüpfung Kunde ↔ Ansprechpartner mit Telefon/E-Mail
checkAndUpdateCustomerNo	Automatische Nummernvergabe je nach Kontakttyp

Fachlicher Ablauf / Workflow

Schnellerfassung in der UI (CRM12)

1. Maske öffnen – Defaults laden (GET /api/crm/crmMaskDefaultValues)
2. Kontaktdaten erfassen (Name, Adresse, Kontakttyp)
3. CRM-Aktion erfassen (Text, Datum, Art, Status)
4. Optional: Ansprechpartner mit Telefon/E-Mail
5. Speichern – ein Transaktionsschritt legt alle Objekte an

Ablauf im Backend (saveCrmMask)

1. Customer anlegen oder aktualisieren (params.customer)
2. customerNo prüfen/vergeben via crmService.checkAndUpdateCustomerNo
3. CrmAction anlegen und dem Kunden zuordnen (params.action)
4. Optional ContactPerson + CustomerEmployee als Hauptansprechpartner
5. Response: { customerId, actionId }

USt-ID-Sammelprüfung

Über CRM-Modul können mehrere Kunden für USt-ID-Validierung geprüft werden:

• POST /api/crm/checkCustomerUstId mit customerIds[]
• Ergebnis: success[] und fails[] mit Fehlerdetails pro Kunde
• Länderliste für USt-Check: GET /api/crm/countryList

Partner-Szenarien

Lead-Formular (Web-to-Lead)

GET /api/crm/crmMaskDefaultValues

Defaults für Mandant laden, dann:

POST /api/crm/crmMask

{
  "customer": {
    "name": "Lead aus Webformular",
    "email": "lead@example.de",
    "street": "Hauptstraße 5",
    "zipcode": "10115",
    "city": "Berlin",
    "contactType": { "id": "<Interessent-ID>" }
  },
  "action": {
    "actionText": "Web-Anfrage Produkt X",
    "actionDate": "2026-09-09",
    "actionKind": { "id": 1 },
    "actionStatus": { "id": 2 },
    "user": { "id": 1234567890123456 }
  },
  "customerEmployee": {
    "phone": "+49 30 123456",
    "email": "lead@example.de",
    "contactPerson": {
      "firstname": "Max",
      "surname": "Mustermann"
    }
  },
  "copyToContactPerson": true
}

Nur Kunde + Aktion (ohne Ansprechpartner)

customerEmployee weglassen – es werden nur Customer und CrmAction angelegt.

Bestehenden Kunden ergänzen

Wenn customer.id gesetzt ist, wird der bestehende Datensatz aktualisiert und eine neue Aktion angehängt.

Voraussetzungen

• Defaults: konfiguriertes Firmenland, Heimatwährung, ActionKind (type=1), ActionStatus
• User-Kontext aus Auth-Session (Default-User in Defaults)
• ContactType für Interessent/Kunde im Mandanten
• Nummernkreis-Logik für automatische customerNo
• Partner-User mit Recht CRM12

Auswirkungen im ERP

Aktion	Auswirkung
crmMask (neu)	Customer + CrmAction + optional ContactPerson
crmMask (Update)	Kundenstamm aktualisiert, neue Aktion
copyToContactPerson	Telefon/E-Mail auf Ansprechpartner gespiegelt
checkCustomerUstId	USt-Prüfhistorie (CustomerUstCheckHistory)

Typische Fehlerquellen

• Fehlende Pflichtfelder in action – User, ActionKind, ActionStatus
• Ungültiger contactType – falsche ID → falsche CRM-Sicht (Interessent vs. Kunde)
• Doppelte customerNo – Konflikt bei manueller Nummer statt Auto-Vergabe
• USt-Check ohne Firmen-USt-ID – error.ustCheck.NoCompanyUstId
• Defaults nicht geladen – UI/API ohne crmMaskDefaultValues liefert unvollständige Masken

Weiterlesen

• Technisch: CRM API
• Einzelprozesse: Interessenten & Kontakte, CRM-Aktionen
• Vertrieb: Kunden & Kontakte (SAL)
• Stammdaten: Kontakt-Import