CRM Customer Data-Schnittstelle (CDI)

Die CRM Customer Data-Schnittstelle (CDI) wurde zu John Deere DBS 365 hinzugefügt, um Debitoren- und Kontaktdaten mit John Deere CRM zu synchronisieren.

In diesem Kapitel finden Sie die folgenden Abschnitte:

• Einrichtung
  • Einrichtung CRM Customer Data-Schnittstelle (CDI)
  • OAuth2-Einrichtung
  • Aufgabenwarteschlangen-Einrichtung
• Benutzerhandbuch
  • Aktionen für Customer Data-Schnittstelle
  • Debitorendaten an John Deere CRM senden
  • Debitorendaten von John Deere CRM empfangen

Einrichtung

Bitte führen Sie die Einrichtung in der folgenden Reihenfolge aus:

• Einrichtung CRM Customer Data-Schnittstelle (CDI)
• OAuth2-Einrichtung
• Aufgabenwarteschlangen-Einrichtung

Einrichtung CRM Customer Data-Schnittstelle (CDI)

Gehen Sie zum Einrichten der Customer Data-Schnittstelle wie folgt vor:

• Schließen Sie die Schritte im Abschnitt Basiseinrichtung der CRM-Integration ab.
• Öffnen Sie die Tabelle Schnittstellenliste in John Deere DBS 365 und wählen Sie den Eintrag JDCRMCUSTDATA aus.
• Im Inforegister Allgemein:
  • Aktivieren Sie den Schieberegler Schnittstellenprotokoll, um ein Protokoll aller Customer Data-Schnittstellenaktivitäten über die Schaltfläche Protokoll in der Menüleiste zu führen.

• Im Inforegister Autorisierung:
  • Wählen Sie im Feld Autorisierungsart den Wert OAuth2 aus.
  • Wählen Sie im Feld Autorisierungscode den Wert JDCRM aus.
• Geben Sie im Inforegister Parameter die folgenden Daten in das Feld Wert ein, um die Schnittstelle vorzubereiten:
  • AutomaticSync: Optional schaltet die automatische Synchronisierung von Debitorendaten mit John Deere CRM ein oder aus. Verfügbare Optionen:
    • beide: Debitorendaten werden in beiden Richtungen synchronisiert eingehend (von John Deere CRM nach John Deere DBS 365) und ausgehend (von John Deere DBS 365 nach John Deere CRM)
    • inaktiv: Synchronisierung ist deaktiviert
    • eingehend: Debitorendaten werden nur in eingehender Richtung synchronisiert (von John Deere CRM nach John Deere DBS 365)
    • ausgehend: Debitorendaten werden nur in ausgehender Richtung synchronisiert (von John Deere DBS 365 nach John Deere CRM)
  • DefaultCustomerTemplate: Optional definiert die Standarddebitorenvorlage, die zum Ausfüllen des zugehörigen Felds im CRM-Integrationsdatensatz verwendet wird.
    Im Feld DefaultCustomerTemplate von unbearbeiteten Debitorendatensatz-Seiten, die aus der Tabelle CRM-Integrationsdatensätze geöffnet werden, können Sie den Wert vor dem Abschluss sehen oder bearbeiten (nur möglich, wenn der Wert DBSID leer ist).
  • SystemID: Geben Sie die System-ID des John Deere CRM-Produktivmandanten ein.
  • WebServiceURL: Geben Sie die Adresse des Webdiensts ein, der für das Senden von Debitorendaten an John Deere CRM verwendet wird.
    Standardwert: https://interfacereceiverendpoint-prod.azurewebsites.net/api/customerdata
• Füllen Sie im Inforegister Pflichtfelder alle Werte in allen Zeilen aus, sofern sie nicht vorbefüllt sind. Aktivieren Sie anschließend das Kontrollkästchen Aktiv für die zu synchronisierenden Pflichtfeldwerte.

Wenn alle Anforderungen erfüllt sind (grüne oder graue Werte im Inforegister Parameter), fahren Sie mit der OAuth2-Einrichtung fort, um die Customer Data-Schnittstelleneinrichtung abzuschließen.

Zurück zum übergeordneten Abschnitt

OAuth2-Einrichtung

• Öffnen Sie die Seite OAuth2-Anwendungsendpunkte.
• Wählen Sie den Eintrag JDCRM aus, und klicken Sie auf die Schaltfläche Verwalten > Bearbeiten.
• Fügen Sie die Werte Client-ID und Client-Passwort für Ihr Mandanten-/Händlerkonto hinzu, um die Kommunikation zwischen John Deere DBS 365 und John Deere CRM zu ermöglichen.

