Aktualisiert: 13.01.2025

Build & Price-Integration (B&P)

Build & Price (B&P) ist ein John Deere-System, das es Händlern ermöglicht, Produkte durch Auswahl des Maschinenmodells, das sie einem Debitor anbieten oder für das eigene Lager bestellen möchten, zu konfigurieren und anschließend alle Konfigurationsoptionen in einer webbasierten Umgebung auszuwählen.

In diesem Kapitel finden Sie die folgenden Abschnitte:

Einrichtung

Bevor Sie die B&P-Funktionen nutzen können, muss die B&P-Integration korrekt eingerichtet werden. Bitte folgen Sie den Anweisungen in den folgenden Unterabschnitten Schritt für Schritt:

Tipp

Wenn Sie die Live-Umgebung von Produktiv auf Test umstellen möchten, klicken Sie in der Menüleiste auf die Schaltfläche Ausführungsmodus wechseln.

Schnittstellenliste

Die Basiseinrichtung wird automatisch in der Tabelle Schnittstellenliste vorgenommen, sobald ein Mandant erstellt wird. Für die B&P-Integration ist eine individuelle Einrichtung erforderlich, da sie von kundenspezifischen Händlerwerten abhängt. Gehen Sie zum Abschließen der Einrichtung wie folgt vor:

  • Öffnen Sie die Tabelle Schnittstellenliste in John Deere DBS 365 und wählen Sie den Eintrag JDBNP aus.
  • Im Inforegister Allgemein:
    • Wählen Sie im Feld Richtung den Wert Eingehend aus.
    • Aktivieren Sie den Schieberegler Schnittstellenprotokoll, um ein Protokoll aller B&P-Integrationsaktivitäten über die Schaltfläche Protokoll in der Menüleiste zu führen.

Tipp

Aktivieren Sie bei Bedarf die automatische Löschung von Zeilen auf der Seite Schnittstellenprotokoll nach einer bestimmten Zeit, indem Sie einen Wert in das Feld Protokolleinträge löschen nach eingeben.
Beispiel: 2J = alle Protokolleinträge, die älter als 2 Jahre sind, werden automatisch gelöscht. Informationen zur Eingabe eines Zeitraums finden Sie hier.

  • Im Inforegister Autorisierung:
    • Wählen Sie im Feld Autorisierungsart den Wert OAuth2 aus.
    • Wählen Sie im Feld Autorisierungscode den Wert BNP PROD aus.
    • Wählen Sie im Feld Bereich den Wert BNP PROD aus.
  • Geben Sie im Inforegister Parameter in das Feld Wert die folgenden Informationen ein, um die Schnittstelle vorzubereiten.
    Alle Werte sind standardmäßig vorgegeben, und es müssen keine individuellen Einstellungen vorgenommen werden:
    • BuildAndPriceURL: definiert die URL, mit der die B&P-Website geöffnet wird.
      Standardwert: https://salescenter.deere.com
    • DataExchangeURL: definiert die Basis-URL für den Zugriff auf Konfigurationsdaten.
      Standardwert: https://om-api.deere.com
    • MaxSessionValidity: legt die Dauer (in Stunden) fest, die eine in B&P geöffnete Sitzung gültig ist, d. h. die Zeit zwischen dem Starten der B&P-Website und dem Klicken auf Send to DBS (An DBS senden) im B&P-Portal.
      Standardwert: 4
    • NewConfigurationEndpoint: definiert die Endpunkt-URL zum Öffnen der B&P-Website, um eine neue Konfiguration zu starten.
      Standardwert: /#/crm/build-price
    • ReConfigurationEndpoint: definiert die Endpunkt-URL, mit welcher eine bestehende Konfiguration von der BNP-Website erneut geöffnet wird.
      Standardwert: /#/crm/%1/build-price/reconfigure/options-and-attachments
    • RetrieveConfigurationEndpoint: definiert die Endpunkt-URL zum Aufruf einer B&P-Konfiguration mit einer Konfigurations-ID.
      Standardwert: /om/data-exchange/retrieve/
    • ReturnUrlAppKey: wird zur Autorisierung gegenüber Azure Function benötigt, um die Rückgabe-URL zu verwalten.
    • ReturnUrlHandlerEndpoint: definiert die Endpunkt-URL zum Abrufen von Konfigurations-IDs von B&P.
      Standardwert: https://jdbuildnpriceconfighandler.azurewebsites.net

Tipp

Alle Inforegister können über die individuelle Schaltfläche Wiederherstellen > *<Inforegisterbezeichnung> wiederherstellen auf die Standardeinstellungen zurückgesetzt werden.

