Zum Hauptinhalt springen

Klar Magento Integrationsmodule

Magento 1 und Magento 2 Synchronisierung für Klar

Verfasst von Frank Birzle
Heute aktualisiert

Melde Dich für die Klar - Magento Technical Updates mail distribution list hier an:
https://cdn.forms-content.sg-form.com/44d51bd3-3cac-11f1-83e8-06e45b3a2e4c

Wir informieren über wichtige Updates bzgl. unserer Magento Module.




Verbinde deinen Magento-Shop mit Klar und erhalte volle Transparenz über deine Bestelldaten — inklusive Positionen, Steuern, Rabatte, Versandkosten, Retouren und Kundeninformationen.

Wir bieten offizielle Integrationsmodule für Magento 1 und Magento 2 an.

Was die Module leisten

Beide Module senden deine vollständigen Bestelldaten an die Klar Orders API. Sobald die Verbindung steht, stehen alle Bestellungen — inklusive Positionen, angewandter Rabatte, Steueraufschlüsselung, Versandkosten und Rückerstattungen — in Klar für Reporting und Analysen zur Verfügung.

  • Automatische Synchronisation — neue und aktualisierte Bestellungen werden automatisch an Klar gesendet, sobald sie aufgegeben, versendet oder erstattet werden

  • Historischer Import — exportiere deine gesamte Bestellhistorie oder einen bestimmten Zeitraum, um Daten in Klar nachzuladen

  • Idempotent — das erneute Senden derselben Bestellung aktualisiert sie in Klar, anstatt Duplikate zu erzeugen. Du kannst jederzeit gefahrlos erneut exportieren

Magento 2

Repository: placeholder-tech/klar-magento-2 Kompatibilität: Magento 2.4.x, PHP 8.1+

Highlights

  • Admin-Oberfläche — alles konfigurierbar unter Stores > Konfiguration > Verkäufe > Klar, inklusive Verbindungstest, Sync-Statusübersicht und integriertem Log-Viewer

  • Flexible Sync-Optionen — Alle synchronisieren, Zeitraum-Sync, einzelne Bestellung synchronisieren und fehlgeschlagene Bestellungen erneut senden — direkt im Admin oder per CLI (bin/magento klar:order)

  • JSON-Vorschau — prüfe den exakten Payload, der an Klar gesendet wird, für jede beliebige Bestellung direkt im Admin

  • Konfigurierbares Feld-Mapping — ordne beliebige Magento-Produkt-, Kunden- oder Bestellattribute einem Klar-API-Feld zu — per einfacher XML-Konfigurationsdatei, ganz ohne Code-Änderungen. Unterstützt Dropdown-Labels, Multiselect-Arrays, verkettete Strings, Booleans und mehr

  • Sync-Tracking — die Bestellübersicht unter Verkäufe > Bestellungen zeigt an, wann jede Bestellung zuletzt mit Klar synchronisiert wurde, inklusive gespeicherter Fehlermeldungen pro Bestellung

  • Konfigurierbare Batch-Größe — steuere, wie viele Bestellungen pro API-Anfrage gesendet werden (1–1000)

  • Detailliertes Error-Logging — API-Fehler werden mit Bestell-IDs und einzelnen Fehlermeldungen in var/log/klar/klar.log protokolliert

  • Bundle- & Configurable-Product-Support — inklusive bundledProducts bei Positionen (API-Version 07.2025)

  • Asynchrone Verarbeitung — Bestellungen werden über Magentos Message Queue zuverlässig im Hintergrund verarbeitet

Migration von ICT_Klar

Falls du aktuell das ältere Modul unter ltd-iconcept/magento2-klar verwendest, steht eine Schritt-für-Schritt-Migrationsanleitung bereit. Deine bestehende Konfiguration, Datenbanktabellen und Queue-Einstellungen bleiben vollständig erhalten.

Erste Schritte

Siehe die vollständige README und Installationsanleitung.


Magento 1

Repository: placeholder-tech/klar-magento-1 Kompatibilität: Magento 1.9.x API-Version: 12.2022

Highlights

  • Automatische Synchronisation — Bestellungen werden nach Aufgabe automatisch per Cron exportiert

  • Zeitraum-Export — plane manuelle Exporte für einen bestimmten Zeitraum unter Admin > Verkäufe > Klar > Export planen

  • Bestellstatus-Tracking — Sync-Status und Fehlermeldungen pro Bestellung einsehbar unter Admin > Verkäufe > Klar > Bestellstatus

  • E-Mail-Datenschutz — Kunden-E-Mails können optional gehasht übermittelt werden

Erste Schritte

Siehe die vollständige README und Installationsanleitung.


Feature-Vergleich

Feature

Magento 1

Magento 2

Automatische Bestellsynchronisation

Ja

Ja

Historischer / Massenexport

Zeitraum

Alle, Zeitraum, Einzelbestellung

Admin-Konfigurationsoberfläche

Einfach

Vollständig (Logo, Sync-Panel, Log-Viewer)

CLI-Unterstützung

bin/magento klar:order

JSON-Vorschau / Debug-Modus

Ja

Attribut → Klar-Feld-Mapping

Ja (XML-Konfiguration)

Sync-Status in Bestellübersicht

Separate Seite

Inline-Spalte mit Zeitstempel

Fehlermeldungen pro Bestellung

Ja

Ja

Fehlgeschlagene erneut senden

Manuell

Ein-Klick-Button

Konfigurierbare Batch-Größe

Ja (1–1000)

Bundle-Product-Support

Ja

Asynchrone Message Queue

Cron-basiert

Magento Message Queue

API-Version

12.2022

07.2025

Brauchst du Hilfe?

Falls Probleme auftreten, erstelle bitte ein Issue im jeweiligen GitHub-Repository oder wende dich an unser Support-Team.

Hat dies deine Frage beantwortet?