Margly
Anbindungen

Verbindung eines Shoptet-E-Shops

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

6 Min. Lesezeit

Drei Möglichkeiten, Shoptet zu verbinden#

Shoptet unterstützt drei Wege der Integration mit Margly:

  1. Autorisiertes Margly.io-Add-on in Shoptet Doplňky (in Vorbereitung — bald verfügbar) — Installation per Klick, kein manuelles Eingeben von Schlüsseln. Nach der Veröffentlichung wird dies der empfohlene Weg sein.
  2. API-Schlüssel (Privátní 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 (in Vorbereitung)#

Variante B: Verbindung über Privátní API-Schlüssel#

Der Privátní 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 Privátní API-Token in Shoptet

    Gehen Sie in der Shoptet-Administration zu Nastavení → Privátní API. Klicken Sie auf Vygenerovat token, benennen Sie es zum Beispiel „Margly" und kopieren Sie das generierte Token (es wird nur einmal angezeigt — speichern Sie es ab).

  2. Fügen Sie das Token in Margly ein

    Öffnen Sie in Margly Verbindungen → Shoptet und fügen Sie das Privátní API-Token ein. Klicken Sie auf Ověřit a uložit — Margly verifiziert das Token sofort gegen die Shoptet-API.

  3. Margly registriert automatisch Webhooks

    Nach der Verifizierung des Tokens registriert Margly im Hintergrund einen Satz Webhooks für:

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

    Die Registrierung dauert ein paar Sekunden und Sie sehen den Status „Webhooks aktiv" im Bereich Verbindungen.

  4. Warten Sie auf den ersten Datenabruf

    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 kein Privátní 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: Gehen Sie in der Shoptet-Administration zu Produkty → Export. Erstellen Sie einen eigenen Export (z. B. „Daten für Margly") und fügen Sie im Feldeditor diese Spalten hinzu (Sie finden sie im Feldauswahl-Angebot):

    • Výchozí kategorie
    • Nákupní cena
    • Nákupní cena v procentech DPH
    • Nákupní cena včetně DPH
    • Měna

    Wichtig: „Povolit pouze z konkrétní IP adresy" 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 Privátní 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.
  • „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