Anleitungen¶

Diese Anleitung bietet Schritt-für-Schritt-Workflows für häufige Aufgaben mit ADCELL Provisionsfreigabe.

Wie das Plugin funktioniert¶

ADCELL-API (offene Provisionen) → Plugin (Abgleich mit Shopware-Bestellungen) → Entscheidungen → ADCELL-API (Freigabe/Stornierung)

Detaillierter Ablauf:

Das Plugin ruft offene Provisionen von der ADCELL-API ab
Für jede Provision wird die zugehörige Shopware-Bestellung gesucht (über die Bestellnummer im Feld „reference")
Der Entscheidungsalgorithmus prüft in dieser Reihenfolge:
Ist ein Programm-Mapping vorhanden? → Wenn nein: Nicht zugeordnet
Existiert die Bestellung in Shopware? → Wenn nein: Stornieren
Ist die Bestellung storniert/fehlgeschlagen? → Stornieren
Wurde die Lieferung komplett retourniert? → Stornieren
Wurde die Zahlung komplett erstattet? → Stornieren
Ist die Zahlung offen/ausstehend? → Stornieren
Ist die Zahlung fehlgeschlagen? → Stornieren
Wurde noch nicht versendet? → Stornieren
Liegt eine Teilerstattung vor? → Korrigieren
Weicht der Warenkorbwert ab (über Toleranz)? → Korrigieren
Alles in Ordnung? → Freigeben
Die Entscheidungen werden als Batch gespeichert (Status: „Vorbereitet")
Sie prüfen die Ergebnisse und können Entscheidungen überschreiben
Beim Senden werden die Entscheidungen an die ADCELL-API übermittelt

Der Shop-Wert wird wie folgt berechnet:

Shop-Wert = Netto-Bestellwert − Netto-Versandkosten

Bei Brutto-Shops (B2C) wird die Mehrwertsteuer automatisch herausgerechnet. Dieser Wert wird mit dem ADCELL-Warenkorbwert verglichen.

Ziel: Das Plugin vollständig einrichten und den ersten Abgleich durchführen.

Zeitaufwand: ca. 10 Minuten

Schritte:

Plugin aktivieren
Navigieren zu: Erweiterungen → Meine Erweiterungen
ADCELL Provisionsfreigabe aktivieren
Test-Modus einschalten
Navigieren zu: Erweiterungen → Meine Erweiterungen → ADCELL Provisionsfreigabe → Konfigurieren
Test-Modus auf An setzen
Speichern
ADCELL-Konto anlegen
Navigieren zu: Bestellungen → ADCELL Provisionsfreigabe → Konten
Konto anlegen mit Benutzername und Passwort
Verbindung testen
Programm-Mapping einrichten
Navigieren zu: Bestellungen → ADCELL Provisionsfreigabe → Programm-Mapping
Konto auswählen → Programme laden
Für jedes aktive Programm ein Mapping zum passenden Verkaufskanal erstellen
Ersten Abgleich durchführen
Navigieren zu: Bestellungen → ADCELL Provisionsfreigabe → Abgleich
Konto und Zeitraum wählen (z.B. 30 Tage)
Abgleich starten und Ergebnisse prüfen
Test-Modus deaktivieren (nach erfolgreicher Prüfung)
Einstellungen → Test-Modus auf Aus

Ergebnis: Das Plugin ist einsatzbereit. Beim nächsten Abgleich werden Entscheidungen an ADCELL gesendet.

Ziel: Offene Provisionen prüfen und Entscheidungen an ADCELL senden.

Schritte:

Ergebnis: Alle Entscheidungen sind an ADCELL übermittelt. Der Batch erscheint im Dashboard.

Ziel: Einen zuvor erstellten Abgleich, der noch nicht gesendet wurde, öffnen und senden.

Schritte:

Dashboard öffnen
Navigieren zu: Bestellungen → ADCELL Provisionsfreigabe → Dashboard
Batch auswählen
In der Tabelle „Letzte Abgleiche" den gewünschten Batch finden (Status: „Vorbereitet")
Auf den Datums-Link klicken oder über das Kontextmenü (drei Punkte) → „Details anzeigen"
Prüfen und senden
Entscheidungen überprüfen, ggf. anpassen
Auf An ADCELL senden klicken

Ziel: Provisionen täglich automatisch abgleichen und freigeben lassen.

Voraussetzungen: - Mindestens ein aktives ADCELL-Konto - Programm-Mappings eingerichtet - Shopware Message Queue Worker läuft

Schritte:

Einstellungen konfigurieren
Navigieren zu: Erweiterungen → Meine Erweiterungen → ADCELL Provisionsfreigabe → Konfigurieren
Automatische Freigabe aktivieren: An
Tage vor Auto-Accept-Deadline: 3 (empfohlen)
Speichern
Message Queue sicherstellen
Prüfen Sie, dass bin/console messenger:consume als Cronjob oder Supervisor-Prozess läuft

Ergebnis: Das Plugin führt täglich automatisch einen Abgleich durch und sendet Entscheidungen an ADCELL.

Erst testen: Nutzen Sie den Test-Modus, um Entscheidungen zu prüfen, bevor Sie live gehen
Regelmäßig abgleichen: Führen Sie Abgleiche mindestens wöchentlich durch, um vor der Auto-Accept-Deadline zu handeln
Mappings aktuell halten: Neue ADCELL-Programme sollten zeitnah einem Verkaufskanal zugeordnet werden
Mindest-Bestellalter setzen: Nutzen Sie das Mindest-Bestellalter (z.B. 14 Tage), um Provisionen erst nach Ablauf der Widerrufsfrist freizugeben

Lassen Sie den Test-Modus nicht versehentlich im Produktivbetrieb aktiviert — Entscheidungen werden dann nicht gesendet
Führen Sie den gleichen Abgleich nicht mehrfach durch, ohne vorherige Batches zu senden — die Dashboard-Statistik zählt nur gesendete Positionen, aber Sie erzeugen unnötige vorbereitete Batches
Ändern Sie die Toleranzwerte nicht zu hoch, da sonst berechtigte Korrekturen unterbleiben