XONIC Premium
xoPort Datenschnittstelle

XONIC Plus: xoPort Datenschnittstelle – Leistungsbeschreibung

§ 1 Vertragsgegenstand

Die XONIC Plus: xoPort Datenschnittstelle ist die zentrale Lizenz für den professionellen Datenaustausch zwischen dem XONIC Shopsystem und externen Systemen. Sie umfasst drei Integrationswege: XML Import/Export mit XSLT-Transformation, die xoPort REST API (JSON, OAuth2) sowie direkte Warenwirtschafts-Connectoren. Jahreslizenz mit automatischer Verlängerung (Kündigung 4 Wochen vor Ablauf per E-Mail).

§ 2 Funktionsumfang

A) XML Import/Export-Schnittstelle

• XML-Export: Produkte (inkl. Kategorien, Preise, Staffelpreise, Lagerbestände, Attribute, Bilder, Cross-Selling, Extra-Felder, mehrsprachige Beschreibungen), Kategorien (Hierarchien, SEO-URLs), Bestellungen (vollständige Positions-Struktur), Kunden (Adressen, Kundengruppen), Hersteller, Gutscheine
• XML-Import: Upload via Backend/FTP, XSLT-Normalisierung, Schema-Validierung, Batch-Verarbeitung (konfigurierbare Größe), Conflict-Resolution (Update vs. Neuanlage), Import aller Export-Entitäten
• XSLT-Transformation: XSLT 1.0 für beliebige Zielformate, vordefinierte Templates für SelectLine, Taifun, Prodress, OpenTrans (BMEcat 2005), POSMaster, oEmbed, PHP-Funktionen in Templates integrierbar, individuelle Template-Anpassungen möglich
• Sicherheit: IP-Whitelist, API-Key-Authentifizierung, HTTPS-Verschlüsselung

B) xoPort REST API

• Datenformat: JSON (UTF-8)
• Authentifizierung: OAuth2 Client Credentials Grant (RFC 6749) mit Scope-basierter Autorisierung
• Methoden: GET (Export), POST (Insert), PUT (Update), DELETE – RESTful nach RFC 7231
• Ressourcen: Produkte (inkl. Bilder, Tabs, Preise, Videos, Lieferanten, ContentEditor), Kategorien, Kunden (Multi-Adressen), Bestellungen (nur Export), Hersteller (GPSR), Lieferanten, News, FAQ, CMS-Seiten
• Features: Batch-Verarbeitung, Usage Tracking, Payload-Logging, Query-Filter, Unknown-Field-Warnings
• Sicherheit: OAuth2-Tokens (zeitlich begrenzt), Scope-basierte Berechtigungen (read/write/delete pro Ressource), HTTPS-Verschlüsselung

C) Warenwirtschafts-Connectoren

• JTL-Wawi: Bidirektionale Synchronisation über den JTL-Connector – Produkte, Kategorien, Hersteller, Bestellungen, Zahlungsstatus, Lagerbestände, Preise, Kundenstammdaten, Cross-Selling, Produktbilder
• Tricoma: Artikelstammdaten, Varianten, Bestellübermittlung, Lagerbestands-Synchronisation
• Weitere Systeme: Über XML/XSLT oder REST API anbindbar (SelectLine, Xentral, Sage u. a.)

D) Backend-Administration

• Lizenzaktivierung über XONIC Admin-Interface
• OAuth2-Client-Verwaltung mit Nutzungsstatistiken und Log-Ansicht (REST API)
• Sicherheitseinstellungen: IP-Filter, API-Keys (XML), OAuth2-Clients/Scopes (REST)
• XSLT-Template-Verwaltung via FTP/SSH
• JTL-Token-Konfiguration

§ 3 Technische Voraussetzungen

• XONIC Shopsystem (CSV & XML ab V3, xoPort REST API ab V4.6), PHP 8.3+, MySQL
• PHP-Erweiterungen für XSLT-Verarbeitung und XML-Manipulation (für XML-Schnittstelle)
• Serverspeicher für große Kataloge (empfohlen: mindestens 256 MB für >10.000 Produkte)
• Schreibrechte für Import-/Export-Dateien auf dem Server