Tipp

Falls für Händlerprozesse erforderlich, ist es möglich, John Deere-Profil-IDs für Kunden wie folgt hinzuzufügen:

• Öffnen Sie die Seite Debitoren.
• Wählen Sie den Debitor aus, dem die Profil-ID hinzugefügt werden soll, und klicken Sie auf die Schaltfläche Verwalten > Bearbeiten.
• Befüllen Sie im Inforegister Allgemein auf der Seite Debitorenkarte den Wert JD-Profil-ID mit der numerischen Profil-ID, die von John Deere verwendet wird.

Um die Customer Data-Schnittstelle zu nutzen, können Sie die Schnittstelle über die Schaltfläche Schnittstelle aktivieren auf der CRM-Schnittstellenkarte des Eintrags JDCRMCUSTDATA aktivieren.

Die Einrichtung der Customer Data-Schnittstelle ist abgeschlossen. Bitte fahren Sie mit dem Abschnitt Aufgabenwarteschlangen-Einrichtung fort, um die Aufgabenwarteschlange für die automatische Verarbeitung einzurichten.

Zurück zum übergeordneten Abschnitt

Aufgabenwarteschlangen-Einrichtung

Diese Aufgabenwarteschlange wird verwendet, um Debitorendaten automatisch zwischen John Deere DBS 365 und John Deere CRM auszutauschen. Gehen Sie zum Einrichten der Aufgabenwarteschlange wie folgt vor:

• Öffnen Sie in John Deere DBS 365 die Tabelle Aufgabenwarteschlangenposten.
• Klicken Sie auf die Schaltfläche Neu, um einen neuen Aufgabenwarteschlangenposten anzulegen.
• Nehmen Sie im Inforegister Allgemein auf der Seite Karte für Aufgabenwarteschlangenposten folgende Einstellungen vor:
  • Wählen Sie in dem Feld Art des auszuführenden Objekts den Wert Codeunit aus.
  • Wählen Sie in dem Feld ID des auszuführenden Objekts den Wert 5575063 aus.
  • Geben Sie im Feld Beschreibung eine eindeutige Beschreibung der Aufgabenwarteschlange ein, z. B.: Automatische Aktualisierung CRM-Debitorendaten
  • Geben Sie im Feld Parameterzeichenfolge den Wert für den entsprechenden Aufgabenwarteschlangenposten der CRM-Integration ein, d. h.: CrmCustomerData
  • Optional Geben Sie in dem Feld Früheste(s) Startdatum/-uhrzeit das Datum und die Uhrzeit ein, zu dem/der die Aufgabenwarteschlange das nächste Mal ausgeführt werden soll. Ist kein Wert ausgewählt, wird die Aufgabenwarteschlange ausgeführt, sobald Status = Bereit.
• Nehmen Sie im Inforegister Wiederholung auf der Seite Karte für Aufgabenwarteschlangenposten folgende Einstellungen vor:
  • Aktivieren Sie die Schieberegler für alle Wochentage.
  • Wählen Sie im Feld Startzeit eine möglichst frühe Tageszeit aus, damit die CRM-Daten ständig aktualisiert werden.
    Empfohlener Wert: 00:01:00 (12:01:00 AM).
  • Wählen Sie im Feld Endzeitpunkt einen möglichst späten Zeitpunkt aus, damit die CRM-Daten ständig aktualisiert werden.
    Empfohlener Wert: 23:59:00 (11:59:00 PM).
  • Geben Sie in das Feld Anzahl der Minuten zwischen Ausführungen einen Wert ein, der Ihren Prozess am besten widerspiegelt. Wir empfehlen einen Wert zwischen 15 und 60.
• Klicken Sie zum Starten der Aufgabenwarteschlange auf die Schaltfläche Verarbeiten  > Status auf 'Bereit' festlegen.

Die Aufgabenwarteschlange wird nun wie definiert ausgeführt und automatisch die CRM-Daten zwischen John Deere DBS 365 und John Deere CRM synchronisieren.

Zurück zum übergeordneten Abschnitt

Benutzerhandbuch

Nach erfolgreicher Einrichtung kann mit der CRM Customer Data-Schnittstelle (CDI) Folgendes erledigt werden:

Dieser Abschnitt zeigt alle Aktionen, die mit der Customer Data-Schnittstelle möglich sind, sowie die entsprechenden Ergebnisse. Er enthält die folgenden Unterabschnitte:

• Debitorendaten an John Deere CRM senden
• Debitorendaten von John Deere CRM empfangen
• Eingehende und ausgehende Kontaktdaten verarbeiten

Debitorendaten an John Deere CRM senden

