XONIC Premium
interface de données xoPort

XONIC Plus : interface de données xoPort – Cahier des charges

§ 1 Objet du contrat

L’interface de données XONIC Plus : xoPort est la licence centrale permettant l’échange professionnel de données entre le XONIC Shop System et des systèmes externes. Elle comprend trois méthodes d’intégration : l’importation/exportation XML avec transformation XSLT, l’API REST xoPort (JSON, OAuth2) ainsi que des connecteurs directs vers les systèmes de gestion des stocks. Licence annuelle avec renouvellement automatique (résiliation par e-mail 4 semaines avant l’expiration).

§ 2 Fonctionnalités

A) Interface d’import/export XML

• Export XML : produits (y compris catégories, prix, tarifs dégressifs, stocks, attributs, images, ventes croisées, champs supplémentaires, descriptions multilingues), catégories (hiérarchies, URL SEO), commandes (structure complète des lignes de commande), clients (adresses, groupes de clients), fabricants, bons d’achat
• Importation XML : téléchargement via le backend/FTP, normalisation XSLT, validation du schéma, traitement par lots (taille configurable), résolution des conflits (mise à jour ou création d’une nouvelle entrée), importation de toutes les entités exportées
• Transformation XSLT : XSLT 1.0 pour tous les formats cibles, modèles prédéfinis pour SelectLine, Taifun, Prodress, OpenTrans (BMEcat 2005), POSMaster, oEmbed, fonctions PHP intégrables dans les modèles, personnalisations individuelles des modèles possibles
• Sécurité : liste blanche d'adresses IP, authentification par clé API, chiffrement HTTPS

B) API REST xoPort

• Format des données : JSON (UTF-8)
• Authentification : OAuth2 Client Credentials Grant (RFC 6749) avec autorisation basée sur le périmètre
• Méthodes : GET (exportation), POST (insertion), PUT (mise à jour), DELETE – RESTful selon la norme RFC 7231
• Ressources : produits (y compris images, onglets, prix, vidéos, fournisseurs, ContentEditor), catégories, clients (adresses multiples), commandes (exportation uniquement), fabricants (GPSR), fournisseurs, actualités, FAQ, pages CMS
• Fonctionnalités : traitement par lots, suivi de l'utilisation, journalisation des charges utiles, filtres de requête, avertissements en cas de champs inconnus
• Sécurité : jetons OAuth2 (à durée limitée), autorisations basées sur le périmètre (lecture/écriture/suppression par ressource), chiffrement HTTPS

C) Connecteurs de gestion des stocks

• JTL-Wawi : synchronisation bidirectionnelle via le connecteur JTL – produits, catégories, fabricants, commandes, statuts de paiement, stocks, prix, données de base clients, ventes croisées, images de produits
• Tricoma : fiches articles, variantes, transmission des commandes, synchronisation des stocks
• Autres systèmes : connectables via XML/XSLT ou API REST (SelectLine, Xentral, Sage, etc.)

D) Administration du backend

• Activation de la licence via l'interface d'administration XONIC
• Gestion des clients OAuth2 avec statistiques d'utilisation et affichage des journaux (API REST)
• Paramètres de sécurité : filtres IP, clés API (XML), clients OAuth2/portées (REST)
• Gestion des modèles XSLT via FTP/SSH
• Configuration des jetons JTL

§ 3 Conditions techniques requises

