CRM-Aktionen (CRM08)

Transaktion: CRM08 Aktionen
UI-Pfad: /crmActions

Business-Zweck

CRM-Aktionen dokumentieren vertriebliche Aktivitäten am Kunden: Telefonate, E-Mails, Besuche, Wiedervorlagen und Unteraktionen. Sie bilden die Aktivitätshistorie ab und können mit Verkaufschancen, Vertriebsbelegen (Angebote) und Retouren verknüpft werden.

Partner synchronisieren Aktivitäten aus externen CRM-Systemen oder erzeugen sie als Folge automatisierter Workflows (z. B. nach Shop-Registrierung).

Kernbegriffe

Begriff	Bedeutung
CrmAction	CRM-Aktivität mit Text, Datum, Status, Verantwortlichem
actionKind	Art der Aktion (z. B. Wiedervorlage type=2 für Toolbar)
actionStatus	Bearbeitungsstatus (offen/erledigt via isDone)
actionType	Kategorie: Telefon, E-Mail, Meeting, persönlich
mainAction / isSubAction	Hierarchie: Unteraktionen an Hauptaktion
user / userDelegatedTo	Verantwortlicher / delegierter Bearbeiter
usersToBeInformed	Benutzer für E-Mail-Benachrichtigung
crmOpportunity	Optionale Verknüpfung zur Verkaufschance
offers	Verknüpfte Vertriebsbelege (SalesHead.refCrmAction)
appointment	Kalendertermin (optional, Exchange-Sync)

Fachlicher Ablauf / Workflow

Aktion anlegen

1. Kunde (customer) und Aktionstext (actionText) setzen
2. Datum (actionDate), optional Enddatum (endDate)
3. Status (actionStatus), Priorität (actionPriority), Grund (actionReason)
4. Verantwortlichen User zuweisen
5. Optional: Verkaufschance, Retoure, Kampagne verknüpfen
6. Speichern via UI oder POST /api/crmAction/

Wiedervorlage / Toolbar

Offene Wiedervorlagen (actionKind type=2) erscheinen in der CRM-Toolbar für den zuständigen User – abrufbar über GET /api/crmAction/crmActionListForToolbar (±5 Tage um heute).

Unteraktionen

1. Hauptaktion mit hasSubActions = true
2. Unteraktion mit mainAction.id und isSubAction = true
3. Liste: GET /api/crmAction/subActionList

Termin aus Aktion

1. Aktion speichern mit createAppointment = true oder nachträglich:
2. POST /api/crmAction/createAppointment/{id} – erzeugt Appointment
3. Datumsänderung synchronisiert Termin: GET /api/crmAction/updateAppointment?id=...

Benachrichtigung

Bei isInformUser = true und gesetzten usersToBeInformed versendet reybex eine Informations-E-Mail (mailingService.sendInformationAboutCrmActionMail).

Partner-Szenarien

Aktivität aus externem CRM importieren

POST /api/crmAction/

{
  "customer": { "id": 9876543210987654 },
  "actionText": "Follow-up Produktdemo",
  "actionDate": "2026-09-15",
  "actionKind": { "id": 1 },
  "actionStatus": { "id": 1 },
  "user": { "id": 1234567890123456 },
  "actionTextLong": "<p>Details aus externem CRM</p>"
}

Update: gleicher Endpoint mit id im Body.

Aktivitäten lesen (Delta-Sync)

GET /api/crmAction/?startDate=2026-09-01&endDate=2026-09-30

Kendo-Grid-Parameter für Filter, Sortierung, Paginierung unterstützt.

Aktivität mit Verkaufschance

{
  "customer": { "id": 9876543210987654 },
  "crmOpportunity": { "id": 1111222233334444 },
  "actionText": "Verhandlung Phase 2"
}

Löschen (Batch)

DELETE /api/crmAction/

Body: { "crmActions": [id1, id2] }

Voraussetzungen

• Kunde muss existieren (CRM02 oder konvertierter Interessent)
• User für user-Pflichtfeld muss gültig sein
• Prüftabellen: ActionKind, ActionStatus, ActionType, ActionPriority
• Für Termine: Kalender-/Exchange-Konfiguration im Mandanten
• Partner-User mit Recht CRM08

Auswirkungen im ERP

Aktion	Auswirkung
Neue Aktion	Historie am Kunden, ggf. E-Mail an informierte User
Termin erstellen	Eintrag im Kalender, optional Exchange-Sync
Verknüpfung Angebot	Nachverfolgung Vertriebsaktivität ↔ Beleg
Löschen	Soft-Delete über customerService.deleteCrmAction
Unteraktion	Hauptaktion markiert als hasSubActions

Typische Fehlerquellen

• Fehlender User – Validierung message.followActionUser.empty.error
• Termin existiert bereits – appointment.exist bei doppeltem createAppointment
• Ungültiges Datum – actionDate muss parsebar sein
• Falsche actionKind-ID – mandantenspezifische Prüftabelle
• HTML in actionTextLong – in Toolbar wird HTML per Jsoup bereinigt angezeigt
• Bulk-Delete ohne IDs – leere crmActions-Liste

Weiterlesen

• Technisch: CRM Action API
• Kontakte: Interessenten & Kontakte
• Pipeline: Verkaufschancen
• Schnellerfassung: Schnellerfassung (Kunde + Aktion kombiniert)
• Vertrieb: Angebote