Alle an John Deere CRM übermittelten Debitorendaten werden auf der Seite CRM-Integrationsdatensätze nachgehalten und weisen den Wert Richtung = Ausgehend auf. Nach dem Klicken auf Detaildaten können Sie den vollständigen Debitorendatensatz mit allen synchronisierten Daten einsehen. Jeder aktualisierte (Transaktionsart = Ändern), neu erstellte (Transaktionsart = Einfügen) und gelöschte (Transaktionsart = Löschen) Debitorendatensatz wird automatisch in John Deere CRM aktualisiert.

Im Feld CRM-Status im Inforegister CRM-Integration kann man sehen, ob ein Serviceartikel oder Debitor bereits mit John Deere CRM synchronisiert ist:

• Ausstehend (orange)
• Deaktiviert (grau)
• Aktiv (grün)

Das Feld Debitorenklassifizierung im Inforegister Allgemein auf der Seite Debitorenkarte zeigt die folgenden Codes, was eine spezifischere Filterung und Planung ermöglicht:

• A = Kunde mit hohem Potenzial
• B = Kunde mit mittlerem Potenzial
• C = Kunde mit geringem Potenzial
• K = Großkunde
• S = strategischer Kunde

Zurück zum übergeordneten Abschnitt

Debitorendaten von John Deere CRM empfangen

Die Puffertabelle CRM CustomerData sammelt alle von John Deere CRM eingehenden Informationen und zeigt die Detaildaten an, die immer dann mit John Deere CRM ausgetauscht werden, wenn neue oder geänderte Debitorendaten empfangen oder gesendet werden. Nach dem Klicken auf einen Posten in der Puffertabelle wird die Seite Debitorendatensatz schreibgeschützt geöffnet, um weitere Informationen anzuzeigen.

Nach dem Importieren der über die Aufgabenwarteschlange CrmCustomerData empfangenen John Deere CRM-Debitorendaten aus der Puffertabelle können die entsprechenden Posten auf der Seite Integrationsdatensätze überprüft werden. Falls der Integrationsdatensatz nicht den Wert DBSID enthält, prüft John Deere DBS 365, ob bereits ein Debitor mit der entsprechenden CRM-ID in der Tabelle Debitoren vorhanden ist. Falls ja, wird der bestehende Debitor entsprechend aktualisiert. Falls nicht, wird ein neuer Debitor erstellt. Die von John Deere CRM empfangenen Kontaktdaten werden in John Deere DBS 365 weder aktualisiert noch erstellt.

Beim Empfangen von neuen Debitorendaten von John Deere CRM können Benutzer entscheiden, welche Daten sie von der CDI-Aktualisierung übernehmen wollen. Navigieren Sie hierzu zum Inforegister Details der CDI-Integrationssätze und gehen Sie wie folgt vor:

• Um die bedingte Hervorhebung der von John Deere CRM eingehenden Debitorenaktualisierungen zu aktivieren, muss der Parameter AutomaticSync auf der JDCRMCUSTDATA-Schnittstellenseite den Wert inaktiv oder ausgehend aufweisen. Ansonsten wird das Inforegister Details in CDI-Integrationsdatensätzen nicht angezeigt.
• Falls es Unterschiede bei den Debitorendaten gibt (siehe nächster Aufzählungspunkt erster Ebene), können die Benutzer entscheiden, ob sie die von John Deere CRM eingehenden Änderungen übernehmen. Hierfür wird das Kontrollkästchen Daten übernehmen verwendet:
  • Kontrollkästchen Daten übernehmen aktiviert: Die aktualisierten Daten werden bei Abschluss des Imports in den John Deere DBS 365-Debitorendatensatz übernommen.
  • Kontrollkästchen Daten übernehmen deaktiviert: Die aktualisierten Informationen werden bei Abschluss des Imports nicht übernommen, d. h. es besteht von nun an ein Unterschied zwischen den Debitorendaten von John Deere CRM und John Deere DBS 365.
  • Über die entsprechenden Schaltflächen in der Menüleiste des Inforegisters Details können Änderungen für alle oder neue Zeilen stapelweise übernommen oder abgelehnt werden. Die entsprechenden Kontrollkästchen werden je nach Auswahl automatisch aktiviert.

Beim Empfangen von aktualisierten Debitorendaten aus John Deere CRM (Diese Funktion gilt nicht für die Aktualisierung von Kontakten!) werden Unterschiede in den Debitorendaten nun im Inforegister Details des Integrationsdatensatzes wie folgt hervorgehoben:

