Aktualisiert: 10.03.2026

Einrichtung

Dieser Abschnitt beschreibt die Einrichtung der Schnittstelle Aptean Equipment DMS x STIHL.

In diesem Kapitel finden Sie die folgenden Abschnitte:

Basiseinrichtung

Zunächst muss die grundlegende Schnittstelleneinrichtung vorgenommen werden. Gehen Sie hierzu wie folgt vor:

  • Öffnen Sie die Seite Schnittstellenliste in unserer ERP-Lösung und wählen Sie den Eintrag STIHL aus.
  • Im Inforegister Allgemein:
    • Aktivieren Sie den Schieberegler Schnittstellenprotokoll, um ein Protokoll aller Aptean Equipment DMS x STIHL-Aktivitä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: 90T = alle Protokolleinträge, die älter als 90 Tage 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 **STIHL ** aus, und klicken Sie auf die Schaltfläche Details anzeigen.
      • Die Seite OAuth2-Anwendungsendpunkt für den Wert STIHL wird geöffnet.
      • Wählen Sie im Feld OAuth2-Autorisierungsmethode den Wert Client-Anmeldedaten aus.
      • Geben Sie in die Felder Client-ID und Client Geheimnis Ihre Anmeldeinformationen für STIHL ein.
      • Schließen Sie die Seite OAuth2-Anwendungsendpunkt.
    • Wählen Sie im Feld Bereich den Wert STIHL-HÄNDLERBEST. aus.
  • Geben Sie im Inforegister Parameter in das Feld Wert die folgenden Informationen ein, um die Schnittstelle vorzubereiten:
    • APIEndPoint: Gibt die Endpunkt-URL für den STIHL-Händlerbestand an.
      Standardwert: https://ig.stihl.com/api/
    • CleanArchiveEntriesAfter: Definiert die Datumsformel für das Entfernen von archivierten Einträgen. Wenn Sie archivierte Transaktionen länger oder kürzer aufbewahren möchten, erhöhen bzw. verringern Sie den Wert.
      Standardwert: 2M
    • DealerID: Gibt die STIHL Händler-ID an.
      Dieser Wert wird von STIHL bereitgestellt.
    • DMSName: Gibt den DMS-Namen an, der an den Endpunkt gesendet wird.
      Bitte sprechen Sie bei Bedarf mit Ihrem STIHL-Ansprechpartner ab, welcher DMS-Name von Ihrem Unternehmen gesendet werden soll.
    • ItemLastInventoryChangeWithinDays: Legt fest, wie viele Tage zurückgeschaut werden soll, um Bestandsänderungen im Bestandsupload für einen Bestand von 0 einzubeziehen.
      Standardwert: 7
    • ManufacturerFilter: Gibt den Herstellercode an. Dieser Wert wird benötigt, um STIHL-Artikel in Ihrem Lagerbestand zu identifizieren.
      Standardwert: STIHL

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 STIHL-Schnittstellenkarte aktivieren.

Fahren Sie mit dem Abschnitt Aufgabenwarteschlangen-Einrichtung fort.

Zurück zum übergeordneten Abschnitt

Aufgabenwarteschlangen-Einrichtung

3 job queue entries are created as described in the following subsections:

Zurück zum übergeordneten Abschnitt

Aufgabenwarteschlange zur Aktualisierung des STIHL-Lagerbestands

Mit dieser Aufgabenwarteschlange wird der aktuelle STIHL-Lagerbestand an STIHL gesendet. Sie wird automatisch während der Einrichtung für Aptean Equipment DMS x STIHL erstellt, sodass es nicht erforderlich ist, sie manuell zu erstellen. Wird Aptean Equipment DMS x STIHL aktiviert, wird eine Benachrichtigung angezeigt, über die die Aufgabenwarteschlange bei Bedarf geöffnet werden kann. Falls die Aufgabenwarteschlange verändert oder zurückgesetzt wurde, befolgen Sie die nachfolgenden Schritte, um die empfohlenen Einstellungen wiederherzustellen:

Hinweis

