XONIC Premium
interfaccia dati xoPort

XONIC Plus: Interfaccia dati xoPort – Descrizione delle prestazioni

§ 1 Oggetto del contratto

L’interfaccia dati XONIC Plus: xoPort è la licenza centrale per lo scambio professionale di dati tra il XONIC Shop System e sistemi esterni. Comprende tre modalità di integrazione: importazione/esportazione XML con trasformazione XSLT, l’API REST xoPort (JSON, OAuth2) e connettori diretti per la gestione delle scorte. Licenza annuale con rinnovo automatico (disdetta da inviare via e-mail 4 settimane prima della scadenza).

§ 2 Funzionalità

A) Interfaccia di importazione/esportazione XML

• Esportazione XML: prodotti (incl. categorie, prezzi, prezzi scalari, giacenze di magazzino, attributi, immagini, cross-selling, campi aggiuntivi, descrizioni multilingue), categorie (gerarchie, URL SEO), ordini (struttura completa delle voci), clienti (indirizzi, gruppi di clienti), produttori, buoni sconto
• Importazione XML: caricamento tramite backend/FTP, normalizzazione XSLT, convalida dello schema, elaborazione in batch (dimensione configurabile), risoluzione dei conflitti (aggiornamento vs. nuova creazione), importazione di tutte le entità esportate
• Trasformazione XSLT: XSLT 1.0 per qualsiasi formato di destinazione, modelli predefiniti per SelectLine, Taifun, Prodress, OpenTrans (BMEcat 2005), POSMaster, oEmbed, funzioni PHP integrabili nei modelli, possibilità di personalizzazione dei modelli
• Sicurezza: whitelist IP, autenticazione tramite chiave API, crittografia HTTPS

B) API REST xoPort

• Formato dati: JSON (UTF-8)
• Autenticazione: OAuth2 Client Credentials Grant (RFC 6749) con autorizzazione basata su ambito
• Metodi: GET (esportazione), POST (inserimento), PUT (aggiornamento), DELETE – RESTful secondo RFC 7231
• Risorse: prodotti (incl. immagini, schede, prezzi, video, fornitori, ContentEditor), categorie, clienti (indirizzi multipli), ordini (solo esportazione), produttori (GPSR), fornitori, notizie, FAQ, pagine CMS
• Funzionalità: elaborazione in batch, monitoraggio dell’utilizzo, registrazione del payload, filtri di query, avvisi sui campi sconosciuti
• Sicurezza: token OAuth2 (a durata limitata), autorizzazioni basate sull’ambito (lettura/scrittura/cancellazione per risorsa), crittografia HTTPS

C) Connettori per la gestione delle merci

• JTL-Wawi: sincronizzazione bidirezionale tramite il connettore JTL – prodotti, categorie, produttori, ordini, stato dei pagamenti, giacenze di magazzino, prezzi, dati anagrafici dei clienti, cross-selling, immagini dei prodotti
• Tricoma: dati anagrafici articoli, varianti, trasmissione degli ordini, sincronizzazione delle giacenze di magazzino
• Altri sistemi: integrabili tramite XML/XSLT o API REST (SelectLine, Xentral, Sage ecc.)

D) Amministrazione backend

• Attivazione della licenza tramite l’interfaccia di amministrazione XONIC
• Gestione dei client OAuth2 con statistiche di utilizzo e visualizzazione dei log (API REST)
• Impostazioni di sicurezza: filtri IP, chiavi API (XML), client OAuth2/ambiti (REST)
• Gestione dei modelli XSLT tramite FTP/SSH
• Configurazione dei token JTL

§ 3 Requisiti tecnici

• XONIC Shop System (CSV e XML a partire dalla versione 3, API REST xoPort a partire dalla versione 4.6), PHP 8.3+, MySQL
• Estensioni PHP per l’elaborazione XSLT e la manipolazione XML (per l’interfaccia XML)
• Spazio su disco per cataloghi di grandi dimensioni (consigliato: almeno 256 MB per >10.000 prodotti)
• Diritti di scrittura per i file di importazione/esportazione sul server

§ 4 Cosa NON comprende la licenza