• Keine Einfärbung: keine Datenaktualisierung verfügbar, d. h. John Deere CRM und John Deere DBS 365 haben den gleichen Wert, oder eine eingehende Änderung wurde in John Deere DBS 365 während einer früheren Aktualisierung nicht übernommen.
• Rot Einfärbung in der Spalte CRM-Daten: Die aktualisierten Daten unterscheiden sich zwischen John Deere CRM und John Deere DBS 365.
• Rote Einfärbung in der Spalte DBS-Daten: John Deere DBS 365 enthält Daten, die in John Deere CRM nicht verfügbar sind.
• Grüne Einfärbung in der Spalte CRM-Daten: Es gehen neue Informationen von John Deere CRM ein, die vorher in John Deere DBS 365 nicht vorhanden waren.

Tipp

• Debitoren mit CRM-ID oder DBS-ID werden automatisch aktualisiert.
• Wird bei einem bestehenden Debitor ein übereinstimmender Wert USt-IdNr. oder JD-Profil-ID gefunden, wird eine Option angezeigt, die alle Debitoren in John Deere DBS 365 auflistet, die genau diesen Wert enthalten, sodass der Benutzer den richtigen Debitor auswählen kann.
• Verfügt ein Debitor nicht über eine CRM-ID, eine DBS-ID oder einen übereinstimmenden Wert USt-IdNr./JD-Profil-ID, müssen Benutzer auf die Schaltfläche Debitor erstellen/aktualisieren klicken, um einen neuen Debitor in John Deere DBS 365 anzulegen.

Zurück zum übergeordneten Abschnitt

Eingehende und ausgehende Kontaktdaten verarbeiten

Beim Öffnen eines Integrationsdatensatzes mit Schnittstellenart = JDCRMCUSTDATA über die Schaltfläche Detaildaten in der Menüleiste der Seite CRM-Integrationsdatensätze werden die Informationen aus den beiden Inforegistern Debitor und Kontakt importiert und nach dem Ausführen der Aufgabenwarteschlange verarbeitet:

• Wenn ein neuer Debitor von John Deere CRM eingeht, wird automatisch auch ein Kontakt mit Allgemein > Art = Person angelegt.
• Wenn ein neuer Debitor von John Deere DBS 365 eingeht, werden die Information zu John Deere CRM hinzugefügt.
• Wenn Debitoren- oder Kontaktinformationen in John Deere CRM geändert werden (siehe spezifischer Integrationsdatensatz), werden sie auch in John Deere DBS 365 aktualisiert.
• Wenn die Kontaktdaten des Hauptkontakts (Allgemein > Art = Unternehmen) in John Deere DBS 365 geändert werden, werden die aktualisierten Informationen mit John Deere CRM synchronisiert.
• Werden die Kontaktdaten eines Unterkontakts (Allgemein > Art = Person) in John Deere DBS 365 geändert, werden keine Daten mit John Deere CRM synchronisiert, die Daten werden nur in John Deere DBS 365 geändert.

Es ist auch möglich, Debitoren-/Kontaktdatensätze manuell über die Schaltfläche Debitor anlegen/aktualisieren in der Menüleiste eines Integrationsdatensatzes anzulegen oder zu aktualisieren, solange der Integrationsdatensatz noch nicht bearbeitet wurde. Verarbeitete Integrationsdatensätze zeigen die Schaltflächen Debitor und Kontakte in der Menüleiste an, um direkt auf den entsprechenden Datensatz zuzugreifen (basierend auf dem Wert Debitor > DBSID).

Um die ID zu sehen, die in John Deere CRM für einen Kontakt verwendet wird, wurde dem Inforegister CRM-Integration auf der Seite Kontaktkarte das Feld CRM-Kontakt-ID hinzugefügt. Dieser Wert wird ausgefüllt, wenn CRM-Status = Aktiv.
Der Hauptkontakt wird auf der Seite Kontakte immer in Fettdruck geschrieben und repräsentiert die Muttergesellschaft (Allgemein > Art = Unternehmen), d. h. die CRM-ID ist für diesen Kontakt und den zugehörigen Debitor gleich.

Wenn der Schieberegler CRM deaktiviert im Inforegister CRM-Integration auf einer Seite Debitorenkarte aktiviert wird, wird dieser Debitor mit allen untergeordneten Kontakten nicht mehr synchronisiert, bis der Schieberegler in John Deere DBS 365 oder John Deere CRM wieder aktiviert wird. Diese Funktion ist nützlich, wenn ein Unternehmen abgemeldet wurde oder wenn es einen doppelten Eintrag gibt (das Löschen ist in John Deere CRM nicht möglich).

Zurück zum übergeordneten Abschnitt