Laut STIHL muss diese Aufgabenwarteschlange mindestens einmal täglich ausgeführt werden, vorzugsweise zwischen 00:00 und 06:00 Uhr (00:00 und 06:00 AM) zu einer ungeraden Minute. Sie darf nicht zur gleichen Zeit wie die Aufgabenwarteschlange zur Verarbeitung von STIHL-Bestandsänderungen ausgeführt werden.

  • Öffnen Sie die Seite Aufgabenwarteschlangenposten in unserer ERP-Lösung über die Suche (ALT+Q).
  • Klicken Sie auf die Schaltfläche Neu, um einen neuen Aufgabenwarteschlangenposten anzulegen.
  • Nehmen Sie im Inforegister Allgemein auf der 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 72560293 aus.
    • Optional Geben Sie im Feld Beschreibung bei Bedarf eine eindeutige Beschreibung der Aufgabenwarteschlangen ein, z. B. STIHL-Bestandsaktualisierung.
    • 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 Karte für Aufgabenwarteschlangenposten folgende Einstellungen vor:
    • Aktivieren Sie die Schieberegler für alle Wochentage.
    • Wählen Sie im Feld Startzeit eine Zeit vor den üblichen Geschäftszeiten aus, damit die geänderten Lagerbestandsdaten vor Beginn des Arbeitstages an STIHL gesendet werden können. Verwenden Sie unbedingt einen ungeraden Minutenwert, um eine bessere Lastverteilung zu erzielen.
      Empfohlener Wert: 00:01:00 (00:01:00 AM)
    • Geben Sie in das Feld Endzeit den folgenden Wert ein: 06:00:00 (06:00:00 AM)
    • Lassen Sie das Feld Anzahl der Minuten zwischen Ausführungen leer, da die Aufgabenwarteschlange nur einmal am Tag laufen soll.

Der Aufgabenwarteschlangenposten ist fertiggestellt und weist den Wert Status = Wartend auf.

Zurück zum übergeordneten Abschnitt

Aufgabenwarteschlange zur Verarbeitung von STIHL-Bestandsänderungen

Mit dieser Aufgabenwarteschlange werden jegliche Änderungen am STIHL-Lagerbestand verarbeitet. Sie wird automatisch während der Einrichtung für Aptean Equipment DMS x STIHL erstellt, sodass es nicht erforderlich ist, sie manuell zu erstellen. Wird Aptean Equipment DMS x STIHL aktiviert, wird eine Benachrichtigung angezeigt, über die die Aufgabenwarteschlange bei Bedarf geöffnet werden kann. Falls die Aufgabenwarteschlange verändert oder zurückgesetzt wurde, befolgen Sie die nachfolgenden Schritte, um die empfohlenen Einstellungen wiederherzustellen:

Hinweis

Laut STIHL darf diese Aufgabenwarteschlange nur während der Geschäftszeiten in stündlichen Intervallen ausgeführt werden. Sie darf nicht zur gleichen Zeit wie die Aufgabenwarteschlange zur Aktualisierung des STIHL-Lagerbestands ausgeführt werden.

  • Öffnen Sie die Seite Aufgabenwarteschlangenposten in unserer ERP-Lösung über die Suche (ALT+Q).
  • Klicken Sie auf die Schaltfläche Neu, um einen neuen Aufgabenwarteschlangenposten anzulegen.
  • Nehmen Sie im Inforegister Allgemein auf der 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 72560291 aus.
    • Optional Geben Sie im Feld Beschreibung bei Bedarf eine eindeutige Beschreibung der Aufgabenwarteschlangen ein, z. B. STIHL-Bestandsänderung.
    • 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 Karte für Aufgabenwarteschlangenposten folgende Einstellungen vor:
    • Aktivieren Sie die Schieberegler für alle Wochentage.
    • Wählen Sie im Feld Startzeit den Beginn der üblichen Geschäftszeiten aus, damit die geänderten Lagerbestandsdaten direkt an STIHL gesendet werden können.
      Empfohlener Wert: 07:00:00 (07:00:00 AM).
    • Wählen Sie im Feld Ende das Ende der üblichen Geschäftszeiten aus, damit keine geänderten Lagerbestandsdaten an STIHL gesendet werden, wenn keine Änderungen anfallen.
      Empfohlener Wert: 19:00:00 (07:00:00 PM).
    • Geben Sie im Feld Anzahl der Minuten zwischen Ausführungen den Wert 60 ein.

