GRANIT-Schnittstellen einrichten

Die GRANIT-Integration erlaubt es Benutzern den GRANIT-Webshop in Microsoft Dynamics 365 Business Central zu integrieren und somit Daten wie Artikelkataloge, Preise und Artikelverfügbarkeiten zu synchronisieren und zu überprüfen.

Dieses Kapitel befasst sich mit der ersten Einrichtung der GRANIT-Integration nach erfolgreicher Installation.

Dieses Kapitel umfasst die folgenden Inhalte:

Benutzereinrichtung für GRANIT

Die Benutzereinrichtung in der GRANIT-Integration funktioniert wie in Microsoft Dynamics 365 Business Central.
Für eine genaue Beschreibung der kompletten Benutzereinrichtung klicken Sie hier.

  • Suchen Sie die Seite Benutzer Einrichtung über die Schnellsuche (ALT+Q), der die folgenden Felder für die GRANIT-Integration hinzugefügt wurden:
Feld Beschreibung
Fricke-Kundennr. Geben Sie hier Ihre Fricke-Kundennummer ein. Die hier eingegebene Kundennummer wird als Standardwert in Einkaufsbestellungen verwendet, kann jedoch manuell geändert werden.
GRANIT-Webshop-Passwort Geben Sie hier das Passwort des Benutzers ein, mit dem Sie sich im GRANIT-Webshop anmelden möchten. Dieses Passwort wurde Ihnen von Fricke zugesendet.
GRANIT-Webshop-Benutzer Geben Sie hier den Benutzernamen des Benutzers ein, mit dem Sie sich im GRANIT-Webshop anmelden möchten.
  • Füllen Sie die Felder mit den von Ihnen gewünschten Werten aus.
  • Ihre Eingaben werden automatisch gespeichert.

Sie haben erfolgreich die Benutzereinrichtung für die GRANIT-Schnittstelle vorgenommen.

GRANIT-Schnittstellen einrichten

Nach der erfolgreichen Installation müssen Sie für die einzelnen Schnittstellen eine Einrichtung vornehmen.
Gehen Sie zum Einrichten einer Schnittstelle wie folgt vor:

  • Suchen Sie die Seite Schnittstellenliste über die Schnellsuche (ALT+Q), und klicken Sie auf die Schnittstelle, die Sie einrichten möchten.
  • Die jeweilige Schnittstellenkarte wird angezeigt.
  • Im Inforegister Allgemein wird Ihnen die Schnittstellenart angezeigt.
  • Optional Geben Sie in das Feld Beschreibung eine eindeutige Beschreibung der Schnittstelle ein.
  • Im Inforegister Allgemein:
    • Aktivieren Sie den Schieberegler Schnittstellenprotokoll, um ein Protokoll aller Schnittstellenaktivitä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: 30T = alle Protokolleinträge, die älter als 30 Tage sind, werden automatisch gelöscht. Informationen zur Eingabe eines Zeitraums finden Sie hier.

Sie haben die Schnittstelle erfolgreich eingerichtet.

GRANIT Price List-Parameter einrichten

Auf der Schnittstellenkarte der Schnittstelle GRANIT Price List können Sie im Inforegister Parameter die folgenden Parameter einrichten.

Tipp

Pflichtfelder werden fett, optionale Felder kursiv hervorgehoben:

Parameter Beschreibung
AZURE_CONTAINER_NAME Geben Sie den Containernamen des ausgewählten Azure Blob Storage-Kontos an.
AZURE_SHAREDACCESSKEY Geben Sie den Shared Access Key des ausgewählten Azure Blob Storage-Kontos ein.
AZURE_STORAGE_ACCOUNT Geben Sie das Azure Blob Storage-Konto ein, das zum Herunterladen von GRANIT-Preisdateien verwendet wird.
GRANIT_PriceList_Catalog Geben Sie den Code des Katalogs ein, der für diese Schnittstelle verwenden werden soll.
GRANIT_Pricelist_CatalogInformationImport Wählen Sie aus, welche zusätzlichen Kataloginformationen als Attribute zu Artikeln hinzugefügt werden sollen.
GRANIT_Pricelist_CatalogNo Geben Sie die Katalognummer ein, die Sie als Attribut zu Artikeln hinzufügen möchten.
GRANIT_Pricelist_CatalogPage Geben Sie die Katalogseite ein, die Sie als Attribut zu Artikeln hinzufügen möchten.
GRANIT_PriceList_FileFilter Geben Sie den Dateifilter ein, um GRANIT-Preisdateien aus dem Azure Blob Storage zur automatischen Verarbeitung zu filtern.
GRANIT_Pricelist_Localisation Wählen Sie den Sprachcode für den GRANIT-Webshop aus.
GRANIT_Pricelist_SpecialCatalog Geben Sie den Spezialkatalog von GRANIT ein, den Sie für diese Schnittstelle verwenden möchten.
GRANIT_Pricelist_Webshop_URL Geben Sie die URL des GRANIT-Webshops ein.
  • Füllen Sie für die jeweiligen Parameter das Feld Wert aus.
  • Ihre Eingaben werden automatisch gespeichert.

