Importazione ed esportazione tramite CSV ed Excel
Con CSV-Porter è possibile trasferire articoli, prezzi, giacenze, caratteristiche, clienti e ordini sotto forma di file CSV o Excel: una tantum nel backend o regolarmente tramite un link per i sistemi di gestione delle scorte e i portali dei prezzi. Questa guida illustra come creare un Porter, assegnare le colonne, interpretare il report di importazione ed evitare gli errori più comuni.
In sintesi
- Dove: in Strumenti → xoPort CSV Import/Export Manager. Un Porter è una routine salvata composta da rubrica, colonne e impostazioni. Lo stesso Porter esegue sia l’esportazione che l’importazione.
- Porter predefiniti: sono già pronti di fabbrica, ma protetti e disattivati. Duplicate il Porter appropriato e lavorate con la copia.
- Formati: CSV, TXT, XLS, XLSX e ODS. Per lavorare in Excel, i formati più sicuri sono XLSX o CSV in UTF-8.
- Importazione: la scrittura avviene immediatamente, non è prevista una prova. Esportare prima le stesse colonne come copia di sicurezza e testare con poche righe. Il report di importazione indica ogni riga rifiutata.
- Automatico: link di esportazione e importazione per portali di prezzi, sistemi di gestione delle scorte e cronjob. I dati relativi a clienti e ordini sono conservati in una directory protetta con password e filtro IP.
In questa guida
Come funziona Porter
Un Porter definisce quali dati trasferire, in quali colonne e in quale formato di file. L’esportazione e l’importazione avvengono tramite la stessa mappatura delle colonne. Un file esportato può quindi essere modificato e reimportato utilizzando lo stesso Porter.
Sezione
La rubrica determina quali dati sono riconosciuti dal Porter: prodotti, opzioni di prodotto, prezzi per gruppi di clienti, dati dei clienti, dati degli ordini e altro ancora. Da essa dipendono le colonne selezionabili e il tipo di importazione o esportazione.
Colonne
In «Modifica colonne» è possibile attivare i campi che devono essere presenti nel file e assegnare a ciascuna colonna un «nome colonna». Durante l’importazione, il negozio assegna le colonne del file in base a questi nomi presenti nell’intestazione.
Impostazioni
Separatori di campi e di testo, formato di output, set di caratteri, lingua di Porter e filtri per l’esportazione. Per l’importazione automatica viene aggiunta una directory da cui Porter legge i file.
La panoramica in Strumenti → xoPort CSV Import/Export Manager raggruppa i Porter nelle schede «Dati prodotto», «Portali dei prezzi», «Dati clienti e ordini» e «Altro». Il menu azioni di un Porter offre «Info e link», «Modifica colonne», «Impostazioni», «Importa dati nel negozio», «Esporta dati dal negozio», «Duplica routine di esportazione» e «Elimina». I file Porter predefiniti (contrassegnati da un lucchetto) non dispongono delle opzioni «Modifica colonne» e «Elimina»; per apportare modifiche, è necessario duplicarli. Il pulsante nella colonna «Stato del file Porter» abilita il link di esportazione e importazione. Le operazioni di importazione ed esportazione nel backend funzionano anche quando il file Porter è disattivato.
Panoramica dei porter: i porter standard sono contrassegnati da un lucchetto; il menu a freccia accanto a «Info e link» porta alle colonne, alle impostazioni, all’importazione, all’esportazione, alla duplicazione e all’eliminazione. Cliccare per ingrandire.
I Porter predefiniti
Questi Porter sono inclusi in ogni negozio. Sono protetti: le loro colonne non possono essere modificate e non possono essere eliminati. Di default sono disattivati.
| Porter | Contenuto |
|---|---|
| Prodotti (completi) | tutti i campi relativi ai prodotti, ideali come modello per creare un proprio Porter dedicato ai prodotti |
| Prodotti | le principali categorie di prodotti: testi, stato, categorie, disponibilità, peso, prezzi, imposte, prezzi speciali |
| Aggiornamento prezzi | ID prodotto, codice articolo, nome, stato, disponibilità, prezzi, imposte, prezzo speciale, prezzo di listino e prezzo base |
| Aggiornamento categorie, aggiornamento produttori, aggiornamento immagini | Testi delle categorie e dati SEO, dati del produttore, immagini dei prodotti con descrizione |
| Opzioni di prodotto (caratteristiche) | Caratteristiche e valori per ogni articolo con sovrapprezzo, codice articolo, EAN e disponibilità |
| Prezzi scalari (gruppi di clienti) | Prezzi e scaglioni per gruppo di clienti |
| Dati dei clienti | Clienti con indirizzi e gruppo clienti |
| Esportazione degli ordini Parte 1 e Parte 2, rispettivamente per «(n.)» e «(stato)» | Ordini in due file: dati dell’ordine e voci dell’ordine |
| «Desktop Enterprise …» | File di esportazione predisposti per il sistema di gestione delle scorte Desktop Enterprise |
| Scheda «Portali dei prezzi» | Esportazioni predisposte per il confronto dei prezzi, con indicazioni sul fornitore nella finestra di dialogo di esportazione |
«Prezzi», «Stock» e «Categorie» non sono sezioni a sé stanti, ma gruppi di campi della sezione «Prodotti». I porter standard «Aggiornamento prezzi» e «Aggiornamento categorie» mostrano come crearne di snelli per una determinata attività.
Creazione di un Porter
Il modo più veloce è duplicare un porter standard che si avvicini al proprio compito. In alternativa, è possibile creare un nuovo porter e selezionare autonomamente le colonne.
- Una volta individuato il porter adatto, selezionare «Duplica routine di esportazione» dal menu azioni. La copia si chiamerà, ad esempio, «Aggiornamento prezzi (Copia 1)» e non sarà protetta. Per creare un porter completamente nuovo, fare clic su «Crea nuovo porter».
- In «Impostazioni» assegnare un «Nome della routine xoPort» descrittivo, verificare la «Categoria» e il separatore, quindi salvare. Dopo aver cliccato su «Avanti», un nuovo Porter porta direttamente alle colonne.
- In «Modifica colonne» attivare solo i campi che si desidera effettivamente trasferire e salvare.
- Esportare il Porter una volta con «Esporta dati dal negozio». Il file mostra la struttura esatta e funge da modello per l’importazione.
- Attivare lo «Stato del Porter» solo quando è necessario il link di esportazione o importazione.
Le impostazioni di un proprio Porter; i filtri per categoria e produttore sono omessi nell’immagine. Cliccare per ingrandire.
Panoramica delle impostazioni
| Campo | Funzione |
|---|---|
| «Separatore di campi», «Separatore di testo» | Caratteri tra i campi (impostazione predefinita ;, tabulatore come \t) e attorno ai contenuti dei campi (impostazione predefinita "). Si applicano all’esportazione e all’importazione. |
| «Carattere di mascheramento diverso» | Lasciare vuoto. In un normale file CSV, il separatore di testo maschera se stesso. |
| «Formato di output» | csv, txt, xls, xlsx o ods. Per i formati Excel, il negozio genera un vero e proprio file di foglio di calcolo. |
| «Set di caratteri di output» | UTF-8 (impostazione predefinita) o ANSI. Vale solo per l’esportazione. Selezionare ANSI solo se il sistema di destinazione non supporta UTF-8. |
| «Quotazione CSV» | quando viene inserito il separatore di testo: «Standard PHP (fputcsv)» (impostazione predefinita), «Sempre (tutti i campi)» o «Minimo (solo con caratteri speciali)» |
| «Rubrica», «Raggruppamento» | quali dati sono riconosciuti dal Porter e in quale scheda della panoramica si trovano |
| «Filtro di esportazione», «Filtro per categoria», «Filtro per produttore», «Livello minimo di magazzino», «Esporta» | limitano l’esportazione, ad esempio a determinate categorie o articoli con disponibilità e prezzo. Non si applicano all’importazione. |
| «Nessun prodotto inattivo (esportazione)», prodotti singoli, master e slave | quali articoli sono inclusi nell’esportazione |
| «Copie dei prodotti (link)» | Esportazione: una riga per ogni categoria dell’articolo. Importazione: integrare le assegnazioni alle categorie anziché sostituirle (vedi Importazione). |
| «Campi aggiuntivi (colonne)» | Numero di campi prodotto aggiuntivi, ad esempio per i dati di un portale di prezzi |
| «Lingua del prodotto» | Lingua di tutti i campi dipendenti dalla lingua, come nome, descrizione e nome della categoria |
| «Esportazione rapida della categoria nella gestione prodotti» | visualizza Porter nella gestione prodotti accanto alla ricerca rapida. Esso esporta quindi la categoria attualmente visualizzata insieme alle sottocategorie. |
| «Importazione automatica directory» | Cartella per i file che il link di importazione legge (vedi «Automaticamente tramite link») |
Sezioni e campi
La rubrica determina anche dove viene salvato il file di esportazione. I dati relativi ai prodotti e ai marketplace sono destinati ai portali di prezzi e sono accessibili tramite un link pubblico. Tutte le altre rubriche si trovano nella directory protetta.
| Sezione | Contenuto | Link di esportazione |
|---|---|---|
| Prodotti | Dati anagrafici e testi, stato, categorie, produttori con indirizzo per la sicurezza dei prodotti (GPSR), fornitori, magazzino e spedizione, prezzi e imposte, prezzo base, prezzo speciale, prezzi scalari, immagini, video, titolo della pagina e parole chiave, valori bonus e gratuiti, campi aggiuntivi | aperto |
| Opzioni prodotto | Caratteristiche e valori per ogni articolo: nome o ID, sovrapprezzo, ordine, codice articolo, EAN, giacenza, immagine, peso, stato, preselezione | aperto |
| Prezzi per gruppi di clienti | Prezzi, scaglioni e prezzi speciali per gruppo di clienti, nonché prezzi personalizzati per cliente | protetto |
| Schede prodotto, modelli di schede prodotto, assegnazioni delle schede prodotto | Schede della pagina del prodotto con nome e contenuto per ciascuna lingua, modelli e relativa assegnazione alle categorie | protetto |
| Download/caricamenti, pagine CMS | File relativi agli articoli e contenuti delle pagine CMS | protetto |
| Dati dei clienti | Clienti, indirizzi, gruppi di clienti, impostazioni e dati relativi agli ordini per ciascun cliente | protetti |
| Abbonati alla newsletter | Abbonati alla newsletter del negozio online | protetti |
| Dati degli ordini (generali), dati degli ordini (prodotti) | Ordini con indirizzi, pagamenti e importi, nonché le relative voci; è possibile importare solo i numeri di tracciamento | protetti |
| Piattaforme di vendita, dati relativi alle piattaforme | Autorizzazione per ciascuna piattaforma, prezzo netto o lordo della piattaforma, prezzi dello shop, prezzo speciale e disponibilità | aperto |
| Pacchetti 4.10 | Pacchetti con i relativi componenti, quantità, selezione degli attributi e impostazioni | protetti |
Caratteristiche
Le caratteristiche, i valori e le varianti vengono gestiti tramite il Porter "Opzioni di prodotto (caratteristiche)". La guida Attributi di prodotto spiega come sono strutturate le caratteristiche e cosa offre l'API REST a questo proposito.
Solo nell’esportazione
Alcuni campi vengono calcolati dal negozio e vengono semplicemente visualizzati:
- «Prezzi scalari in un campo» con l’intera scala dei prezzi in una colonna (
1:0.89 50:0.79), ad esempio per i cataloghi di approvvigionamento - «Contenuto (quantità con unità)» come
0.5 lper le indicazioni di prezzo neifeed 4.9.135
Altre guide
Le colonne relative ai bonus e agli articoli gratuiti sono descritte nella sezione «Punti bonus e prodotti gratuiti», mentre i campi dell’etichetta di garanzia UE sono illustrati nella sezione «Etichetta di garanzia UE».
Colonne e opzioni
In «Modifica colonne», a sinistra è visualizzato il campo nel negozio, a destra la colonna nel file. Le frecce al centro indicano se un campo può essere importato, esportato o entrambi.
| Ambito | Funzione |
|---|---|
| Il pulsante davanti al campo | aggiunge il campo al Porter. «Attiva tutte le colonne» e «Rimuovi tutte le colonne attive» attivano o disattivano tutto in una volta. |
| «Opzioni di importazione» | convertono il valore durante l’importazione, ad esempio chg=,-->. per le virgole decimali |
| «Ordinamento» | Ordine delle colonne nell’esportazione |
| «Nome colonna» | Intestazione nel file. Durante l’importazione deve essere riportata esattamente così nell’intestazione, rispettando anche le maiuscole e le minuscole. |
| «Opzioni di esportazione» | convertono il valore durante l’esportazione. Il pulsante con l’icona «i» apre la «Guida alle opzioni di xoPort» con tutte le opzioni e gli esempi. |
Ogni sezione richiede campi chiave affinché il negozio possa associare le righe. Per i prodotti si tratta dell’«ID prodotto» o del «Codice articolo (Modello)», per i clienti dell’ID cliente, del numero cliente individuale o dell’indirizzo e-mail, per gli ordini del numero d’ordine. Se mancano, il negozio online non consente il salvataggio delle colonne. Le colonne con %u nel nome, come Categorie %u o Image %u, vengono numerate in ordine progressivo: Categorie 1, Categorie 2 e così via.
In «Modifica colonne» è possibile attivare i campi e assegnare i nomi delle colonne al file; per quanto riguarda le giacenze di magazzino, chg=,--> converte la virgola decimale durante l’importazione. Cliccare per ingrandire.
Le opzioni più importanti
| Opzione | Effetto | Esempio |
|---|---|---|
chg=alt-->neu | sostituisce il testo, più volte con il punto e virgola | chg=,-->. trasforma 2,99 nel valore 2.99 |
clc= | effettua operazioni aritmetiche: *, /, +, - | clc=/100 converte i centesimi in euro |
rnd= | arrotonda alle cifre decimali | rnd=2 |
set=, alt= | valore fisso per tutte le righe o valore sostitutivo per le celle vuote | alt=3-5 Werktage |
date=, datetime= | formato data del file | date=d.m.Y |
nohtml= | rimuove l'HTML durante l'esportazione, con 1, 2 o 3 per la gestione dei ritorni a capo | nohtml=2 |
path=abs, path=catch | Esportazione: URL completo dell'immagine. Importazione: carica l'immagine da un URL e la salva nel negozio – attualmente sempre nella cartella delle immagini dei prodotti, quindi da utilizzare solo per le immagini dei prodotti. | path=catch_if_not_exists carica solo le immagini mancanti |
skip | come opzione di importazione da sola: ignora la colonna durante l’importazione. Come opzione di esportazione con un valore: ometti le righe con questo valore. | skip= Omette le righe con campo vuoto |
filter= | Esportazione: conserva solo le righe con questo valore | filter=1 |
implode= | Testo di separazione per colonne raggruppate come percorso categoria o caratteristiche, impostazione predefinita « > » | implode= :: |
Separare più opzioni con il punto e virgola, ad esempio rnd=2;chg=.-->,.
Una cella vuota rimane vuota con clc e non interrompe più l’esportazione. 4.9.85
Preparazione del file
La maggior parte degli errori di importazione deriva dal file: separatore errato, intestazione di colonna rinominata o numeri che il foglio di calcolo ha trasformato.
Riga di intestazione e separatore
La prima riga contiene i nomi delle colonne del file. I separatori di campo e di testo del file devono corrispondere alle impostazioni. Se il separatore di campo compare all’interno di un testo, ad esempio un punto e virgola nella descrizione, il testo deve essere racchiuso tra separatori di testo. In caso contrario, il numero di valori non corrisponderà alla riga di intestazione e lo shop salterà quella riga.
Set di caratteri
Salvate i file CSV in UTF-8, in Excel con «CSV UTF-8 (separato da delimitatori)».
Il negozio riconosce automaticamente i file provenienti da programmi Windows con set di caratteri dell’Europa occidentale o centrale. Se in questo processo vengono persi dei caratteri, la valutazione dell’importazione lo segnala.ab 4.9.26
File Excel
Il Porter importa direttamente i file XLS, XLSX e ODS. Legge il foglio di lavoro che era attivo al momento del salvataggio, comprese le formule con i relativi risultati. Per l’elaborazione in Excel, è consigliabile esportare in formato XLSX: i codici articolo, gli EAN e i codici postali risulteranno così come testo nel file senza perdere gli zeri iniziali, mentre i prezzi e le quantità saranno riportati come numeri reali.
Numeri, date, immagini
L’importazione legge prezzi e pesi con virgola o punto decimale; le colonne numeriche appena attivate riportano inoltre il formato chg=,-->.. Non sono ammessi separatori delle migliaia; le quantità devono essere numeri interi. I dati vanno inseriti nel formato specificato dall’opzione della colonna, solitamente 10.09.2026. Le immagini vanno specificate come nomi di file relativi alla cartella delle immagini, oppure, con path=catch, anche come URL a un file JPG, PNG, GIF o WebP.
Esportazione dei dati
L’esportazione copia i dati dal negozio in un file. Nel negozio non cambia nulla.
- Nel menu delle azioni, selezionare «Esporta dati dal negozio ». Si aprirà la scheda «Esportazione dati».
- Scegliere la posizione di salvataggio: «Server (conserva il file di esportazione sul server)» o «Locale (elimina il file di esportazione dopo il download)».
- Filtrare in base alla sezione: per i prodotti in base a categorie e produttori, per i clienti in base alle «Modifiche da» una data, per gli ordini in base a una data o a un intervallo di numeri d’ordine. Per prodotti, caratteristiche e prezzi per gruppi di clienti, selezionare inoltre la «Lingua del carrello».
- Fare clicsu «Avvia esportazione ». Al termine, il negozio visualizzerà il messaggio «… righe di dati più riga di intestazione salvate» e avvierà il download.
Durante l’esportazione, selezionare la posizione di salvataggio e restringere la selezione dei prodotti per categoria e produttore. Cliccare per ingrandire.
Con «Server», il file rimane su xoport_<ID>.<Format>; per le sezioni relative a prodotti e marketplace, nella cartella pubblica xoport/; per tutte le altre, in xoport/secure/. Il percorso esatto è indicato in «Info e link». Selezionando «Locale», il negozio elimina il file dopo il download; se Porter è disattivato, ciò avviene sempre. Per esportazioni una tantum che non devono essere accessibili dall’esterno, «Locale» è la scelta migliore.
Importazione dei dati
L’importazione inserisce immediatamente ogni riga valida nel negozio. Esportate prima le stesse colonne come copia di sicurezza e testate i nuovi Porter con poche righe.
- Nel menu delle azioni, selezionare «Importa dati nel negozio ». Si aprirà la scheda «Importazione dati».
- Selezionare la fonte: «Caricamento file dal proprio computer (csv, txt, xls, xlsx o ods)», un «file esistente sul server» o i file nella directory di importazione automatica.
- Verificare la «lingua del Porter» per prodotti, caratteristiche e prezzi per gruppi di clienti.
- Fare clic su«Avvia importazione» e attendere che la barra di avanzamento indichi l’avvio dell’elaborazione. Non interrompere l’importazione.
L’importazione legge un file caricato, il file di esportazione sul server o i file presenti nella directory di importazione automatica. Cliccare per ingrandire.
Trovare e creare un nuovo articolo
Il negozio cerca un articolo prima tramite l’«ID prodotto», poi tramite il «codice articolo (modello)». Crea un nuovo articolo solo se la riga contiene un numero articolo e un nome e se la lingua del file di importazione è la lingua predefinita del negozio. Un file di importazione privo della colonna «Nome» si limita ad aggiornare i dati, saltando gli articoli sconosciuti.
Cosa modifica una riga
Vengono scritte solo le colonne presenti nel file e attivate nel Porter. Una cella vuota in una di queste colonne svuota il campo. I campi che devono rimanere invariati vanno rimossi dal file e dal Porter.
Un’importazione parziale, ad esempio solo le giacenze dichiarate per magazzino, non svuota più i campi di magazzino che il Porter non gestisce affatto.ab 4.9.94
Assegnazione delle categorie
Le categorie vanno specificate come nomi in Categorie 1, Categorie 2 … oppure come «ID categoria»; Altre categorie vanno inserite separate da virgole in «Altri ID categoria». Se l’opzione «Copie prodotto (link)» è disattivata, la riga sostituisce tutte le precedenti assegnazioni dell’articolo. Se è attivata, le categorie vengono aggiunte. Dopo un’importazione nel backend, il negozio inserisce gli articoli privi di categoria nella categoria disattivata «xoport_unsorted».
Prezzi e imposte
Si consiglia di importare il prezzo netto. Se nel file è presente solo il prezzo lordo, il negozio ricalcola l’importo utilizzando l’aliquota fiscale della riga o, per gli articoli già presenti, la relativa classe fiscale. Se l’aliquota fiscale o la classe fiscale con relativa aliquota sono sconosciute, il negozio le crea come nuova classe fiscale. Se nella riga è presente solo un nome sconosciuto della classe fiscale, l’articolo rimane senza classe fiscale. Verificate quindi in anticipo l’ortografia.
Altre lingue
Per le traduzioni, creare un Porter dedicato con la lingua di destinazione come lingua del Porter, contenente solo i campi dipendenti dalla lingua e gli ID. Il negozio assegna le categorie e i produttori in un’altra lingua solo tramite il loro ID; in caso contrario, li crea due volte.
Caratteristiche
La colonna «options sort order» definisce l’ordine dei valori. Se è vuota, i valori esistenti mantengono l’ordine presente nel negozio,mentre i nuovi valori vengono aggiunti alla fine. 4.9.106
Eliminazione tramite importazione
Eliminare determinati valori nella colonna dello stato invece di modificarli. Controllare con particolare attenzione tali file.
| Valore e colonna | Effetto |
|---|---|
del in «Stato del prodotto» | elimina l’articolo, i file immagine rimangono |
del+ in «Stato del prodotto» | elimina l'articolo e i relativi file immagine, a meno che non siano utilizzati da altri articoli |
delmodel in «Stato del prodotto» | elimina tutti gli articoli con questo codice articolo; la colonna «Codice articolo» è obbligatoria a tal fine |
delopt in «Stato del prodotto» | rimuove tutte le caratteristiche dall’articolo. Ulteriori modifiche all’articolo devono essere inserite in una seconda riga con stato 0 o 1. |
del nello stato o nella preselezione di una caratteristica | rimuove questo valore di caratteristica dall’articolo |
del nello stato della categoria | elimina la categoria insieme a tutte le sottocategorie |
del nel prezzo per gruppo di clienti o per cliente | elimina questo prezzo |
Leggere il resoconto dell’importazione
Dopo l’importazione, il negozio mostra il messaggio «Importazione completata» con il numero di righe lette, una tabella con le voci «Aggiornato», «Nuovo» e «Eliminato» per ogni tipo di dato e, sopra, i messaggi.
Rosso e giallo
I messaggi in rosso indicano errori: le righe non sono state elaborate. I messaggi in giallo indicano righe saltate intenzionalmente, ad esempio articoli provenienti dal sistema di gestione delle scorte che non esistono nel negozio.
Righe interessate
Il pulsante accanto a un messaggio mostra le righe interessate in una tabella con il numero di riga e i valori del file. Il numero di riga conta la riga di intestazione come riga 1, come in Excel. Vengono visualizzate al massimo 1.000 righe. 4.9.106
Report CSV
«Errori e avvisi come CSV» carica tutte le righe rifiutate di un'esecuzione in un file, con tipo, messaggio e le colonne del file di importazione. Corregga le righe in quel file e importi nuovamente solo quelle.ab 4.9.106
Un confronto delle scorte con sei righe: tre articoli aggiornati, due codici articolo sconosciuti saltati, una riga rifiutata perché conteneva troppi valori. Clicca per ingrandire.
Messaggi frequenti
| Messaggio | Significato e soluzione |
|---|---|
| «Il numero di valori non corrisponde all’intestazione …» | La riga contiene un numero di campi maggiore o minore rispetto all’intestazione; solitamente si tratta di un separatore di campi presente in un testo privo di separatori di testo. |
| «L’articolo non è presente nel negozio…» (giallo) | Il Porter non dispone di una colonna «Nome» e pertanto non crea articoli. Ciò è intenzionale in caso di allineamento delle scorte e dei prezzi.ab 4.9.106 |
| «Gli articoli da creare devono avere un nome!» | La colonna del nome è presente, ma la cella è vuota. |
| «ID articolo o numero articolo non trovato!» | L’articolo è sconosciuto e non è stato possibile crearlo, solitamente perché la lingua del Porter non è quella standard. |
| «… Caratteri … scartati …» | Il file conteneva caratteri non presenti nel set di caratteri riconosciuto. Salvare il file in formato UTF-8 e importarlo nuovamente. |
| «Data non valida …» | La data non corrisponde all’opzione « date= » o « datetime= ». Il negozio online imposta quindi la data corrente. |
| «… Gruppo/i clienti non importato/i …» | Importazione di clienti con un gruppo che non esiste nel negozio. I clienti esistenti mantengono il proprio gruppo, mentre a quelli nuovi viene assegnato il gruppo 0.ab 4.9.139 |
| «Il file di importazione contiene probabilmente dati errati o non presenta una riga di intestazione corrispondente…» | Nessuna colonna del file corrisponde a un nome di colonna del Porter. Controllare i separatori e le intestazioni delle colonne. |
Proteggere i campi dalla sovrascrittura
Se un file proviene regolarmente dal sistema di gestione delle scorte, alcuni campi nel negozio dovrebbero comunque mantenere i propri dati, ad esempio le descrizioni aggiornate.
Porter snello
La protezione più sicura: il Porter contiene solo le colonne che il sistema di gestione delle merci deve fornire, ad esempio codice articolo, disponibilità e prezzo. Tutto il resto rimane invariato.
Ignora colonna
Se il file contiene una colonna che non deve essere importata, inserite “ skip ” in “Opzioni di importazione” per quella colonna. L’importazione la ignorerà.
Blocchi di importazione a livello di articolo
Nella scheda «Interfaccia dati» dell’articolo è possibile bloccare singole sezioni. Il CSV-Porter tiene conto delle opzioni «Aggiorna nome» e «Aggiorna descrizione». I restanti blocchi, come prezzo o giacenza, si applicano all’importazione XML dal sistema di gestione delle merci.
La scheda con i blocchi di importazione appare nell’articolo solo se è attiva un’interfaccia di gestione delle scorte. Essa riporta il nome di quest’ultima, ad esempio «Interfaccia dati xoPort (XML)».
Nell’importazione dei clienti, il negozio modifica il gruppo clienti solo se il file indica un gruppo già presente nel negozio. Un file semplificato senza colonna del gruppo lascia invariato il gruppo.ab 4.9.139
Automaticamente tramite link e cron
Ogni Porter dispone di un link di esportazione e, con la directory di importazione automatica, di un link di importazione. Entrambi si trovano nella sezione «Info e link». Se il portale dei prezzi, il sistema di gestione delle merci o un cronjob richiamano il link, il Porter viene eseguito senza necessità di effettuare il login nel backend.
Link di esportazione
Il link https://ihr-shop.example/xoport.php?id=<ID> genera un file aggiornato ad ogni accesso e lo fornisce. Questo link va inserito nel portale dei prezzi o nel sistema di gestione delle merci. Le rubriche protette utilizzano xoport/secure/xoport.php?id=<ID>. Il Porter deve essere attivo, altrimenti il link risponde con «Porter is not active!».
Link di importazione
- Nelle impostazioni, alla voce «Directory di importazione automatica», creare una directory utilizzando l’icona «+» e salvare.
- Il sistema di gestione delle merci salva i propri file tramite FTP o SFTP in
xoport/import/<Verzeichnis>/. - Il link
&action=importlegge tutti i file CSV, TXT, XLS, XLSX e ODS presenti nella directory. I file importati con successo vengono spostati nella sottocartellaarchiv/, mentre quelli con errori rimangono nella directory originale.
«Info e link» mostra il file di esportazione salvato, il link di esportazione e, se è presente una cartella di importazione automatica, il link di importazione. Cliccare per ingrandire.
Il negozio non dispone di un proprio sistema di temporizzazione per Porter. Per esecuzioni regolari, create presso il vostro hoster un’attività programmata (cronjob) che richiami il link. Il link di importazione risponde con STATUS=ok&Files=… o STATUS=error&Files=…. Se è già in corso un’importazione dello stesso Porter, segnala «Import already running» e non ne avvia una seconda.
Proteggere le esportazioni
La possibilità di accedere a un’esportazione senza effettuare il login dipende dalla categoria e dallo stato del Porter.
Categorie aperte
Prodotti, opzioni di prodotto, marketplace e dati dei marketplace sono destinati ai portali di prezzi. Il link di esportazione e un file salvato con il nome «Server» nella cartella xoport/ sono accessibili senza password fintanto che il Porter è attivo. Disattivate i Porter che non sono necessari dall’esterno e non inserite campi riservati, come il prezzo di acquisto, in un Porter aperto.
Sezioni protette
I dati relativi a clienti, ordini e tutto il resto si trovano in xoport/secure/. I file ivi archiviati sono bloccati via web; è accessibile solo il link di esportazione.ab 4.9.25
Proteggete il link con nome utente e password in Impostazioni → Generale → Impostazioni di base → Proteggi directory clienti e ordini xoPort e, se possibile, con indirizzi IP fissi in Impostazioni → Generale → Impostazioni di base → Filtro IP directory clienti e ordini xoPort.
Se sono impostati sia la password che il filtro IP, l’accesso è consentito solo con una password valida o da un indirizzo IP autorizzato. Nel filtro IP è possibile inserire più indirizzi e intervalli, come ad esempio 203.0.113.0/24, separati da virgole. Se manca la password, la finestra di dialogo di esportazione mostra un avviso in rosso.
Esportazione di ordini e clienti
Porter esporta gli ordini in due file: dati dell’ordine e voci dell’ordine. Esporta i clienti con indirizzi e indicatori per le analisi.
Due Porter per un ordine
Un Porter della sezione «Dati dell’ordine (generali)» fornisce una riga per ogni ordine con cliente, indirizzo di fatturazione e di consegna, pagamento, spedizione e totali. Un Porter della sezione «Dati dell’ordine (prodotti)» fornisce una riga per ogni posizione. Entrambi sono collegati dal numero d’ordine. Se «Selezione esportazione» = «Numero d’ordine», collegate il Porter delle voci in «Porter ‘Dati ordine generali’ associato». In questo modo, non esporterà mai più ordini rispetto al primo.
Selezione esportazione
- Numero d’ordine: a partire da un numero, come intervallo (ad es.
100-150) o con-100sempre gli ultimi 100. Dopo un’esportazione, il negozio imposta il numero iniziale sull’ordine successivo, tranne in caso di valori negativi. - Stato: tutti gli ordini con lo «Stato prima dell’esportazione». Successivamente, il negozio imposta il «Nuovo stato dopo l’esportazione», senza avvisare il cliente.
- sempre completo: tutti gli ordini, ad esempio in caso di cambio di negozio.
- Periodo: ordini degli ultimi giorni, impostazione predefinita 30.
Esportazione ripetuta e tracciamento
È possibile esportare nuovamente un ordine reimpostando il numero iniziale nelle impostazioni o riportando l’ordine allo «Stato prima dell’esportazione». Le sezioni una tantum vanno specificate nella finestra di dialogo di esportazione alla voce «Esporta solo ordini con numero/i d’ordine»; il numero iniziale salvato rimane quindi invariato. Gli ordini stessi non possono essere importati. Tuttavia, un importatore che accetta solo «numero d’ordine» o «numero di transazione» e «numero di tracciamento» acquisisce i numeri di spedizione, separati da punti e virgola.
Dati cliente
Il Porter «Dati cliente» esporta gli account dei clienti con indirizzi e gruppo cliente. Alla voce «Dettagli ordini del cliente» sono disponibili «Numero di ordini», «Valore netto degli ordini», «Valore totale degli ordini» e «Data dell’ultimo ordine», ad esempio per una segmentazione. Gli acquirenti ospiti non dispongono di un account cliente e non sono inclusi in questa esportazione. I loro dati sono disponibili nei dati dell’ordine.
Per le analisi del fatturato e le fatture sono disponibili procedure specifiche: Report → Esportazione fatturato in CSV fornisce una riga per ogni ordine con importo netto, lordo e IVA; le fatture possono essere stampate in blocco dalla panoramica degli ordini. Maggiori informazioni nella guida Modifica ordini.
Errori tipici e relative soluzioni
Se un’importazione non funziona come dovrebbe, la causa è quasi sempre una di queste. Verificale una per una.
| Osservazione | Causa | Soluzione |
|---|---|---|
| Non viene elaborato nulla, messaggio di errore in rosso relativo alla riga di intestazione | Il separatore di campi del file non è corretto; l’intestazione viene letta come un’unica colonna | Allineare il separatore nel file e nelle impostazioni |
| Una colonna viene ignorata senza alcun avviso | L'intestazione della colonna differisce dal «nome della colonna», anche solo per maiuscole e minuscole | Modificare l’intestazione del file o il nome della colonna. Attenzione: in seguito la colonna verrà interpretata, ad esempio come uno stato. |
| I nuovi articoli non vengono creati | manca la colonna del nome, il nome è vuoto oppure la lingua di Porter non è quella predefinita | Inserire una colonna «Nome», impostare la lingua di Porter come lingua predefinita |
| Prezzi errati o pari a 0 | Punti separatori delle migliaia, prezzo lordo senza indicazione dell’imposta o virgola decimale senza l’opzione di importazione chg=,-->. | Numeri senza separatore delle migliaia; verificare l’opzione di importazione, importare il valore netto o specificare l’aliquota fiscale |
| Articoli senza imposta | nel file è presente solo il nome di una classe fiscale che il negozio online non riconosce | Scrivere i nomi esattamente come nel negozio oppure specificare l’aliquota fiscale |
| Campi improvvisamente vuoti | Celle vuote in una colonna attivata | Eliminare la colonna dal file e da Porter oppure inserire i valori |
| Gli articoli perdono le categorie | "Copie dei prodotti (link)" è disattivato, il file indica solo una categoria per ogni articolo | Attivare «Copie dei prodotti (link)» o specificare tutte le categorie |
| Umlauti o caratteri speciali errati | Il file è salvato con un altro set di caratteri | Salvare in formato UTF-8, Excel: «CSV UTF-8» |
| Mancano gli zeri iniziali nell’EAN o nel codice articolo | Excel ha aperto e salvato il file CSV come numero | esportare in formato XLSX e modificare oppure importare la colonna in Excel come testo |
| Categorie o produttori duplicati | Importazione in un’altra lingua senza ID | Fornire l’ID della categoria o l’ID del produttore |
| Molte nuove classi fiscali | La classe fiscale nel file è scritta in modo diverso rispetto a quella nel negozio | Uniformare la grafia, eliminare le classi in eccesso |
| Il link di esportazione risponde "Porter non è attivo!" | Lo stato di Porter è disattivato | Attivare lo stato di Porter |
XML, REST-API e sistema di gestione delle scorte
CSV-Porter è pensato per i file che modificate voi stessi o che un sistema salva regolarmente. Per la sincronizzazione continua con un sistema di gestione delle merci sono disponibili delle interfacce.
API REST
L’interfaccia JSON/REST di xoPort legge e scrive prodotti, categorie, clienti, ordini e altro ancora. I dati di accesso si configurano in Strumenti → Client OAuth2 di xoPort. Gli endpoint, i campi e la procedura di autenticazione sono descritti nella documentazione dell’API.
Interfaccia XML
Le integrazioni più datate con i sistemi di gestione delle scorte utilizzano l’interfaccia XML di xoPort. Anche i relativi campi sono riportati nella documentazione dell’API.
La sua disponibilità è gestita in Impostazioni → Interfacce → Sistemi di gestione delle merci/ERP/Contabilità → Interfaccia dati xoPort → xoPort: vecchia interfaccia XML utilizzabile. I nuovi negozi partono con l’interfaccia XML disattivata,mentre quelli esistenti la mantengono attiva. 4.9.78
Gestione delle scorte e contabilità
Per JTL-Wawi, Billbee, OpenXE, DATEV e Lexware Office sono disponibili integrazioni dedicate. Saremo lieti di discutere con voi quale sia la soluzione più adatta alla vostra attività.
Lista di controllo prima della prima importazione
- Porta personalizzata come copia di una porta standard, con solo le colonne necessarie.
- Backup: le stesse colonne esportate e conservate in precedenza.
- File con la stessa intestazione, lo stesso separatore di campi e di testo e in formato UTF-8 o XLSX.
- Colonna chiave presente: ID prodotto o codice articolo; per i clienti, ID cliente o indirizzo e-mail.
- Lingua del file di importazione verificata; per i nuovi articoli, la lingua predefinita.
- Opzione “Copie dei prodotti (link)” selezionata intenzionalmente, se nel file sono presenti categorie.
- Nessuna cella vuota nelle colonne i cui valori devono essere mantenuti.
- Eseguire un test con poche righe, leggere la valutazione dell’importazione e verificare il risultato nel negozio.
- Stato “Porter” attivato solo se è necessario un link esterno.
Domande frequenti
Perché l’importazione non crea nuovi articoli dal file?
Perché l’importazione CSV non elabora i record?
Perché l’importazione dei prezzi fallisce e come posso controllare il file?
chg=,-->. » e se state fornendo prezzi netti o lordi. Il negozio ricalcola i prezzi lordi in base all’aliquota fiscale della riga o alla classe fiscale dell’articolo. L’analisi dell’importazione e il report CSV indicano ogni riga rifiutata con la relativa motivazione.Come posso assegnare categorie aggiuntive agli articoli senza perdere quelle esistenti?
Posso modificare l’ordinamento delle caratteristiche tramite importazione?
Come faccio a rimuovere le caratteristiche tramite importazione CSV?
del, inserisca "0" nella colonna "Stato". Per rimuovere tutte le caratteristiche di un articolo, inserisc delopt nella colonna "Stato" di un Porter del prodotto. Utilizzi una riga separata per questa operazione e inserisca eventuali ulteriori modifiche in una seconda riga con stato 0 o 1.Quale campo controlla la vendita di un articolo?
products eol. Tali articoli non possono essere venduti oltre le quantità presenti in magazzino.Come si importano i meta-testi o i testi delle categorie?
I dati rimangono nel negozio durante l’esportazione?
del.Dove trovo il file esportato sul server?
xoport/xoport_<ID>.<Format> oppure, per i dati relativi a clienti e ordini, in xoport/secure/. Il percorso esatto e la data dell’ultimo file sono indicati in “Info e link”. I feed per Google Merchant Center generano un percorso dedicato, vedi Google Merchant Center e feed di prodotto.Posso proteggere con una password le esportazioni di Porter?
Come posso esportare gli ordini in un intervallo di numeri o esportarli nuovamente?
100-150. Per un’esportazione ripetuta, reimpostare il numero iniziale oppure, in caso di esportazione in base allo stato, riportare l’ordine allo «Stato precedente all’esportazione».Posso importare gli ordini nel negozio tramite CSV-Porter?
Come si esportano i dati dei clienti, compresi quelli degli ordini degli ospiti?
Come faccio a escludere dall’esportazione le righe con campi vuoti?
skip= senza alcun valore. Ad esempio, con skip=0 si omettono le righe con valore 0. Alla voce “Opzioni di importazione”, invece, skip significa semplicemente che l’importazione ignora l’intera colonna.Quali formati immagine vengono caricati durante l’importazione da un URL?
path=catch o path=catch_if_not_exists, Porter carica immagini con le estensioni JPG, JPEG, PNG, GIF e WebP da un URL e le salva nel negozio. Senza questa opzione, si aspetta il nome del file di un’immagine già presente nella cartella delle immagini.Come posso aggiornare le informazioni del produttore relative alla sicurezza del prodotto tramite importazione?
DE. Il negozio individua il produttore tramite l’«ID produttore» o il «nome del produttore».Quale endpoint e quali credenziali devo utilizzare per un’importazione tramite interfaccia?
Guide approfondite
Configuriamo insieme a voi lo scambio di dati
Vi aiutiamo a scegliere il Porter più adatto, a configurare la mappatura delle colonne per il vostro sistema di gestione delle scorte e a effettuare la prima importazione.
Contatta subito l’assistenza