Wenn alle Anforderungen erfüllt sind (grüne oder graue Werte im Inforegister Parameter), können Benutzer die Schnittstelle über die Schaltfläche Schnittstelle aktivieren auf der B&P-Schnittstellenkarte aktivieren.

Die Basiseinrichtung der B&P-Integration ist abgeschlossen. Fahren Sie mit der Konfiguratoreinrichtung fort.

Zurück zum übergeordneten Abschnitt

Konfiguratoreinrichtung

Auf der Seite Konfiguratorliste muss der Konfigurator für John Deere und B&P erstellt werden, um Konfigurationen in das Zielobjekt zu übertragen. Gehen Sie hierzu wie folgt vor:

  • Öffnen Sie die Seite Konfiguratorliste in John Deere DBS 365.
  • Klicken Sie auf den Wert Build & Price, um die Unterseite Konfiguratorkarte zu öffnen.
  • Wählen Sie im Feld Schnittstellenart den soeben in der Tabelle Schnittstellenliste aktivierten Eintrag Build & Price aus.
  • Wählen Sie im Feld Hersteller den Wert JD aus.
  • Wählen Sie im Feld Kred.-Nr. den für John Deere eingerichteten Kreditor aus.
  • Aktivieren Sie den Konfigurator, indem Sie auf die Schaltfläche Aktivieren in der Menüleiste klicken.

Die Einrichtung der B&P-Integration ist abgeschlossen. Informationen zur Verarbeitung von B&P-Konfiguratordateien finden Sie hier.

Zurück zum übergeordneten Abschnitt

Benutzerhandbuch

In diesem Abschnitt werden die Aufgaben beschrieben, die mit der B&P-Integration durchgeführt werden können. Er enthält die folgenden Unterabschnitte:

Konfiguratordateien erstellen und verarbeiten

Die Konfigurationen von B&P aus dem John Deere Build & Price-Portal werden über JSON-Dateien an John Deere DBS 365 übertragen. Der Prozess auf hoher Ebene sieht wie folgt aus (die Schnittstelle muss eingerichtet und aktiviert sein):

  1. Ein Konfiguratorprozess wird in einer Einkaufsbestellung oder einer Verkaufskalkulation durch Klicken auf Aktionen > Konfigurator > Konfiguration laden in der Menüleiste oder auf Neu  Konfigurator > Konfiguration laden im Inforegister Zeilen gestartet. Anschließend wird das Build & Price-Webportal in einer separaten Sitzung geöffnet.
  2. Im Build & Price-Webportal kann eine Konfiguration erstellt oder eine bestehende Konfiguration ausgewählt und direkt an John Deere DBS 365 übertragen werden.

Wichtig

Die Sitzung hat eine Standardzeitspanne von 10 Minuten, bevor sie automatisch beendet wird. Achten Sie darauf, die Konfiguration rechtzeitig zu übertragen. Nach der Zeitspanne muss die Sitzung neu gestartet werden.

  1. Wenn die Konfiguration in der separaten Sitzung erfolgreich abgeschlossen wurde, kann die Seite geschlossen werden. Die exportierte Konfiguration (JSON-Datei) wird an John Deere DBS 365 gesendet und dort verarbeitet.
  2. Anhand des separaten Sitzungstokens weiß John Deere DBS 365, in welches Dokument die Konfigurationsdaten aus der JSON-Datei importiert werden müssen. Die Daten der JSON-Datei werden zunächst in der Tabelle Herstellerkonfigurationen gespeichert und dann in das entsprechende Dokument kopiert, von dem aus der Konfigurator gestartet wurde.
  3. Beim Öffnen einer Konfiguration durch Anklicken des Werts Beschreibung in der Tabelle Herstellerkonfigurationen wurde die Spalte Sortierreihenfolge zum Inforegister Konfiguration auf der Seite Herstellerkonfigurationskarte hinzugefügt, um die ursprüngliche Reihenfolge der Konfigurationen zu sehen, falls die Sortierung geändert wird.

Tipp

Wenn eine Einkaufsbestellung aus einer Verkaufskalkulation mit einer B&P-Konfiguration erstellt wird, ist der Wert Warenkorbnr. ebenfalls verfügbar. Die Quelle der Konfigurations-ID hängt vom Quellbeleg ab:

  • Wenn die Einkaufsbestellung aus der Verkaufskalkulation stammt, ist die Quelle der Wert B&P-Warenkorbnr. von der Seite Maschine der Kundenbestellung.
  • Wenn die Einkaufsbestellungszeilen aus der B&P-Integration stammen, ist die Quelle der Wert QuoteID aus der B&P-Rückgabe-URL.

