Anbindungen

Verbindung eines Shoptet-E-Shops

Drei Möglichkeiten, Shoptet zu verbinden — autorisiertes Margly.io-Add-on (empfohlen), API-Schlüssel oder 3 CSV-Feeds.

10 Min. Lesezeit

Drei Möglichkeiten, Shoptet zu verbinden#

Shoptet unterstützt drei Wege der Integration mit Margly:

  1. Autorisiertes Margly.io-Add-on im Shoptet App Marketplace (empfohlen) — Installation per Klick, kein manuelles Eingeben von Schlüsseln. Der einfachste und schnellste Weg.
  2. API-Schlüssel (Private API) — sofortiges Laden, Webhooks für Echtzeit-Aktualisierungen. Nur im Shoptet Premium-Tarif verfügbar.
  3. CSV-Feeds — funktioniert für alle Shoptet-Tarife. Margly benötigt 3 separate Feed-URLs (Bestellungen, Produkte, Kunden). Daten werden automatisch nach Ihrem Margly-Tarif geladen (Starter 1×/Tag, Professional 2×/Tag, Business / Enterprise / Testphase 4×/Tag).

Variante A: Autorisiertes Margly.io-Add-on (empfohlen)#

Das Margly.io-Add-on ist genehmigt und im Shoptet App Marketplace verfügbar. Es ist der einfachste Weg der Verbindung — Installation per Klick, ohne manuelles Eingeben von Schlüsseln.

  1. Öffnen Sie das Margly.io-Add-on

    Gehen Sie auf doplnky.shoptet.cz/margly-io oder öffnen Sie in Ihrer Shoptet-Administration den Bereich Doplňky, finden Sie Margly.io und klicken Sie auf Add-on bestellen.

  2. Berechtigungen genehmigen

    Bestätigen Sie den read-only Zugriff auf Produkte, Bestellungen und Kunden. Das Add-on fordert niemals Schreibrechte an.

  3. Fertig — Margly erledigt den Rest

    Margly erstellt automatisch ein Konto, startet die 14-tägige kostenlose Testphase, registriert Webhooks für Echtzeit-Daten und lädt historische Daten. Das Add-on öffnen Sie anschließend direkt aus der Shoptet-Administration (Add-on-Manager → Margly) oder über app.margly.io.

Variante B: Verbindung über Private-API-Schlüssel#

Der Private-API-Schlüssel ist der schnellste Weg zu aktuellen Daten — Margly erhält Änderungen im E-Shop (neue Bestellung, Storno, Preisänderung) in Echtzeit über Webhooks, sodass die Übersichten in der Anwendung praktisch sofort sind.

  1. Generieren Sie ein Private-API-Token in Shoptet

    Gehen Sie in der Shoptet-Administration zu Verbindungen → Private API. Klicken Sie auf Token generieren, benennen Sie es zum Beispiel „Margly" und kopieren Sie das generierte Token (es wird nur einmal angezeigt — speichern Sie es ab).

    Geben Sie dem Token außerdem diese Endpoint-Gruppen frei:

    Endpoint-GruppeBerechtigungWofür Margly sie braucht
    EinstellungenLesen + SchreibenÜber den Schreibzugriff werden die Webhooks registriert. Ohne ihn erhält Margly keine Echtzeit-Änderungen.
    BestellungenLesenUmsatz, Margen, Versandkosten, Kundenrückkehrrate.
    ProdukteLesenEinkaufspreise — ohne sie kann Margly keine Marge berechnen.
    KundenLesenLebenszeitwert des Kunden und seine Rückkehrrate.

  2. Fügen Sie das Token in Margly ein

    Wenn Sie Margly gerade einrichten, sind Sie im Registrierungsassistenten bei Schritt 3 von 3 — Verbindungen. Wenn Sie bereits ein Konto haben, öffnen Sie Verbindungen → Shoptet.

    Füllen Sie drei Felder aus:

    • Hauptwährung — die Währung, in der Sie alle Zahlen sehen möchten.
    • E-Shop-URL — die Domain Ihres E-Shops, zum Beispiel https://www.mein-eshop.de.
    • Shoptet API-Schlüssel — hier fügen Sie das Token aus dem vorherigen Schritt ein.

    Klicken Sie auf Schlüssel verifizieren. Margly verifiziert das Token sofort gegen die Shoptet-API und zeigt das Datum der Verifizierung, den Token-Typ Private API und den Namen Ihres E-Shops an.

  3. Margly registriert die Webhooks

    Die Registrierung läuft automatisch während der Token-Verifizierung — Sie selbst tun nichts. Margly abonniert:

    • den Bestelllebenszyklus (Erstellung, Bearbeitung, Bezahlung, Storno)
    • die Produktverfügbarkeit und Lagerbewegungen
    • den Kundenlebenszyklus (Erstellung, Bearbeitung)

    Unter dem Schlüsselfeld finden Sie die Karte Shoptet Webhooks mit der Schaltfläche Verbindung erneuern. Die brauchen Sie nur selten — falls Shoptet einmal keine Aktualisierungen mehr sendet. Die Schaltfläche rotiert den Signaturschlüssel und registriert alle Ereignisse neu.

  4. Bestätigen Sie die Feldzuordnung

    Klicken Sie auf Weiter zur Feldzuordnung. Es öffnet sich die Karte Feldzuordnung mit den Reitern Bestellungen, Produkte und Kunden sowie den Spalten Unsere Metrik, API-Feld und Status.

    Margly füllt alles automatisch vor — sehen Sie es durch und ändern Sie nichts, wenn Sie keinen Grund dazu haben. Beim ersten Mal ist die ganze Spalte Status gelb „nicht gespeichert"; das ist kein Fehler, es bedeutet nur „noch nicht bestätigt". Ein Sternchen neben einer Metrik bedeutet, dass sie erforderlich ist.

    Klicken Sie auf Zuordnung speichern und bestätigen. Die Status wechseln auf „auto" und Margly beginnt, Daten abzurufen.

  5. Schließen Sie die Registrierung ab und warten Sie auf die Daten

    Klicken Sie auf Registrierung abschließen. Margly lädt historische Daten herunter — typischerweise 5–30 Minuten je nach E-Shop-Größe. Den Status sehen Sie in Verbindungen → Datenaktualisierung.

