Sylius installieren

Order Invoicer verbindet sich mit Ihrem Sylius-Shop über dessen Admin-API (API Platform v2). Die Authentifizierung erfolgt mit den Zugangsdaten eines Administrators, der über API-Zugriff verfügt: Order Invoicer tauscht sie bei jeder Synchronisierung gegen ein kurzlebiges Token aus. Es ist kein dauerhafter API-Schlüssel erforderlich.

Voraussetzungen

Sylius 2.x mit aktivierter API (standardmäßig aktiviert)
Ihr Shop ist über HTTPS erreichbar
Ein Administratorkonto mit API-Zugriff (ROLE_API_ACCESS)

1. API-Zugriff für einen Administrator aktivieren

Die Sylius-Admin-API ist nur für Administratoren erreichbar, die über die Rolle ROLE_API_ACCESS verfügen. Ein regulärer Administrator kann sich authentifizieren, ihm wird der API-Zugriff jedoch verweigert (403-Fehler).

Wir empfehlen, einen dedizierten Administrator für die Integration zu erstellen:

Melden Sie sich im Sylius-Admin-Panel an.
Öffnen Sie Configuration → Administrators.
Erstellen Sie einen neuen Administrator (oder bearbeiten Sie einen vorhandenen) und aktivieren Sie die Option API access (ROLE_API_ACCESS).
Speichern Sie und notieren Sie sich anschließend dessen E-Mail und Passwort.

Ein dedizierter Administrator erleichtert das Widerrufen des Zugriffs und vermeidet die Offenlegung Ihres Hauptkontos. Order Invoicer benötigt lediglich Lesezugriff auf Bestellungen.

2. Ihre Verbindungsdaten zusammenstellen

Sie benötigen drei Informationen:

Store URL: die Stammadresse Ihres Shops, z. B. https://store.example.com (ohne /admin oder Pfad — Order Invoicer hängt /api/v2/admin automatisch an).
Administrator-E-Mail: die E-Mail-Adresse des Administrators mit API-Zugriff.
Administrator-Passwort: das Passwort dieses Kontos.

3. Den Shop in Order Invoicer verbinden

Fügen Sie in Order Invoicer einen Connector hinzu und wählen Sie Sylius.
Geben Sie die Store URL, die Administrator-E-Mail und das Passwort ein.
Klicken Sie auf Verbindung testen, um Ihre Zugangsdaten zu überprüfen.
Speichern Sie: Order Invoicer beginnt mit der Synchronisierung abgeschlossener Bestellungen.

4. Die Konfiguration überprüfen

Sie können die API-Authentifizierung mit cURL testen:

curl -X POST "https://store.example.com/api/v2/admin/administrators/token" \
  -H "Content-Type: application/ld+json" \
  -d '{"email":"admin@example.com","password":"your-password"}'

Eine Antwort, die ein token-Feld enthält, bestätigt, dass die Zugangsdaten gültig sind und dass der Administrator über API-Zugriff verfügt.

Häufige Fehlerbehebung

Fehler „The user doesn't have ROLE_API_ACCESS" (403)

Der Administrator hat sich authentifiziert, verfügt aber nicht über API-Zugriff. Aktivieren Sie die Option API access für dieses Konto (siehe Schritt 1) oder verwenden Sie einen dedizierten Administrator.

Fehler „Invalid credentials" (401)

Überprüfen Sie die E-Mail-Adresse und das Passwort des Administrators.
Stellen Sie sicher, dass das Konto aktiv ist.

Verbindungsfehler oder 404

Überprüfen Sie, ob die URL die Stammadresse des Shops ist (https://store.example.com), nicht die Admin-URL (.../admin/...).
Stellen Sie sicher, dass der Shop über HTTPS erreichbar und die API aktiviert ist.

Support

Falls Sie auf Schwierigkeiten stoßen, kontaktieren Sie uns unter contact@orderinvoicer.com.

Hinweis: Sobald diese Konfiguration abgeschlossen ist, können Sie Ihr Rechnungstool in Order Invoicer verknüpfen.