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.logprotokolliertBundle- & Configurable-Product-Support — inklusive
bundledProductsbei Positionen (API-Version07.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 | — |
|
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 |
|
|
Brauchst du Hilfe?
Falls Probleme auftreten, erstelle bitte ein Issue im jeweiligen GitHub-Repository oder wende dich an unser Support-Team.