Sie haben erfolgreich die Parameter der Schnittstelle eingerichtet. Bitte fahren Sie mit dem nächsten Schritt im Abschnitt GRANIT-Schnittstellen einrichten fort, um sie zu aktivieren.

GRANIT Price & Availability-Parameter einrichten

Auf der Schnittstellenkarte der Schnittstelle GRANIT Price & Availability können Sie im Inforegister Parameter die folgenden Parameter einrichten.

Tipp

Pflichtfelder werden fett, optionale Felder kursiv hervorgehoben:

Parameter Beschreibung
GRANIT_CatalogLabel Geben Sie den Code des Katalogs ein, der für diese Schnittstelle verwenden werden soll.
Localisation Wählen Sie den Sprachcode für den GRANIT-Webshop aus.
Web-Service URL Geben Sie die URL der Seite ein, die für die Preis- und Verfügbarkeitsüberprüfung verwendet werden soll.
Web-Service Version Geben Sie hier Version des Webdiensts ein.
  • Füllen Sie für die jeweiligen Parameter das Feld Wert aus.
  • Ihre Eingaben werden automatisch gespeichert.

Sie haben erfolgreich die Parameter der Schnittstelle eingerichtet. Bitte fahren Sie mit dem nächsten Schritt im Abschnitt GRANIT-Schnittstellen einrichten fort, um sie zu aktivieren.

GRANIT Smart Orders-Parameter einrichten

Auf der Schnittstellenkarte der Schnittstelle GRANIT Smart Orders können Sie im Inforegister Parameter die folgenden Parameter einrichten.

Tipp

Pflichtfelder werden fett, optionale Felder kursiv hervorgehoben:

Parameter Beschreibung
GRANIT_SmartOrders_APIKey Geben Sie den API-Schlüssel des Fricke-HTTP-Servers für das Hochladen von Bestellungen ein.
GRANIT_SmartOrders_HTTPHost Geben Sie die Host-URL des Fricke-HTTP-Servers für das Hochladen von Bestellungen ein.
GRANIT_SmartOrders_Localisation Wählen Sie den Sprachcode für den Smart Orders-Endpunkt aus.
GRANIT_SmartOrders_TestProd Wählen Sie aus, ob es sich beim Verzeichnis des Fricke-HTTP-Servers um einen Test- oder Produktivserver handelt.
GRANIT_SmartOrders_UploadDirectory Geben Sie das Verzeichnis des Fricke-HTTP-Servers ein, welches zum Hochalden von Bestellungen verwendet werden soll.
GRANIT_SmartOrders_Vendor Geben Sie den Kreditor ein, mit dem Sie Einkaufsbestellungen bei GRANIT aufgeben.
  • Füllen Sie für die jeweiligen Parameter das Feld Wert aus.
  • Ihre Eingaben werden automatisch gespeichert.

Sie haben erfolgreich die Parameter der Schnittstelle eingerichtet. Bitte fahren Sie mit dem nächsten Schritt im Abschnitt GRANIT-Schnittstellen einrichten fort, um sie zu aktivieren.

GRANIT OCI-Parameter einrichten

Auf der Schnittstellenkarte der Schnittstelle GRANIT OCI-Schnittstelle können Sie im Inforegister Parameter die folgenden Parameter einrichten.

Tipp

Pflichtfelder werden fett, optionale Felder kursiv hervorgehoben:

Parameter Beschreibung
GRANIT_OCI_APIURL Geben Sie die API-URL für das Erstellen von Einkaufszeilen an.
GRANIT_OCI_HookURL Geben Sie die HOOK-URL für das Übertragen des Warenkorbs aus dem Webshop an.
GRANIT_OCI_Localisation Wählen Sie den Sprachcode für den GRANIT-Webshop aus.
GRANIT_OCI_Vendor Geben Sie den Kreditor ein, mit dem Sie Einkaufsbestellungen bei GRANIT aufgeben.
GRANIT_OCI_WebshopURL Geben Sie die URL des OCI-Webshops ein.
  • Füllen Sie für die jeweiligen Parameter das Feld Wert aus.
  • Ihre Eingaben werden automatisch gespeichert.

Sie haben erfolgreich die Parameter der Schnittstelle eingerichtet. Bitte fahren Sie mit dem nächsten Schritt im Abschnitt GRANIT-Schnittstellen einrichten fort, um sie zu aktivieren.

GRANIT Customer Sales Order-Parameter einrichten