§ 4 Was die Lizenz NICHT umfasst

• Automatische Überwachung und Fehlerbehebung bei fehlerhaften Import-Dateien (manuelle Korrektur erforderlich)
• Grafische Vorschau von Produktbildern während des Imports (nur Dateinamen-Matching)
• Export von Binärdaten (Bilder, PDFs) – nur Dateinamen/URLs werden exportiert
• Echtzeit-Synchronisation (nur periodisch via Cronjob, Webhook oder manueller Trigger)
• Export von Zahlungsinformationen (datenschutzkonform ausgeschlossen)
• Import/Export von Shop-Konfigurationen, Design-Templates oder Sprachdateien
• Automatische Konvertierung zwischen ERP-Systemen ohne Konfiguration/Template-Anpassung
• Hosting oder Betrieb externer Warenwirtschaftssysteme (JTL-Wawi, Tricoma etc.)

§ 5 Support & Lizenzierung

• Lizenzmodell: Jahreslizenz (automatische Verlängerung, Kündigung 4 Wochen vor Ablauf per E-Mail).
• Aktivierung: Über XONIC Admin-Interface, lokale Lizenz-Validierung ohne Call-Home.
• Support: Gemäß gebuchter Support & Update-Lizenz (separate Vereinbarung).
• Updates: Support-Leistungen und Updates während Lizenzlaufzeit gemäß gebuchtem Support-Level.
• Individuelle Anpassungen: Entwicklung kundenspezifischer XSLT-Templates, REST-API-Integrationen oder WaWi-Connector-Konfigurationen auf Anfrage (separates Angebot).

§ 6 Haftungsausschluss & Kundenpflichten

Die Software wird „as is" ohne Gewähr bereitgestellt. XONIC Solutions haftet nicht für:

• Datenverlust durch fehlerhafte Import-Dateien, XSLT-Fehler oder API-Fehlkonfiguration (Kundenpflicht: Backup vor Import)
• Down-Time externer Systeme (ERP, Warenwirtschaft) oder Schnittstellen-Ausfälle
• Inkompatibilitäten mit Drittsystemen ohne entsprechende Konfiguration/Template-Anpassung
• Performance-Probleme bei unzureichender Server-Dimensionierung (Kundenpflicht: Hardware-Sizing)
• Fehlkonfigurationen in IP-Whitelist, API-Keys, OAuth2-Clients oder XSLT-Templates (Kundenpflicht)
• Änderungen an APIs externer Systeme (JTL, Tricoma etc.), die Anpassungen erfordern

Kundenpflicht vor Produktiv-Betrieb: Testdurchläufe auf Staging-Umgebung durchführen! Datensicherungen vor Import/Export-Operationen liegen in Kundenverantwortung.

§ 7 Datenschutz

• Verarbeitung von Kundendaten (Name, Adresse, E-Mail) ausschließlich für Zwecke der Datenintegration.
• Kundenpflicht: Exportierte Dateien (XML, JSON) DSGVO-konform speichern/übertragen (HTTPS, verschlüsselte FTP). Geheimhaltung von API-Keys, OAuth2-Secrets, JTL-Tokens und IP-Filter-Konfigurationen.
• XONIC verarbeitet keine Kundendaten aus dem Modul (außer für explizit angefragte Support-Leistungen).
• Lizenz-Validierung erfolgt lokal ohne Datenübertragung an externe Server (Offline-Check).
• OAuth2-Token-Daten werden ausschließlich in der Shop-Datenbank gespeichert.

§ 8 Rechtliches

• Es gilt deutsches Recht unter Ausschluss des UN-Kaufrechts (CISG).
• Gerichtsstand: Chemnitz (bei Kaufleuten, juristischen Personen des öffentlichen Rechts).
• Salvatorische Klausel: Unwirksamkeit einzelner Bestimmungen berührt Gesamtvertrag nicht.
• Änderungen/Ergänzungen bedürfen der Schriftform.

Stand: Februar 2026 | Version: 2.0
XONIC Solutions GmbH • Wildparkstraße 3 • 09247 Chemnitz
info@xonic-solutions.de • www.xonic-solutions.de