Shopware 6 Setup
Zentrale Einrichtungsseite für den Shopware 6 Connector. Hier werden die Verbindungsdaten zur Middleware (ECIShopwareService), die API-Zugangsdaten zum Shop sowie alle Standardwerte für Bestellimport, Artikelsynchronisation und Preissteuerung konfiguriert.
Die Kommunikation mit dem Shopware-6-Shop erfolgt nicht direkt, sondern über eine Middleware (ECIShopwareService), die als Vermittler zwischen Business Central und der Shopware Admin API fungiert.
Seite öffnen
- Über die Suche: Shopware 6 Setup
- Über das Shopware 6 Dashboard → Aktion Setup
Felder
API Configuration
Verbindungsdaten zur Middleware und zum Shopware-6-Shop.
| Feld | Beschreibung |
|---|---|
| Service Base URL | URL der Middleware (ECIShopwareService), z. B. https://middleware.example.com. Alle API-Aufrufe werden über diese Middleware an den Shop weitergeleitet. |
| API User | API-Benutzername für den Shopware-6-Shop. Wird verschlüsselt in IsolatedStorage gespeichert und als *** maskiert angezeigt. Dieser Benutzer muss in der Shopware-Administration unter Einstellungen > System > Integrationen angelegt sein. |
| API Password | API-Passwort für den Shopware-6-Shop. Wird verschlüsselt in IsolatedStorage gespeichert und als *** maskiert angezeigt. |
| Bearer Token | Authentifizierungs-Token für die Middleware. Wird verschlüsselt in IsolatedStorage gespeichert und als *** maskiert angezeigt. Dieses Token autorisiert Business Central gegenüber der Middleware. |
Sicherheitshinweis
Alle Zugangsdaten werden in IsolatedStorage gespeichert und niemals im Klartext in der Datenbank abgelegt. Die Anzeige zeigt immer *** – erst bei Änderung wird der neue Wert übernommen.
Order Import
Einstellungen für den automatischen Bestellimport aus dem Shopware-6-Shop.
| Feld | Beschreibung |
|---|---|
| Order Import Enabled | Aktiviert den automatischen Bestellimport über die Job Queue. Wenn deaktiviert, werden keine neuen Bestellungen aus dem Shop importiert. |
| Max Orders Per Run | Maximale Anzahl an Bestellungen, die pro Job-Queue-Lauf importiert werden. Standardwert: 15. Ein niedrigerer Wert verhindert Timeouts bei großen Bestellmengen. |
| Missing Item Substitute | Sachkonto-Nr. (G/L Account), das als Ersatz verwendet wird, wenn ein Shopware-Artikel keinem BC-Artikel zugeordnet werden kann. Verhindert Fehler beim Bestellimport. |
| Charge Item Shipping | Sachkonto-Nr. für Versandkosten. Shopware-Versandkosten werden als separate Zeile mit diesem Konto in den Verkaufsauftrag übernommen. |
| Suppress Status on Ship | Wenn aktiviert, wird bei der Lieferungsbuchung kein automatisches Status-Update an den Shopware-Shop gesendet. Nützlich, wenn der Status manuell oder über einen anderen Workflow aktualisiert werden soll. |
Item Settings
Standardwerte für die Artikelsynchronisation.
| Feld | Beschreibung |
|---|---|
| Default Tax ID | Standard-Steuer-ID im Shopware-Shop. Neue Artikel werden mit dieser Steuerklasse angelegt. Die ID muss in der Shopware-Administration unter Einstellungen > Shop > Steuern ermittelt werden. |
| Image Album ID | Medienordner-ID in Shopware, in den Artikelbilder hochgeladen werden. Die ID muss in der Shopware-Administration unter Inhalte > Medien ermittelt werden. |
| Price List Code | Kundenpreisgruppen-Code (z. B. SHOP), aus dem Verkaufspreise für den Shop gelesen werden. Wenn leer, wird der Standardpreis verwendet. |
Status
Schreibgeschützte Statusinformationen zur letzten Synchronisation.
| Feld | Beschreibung |
|---|---|
| Last Order Sync | Zeitstempel der letzten erfolgreichen Bestellsynchronisation. |
| Last Item Sync | Zeitstempel der letzten erfolgreichen Artikelsynchronisation. |
| Last Sync Error Message | Letzte Fehlermeldung bei einer Synchronisation. Wird rot angezeigt, wenn ein Fehler vorliegt, andernfalls grün (kein Fehler). |
| Last Sync Error DateTime | Zeitstempel des letzten Synchronisationsfehlers. |
Aktionen
| Aktion | Beschreibung |
|---|---|
| Create Job Queue Entries | Erstellt die Standard-Job-Queue-Einträge für die automatische Synchronisation (Bestellimport, Artikelupdate, Preisupdate, Bestandsupdate). Nach dem Erstellen erscheint eine Bestätigung. Die Einträge müssen anschließend in der Job-Queue-Verwaltung aktiviert werden. |
| Test Connection | Testet die Verbindung zur Middleware, indem der /health-Endpunkt aufgerufen wird. Bei Erfolg erscheint eine Bestätigungsmeldung, bei Fehler wird die Fehlermeldung angezeigt. |