• Monitoraggio automatico e risoluzione degli errori in caso di file di importazione difettosi (è necessaria la correzione manuale)
• Anteprima grafica delle immagini dei prodotti durante l’importazione (solo corrispondenza dei nomi dei file)
• Esportazione di dati binari (immagini, PDF) – vengono esportati solo nomi di file/URL
• Sincronizzazione in tempo reale (solo periodicamente tramite cronjob, webhook o trigger manuale)
• Esportazione delle informazioni di pagamento (esclusa per motivi di protezione dei dati)
• Importazione/esportazione di configurazioni del negozio, modelli di design o file di lingua
• Conversione automatica tra sistemi ERP senza configurazione/adattamento dei modelli
• Hosting o gestione di sistemi di gestione delle scorte esterni (JTL-Wawi, Tricoma ecc.)

§ 5 Assistenza e licenze

• Modello di licenza: licenza annuale (rinnovo automatico, disdetta via e-mail 4 settimane prima della scadenza).
• Attivazione: tramite l’interfaccia di amministrazione XONIC, convalida locale della licenza senza call-home.
• Assistenza: in base alla licenza di assistenza e aggiornamento sottoscritta (accordo separato).
• Aggiornamenti: servizi di assistenza e aggiornamenti durante il periodo di validità della licenza in base al livello di assistenza sottoscritto.
• Personalizzazioni: sviluppo di modelli XSLT specifici per il cliente, integrazioni API REST o configurazioni del connettore WaWi su richiesta (offerta separata).

§ 6 Esclusione di responsabilità e obblighi del cliente

Il software viene fornito «così com’è», senza alcuna garanzia. XONIC Solutions non risponde di:

• la perdita di dati dovuta a file di importazione errati, errori XSLT o configurazione errata dell’API (obbligo del cliente: eseguire un backup prima dell’importazione)
• Tempi di inattività di sistemi esterni (ERP, sistemi di gestione delle merci) o malfunzionamenti delle interfacce
• Incompatibilità con sistemi di terze parti in assenza di una configurazione adeguata o di un adattamento dei modelli
• Problemi di prestazioni dovuti a un dimensionamento insufficiente del server (obbligo del cliente: dimensionamento dell’hardware)
• Configurazioni errate nella whitelist IP, nelle chiavi API, nei client OAuth2 o nei modelli XSLT (obbligo del cliente)
• Modifiche alle API di sistemi esterni (JTL, Tricoma ecc.) che richiedono adeguamenti

Obbligo del cliente prima della messa in produzione: eseguire test sull’ambiente di staging! I backup dei dati prima delle operazioni di importazione/esportazione sono a carico del cliente.

§ 7 Protezione dei dati

• Trattamento dei dati del cliente (nome, indirizzo, e-mail) esclusivamente ai fini dell’integrazione dei dati.
• Obbligo del cliente: archiviare/trasferire i file esportati (XML, JSON) in conformità al GDPR (HTTPS, FTP crittografato). Riservatezza delle chiavi API, dei segreti OAuth2, dei token JTL e delle configurazioni dei filtri IP.
• XONIC non tratta i dati dei clienti provenienti dal modulo (ad eccezione dei servizi di assistenza esplicitamente richiesti).
• La convalida della licenza avviene localmente senza trasmissione di dati a server esterni (controllo offline).
• I dati relativi ai token OAuth2 vengono memorizzati esclusivamente nel database del negozio.

§ 8 Note legali

• Si applica il diritto tedesco, con esclusione della Convenzione delle Nazioni Unite sui contratti di vendita internazionale di beni (CISG).
• Foro competente: Chemnitz (per commercianti e persone giuridiche di diritto pubblico).
• Clausola salvatoria: l’inefficacia di singole disposizioni non pregiudica la validità complessiva del contratto.
• Eventuali modifiche o integrazioni devono essere effettuate per iscritto.

Aggiornato a: febbraio 2026 | Versione: 2.0
XONIC Solutions GmbH • Wildparkstraße 3 • 09247 Chemnitz
info@xonic-solutions.de • www.xonic-solutions.de