Sie können die Customer Sales Order-Schnittstelle (Partnershop) wie folgt einrichten:

Customer Sales Order-Schnittstelleneinrichtung
  • Öffnen Sie die Seite Schnittstellenliste in Microsoft Dynamics 365 Business Central und wählen Sie den Eintrag GRANIT Customer Sales Order-Schnittstelle aus.
  • Stellen Sie sicher, dass der Schieberegler Schnittstellenprotokoll im Inforegister Allgemein aktiviert ist.
  • Überspringen Sie das Inforegister Parameter, da keine Werte einzurichten sind.
  • Klicken Sie im Inforegister Zuordnungseinrichtung auf den Eintrag TSRD BPIA Data Mapping.
  • Die Tabelle Datenzuordnungen wird geöffnet. Bitte ergänzen Sie die entsprechenden Zuordnungen für die GRANIT-XML-Dateien gemäß der folgenden Tabelle hinzu, damit die Einkaufsbestellung verarbeitet werden kann:
Spalte Beschreibung
Externer Code Geben Sie die von GRANIT verwendeten XML-Codes ein.
Es müssen mindestens die folgenden Basiswerte angelegt und vollständig zugeordnet sein:
RECHNUNG
STK
Zuordnungstabellen-ID Geben Sie die ID der entsprechenden Tabelle ein, um eine korrekte Zuordnung der Daten zu gewährleisten.
Für die Basiswerte gelten Stand Mai 2026 die folgenden Zuordnungs-IDs:
RECHNUNG (Rechnung)  = 289 (Zahlungsform)
STK (Stück)  = 204 (Einheiten)
Überschrift der Zuordnungstabelle Referenz Zeigt den Namen der entsprechenden Zuordnungstabelle an, die in der Spalte Zuordnungstabellen-ID definiert ist.
Zuordnungscode Wählen Sie die Einheit aus, um den jeweiligen GRANIT-Wert dem entsprechenden Wert aus Ihrer Unternehmenseinrichtung zuzuordnen.
Beschreibung Optional Geben Sie eine Beschreibung zu Ihrer Information oder als Referenz ein.
  • Ihre Eingaben werden automatisch gespeichert.
  • Schließen Sie die Tabelle Datenzuordnungen.
  • Falls das Kontrollkästchen Abgeschlossen noch nicht aktiviert ist, klicken Sie in der Menüleiste des Inforegisters Zuordnungseinrichtung auf die Schaltfläche Einrichtungen abschließen. Die Farbe des Eintrags TSRD BPIA Daten-Mapping muss grün sein.
  • Fahren Sie mit der Geschäftspartnereinrichtung fort.
Geschäftspartnereinrichtung

Es ist notwendig, den Microsoft Dynamics 365 Business Central-Kreditor dem tatsächlichen GRANIT-Unternehmen oder mehrere Kreditoren ihren entsprechenden GRANIT-Unternehmen in einer Umgebung mit mehreren Kreditoren zuzuordnen. Gehen Sie zum Einrichten von Geschäftspartnern wie folgt vor:

  • Suchen Sie die Seite Geschäftspartner über die Schnellsuche (ALT+Q).
  • Öffnen Sie den Eintrag GRANIT-Integrations-App.
  • 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 GRANIT-Geschäftspartner aus.
    • Die Spalte Beschreibung wird automatisch ausgefüllt und kann nicht geändert werden.
    • Wiederholen Sie diese Schritte für alle GRANIT-Geschäftspartner, falls vorhanden.
  • Schließen Sie die Tabelle Geschäftspartnerbeziehungen.
  • Fahren Sie mit der Integrationsmoduleinrichtung fort.
Integrationsmoduleinrichtung

Anschließend muss das Integrationsmodul für den Eintrag GRANIT-Integrations-App eingerichtet werden. Gehen Sie dazu wie folgt vor:

  • Wählen Sie den Eintrag aus und klicken Sie in der Menüleiste der Seite Geschäftspartner auf die Schaltfläche Integrationsmodule.
  • Öffnen Sie den Eintrag CUSTOMERSALESORDER.
  • Gehen Sie auf der Seite Integrationsmodul wie folgt vor:
  • Wählen Sie im Inforegister Schnittstelle die folgenden Werte aus:
    • Schnittstellenart = GRANIT Customer Sales Order
    • Speicherart = Azure-Blobspeicher
  • Geben Sie im Inforegister Parameter in das Feld Wert die folgenden Informationen ein, um die Schnittstelle vorzubereiten:

Tipp

Pflichtfelder werden fett, optionale Felder kursiv hervorgehoben:

