Interessenten & Kontakte

Transaktionen: CRM01 Interessenten, CRM02 Kontakte
UI-Pfade: /prospects, /customers

Business-Zweck

Im CRM-Modul werden Kontakte über dieselbe Domäne Customer wie im Vertrieb verwaltet – unterschieden durch den Kontakttyp (ContactType):

• CRM01 Interessenten – Leads und potenzielle Kunden (ContactType.type = 0, Interessent)
• CRM02 Kontakte – qualifizierte Kunden und CRM-relevante Debitoren (ContactType.type = 1, Kunde)

Partner synchronisieren Leads aus externen CRM-Systemen, Shops oder Messe-Listen und konvertieren qualifizierte Interessenten zu Debitoren für den Vertrieb (SAL01/SAL16).

Kernbegriffe

Begriff	Bedeutung
Customer	Zentraler Kontakt-Stammdatensatz (Interessent, Kunde, Lieferant)
ContactType	Steuert Rolle: 0=Interessent, 1=Kunde, 2=Lieferant, 3=Sonstige
customerNo	Interne Kontaktnummer; kann bei Konvertierung neu vergeben werden
CustomerEmployee	Verknüpfung Kunde ↔ Ansprechpartner (ContactPerson)
CustomerCrmIntegration	Mapping zu externer CRM-ID bei Integration
convertProspectToCustomer	Umwandlung Interessent → Debitor mit neuer Kundennummer

Fachlicher Ablauf / Workflow

Interessent anlegen (CRM01)

1. Kontakt mit ContactType Interessent anlegen (POST /api/customer/)
2. Stammdaten: Name, Adresse, E-Mail, Telefon, Branche
3. CRM-Aktionen und Verkaufschancen zuordnen
4. Bei Qualifizierung: Konvertierung zu Kunde

Kontakt pflegen (CRM02)

1. Bestehenden Kunden lesen/aktualisieren
2. Ansprechpartner und Adressen pflegen
3. USt-ID prüfen (POST /api/crm/checkCustomerUstId oder SAL-Endpoint)
4. Für Vertrieb: Kunde ist referenzierbar in SalesHead.customer

Interessent → Kunde konvertieren

1. Interessent ist qualifiziert (Budget, Entscheidung, Auftrag geplant)
2. Konvertierung auslösen: GET /api/customer/convertProspectToCustomer/{id}
3. System setzt ContactType auf Kunde und vergibt ggf. neue customerNo über Nummernkreis-Logik (crmService.checkAndUpdateCustomerNo)
4. FiBu-Konto wird gesetzt (customerService.setAccount)
5. Kunde erscheint in SAL01 und ist für Aufträge nutzbar

Automatische Konvertierung

Bei Auftragserstellung kann reybex Interessenten automatisch konvertieren, wenn der Vertriebsbeleg einen Interessenten referenziert (SalesHeadApiService ruft convertProspectToCustomer auf). Partner sollten dieses Verhalten kennen und ggf. vorab manuell konvertieren.

Partner-Szenarien

Externes CRM – Connector-Import

Für CRM-Connectoren (bidirektionale Integration):

POST /api/customer/crmSaveForConnector

Body mit customers[]-Array. Pro Eintrag u. a.:

• ourCustomerNumber – Schlüssel (findet bestehenden oder legt neu an)
• name, street, zipcode, city, countryCode, currencyCode
• contactEmail, contactName, customerContact – Ansprechpartner
• paymentDuration, salesPersonCode – optional Zahlungsbedingung/Vertreter

Response: { "success": [...], "fails": [...] } – fehlgeschlagene Nummern für Retry.

Lead aus Shop/Portal

Einzelanlage wie SAL-Kunde, aber mit Interessent-Kontakttyp:

{
  "name": "Neuer Lead GmbH",
  "customerNo": "L-5001",
  "contactType": { "id": "<Interessent-ContactType-ID>" },
  "email": "info@lead.de",
  "street": "Musterweg 1",
  "zipcode": "80331",
  "city": "München"
}

Vollsync mit Delta

Periodischer Abgleich über GET /api/customer/{id} mit Kendo-Filter auf lastUpdated oder Export ?isExport=1.

Webhook aus externem CRM

Bei CRM-Integration: POST /api/crmIntegrationHook/updateCustomer – aktualisiert oder legt Kunden anhand externer ID an (siehe CRM Integration API).

Voraussetzungen

• Mandant mit konfigurierten ContactType-Einträgen (Interessent, Kunde)
• Nummernkreis für Kundennummern bei Konvertierung
• Partner-User mit Recht CRM01 / CRM02
• Eindeutige customerNo pro Mandant (oder definierte Matching-Strategie)
• Für Connector-Import: gültige countryCode, currencyCode in Prüftabellen

Auswirkungen im ERP

Aktion	Auswirkung
Neuer Interessent	Referenzierbar in CRM08, CRM10; noch kein SAL-Auftrag (ohne Konvertierung)
Konvertierung zu Kunde	Neuer/evtl. geänderter customerNo, FiBu-Konto, SAL01-Sichtbarkeit
crmSaveForConnector	Upsert inkl. Ansprechpartner; Fehler pro Nummer isoliert
Adressänderung	Wirkt auf CRM-Aktionen, Chancen, ggf. offene Belege
Löschen	Blockiert bei Referenzen (Belege, Aktionen)

Typische Fehlerquellen

• Interessent statt Kunde in Auftrag – Auftragserstellung schlägt fehl oder konvertiert unerwartet
• Doppelte customerNo – Connector/Import überschreibt oder bricht ab
• Fehlender ContactType Kunde – customerType.not.found.error bei Konvertierung
• Lieferant konvertieren – convertProspectToCustomer lehnt Vendor ab
• Hardcodierte ContactType-IDs – mandantenspezifisch, immer per API/Config ermitteln
• crmSaveForConnector: unbekannter countryCode – Land nicht in Prüftabelle

Weiterlesen

• Technisch: Customer API (CRM)
• Vertrieb: Kunden & Kontakte (SAL), Customer API (SAL)
• Stammdaten: Kontakt-Import
• Folgeprozesse: CRM-Aktionen, Verkaufschancen
• Integration: CRM Integration API