CRM-Berichte & Integration

Transaktionen: CRM60 Partnerkunden Liste, CRM80 CRM-Integrationshistorie
UI-Pfade: /companyPartner, /customerTransfer

Business-Zweck

Dieser Bereich umfasst CRM-Auswertungen und das Monitoring externer CRM-Integrationen. Partner nutzen CRM60 für Partner-/Vertriebsauswertungen und CRM80 zur Fehleranalyse und Nachverfolgung von Synchronisationsläufen mit HubSpot, Salesforce o. ä.

CRM60 – Partnerkunden Liste

Transaktion: CRM60 Partnerkunden Liste
UI-Pfad: /companyPartner

Zweck

Jasper-Report zur Auswertung von Partnerkunden im CRM-Kontext – typischerweise Übersicht über zugeordnete Vertriebspartner, Kundenstrukturen oder Partnerprogramm-relevante Kontakte (mandantenspezifische Report-Konfiguration).

Partner-Relevanz

• Periodische Auswertung für Partner-Programme
• Export/Druck über Standard-Report-Infrastruktur
• Ergänzung zu API-basiertem Kundenexport (GET /api/customer/{id}?isExport=1)

Typischer Ablauf

1. Report in CRM60 öffnen
2. Filter setzen (Zeitraum, Partner, Region – je nach Report-Parameter)
3. PDF/Excel exportieren oder drucken

API-Alternative

Für automatisierte Integrationen ist der programmatische Kundenexport über /api/customer meist flexibler als der statische Report. CRM60 eignet sich für manuelle Partner-Controlling-Auswertungen.

CRM80 – CRM-Integrationshistorie

Transaktion: CRM80 CRM-Integrationshistorie
UI-Pfad: /customerTransfer

Zweck

Übersicht über CrmIntegrationCustomerTransfer-Einträge: ausstehende, laufende und fehlgeschlagene Kundenübertragungen zwischen reybex und externem CRM.

Kernbegriffe

Begriff	Bedeutung
CrmIntegration	Konfiguration: Provider, Endpoint, Token
CrmIntegrationCustomerTransfer	Einzelner Sync-Vorgang pro Kunde/Aktion
actionName	z. B. updateCustomer
processingStatus	0=zu verarbeiten, 1=in Bearbeitung, 2=Erfolg, 3=Fehler (Retry), 4=Fehler (final)
processingTries	Anzahl Versuche
errorMessage	Fehlertext bei Status 3/4
crmIntegrationCustomerId	Externe CRM-Kunden-ID

Fachlicher Ablauf

1. Export reybex → CRM: POST /api/crmIntegration/updateCustomers erzeugt/aktualisiert Transfer-Einträge
2. Import CRM → reybex: GET /api/crmIntegration/listCustomers (Job oder manuell)
3. Webhook: POST /api/crmIntegrationHook/updateCustomer bei Änderungen im externen CRM
4. Monitoring: CRM80 zeigt offene und fehlgeschlagene Transfers
5. Bereinigung: POST /api/crmIntegrationCustomerTransfer/deleteCustomerTransfer entfernt abgeschlossene/fehlerhafte Einträge aus der Queue

Verarbeitungsstatus

Status	Bedeutung	Partner-Aktion
0	Zu verarbeiten	Warten auf Job oder manuellen Trigger
1	In Bearbeitung	Laufender Sync – nicht erneut starten
2	Erfolg	Abgeschlossen (Standard: aus Liste ausgeblendet)
3	Fehler mit Retry	Job versucht erneut
4	Fehler ohne Retry	errorMessage prüfen, manuell korrigieren

Partner-Szenarien

Fehlerhafte Sync-Läufe analysieren

1. CRM80 öffnen, filtern auf Status 3/4
2. errorMessage und betroffene customerNo notieren
3. Stammdaten in reybex oder externem CRM korrigieren
4. Transfer-Einträge löschen oder erneut updateCustomers anstoßen

Vollabgleich aller Kunden

POST /api/crmIntegration/updateCustomers
{ "syncAllCustomers": true }

Erzeugt Transfer-Einträge für alle aktiven Kontakttypen (Interessent, Kunde, …).

Webhook-basierte Echtzeit-Sync

Externes CRM sendet bei Änderung:

POST /api/crmIntegrationHook/updateCustomer

reybex mappt über CustomerCrmIntegration.crmIntegrationCustomerId.

Interessent-Konvertierung aus externem CRM

Wenn externer Status „Kunde“ signalisiert:

POST /api/crmIntegrationHook/convertCustomer

Löst ggf. convertProspectToCustomer aus (siehe Interessenten & Kontakte).

Voraussetzungen

• Aktive CrmIntegration mit gültigem Provider, Token, Endpoint
• Provider-Client implementiert (CrmIntegrationClient, z. B. HubspotClient)
• Mapping-Tabelle CustomerCrmIntegration für bestehende Verknüpfungen
• Partner-User mit Recht CRM80; für API-Trigger zusätzlich Integrations-Rechte
• Kein paralleler Import (DomainLocker auf crmImportCustomers)

Auswirkungen im ERP

Aktion	Auswirkung
updateCustomers	Kunden im externen CRM aktualisiert
listCustomers	Kunden/Ansprechpartner aus CRM importiert
updateCustomer Hook	Echtzeit-Update einzelner Kunden
convertCustomer Hook	Interessent → Kunde, ggf. Re-Import
deleteCustomerTransfer	Queue bereinigt, kein Einfluss auf Stammdaten

Typische Fehlerquellen

• Integration deaktiviert – Crm integration must be added or enabled first
• Paralleler Import – Hook abgelehnt: List customer process is already in progress
• Unbekannter Provider – Client-Klasse nicht gefunden
• Fehlende CRM-ID – Mapping in CustomerCrmIntegration fehlt
• Doppelter updateCustomers – Process-Lock unterbricht zweiten Aufruf
• Transfer Status 4 – Datenfehler (Pflichtfeld, ungültige Referenz) – manuelle Korrektur nötig

Weiterlesen

• Technisch: CRM Integration API
• Kontakte: Interessenten & Kontakte
• Modulübersicht: CRM Modulübersicht
• Vertrieb: Kunden & Kontakte (SAL)