Zurück zum übergeordneten Abschnitt

Konfiguratordateien laden und verarbeiten

Um eine zuvor eingerichtete Konfiguration zu laden, wurde die Schaltfläche Aktionen/Neu > Konfigurator > Konfiguration laden auf der Seite Einkaufsbestellung bzw. im Inforegister Zeilen der Seite Verkaufskalkulation hinzugefügt. Nachdem Sie auf die Schaltfläche geklickt haben, werden alle Konfiguratoren geladen und basierend auf Aktiv  = ja, Hersteller (falls in einer Einkaufsbestellung auf die Schaltfläche geklickt wurde) au dem Wert Kreditor gefiltert.

  • Wenn der Hersteller und/oder Kreditor bekannt ist, wird die Anzahl der Ergebnisdatensätze reduziert.
  • Wenn weder Hersteller noch Kreditor bekannt sind, wird die Konfiguratorliste geöffnet, aus der Sie einen Posten auswählen können.
  • Wenn nur der Kreditor bekannt ist, wird der Hersteller automatisch befüllt, und Sie müssen den korrekten Posten selbst auswählen.
  • Wenn genau ein Posten gefunden wird, wird nur dieser automatisch ausgewählt.

Es ist möglich, JSON- oder XML-Konfiguratordateien mit B&P zu verarbeiten. Konfigurationen sind auf der Seite Herstellerkonfigurationen zu finden. Wenn Sie auf einen Posten klicken, wird die Seite Herstellerkonfigurationskarte zusammen mit einem Inforegister Konfiguration angezeigt. Auf der Seite Herstellerkonfigurationen können Maschinenmanager den Konfigurationsimport aus JSON- oder XML-Dateien eines beliebigen Herstellerkonfigurators einrichten, z. B. B&P von John Deere. Die Schaltfläche Notizen anzeigen in der Menüleiste der Seiten wird verwendet, um die in der XML-/JSON-Datei verfügbaren Notizen anzuzeigen.

Um eine Konfiguration für andere Kreditoren zu erstellen, werden Konfigurationszeilen mit Art = Zubehör auf Katalogartikel mit gefüllten Werten Herstellercode, Kred.-Nr. und Kred.-Artikelnr. geprüft. Wenn kein Katalogartikel mit dieser Spezifikation existiert, wird eine Fehlermeldung angezeigt. Wenn ein Katalogartikel vorhanden ist, sucht John Deere DBS 365 nach einem entsprechenden Artikel oder erstellt, wenn kein Artikel gefunden wird, einen Artikel aus dem Katalogartikel.

Zurück zum übergeordneten Abschnitt

Konfigurationen öffnen

Wenn der Wert Soll-Kalkulationsnr. oder Einkaufsbelegnr. in einer Einkaufsbestellungszeile ausgefüllt ist, können Sie auf die Schaltfläche Beleg öffnen > Soll­-Kalkulation öffnen bzw. Einkaufsbeleg öffnen klicken.

Konfigurationen, die auf der Seite Herstellerkonfigurationskarte verfügbar sind, werden in eine Verkaufskalkulation kopiert, wenn der Schieberegler Vom System erstellt auf der Seite Soll-Kalkulationsvorlagen aktiviert ist.

Konfigurationen in Einkaufsbestellungen und Verkaufskalkulationen werden über die Spalten EK-Preis (Menge × EK-Preis) und Listenpreis (Menge × Listenpreis) im Inforegister Konfiguration auf der Seite Herstellerkonfigurationskarte bearbeitet.

Der Wert B&P-Konfigurations-ID, der über die CRM Customer Order-Schnittstelle (COI) importiert wird, ist auf der entsprechenden Seite Verkaufskalkulation sowie bei der Erstellung einer Verkaufskalkulation über die Seite Herstellerkonfigurationen verfügbar, um die B&P-Konfiguration direkt im Browser zu öffnen. Dies ist nützlich, um den Verkaufsauftrag direkt an JDMINT zu senden.

Zurück zum übergeordneten Abschnitt

Konfigurationen löschen

Es ist möglich, eine Konfiguration aus einer Einkaufsbestellung zu löschen und neu zu laden und eine Benachrichtigung zu einer entsprechenden Soll-Kalkulation zu erhalten, um die Gewissheit zu haben, dass die erforderlichen Felder vor dem Laden von Konfigurationen befüllt sind. Wenn Sie die Konfiguration in eine Einkaufsbestellung laden, wird der Wert Soll-Kalkulationsvorlagennr. im Inforegister Allgemein auf der Seite Einkaufsbestellung festgelegt.

Zurück zum übergeordneten Abschnitt