Parameter Beschreibung
TrackingLinkURL Geben Sie die Basis-URL des GRANIT-Webshops für Ihre Region ein.
Standardwert:
www.granit-parts.com
Benutzer aus der Schweiz müssen www.granit-parts.ch als eigene Webshop-URL eingeben.
AuthType Wählen Sie die Authentifizierungsart für die Authentifizierung beim Azure Blob Storage-Konto aus.
Standardwert: Key
AzureStorageAccount Geben Sie den Namen des Azure-Blobspeichers ein, der für den Dateiabruf verwendet wird.
Diese Informationen erhalten Sie von Ihrem Ansprechpartner bei der TRASER Software GmbH.
SharedAccessAuthValue Geben Sie den Namen des Azure-Blobspeichers ein, der für den Dateiabruf verwendet wird.
Diese Informationen erhalten Sie von Ihrem Ansprechpartner bei der TRASER Software GmbH.
StorageContainerName Geben Sie den Namen des Azure Blob Storage-Containers ein, der für den Dateiabruf verwendet wird.
Diese Informationen erhalten Sie von Ihrem Ansprechpartner bei der TRASER Software GmbH.
StoragePrefix Geben Sie das Dateipräfix ein, um auf bestimmte Auftragsbestätigungs-Datensätze im Azure-Blobspeicher zu filtern.
CatalogIdentifier Wählen Sie den Katalog aus, der für Ihre GRANIT-Katalogartikel eingerichtet wurde. Neue (Katalog-)Artikel werden gemäß der Einrichtung des Parameters ItemHandling automatisch angelegt, wenn noch kein passender (Katalog-)Artikel verfügbar ist.
DropShipmentPostProcessing Wählen Sie die Folgeaktion für Direktlieferungen aus.
Mögliche Werte:
leer = keine Direktlieferung
Direktlieferungsauftrag erstellen = Direktlieferungsauftrag wird nur erstellt; es erfolgt keine Buchung.
Direktlieferungsauftrag erstellen und versenden = Der Direktlieferungsauftrag wird automatisch erstellt und gebucht.
FreightChargeCode Wählen Sie die Ressourcennummer aus, die für Frachtkostenzeilen in Verkaufsaufträgen verwendet werden soll.
Es sind nur Ressourcen zulässig, die als Frachtkosten deklariert sind.
FreightChargeCodePurchase Wählen Sie die Ressourcennummer aus, die für Frachtkostenzeilen in Einkaufsbestellungen verwendet werden soll.
Es sind nur Ressourcen zulässig, die als Frachtkosten deklariert sind.
ItemHandling Wählen Sie den Bearbeitungsmodus für unbekannte Artikel für den Katalog aus, der in der Einrichtung des Parameters CatalogIdentifier definiert ist.
Mögliche Werte:
leer = Wenn kein Artikel gefunden wird, wird beim Import der Bestellung eine Fehlermeldung angezeigt.
Aus Katalogartikel erstellen = Der fehlende Artikel wird automatisch aus dem passenden Katalogartikel erstellt. Wird kein Katalogartikel gefunden, wird beim Import der Einkaufsbestellung eine Fehlermeldung angezeigt.
Beides erstellen = Fehlende Katalogartikel und Artikel werden anhand der Informationen aus der importierten Einkaufsbestellung angelegt.
OrderPostProcessing Wählen Sie die Folgeaktion für Aufträge, mit Ausnahme von Direktlieferungen.
Mögliche Werte:
leer = keine automatische Folgeaktion.
Bestellung erstellen und reservieren = Es werden automatisch eine Einkaufsbestellung und ein Verkaufsauftrag angelegt, und die Artikel werden automatisch reserviert.
Spezialauftrag erstellen = Es wird automatisch ein Spezialauftrag erstellt; es erfolgt keine Reservierung.
PurchasingCodeDropShipment *Pflichtfeld, wenn Parameter DropShipmentPostProcessing ≠ leer ist * Geben Sie den Einkaufscode für die Direktlieferung an, der auf Verkaufszeilen von Direktlieferungsbestellungen angewendet werden soll. Für den Code muss Direktlieferung aktiviert sein.
PurchasingCodeSpecialOrder Pflichtfeld, wenn Parameter OrderPostProcessing = Spezialauftrag erstellen Geben Sie den Einkaufscode für Spezialaufträge an, der auf Verkaufszeilen von Spezialaufträgen angewendet werden soll. Für den Code muss Spezialauftrag aktiviert sein.
  • Klicken Sie in der Menüleiste auf Aktivieren, um das Integrationsmodul zu aktivieren.
  • Sie können alle Seiten schließen.

Tipp

Wenn Sie einen der Werte ändern möchten, muss das Schnittstellen- oder Integrationsmodul zunächst deaktiviert werden.

Sie haben Zuordnung, Geschäftspartner und Integrationsmodul für die Schnittstelle erfolgreich eingerichtet. Bitte fahren Sie mit dem nächsten Schritt im Abschnitt GRANIT-Schnittstellen einrichten fort, um sie zu aktivieren.