Variante C: Verbindung über CSV-Feeds#

Wenn Sie kein Shoptet Premium haben (und damit auch keine Private API), fügen Sie in Margly 3 Feed-URLs ein. Ohne alle drei kann Margly weder Margen noch die Kundenrückkehr berechnen — Produktpreise und Kundendaten sind für die Berechnungen unerlässlich.

Jeder Feed wird in der Shoptet-Administration in einem anderen Bereich generiert — siehe offizielle Shoptet-Hilfe zu Exporten. Das Vorgehen für jeden Feed fassen wir unten zusammen.

  1. Generieren Sie URL-Feeds im CSV-Format in der Shoptet-Administration

    Produkte: Gehe in der Shoptet-Administration zu Produkty → Export. Erstelle einen eigenen Export (z. B. „Daten für Margly") und hake im Feldeditor die Spalten aus der Tabelle unten an.

    Warum genau diese Spalten? Margly sieht nicht in deine Administration — Margly sieht nur, was dein Export mitschickt. Jede Spalte schaltet eine bestimmte Berechnung oder Empfehlung frei. Was du weglässt, kann Margly nicht berechnen; und bei manchen Spalten ist das schlimmer als Schweigen — ohne die Sichtbarkeit weiß Margly nicht, dass du Ware aus dem Verkauf genommen hast, und rechnet sie weiter mit.

    Bereich in der Shoptet-AdministrationAnhakenWas du dadurch in Margly siehst
    BasisinformationenProduktsichtbarkeit, VariantensichtbarkeitMargly erkennt, was du aus dem Verkauf genommen hast. Sonst landet ausgeblendete Ware in deinen Statistiken und der KI-Berater rät dir, Produkte zu überarbeiten, die du nicht mehr verkaufst.
    BasisinformationenBeschreibung, KurzbeschreibungKI-Modelle (ChatGPT, Perplexity) und Suchmaschinen lesen deinen Produkttext. Margly listet dir Ware auf, bei der er fehlt oder zu kurz ist — deshalb empfiehlt dich die KI nicht.
    BasisinformationenMeta-Beschreibung der SeiteDer Text, der in den Suchergebnissen erscheint. Margly zeigt dir Produkte, bei denen er fehlt — dann dichten Google und KI ihren eigenen dazu.
    BasisinformationenHerstellerDie Marke. Einkaufsassistenten ordnen dein Produkt damit ein und vergleichen es mit der Konkurrenz.
    BasisinformationenStandardkategorieMargly rechnet aus, welche Kategorien Geld bringen und welche nur Lager binden.
    PreiseEinkaufspreis, Einkaufspreis in MwSt.-Prozent, Einkaufspreis inkl. MwSt., WährungOhne Einkaufspreis berechnen wir keine Marge — weder je Produkt noch insgesamt. Das ist der wichtigste Punkt der Liste.
    LagerLagerbestandLagerumschlag, Aufteilung der Ware in Stars und Schwache, und Hinweise auf Ladenhüter — also Geld, das in unverkäuflicher Ware liegt.
    LagerEANDer Barcode. Damit ordnen dich Preisvergleiche und Einkaufsassistenten derselben Ware bei der Konkurrenz zu. Ohne ihn zeigen sie dich schlechter oder gar nicht.
    BilderProduktbilderMargly erkennt Ware ohne Foto. Die spielen KI und Preisvergleiche so gut wie nie aus.
    SetsSet-PositionenMargly erkennt, dass ein Produkt bereits ein Bundle ist, und schlägt nicht vor, es erneut zu bauen. Sonst raten wir am Namen und liegen manchmal daneben.

    Wichtig: „Nur von einer bestimmten IP-Adresse zulassen" darf nicht aktiviert sein. Speichern Sie und kopieren Sie die URL aus dem unteren Bereich der Seite.

    Bestellungen: Gehen Sie zu Objednávky → Export. Wählen Sie den Systemexport Shoptet — CSV. Beim Feld „Zahrnout objednávky" wählen Sie Vše. „Permanentní odkaz" darf nicht aktiviert sein. Kopieren Sie die URL aus dem unteren Bereich der Seite.

    Kunden: Gehen Sie zu Zákazníci → Export. Wählen Sie den Exporttyp CSV. „Permanentní odkaz" darf nicht aktiviert sein. Kopieren Sie die URL aus dem unteren Bereich der Seite.

  2. Fügen Sie alle 3 URLs in Margly ein

    Öffnen Sie in Margly Verbindungen → Shoptet (CSV) und fügen Sie ein:

    • URL des Feeds Bestellungen
    • URL des Feeds Produkte
    • URL des Feeds Kunden

    Margly verifiziert alle drei — lädt eine kleine Stichprobe und testet, ob es die Kodierung (UTF-8 oder Windows-1250) und das Spaltentrennzeichen (Semikolon oder Tabulator) lesen kann.

  3. Abruffrequenz nach Ihrem Tarif

    CSV-Feeds lädt Margly nach denselben Regeln wie API/Add-on — die Frequenz richtet sich nach Ihrem Margly-Tarif:

    • Starter — 1×/Tag (morgens)
    • Professional — 2×/Tag (morgens + abends)
    • Business / Enterprise / Testphase — 4×/Tag (morgens, mittags, abends, nachts)

    Details in Datenaktualisierung. Zwischen den Abrufen sind aktuelle Daten erst nach dem nächsten geplanten Abruf sichtbar — für Echtzeit benötigen Sie die Private API (Variante B), die Webhooks sofort sendet.

Häufige Fehler#

  • „Feed nicht verfügbar (403)" — die private CSV-Feed-URL erfordert, dass in den Shoptet-Einstellungen nicht aktiviert ist „Povolit pouze z konkrétní IP adresy" (bei Produkten) oder „Permanentní odkaz" (bei Bestellungen und Kunden). Prüfen Sie das in der Administration.
  • „API-Schlüssel nicht verifiziert (401)" — das Token wurde deaktiviert oder falsch kopiert. Generieren Sie in Shoptet ein neues und fügen Sie es erneut ein.
  • „Dem API-Token fehlen erforderliche Berechtigungen (403)" — das Token ist in Shoptet auf Endpoint-Gruppen beschränkt und einige der von Margly benötigten fehlen. Geben Sie ihm in Verbindungen → Private API Einstellungen (Lesen + Schreiben), Bestellungen, Produkte und Kunden (Lesen) frei.
  • „Margly lädt keine Daten, obwohl der Schlüssel verifiziert ist" — höchstwahrscheinlich haben Sie den letzten Schritt nicht abgeschlossen. Öffnen Sie Verbindungen → Shoptet, scrollen Sie zur Karte Feldzuordnung und klicken Sie auf Zuordnung speichern und bestätigen. Ohne die Bestätigung startet der API-Import nie.
  • „Webhooks wurden nicht registriert" — manche Shoptet-Tarife ermöglichen keine Webhook-Registrierung. Margly funktioniert dann, aber nur mit regulärem Datenabruf (nach Ihrem Tarif).
  • „Falsche Kodierung im CSV" — Margly unterstützt UTF-8 und Windows-1250 (Legacy Shoptet-Feeds). Wenn der Feed eine andere Kodierung enthält (extrem selten), schreiben Sie an den Support.
  • Falsche Währung in den Bestellungen — Margly nimmt die Währung aus den E-Shop-Einstellungen. Wenn Sie einen mehrsprachigen/mehrwährigen E-Shop haben, prüfen Sie im Bereich Abrechnung, dass Sie die richtige Standardwährung haben.

Wie geht's weiter#

Nach erfolgreicher Verbindung von Shoptet empfehlen wir, auch Werbesysteme und externe Dienste zu verbinden — ohne sie sieht Margly nur Umsätze, aber nicht die Rentabilität der Werbung noch den Traffic:

War das hilfreich?

Verwandte Artikel

Persönliche Antwort

Keine Antwort gefunden?

Schreiben Sie uns direkt — wir antworten in der Regel innerhalb von 24 Stunden an Werktagen.

support@margly.io