Margly.io-Add-on aus dem Upgates Marketplace#
Für Upgates haben wir ein offizielles Margly.io-Add-on im Upgates Marketplace vorbereitet. Sie installieren es mit zwei Klicks, Upgates übergibt Margly automatisch die API-Credentials über einen signierten Aufruf und Margly erstellt für Sie das Konto und den Mandanten. Kein Kopieren von Tokens, keine separate Registrierung auf der Website.
Vorgehen#
Öffnen Sie das Add-on im Upgates Marketplace
Gehen Sie auf doplnky.upgates.cz/detail/margly-io.
Klicken Sie auf Installieren
Upgates leitet Sie zur Anmeldung in die Administration Ihres E-Shops weiter (sofern Sie nicht angemeldet sind). Nach der Anmeldung sehen Sie das Add-on-Detail mit einer Übersicht der Berechtigungen.
Genehmigen Sie die Berechtigungen
Upgates fragt, ob Sie Margly Zugriff zum Lesen von Produkten, Bestellungen und Kunden gewähren möchten. Stimmen Sie zu — Margly ist read-only, schreibt nicht in Ihren E-Shop.
Nach der Genehmigung sendet Upgates Margly eine signierte Install-Payload mit den API-Credentials (token + apiUser + apiKey + apiUrl). Margly verifiziert die Signatur und speichert die Credentials in verschlüsselter Form.
Margly schließt die Verbindung automatisch ab
Margly:
- Erstellt für Sie ein Konto und die 14-tägige Testphase
- Erkennt die Währung Ihres E-Shops (CZK / EUR nach Upgates locale)
- Startet den ersten Datenabruf im Hintergrund
Innerhalb von 5–30 Minuten sehen Sie die ersten Daten in Margly (je nach Katalogumfang).
Was Margly aus Upgates liest#
- Produkte — Namen, SKU, Verkaufspreise, Einkaufspreise (wenn Sie sie in Upgates ausfüllen), MwSt.-Sätze, Bestände, Kategorien
- Bestellungen — Positionen, Rabatt, Versand, Status (bezahlt, storniert), Datum, Kunde
- Kunden — E-Mail, Name, Stadt, Firmenkontakt
Margly registriert Upgates-Webhooks automatisch während der Installation des Add-ons — Änderungen im E-Shop (neue Bestellung, Storno, Preisänderung) erhalte ich sofort.
Häufige Probleme#
- Das Add-on hat nicht zurück zu Margly weitergeleitet — prüfen Sie die E-Mail (Margly sendet Ihnen eine Begrüßungsnachricht mit Anmelde-Link) oder öffnen Sie direkt app.margly.io. Die Verbindung wurde hergestellt, nur der Browser hat den Kontext verloren.
- Das Add-on ist bei der Installation fehlgeschlagen — versuchen Sie, die Seite zu aktualisieren und die Installation erneut zu starten. Wenn der Fehler bestehen bleibt, schreiben Sie an support@margly.io mit E-Shop-Name und Screenshot des Fehlers.
- Der Datenabruf dauert ungewöhnlich lange — Upgates hat für große Kataloge strengere Rate Limits. Der erste Datenabruf eines E-Shops mit 10 000+ Produkten kann 20–30 Minuten dauern. Den Status sehen Sie in Margly in Verbindungen → Datenaktualisierung.
- Fehlende Einkaufspreise in Produkten — Upgates hat sie als optionales Feld. Wenn Sie sie nicht haben, berechnet Margly keine Margen — siehe Tipp oben.
Reinstall#
Wenn Sie das Add-on deinstallieren und später innerhalb von 30 Tagen erneut installieren, erkennt Margly denselben Shop am Upgates-Token und verbindet ihn mit Ihrem ursprünglichen Konto — die Daten gehen nicht verloren, der Datenabruf wird fortgesetzt und Margly hört auf, Erinnerungs-E-Mails zu senden.
Deinstallation des Add-ons#
Gehen Sie in der Upgates-Administration zu Doplňky → Margly.io → Odinstalovat. Margly sofort:
- Stoppt den Abruf neuer Daten aus Ihrem E-Shop
- Wechselt in den Read-only-Modus (historische Daten in der Anwendung sehen Sie weiterhin)
- Startet die 30-tägige Frist für die Datenerhaltung
- Sendet Ihnen während dieser Zeit mehrere Erinnerungen (3., 7., 14., 21. und 27. Tag)
Am 31. Tag werden das Konto und alle historischen Daten unwiderruflich gelöscht (DSGVO-Aufbewahrung). Wenn Sie das Add-on bis dahin erneut installieren (siehe Reinstall), verbindet Margly Sie mit dem ursprünglichen Konto und nimmt den Datenabruf wieder auf.
Wenn Sie das Konto früher löschen möchten, schreiben Sie an support@margly.io.
Wie geht's weiter#
- Verbindung von Google Ads für ROAS und Werberentabilität
- PDF-Rechnungsimport — für Betriebskosten (Logistik, Marketing, opex)
- Troubleshooting — wenn etwas fehlschlägt