Zum Hauptinhalt springen

Klar Magento Integrationsmodule

Offizielle Klar-Integrationsmodule fuer Magento 1 und Magento 2 – Funktionen und Vergleich

Verfasst von Frank Birzle

Trag dich hier in unseren Klar-Verteiler Magento Technical Updates ein:
​https://cdn.forms-content.sg-form.com/44d51bd3-3cac-11f1-83e8-06e45b3a2e4c
​
Wir informieren dich, sobald größere neue Updates erscheinen.

Verbinde deinen Magento-Store mit Klar und erhalte volle Sicht auf deine Bestelldaten – inklusive Line Items, Steuern, Rabatten, Versand, Erstattungen und Kundeninformationen.

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

Was die Module machen

Beide Module senden deine vollständigen Bestelldaten an die Klar Orders API. Einmal verbunden, ist jede Bestellung – inklusive ihrer Line Items, angewendeter Rabatte, Steueraufschlüsselungen, Versandkosten und Erstattungsinformationen – in Klar für Reporting und Analyse verfügbar.

  • Automatischer Sync – 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 gesammelt, um Daten in Klar nachzufüllen

  • Idempotent – das erneute Synchronisieren derselben Bestellung aktualisiert sie in Klar, statt Dubletten zu erzeugen, sodass du jederzeit gefahrlos neu exportieren kannst

Magento 2

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

Highlights

  • Admin UI – konfiguriere alles unter Stores > Configuration > Sales > Klar, inklusive eines Test-Connection-Buttons, einer Sync-Status-Übersicht und eines Live-Log-Viewers

  • Flexible Sync-Optionen – Sync All, Zeitraum-Sync, Einzelbestellungs-Sync und erneutes Synchronisieren fehlgeschlagener Bestellungen – alles aus dem Admin-Panel oder per CLI (bin/magento klar:order)

  • JSON-Preview – prüfe für jede Bestellung das genaue Payload, das an Klar gesendet wird, direkt in der Admin UI

  • Konfigurierbares Field-Mapping – mappe jedes Magento-Produkt-, -Kunden- oder -Bestellattribut über eine einfache XML-Config-Datei auf jedes Klar-API-Feld, ohne Code anzufassen. Unterstützt Dropdown-Labels, Multiselect-Arrays, verkettete Strings, Booleans und mehr

  • Sync-Tracking – das Grid unter Sales > Orders zeigt, wann jede Bestellung zuletzt zu Klar synchronisiert wurde, mit pro Bestellung gespeicherten Fehlermeldungen für die Fehlersuche

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

  • Detailliertes Error-Logging – API-Fehler werden mit Bestell-IDs und einzelnen Fehlermeldungen nach var/log/klar/klar.log geloggt

  • Unterstützung für Bundle- & Configurable-Produkte – inklusive bundledProducts auf Line Items (API-Version 07.2025)

  • Asynchrone Verarbeitung – Bestellungen werden über Magentos Message Queue synchronisiert, für zuverlässige Hintergrundverarbeitung

Migration von ICT_Klar

Wenn du aktuell das ältere Modul unter ltd-iconcept/magento2-klar nutzt, gibt es eine Schritt-für-Schritt-Migrationsanleitung. Deine bestehende Konfiguration, deine Datenbanktabellen und deine 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

  • Automatischer Sync – Bestellungen werden nach der Aufgabe automatisch per Cron exportiert

  • Zeitraum-Export – plane Exporte für einen bestimmten Zeitraum manuell unter Admin > Sales > Klar > Schedule Export

  • Order-Status-Tracking – sieh Sync-Status und Fehlermeldungen pro Bestellung unter Admin > Sales > Klar > Orders Status

  • E-Mail-Datenschutz – optional Kunden-E-Mails hashen, bevor sie an Klar gesendet werden

Erste Schritte

Siehe die vollständige README und Installationsanleitung.


Feature-Vergleich

Feature

Magento 1

Magento 2

Automatischer Bestell-Sync

Ja

Ja

Historischer / Bulk-Export

Zeitraum

Alle, Zeitraum, Einzelbestellung

Admin-UI-Konfiguration

Basis

Voll (Logo, Sync-Panel, Log-Viewer)

CLI-Unterstützung

—

bin/magento klar:order

JSON-Preview / Debug-Modus

—

Ja

Custom-Attribut → Klar-Feld-Mapping

—

Ja (XML-Config)

Sync-Status im Order-Grid

Separate Seite

Inline-Spalte mit Zeitstempel

Fehlermeldungen pro Bestellung

Ja

Ja

Fehlgeschlagene Bestellungen erneut synchronisieren

Manuell

Ein-Klick-Button

Konfigurierbare Batch-Größe

—

Ja (1–1000)

Unterstützung für Bundle-Produkte

—

Ja

Asynchrone Message Queue

Cron-basiert

Magento Message Queue

API-Version

12.2022

07.2025

Brauchst du Hilfe?

Wenn du auf Probleme stößt, öffne bitte ein Issue im jeweiligen GitHub-Repository oder wende dich an unser Support-Team.

Hat dies deine Frage beantwortet?