Importazione XML
Trasferisci i dati relativi a prodotti, categorie, clienti e ordini nel tuo negozio tramite richiesta HTTP. L'interfaccia di importazione XML elabora i dati lato server e fornisce una risposta strutturata in formato JSON con una panoramica dei risultati e i messaggi di errore.
Importazioni disponibili
Prodotti
Importazione e aggiornamento dei dati dei prodotti, incluse descrizioni, prezzi, immagini e attributi.
Documentazione →Scorte e stato
Aggiornamento rapido delle scorte e dello stato dei prodotti – ottimizzato per aggiornamenti frequenti con un volume minimo di dati.
Documentazione →Categorie
Importazione delle strutture delle categorie, comprese gerarchia, descrizioni e dati SEO.
Documentazione →Aggiornamento degli ordini
Aggiornamento dello stato degli ordini, dei numeri di tracciamento e delle informazioni di spedizione relative agli ordini esistenti.
Documentazione →Clienti
Importazione dei dati dei clienti, inclusi indirizzi, gruppi di clienti, abbonamenti alla newsletter e numeri cliente esterni.
Documentazione →Caratteristiche
Elaborazione in batch
Elabora più record in un'unica richiesta: ideale per importazioni di massa e aggiornamenti periodici.
Risposta JSON
Risposta strutturata con lo stato di ciascun record, leggibile automaticamente per un'integrazione senza soluzione di continuità.
Convalida
Verifica automatica di tutti i dati trasmessi con messaggi di errore dettagliati in caso di voci non valide.
Chiavi API
Accesso tramite chiavi API configurabili con autorizzazioni personalizzate per un trasferimento sicuro dei dati.
Crittografia HTTPS
Tutti i dati vengono trasmessi in forma crittografata: comunicazione sicura tra il negozio online e i sistemi esterni.
Gestione degli errori
Messaggi di errore dettagliati in caso di dati non validi consentono una rapida diagnosi e correzione.
Risposte e casi di errore
Ogni importazione restituisce un oggetto JSON. A partire dalla versione xoPort API 2.115.0 (Shop 4.9.65), esso contiene inoltre:
outcome:ok(nessun file rifiutato),partial(singoli file rifiutati, gli altri elaborati) oppurefailed(file rifiutati, nessuno elaborato)files.failed: file rifiutati con numero, nome del file, messaggio di errore comprensivo di riga e posizione di archiviazionewarnings.invalid_xml_chars_removed: numero di caratteri rimossi non consentiti da XML 1.0
I caratteri vietati da XML 1.0 (ad es. caratteri di controllo nei testi descrittivi) vengono rimossi dall’importazione prima dell’elaborazione del file. Se un file non può comunque essere letto come XML, non viene archiviato, ma spostato in xoport/xml/import/error/ e lì cancellato, come l’archivio, dopo il periodo di conservazione (di default 14 giorni). I file rifiutati non sono disponibili su files.processed.filenames.
"state": "error" e HTTP 422. I singoli file rifiutati non modificano lo stato HTTP – a tal fine, controllare outcome o files.failed.count. "state": "success" da solo non prova l’avvenuta importazione.