Der Aufgabenwarteschlangenposten ist fertiggestellt und weist den Wert Status = Wartend auf.

Zurück zum übergeordneten Abschnitt

Aufgabenwarteschlange zum Abrufen des Uploadstatus

Mit dieser Aufgabenwarteschlange wird der Uploadstatus wartender Protokolleinträge abgefragt. Anschließend wird der Protokolleintrag aktualisiert. Sie wird automatisch während der Einrichtung für Aptean Equipment DMS x STIHL erstellt, sodass es nicht erforderlich ist, sie manuell zu erstellen. Wird Aptean Equipment DMS x STIHL aktiviert, wird eine Benachrichtigung angezeigt, über die die Aufgabenwarteschlange bei Bedarf geöffnet werden kann. Falls die Aufgabenwarteschlange verändert oder zurückgesetzt wurde, befolgen Sie die nachfolgenden Schritte, um die empfohlenen Einstellungen wiederherzustellen:

  • Öffnen Sie die Seite Aufgabenwarteschlangenposten in unserer ERP-Lösung über die Suche (ALT+Q).
  • Klicken Sie auf die Schaltfläche Neu, um einen neuen Aufgabenwarteschlangenposten anzulegen.
  • Nehmen Sie im Inforegister Allgemein auf der 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 72560292 aus.
    • Optional Geben Sie im Feld Beschreibung bei Bedarf eine eindeutige Beschreibung der Aufgabenwarteschlangen ein, z. B. STIHL-Uploadstatusabfrage.
    • 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 Karte für Aufgabenwarteschlangenposten folgende Einstellungen vor:
    • Aktivieren Sie die Schieberegler für alle Wochentage.
    • Wählen Sie im Feld Startzeit einen Zeitpunkt vor den üblichen Geschäftszeiten aus, damit die Daten von Aptean Equipment DMS x STIHL beim Start bereits auf dem neuesten Stand sind.
      Empfohlener Wert: 01:00:00 (01:00:00 AM).
    • Wählen Sie im Feld Endzeit eine Zeit nach den üblichen Geschäftszeiten aus, damit kein unnötiger Datenverkehr erzeugt wird.
      Empfohlener Wert: 23:00:00 (23:00:00 AM)
    • 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 30.

Der Aufgabenwarteschlangenposten ist fertiggestellt und weist den Wert Status = Wartend auf.

Zurück zum übergeordneten Abschnitt

Geschäftspartnereinrichtung

Es ist notwendig, den Kreditor für unsere ERP-Lösung dem im System hinterlegten Unternehmen STIHL zuzuordnen. Gehen Sie zum Einrichten eines Geschäftspartners wie folgt vor:

  • Suchen Sie die Seite Geschäftspartner über die Schnellsuche (ALT+Q).
  • Öffnen Sie den Eintrag STIHL-Integrations-App.
  • Im Inforegister Allgemein:
    • Wählen Sie im Dropdownmenü Schnittstellenart den Wert STIHL-Händlerbest. aus.
  • Klicken Sie in der Menüleiste der Seite Geschäftspartner auf die Schaltfläche Beziehungen.
  • Gehen Sie in der Tabelle Geschäftspartnerbeziehungen wie folgt vor:
    • Wählen Sie in der Spalte Beziehungsart den Wert Kreditor aus.
    • Wählen Sie in der Spalte Beziehungsnr. die Kreditorennummer für den STIHL-Geschäftspartner aus.
    • Die Spalte Beschreibung wird automatisch ausgefüllt und kann nicht geändert werden.
    • Wiederholen Sie diese Schritte für alle STIHL-Geschäftspartner.
  • Schließen Sie die Tabelle Geschäftspartnerbeziehungen.
  • Klicken Sie in der Menüleiste auf Aktivieren, um das Integrationsmodul zu aktivieren.
  • Sie können alle Seiten schließen.

Zurück zum übergeordneten Abschnitt