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
- GRANIT-Schnittstellen einrichten
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.
- Wählen Sie unter dem Inforegister Autorisierung im Feld Autorisierungsart die Art der Autorisierung aus.
- Wählen Sie im Feld Autorisierungscode den Code der Autorisierung aus.
- Die Felder des Inforegisters Parameter und weiterer Inforegister werden separat für die einzelnen Schnittstellen beschrieben: Bitte stellen Sie sicher, dass Sie die folgenden Einrichtungen abgeschlossen haben, bevor Sie fortfahren:
- Klicken Sie nach erfolgreicher Einrichtung in der Menüleiste auf Schnittstelle aktivieren.
- Ihre Eingaben werden automatisch gespeichert.
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
- Geschäftspartnereinrichtung
- Integrationsmoduleinrichtung
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
- Schnittstellenart =
- 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.comBenutzer 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.