Installation

Voraussetzungen

Connector	Shopware	PHP
3.7.x (aktuell 3.7.500)	6.7	≥ 8.2
3.6.x (aktuell 3.6.300)	6.6	≥ 8.2

Zusätzlich wird ein gültiger Lizenzschlüssel benötigt (erhältlich unter agiqon-connector.de).

info

Sowohl über den Shopware Store als auch über Composer wird automatisch die zur Shop-Version passende Plugin-Variante installiert — der Installationsbefehl ist für Shopware 6.6 und 6.7 identisch.

Plugin installieren

Über den Shopware Store

1. Im Shopware Administration-Backend anmelden.
2. Navigiere zu Erweiterungen → Store.
3. Suche nach „AgiqonConnector" und klicke auf Installieren.

Manuell via Composer

composer require store.shopware.com/agiqonconnector
bin/console plugin:install --activate AgiqonConnector
bin/console cache:clear

Nach der Installation

Nach der Installation stehen folgende Menüpunkte im Shopware Admin zur Verfügung:

Connector
  └─ Dashboard
  └─ OCI-Systeme
  └─ cXML-Systeme
  └─ Übertragungen

Geplante Aufgaben

Der Connector registriert einen geplanten Task, der einmal täglich die temporären Gastkunden aus abgelaufenen Punchout-Sessions entfernt. Seit 3.7.400 / 3.6.200 läuft diese Bereinigung als geplanter Task — zuvor wurde sie bei jedem Login mit ausgeführt.

Damit der Task ausgeführt wird, muss der Shopware-Scheduler laufen:

bin/console scheduled-task:run

In produktiven Installationen übernimmt das in der Regel der dauerhaft laufende Worker. Der Status ist im Admin unter Einstellungen → System → Aufgaben einsehbar.

warnung

Läuft der Scheduler nicht, werden temporäre Gastkunden nicht mehr entfernt und sammeln sich dauerhaft in der Kundenverwaltung an.

Client Authentifikation hinterlegen

Das Plugin eine Authentifikation über die Clientinformationen erfordert, müssen diese nach der Installation hinterlegt werden.

Die Clientinformationen sind unter agiqon-connector.de → Mein Konto → Lizenzen zu finden

1. Im Shopware Administration-Backend anmelden.
2. Zu Erweiterungen → Meine Erweiterungen navigieren.
3. Die drei Punkte neben dem AgiqonConnector Plugin klicken und Konfigurieren wählen.
4. Clientinformationen (Client-ID und Client-Secret) eintragen und speichern.
5. Api Verbindung testen, um sicherzustellen, dass die Authentifikation erfolgreich ist.

Plugin aktualisieren

bin/console plugin:update AgiqonConnector
bin/console cache:clear
bin/console database:migrate --all AgiqonConnector

Vor dem Update auf 3.7.500 / 3.6.300 prüfen

Dieses Release enthält Änderungen, die bestehende Anbindungen beeinflussen können:

• Versandart-Erweiterung umbenannt (ociShippingMethod → connectorShippingMethod). Eigene Integrationen müssen angepasst werden — siehe Versandarten.
• cXML-Feldfilter greifen wieder und verändern dadurch das erzeugte XML — siehe cXML – Felder konfigurieren.
• OCI-Logins setzen die passende Kundenzuordnung voraus, sonst werden sie abgelehnt — siehe OCI – Kunden & Einheiten.
• Deaktivierte Kundenkonten können sich nicht mehr per Token anmelden.

Die vollständige Liste steht im Changelog.

Nach dem Update auf 3.7.400 / 3.6.200

Der korrigierte Feld-Filter (Substring und Zahlenformat) greift bei bestehenden Installationen nicht automatisch. Öffne das vorinstallierte OCI-System einmal im Admin und speichere die Felder vendormat, matgroup und quantity erneut, damit die konfigurierten Filter wieder angewendet werden. Neuinstallationen sind nicht betroffen.