• XONIC Shop System (CSV et XML à partir de la version 3, API REST xoPort à partir de la version 4.6), PHP 8.3+, MySQL
• Extensions PHP pour le traitement XSLT et la manipulation XML (pour l'interface XML)
• Espace de stockage sur le serveur pour les catalogues volumineux (recommandé : au moins 256 Mo pour plus de 10 000 produits)
• Droits d'écriture sur le serveur pour les fichiers d'importation/exportation

§ 4 Ce que la licence NE comprend PAS

• Surveillance automatique et correction des erreurs dans les fichiers d’importation défectueux (correction manuelle requise)
• Aperçu graphique des images de produits pendant l’importation (correspondance des noms de fichiers uniquement)
• Exportation de données binaires (images, PDF) – seuls les noms de fichiers/URL sont exportés
• Synchronisation en temps réel (uniquement de manière périodique via une tâche Cron, un webhook ou un déclencheur manuel)
• Exportation des informations de paiement (exclue pour des raisons de conformité à la protection des données)
• Importation/exportation des configurations de boutique, des modèles de design ou des fichiers de langue
• Conversion automatique entre systèmes ERP sans configuration ni adaptation des modèles
• Hébergement ou exploitation de systèmes de gestion des stocks externes (JTL-Wawi, Tricoma, etc.)

§ 5 Assistance et licence

• Modèle de licence : licence annuelle (renouvellement automatique, résiliation par e-mail 4 semaines avant l'expiration).
• Activation : via l’interface d’administration XONIC, validation locale de la licence sans « call-home ».
• Assistance : conformément à la licence d’assistance et de mise à jour souscrite (accord séparé).
• Mises à jour : prestations d’assistance et mises à jour pendant la durée de la licence, conformément au niveau d’assistance souscrit.
• Adaptations personnalisées : développement de modèles XSLT spécifiques au client, d’intégrations d’API REST ou de configurations de connecteurs WaWi sur demande (devis séparé).

§ 6 Exclusion de responsabilité et obligations du client

Le logiciel est fourni « tel quel », sans garantie. XONIC Solutions décline toute responsabilité en cas de :

• la perte de données due à des fichiers d’importation défectueux, à des erreurs XSLT ou à une mauvaise configuration de l’API (obligation du client : effectuer une sauvegarde avant l’importation)
• les temps d’indisponibilité des systèmes externes (ERP, gestion des stocks) ou les défaillances des interfaces
• les incompatibilités avec des systèmes tiers en l’absence d’une configuration appropriée ou d’une adaptation des modèles
• les problèmes de performances dus à un dimensionnement insuffisant du serveur (obligation du client : dimensionnement du matériel)
• les erreurs de configuration dans la liste blanche d’adresses IP, les clés API, les clients OAuth2 ou les modèles XSLT (obligation du client)
• Modifications apportées aux API de systèmes externes (JTL, Tricoma, etc.) nécessitant des adaptations

Obligation du client avant la mise en production : effectuer des tests sur l'environnement de préproduction ! Les sauvegardes de données avant les opérations d'importation/exportation relèvent de la responsabilité du client.

§ 7 Protection des données

• Traitement des données client (nom, adresse, e-mail) exclusivement à des fins d’intégration des données.
• Obligation du client : stocker/transférer les fichiers exportés (XML, JSON) conformément au RGPD (HTTPS, FTP chiffré). Confidentialité des clés API, des secrets OAuth2, des jetons JTL et des configurations de filtres IP.
• XONIC ne traite aucune donnée client issue du module (sauf dans le cadre de prestations d’assistance explicitement demandées).
• La validation de la licence s'effectue localement sans transfert de données vers des serveurs externes (vérification hors ligne).
• Les données relatives aux jetons OAuth2 sont exclusivement stockées dans la base de données de la boutique.

§ 8 Mentions légales

• Le droit allemand s'applique, à l'exclusion de la Convention des Nations Unies sur les contrats de vente internationale de marchandises (CISG).
• Tribunal compétent : Chemnitz (pour les commerçants et les personnes morales de droit public).
• Clause de sauvegarde : la nullité de certaines dispositions n'affecte pas la validité du contrat dans son ensemble.
• Toute modification ou tout ajout doit être formulé par écrit.

Mise à jour : février 2026 | Version : 2.0
XONIC Solutions GmbH • Wildparkstraße 3 • 09247 Chemnitz
info@xonic-solutions.de • www.xonic-solutions.de