Interfacce e gestione delle scorte

Non incluso in questa guida: file CSV ed Excel con Porter (Guida all'importazione e all'esportazione (CSV)), i marketplace (guide sull’integrazione con eBay e Kaufland), il feed prodotti per Google (guida a Google Merchant Center e feed prodotti) e i corrieri come DHL o GLS (guida a spedizioni e consegne).

Le integrazioni con i sistemi di gestione delle scorte e di contabilità sono raggruppate in Impostazioni → Interfacce → Gestione delle scorte/ERP/Contabilità. Cliccare per ingrandire.

Il modulo aggiuntivo per l’interfaccia datiXONIC Premium: xoPort Datenschnittstelle

L'API REST, l'interfaccia XML, il connettore JTL, Billbee (Sync) e l'integrazione con Tricoma funzionano solo se l'interfaccia dati è abilitata. In assenza di tale abilitazione, l'API REST restituisce l'errore « LICENSE_REQUIRED » e la sezione Strumenti → Clienti OAuth2 xoPort mostra un avviso in rosso.

Il negozio sincronizza le proprie licenze con il server delle licenze di XONIC. Se ciò non avviene per 30 giorni, disattiva l’interfaccia dati e segnala «è stata disattivata poiché da 30 giorni non è stato possibile stabilire una connessione con il server di autenticazione». In tal caso, contattateci.

Creare un accesso

1. Aprire Strumenti → Client OAuth2 di xoPort e fare clic su «Crea nuovo client».
2. Inserire un «Nome client», ad esempio il nome del programma o del fornitore di servizi.
3. Nella sezione «Autorizzazioni», selezionare «Lettura», «Scrittura» o «Cancellazione» per ciascuna area. È obbligatorio selezionare almeno un’autorizzazione.
4. Opzionale: «Limite di frequenza (richieste/ora)» e «Note», ad esempio chi utilizza l’accesso.
5. Creare il client cliccando su «Crea nuovo client». Il negozio mostra «ID client» e «Segreto client». Il segreto appare solo questa volta: copiatelo immediatamente nel programma che deve effettuare l’accesso.

Un accesso per uno strumento di analisi dei prezzi richiede solo «Prodotti: Lettura»; tutte le altre sezioni rimangono bloccate. Cliccare per ingrandire.

Scegliere le autorizzazioni appropriate

Le autorizzazioni sono organizzate per aree, ad esempio Prodotti, Categorie, Clienti, Ordini, Produttori, Fornitori, Media, Notizie, FAQ, Pagine CMS, Contratti, Ticket e Newsletter. È possibile modificarle in un secondo momento tramite «Modifica autorizzazioni» nel menu delle azioni dell’accesso.

Una modifica ha effetto a partire dal token successivo. Un token contiene le autorizzazioni valide al momento della sua emissione. Un’area appena sbloccata è quindi disponibile per il programma solo quando questo richiede un nuovo token, al più tardi dopo un’ora. Un’area revocata rimane accessibile per un token già emesso fino alla sua scadenza. Se si desidera che l’accesso cessi immediatamente, selezionare successivamente «Revoca token», vedere Revoca immediata delle autorizzazioni.

Un'autorizzazione per la sincronizzazione degli articoli consente di leggere e scrivere prodotti, categorie e produttori, ma non di cancellare nulla né di visualizzare i dati dei clienti. Cliccare per ingrandire.

Assegnate l’azione «Elimina» solo se un programma deve effettivamente rimuovere dei record.

Indirizzo e registrazione

Il programma ottiene un token di accesso utilizzando l’ID cliente e il segreto cliente. Il token è valido per un’ora, dopodiché il programma ne richiede uno nuovo. L’indirizzo del token del vostro negozio è riportato nel riquadro informativo in Strumenti → Client xoPort OAuth2.

curl -X POST https://ihr-shop.example/xpanel/xoport/oauth/token \
  -d "grant_type=client_credentials" \
  -d "client_id=<CLIENT_ID>" \
  -d "client_secret=<CLIENT_SECRET>"

curl -H "Authorization: Bearer <TOKEN>" \
  https://ihr-shop.example/xpanel/xoport/export/json/products?limit=250&offset=0

Ogni indirizzo è composto da /xpanel/xoport/, l'attività (export, import o delete), il formato json e l'area. Se il formato è diverso, l'API risponde con "Unknown route". L'eliminazione è possibile solo con il metodo DELETE.

Recuperare tutto pagina per pagina: con ?limit= (impostazione predefinita 50, massimo 250) e ?offset= è possibile scorrere archivi di grandi dimensioni. La risposta riporta il numero totale all’indirizzo stats e, con has_more, indica se seguono altre pagine.

Limiti

• Limite di richieste: ogni account può effettuare, per impostazione predefinita, 5.000 richieste all’ora; vengono conteggiate le richieste degli ultimi 60 minuti. Nel campo «Rate Limit (richieste/ora)» alla voce «Modifica client» è possibile inserire un valore inferiore, che avrà effetto immediato, anche per i token attivi. Solo XONIC può inserire un valore superiore a 5.000, previa verifica. Chi supera il limite riceve un messaggio di errore « 429 » con il codice « RATE_LIMIT_EXCEEDED »; l’indicazione « Retry-After » nella risposta specifica il tempo di attesa in secondi. 4.9.17
  Se XONIC ha impostato un limite illimitato di richieste per un account, tale impostazione rimane invariata in caso di aggiornamenti e controlli HealthCheck; le versioni precedenti lo reimpostano a 5.000.ab 4.9.168 In “Modifica client”, il campo relativo a tale accesso è vuoto, con l’indicazione “Illimitato (impostato da XONIC)”. Se si salva con il campo vuoto, l’accesso rimane illimitato anche se si modificano il nome o le note; un valore fino a 5.000 lo limita, mentre solo XONIC può riportarlo a illimitato.da 4.9.174 Fino alla versione 4.9.173, la maschera mostrava 5.000 per una voce di questo tipo e ogni salvataggio impostava il limite a 5.000, anche se si erano modificati solo il nome o le note. A questi livelli, quindi, XONIC applica le modifiche a questa voce.
• Record per importazione: al massimo il numero consentito in Impostazioni → Interfacce → Gestione merci/ERP/Contabilità → Interfaccia dati xoPort → xoPort API: Limite importazione in blocco, impostato di fabbrica a 50.
• La creazione e la modifica sono separate: POST crea solo nuovi record e, in presenza di un codice articolo esistente, segnala «already exists. Use PUT to update.» PUT modifica solo i dati esistenti.

È possibile modificare il limite di richieste per un'entrata alla voce «Modifica client»; la maschera non accetta valori superiori a 5.000. Cliccare per ingrandire.

In Impostazioni → Interfacce → Gestione merci/ERP/Contabilità → Interfaccia dati xoPort → xoPort: abilita impostazioni per l’interfaccia, è possibile abilitare le singole impostazioni del negozio per l’API. In assenza di inserimenti, l’API non ne rileva alcuno. I dati di accesso, le impostazioni relative alla licenza e alla registrazione rimangono sempre bloccati.ab 4.9.54

«Visualizza utilizzo» elenca ogni richiesta di un accesso; il codice 403 indica un accesso al di fuori delle aree autorizzate. Cliccare per ingrandire.

Non figurano nel log le richieste che il negozio respinge a causa del limite di richieste (429) e gli accessi che vengono rifiutati già prima della richiesta con codice 400, ad esempio a causa di un valore di filtro non valido o di un’indicazione di pagina errata. Tuttavia, questi codici 400 vengono comunque conteggiati ai fini del limite di richieste. Se si sta cercando un errore di questo tipo, chiedere al programma di mostrare la risposta dell’interfaccia.

Revoca immediata delle autorizzazioni: revoca dei token

Un programma effettua l’accesso con l’ID cliente e il segreto cliente e riceve in cambio un token valido per un’ora. Se si modificano le autorizzazioni di un accesso, un token già emesso mantiene quelle precedenti fino alla sua scadenza. Ecco come revocare immediatamente un’autorizzazione:

1. In «Modifica autorizzazioni», bloccare l’area e salvare.
2. Nel menu delle azioni dell’accesso (freccia accanto a «Modifica client») selezionate «Revoca token» e confermate. Tutti i token attivi di questo accesso diventano immediatamente non validi,mentre l’ID client e il segreto rimangonoinvariati. 4.9.168
3. Al prossimo accesso, il programma recupererà automaticamente un nuovo token, ora con le autorizzazioni modificate. Non è necessario apportare alcuna modifica al programma.

«Revoca token» interrompe le sessioni attive di un accesso senza che sia necessario distribuire un nuovo segreto. Clicca per ingrandire.

• La voce è visibile ai collaboratori autorizzati a cancellare su questa pagina e solo per gli accessi attivi. Lo stesso diritto è richiesto per «Disattiva».
• Se la voce non è presente perché il vostro negozio è precedente alla versione 4.9.168, selezionate «Disattiva» e subito dopo «Attiva». Anche questa operazione revoca tutti i token, mentre il segreto rimane invariato.
• Anche «Rinnova secret» revoca i token, ma in tal caso il programma richiede il nuovo secret. Utilizzatelo se il secret potrebbe essere finito nelle mani sbagliate.

Limitare l’accesso a indirizzi IP fissi

In Impostazioni → Interfacce → Gestione merci/ERP/Contabilità → Interfaccia dati xoPort → API xoPort: Limitazione IP (JSON/REST) inserite gli indirizzi da cui provengono i vostri programmi. A quel punto, ogni richiesta dovrà contenere entrambi: uno di questi indirizzi e un token valido. Se lasciato vuoto, l’API REST rimane aperta per qualsiasi accesso con un token valido.ab 4.9.83

• Solo singoli indirizzi, separati da virgola se più di uno. Un intervallo come 203.0.113.0/24 non è mai valido in questo contesto e blocca tutti i programmi.
• Se il negozio si trova dietro un proxy o Cloudflare, vale l’indirizzo che il negozio vede. Se rifiuta un accesso, la risposta IP_NOT_ALLOWED riporta questo indirizzo e la dashboard segnala «xoPort REST: connessione bloccata».
• L’elenco dell’interfaccia XML («xoPort: filtro IP») non autorizza l’accesso all’API REST. L’API REST richiede sempre un token.ab 4.9.83

Inserite solo indirizzi fissi. Se un indirizzo cambia, rimuovete immediatamente quello vecchio dall’elenco: il provider lo riassegna e, in caso contrario, il suo prossimo titolare potrebbe accedervi.

Attivazione e accesso

Le impostazioni di questa sezione si trovano in Impostazioni → Interfacce → Sistemi di gestione delle scorte/ERP/Contabilità → Interfaccia dati xoPort.

• Impostazioni → Interfacce → Sistemi di gestione merci/ERP/Contabilità → Interfaccia dati xoPort → xoPort: vecchia interfaccia XML utilizzabile abilita gli indirizzi disponibili su /xpanel/xoport/. I nuovi negozi iniziano con false, mentre quelli esistenti mantengono true. Su false gli indirizzi rispondono a ogni richiesta con un codice 403, compresi quelli dell’integrazione Tricoma.ab 4.9.78
• Prova: il sistema di gestione delle merci aggiunge la chiave da «xoPort: AppKey-Filter» all’indirizzo come ?key=, oppure effettua la chiamata da un indirizzo tramite «xoPort: IP-Filter». Se il vostro indirizzo Internet cambia, la chiave rappresenta la soluzione più affidabile. Accedete agli indirizzi solo tramite https://.
• Non svuotare il «xoPort: AppKey-Filter» finché è in corso l’esportazione degli ordini in formato XML: l’esportazione accede all’interfaccia del proprio negozio utilizzando questa chiave.
• Il messaggio «xoPort API: autenticazione richiesta» rimane su true. Su false l’interfaccia XML risponde a ogni richiesta senza verifica e la dashboard segnala «L’interfaccia dati xoPort non è protetta».

In Impostazioni → Interfacce → Gestione merci/ERP/Contabilità → Interfaccia dati xoPort sono disponibili le impostazioni di accesso, filtro e importazione dell’interfaccia; i nuovi negozi partono senza la vecchia interfaccia XML. Clicca per ingrandire.

File e indirizzi

Il sistema di gestione merci salva i propri file tramite FTP o SFTP nella cartella xoport/xml/import/. Il sistema li legge solo quando viene richiamato l’indirizzo corretto. Il nome del file deve iniziare esattamente come indicato nella tabella, rispettando anche le maiuscole e le minuscole, e terminare con .xml, ad esempio Products_2026-10-04.xml.

Il negozio sposta i file importati nella sottocartella archiv/. Trascorso il tempo di archiviazione specificato in “xoPort: tempo di archiviazione in giorni” (impostazione predefinita: 14), l’importazione dei prodotti o degli ordini li elimina da lì.

I file che non è possibile leggere vengono spostati in xoport/xml/import/error/ e nella risposta vengono indicati la riga e il motivo. Il sistema rimuove autonomamente i singoli caratteri di controllo non consentiti e quindi legge il file.ab 4.9.65

Il file XML dei prodotti

Un file di prodotto contiene, per ogni articolo, un elemento <product> all’indirizzo <products>. Il negozio individua l’articolo tramite model, il codice articolo. Gli elementi più importanti:

L’importazione trasferisce i prezzi senza modifiche nei campi dei prezzi del negozio; lì vengono riportati i prezzi netti. Se un file fornisce delle caratteristiche, l’importazione sostituisce tutte le caratteristiche dell’articolo con quelle fornite. Se non ne contiene, rimangono quelle esistenti.ab 4.9.21

È possibile definire quali campi e nodi vengono effettivamente importati in Impostazioni → Interfacce → Sistemi di gestione merci/ERP/Contabilità → Interfaccia dati xoPort → xoPort: Impostazioni di importazione prodotti; si veda Blocchi di importazione. Se il vostro sistema di gestione merci fornisce un formato proprio, un modello proprio del negozio (“xoPort: modello XSL personalizzato”) lo converte nel formato del negozio. Tale modello viene mantenuto anche in caso di aggiornamenti.ab 4.9.21

Tutti gli elementi, compresi quelli relativi a categorie, produttori, clienti e ordini, sono descritti nella documentazione dell’API.

1. Il sistema di gestione delle merci o un cronjob richiama https://ihr-shop.example/xpanel/xoport/export_orders.php?key=<AppKey>.
2. Per ogni ordine con un numero superiore a «xoPort: ultimo numero d’ordine esportato», il negozio crea un file order-<Bestellnummer>.xml nella cartella xoport/xml/export/. Successivamente, imposta il valore sull’ultimo ordine il cui file è stato creato con successo. Un ordine non andato a buon fine verrà riproposto alla prossima esecuzione.
3. Il sistema di gestione delle scorte recupera i file tramite FTP o SFTP. I file degli ordini sono bloccati sul web. Di norma, i file recuperati vengono spostati in xoport/xml/export/archiv/.
4. Lo stato, il commento e i numeri di spedizione vengono restituiti tramite un file Orders…xml, vedi File e indirizzi.

Nell’archivio, il negozio cancella i file dopo «xoPort: periodo di archiviazione in giorni». Il valore 0 significa: non cancellare mai. Poiché i file contengono dati dei clienti, è necessario impostare un limite di tempo.ab 4.9.116

Conferma con stato e numero di spedizione

• Il negozio online riconosce lo stato in base al nome, nella denominazione tedesca. Se non riconosce il nome segnalato, crea un nuovo stato dell’ordine con quel nome. Pertanto, nel sistema di gestione delle merci, utilizzate esattamente i nomi degli stati in lingua tedesca del negozio online.
• La ricezione di un’e-mail da parte del cliente è determinata dal campo « customer_notified » del file: « 1 » significa «notificare».
• Se il sistema di gestione delle scorte invia lo stesso messaggio una seconda volta senza che nel frattempo sia stato registrato un altro stato, il negozio lo ignora. Se si desidera segnalare più volte uno stato in caso di consegne parziali, inserire il relativo ID in Impostazioni → Generale → Impostazioni di base → Importazione stati xoPort: Stati per cui inviare una notifica anche in caso di ripetizione.ab 4.9.66

Porter esporta gli ordini in due fasi: un Porter per i dati degli ordini e un secondo per le voci. Per sapere come sono collegati tra loro e come riesportare gli ordini, consultare la sezione Esportazione di ordini e clienti.

Configurazione

Le impostazioni si trovano in Impostazioni → Interfacce → Gestione merci/ERP/Contabilità → JTL:

Cosa viene sincronizzato

Il connettore non importa i numeri di spedizione e gli incassi registrati da JTL-Wawi. Il monitoraggio delle spedizioni va quindi gestito nel negozio, vedi Monitoraggio delle spedizioni. Il connettore JTL non valuta i blocchi di importazione relativi agli articoli.

Due negozi: un connettore è associato a una sola installazione del negozio, con un proprio indirizzo e un proprio «token JTL». Due negozi corrispondono quindi a due connessioni. I diversi domini di una stessa installazione condividono invece il database e il connettore.

OpenXE

La pagina Impostazioni → Interfacce → Sistemi di gestione merci/ERP/Contabilità → OpenXE collega il negozio tramite “Percorso API OpenXE” e “Token API OpenXE”. Senza entrambi, non importa nulla.ab 4.9.106

• Scheda «Importazione dati»: «Prodotti, livelli di magazzino e categorie», «Livelli di magazzino», «Clienti e rappresentanti» e «Dati di tracciamento». Ogni processo viene avviato in background e ne viene visualizzato lo stato di avanzamento sotto la riga corrispondente. È possibile chiudere la pagina, il processo continuerà comunque.
• Scheda «Esportazione dati»: gli ordini con lo «Stato dell’ordine per l’esportazione al sistema gestionale» vengono salvati come file nella «Cartella di archiviazione dei file di esportazione» tramite la funzione «Esporta ordini». Successivamente si ottiene lo «Stato dell’ordine dopo l’esportazione». Per eseguire una nuova esportazione, riportate l’ordine allo stato di esportazione.
• La sincronizzazione delle categorie crea nuove categorie e sposta quelle modificate. Lascia invariati lo stato, l’immagine, l’ordinamento e l’opzione «Categoria come scheda di intestazione» di una categoria esistente. 4.9.135
• Se la pagina segnala «Su questo server non sono possibili processi in background», sul server manca la funzione PHP necessaria. Risolveremo la questione con il vostro provider di hosting.

Altre integrazioni

Se il vostro sistema di gestione delle merci non è presente, solitamente la soluzione più adatta è l’API REST: molti programmi e fornitori di servizi la utilizzano tramite un proprio collegamento o uno strumento come n8n.

L’esportazione del fatturato in formato CSV e la stampa collettiva delle fatture sono descritte nelle guide «Statistiche e report » e «Modifica degli ordini».

n8n

La pagina Impostazioni → Interfacce → Intelligenza artificiale → n8n presenta le schede «Panoramica», «Impostazioni» ed «Eventi»:

1. Inserire «URL istanza n8n», «Tipo di istanza» (n8n Cloud o self-hosted) e «Chiave API n8n», quindi cliccare su «Verifica connessione».
2. In n8n creare un nodo webhook e inserire il suo indirizzo come “URL webhook”. Un “segreto webhook” firma ogni messaggio nell’intestazione X-Webhook-Signature, in modo che n8n riconosca i messaggi autentici.
3. Attivare l’opzione «Abilita webhook» e, nella stessa scheda «Impostazioni», alla voce «Configurazione eventi», selezionare gli eventi desiderati, quindi fare clic su «Salva». Per impostazione predefinita, nessuno è attivo. La scheda «Eventi» mostra quindi lo stato, un payload di esempio e le ultime chiamate al webhook.
4. «Invia evento di prova» verifica il percorso, mentre «Ultime chiamate al webhook» mostra i risultati.

La firma corrisponde solo al corpo del messaggio non modificato. Attivare quindi nel nodo Webhook, sotto “Opzioni”, l’opzione “Raw Body” e calcolare la firma con un nodo Code o il nodo Crypto proprio a partire da questi byte, non dal payload già letto. Il negozio segnala ogni evento immediatamente e al massimo una volta: di norma attende n8n per un massimo di due secondi e non ripete un messaggio se n8n non è momentaneamente raggiungibile.

L’URL del webhook, il segreto e gli eventi segnalati si impostano nella scheda «Impostazioni» della pagina n8n e si salvano cliccando su «Salva». Clicca per ingrandire.

La notifica contiene solo poche informazioni, come il numero d’ordine, l’importo e la modalità di pagamento oppure, nel caso di un nuovo cliente, il nome e l’indirizzo e-mail. Il flusso di lavoro recupera ulteriori dati tramite un proprio accesso all’API REST; si veda API REST.

Variante più semplice senza programmazione: un’esportazione degli ordini tramite Porter e l’importazione dei numeri di spedizione tramite CSV; vedi Esportazione di ordini e clienti.

A livello di articolo: la scheda dell’interfaccia dati

Ogni articolo salvato ha una scheda che prende il nome dalle interfacce che ne valutano i blocchi, ad esempio «Interfaccia dati xoPort / CSV xoPort». Qui è possibile specificare quali campi di questo articolo possono essere sovrascritti durante l’importazione. Se un’opzione è disattivata, l’importazione lascia invariato il campo. Il numero accanto a un gruppo indica quanti dei suoi campi sono bloccati, mentre il numero sulla scheda indica in quanti gruppi è presente un blocco. Gli articoli appena creati vengono sempre importati per intero.

Con l’integrazione plusH o winline, a seconda delle relative impostazioni, vengono aggiunti ulteriori pulsanti, ad esempio «Aggiorna prezzo base per unità», il gruppo «Stock e logistica» (profilo semaforo, livello delle scorte, quantità minima, unità di imballaggio) nonché l’assegnazione di categorie, marchi ed etichette. Senza interfaccia XML, plusH e winline, la scheda si chiama «xoPort CSV» e contiene solo nome e descrizione.ab 4.9.155

Un articolo con prezzo di vendita fisso: il prezzo principale, il prezzo di vendita consigliato e la classe fiscale rimangono invariati durante l’importazione, mentre i testi, le immagini e le giacenze vengono ulteriormente sincronizzati dal sistema di gestione delle merci. Clicca per ingrandire.

• Gli articoli a prezzo fisso, come i libri, vanno bloccati insieme tramite «Aggiorna prezzo principale» e «Aggiorna classe fiscale». Altrimenti, una nuova classe fiscale modifica il prezzo lordo nonostante il prezzo netto sia bloccato.ab 4.9.26 Se il sistema di gestione delle merci fornisce un prezzo consigliato, bloccare anche «Aggiorna prezzo consigliato»: un prezzo consigliato superiore al prezzo di vendita viene visualizzato dal negozio come prezzo barrato con indicazione del risparmio.Da 4.9.168 «Aggiorna prezzo di listino» protegge il prezzo consigliato anche nell’importazione XML.
• Il CSV-Porter tiene conto di «Aggiorna nome» e «Aggiorna descrizione», vedi Proteggere i campi.
• L’API REST imposta e rimuove i blocchi, vedi sotto. Ciò che invia autonomamente viene scritto nonostante il blocco; solo «Aggiorna bonus/omaggio» protegge anche da questo.ab 4.9.169
• JTL-Connector, OpenXE/Xentral e Bechlem non tengono conto dei blocchi.

Impostare i blocchi tramite l’API REST

Il vostro sistema di gestione merci o il vostro fornitore di servizi può impostare i blocchi sull’articolo tramite il campo import_blocks. A partire dalla versione 4.9.168 di Shop, l’API riconosce tutti i pulsanti della scheda e il campo import_blocks_mode definisce cosa succede ai blocchi che non figurano nell’elenco.ab 4.9.168

Fate in modo che il programma invii sempre una modalità: merge per bloccare, remove per sbloccare. La risposta per ogni articolo indica se ogni blocco è stato ricevuto. I nomi dei campi e gli esempi sono riportati nella documentazione dell’API.

Dopo l’aggiornamento alla versione 4.9.168: i blocchi precedenti sono attivi

A partire dalla versione 4.9.168, l’importazione XML dei prodotti tiene conto dei blocchi che in precedenza ignorava: prezzo consigliato, prezzo di listino, sconti, stato del prodotto, immagini del prodotto e GTIN. Tali blocchi possono essere presenti sull’articolo già da tempo, ad esempio a seguito di una precedente integrazione con plusH. Dopo l’aggiornamento, l’importazione non aggiorna più questi campi per gli articoli bloccati senza segnalarlo. Se per singoli articoli il prezzo di listino, un’immagine o lo stato non cambiano più, controllate innanzitutto la scheda.

• Stato del prodotto con plusH e winline: un blocco dello stato è ora valido senza eccezioni. Anche il controllo dei prezzi (prezzo di vendita inferiore al prezzo di acquisto), l’occultamento degli articoli non più disponibili e la disattivazione degli articoli principali lasciano un articolo bloccato. L’eliminazione di articoli non più disponibili non impedisce il blocco.
• winline disattiva gli articoli principali senza varianti attive: a partire dalla versione 4.9.168, questi articoli vanno offline al termine del ciclo; in precedenza rimanevano attivi. Se si desidera che un articolo di questo tipo rimanga visibile, attivare una variante o disabilitare l’opzione “Aggiorna stato del prodotto”.
• GTIN con winline: un GTIN bloccato rimane attivo e l’esportazione degli ordini segnala l’articolo con questo numero al sistema di gestione delle scorte. Bloccare il GTIN solo se il sistema di gestione delle scorte riconosce l’articolo con quel numero.

Per tutti gli articoli: Impostazioni di importazione prodotti

In Impostazioni → Interfacce → Sistemi di gestione merci/ERP/Contabilità → Interfaccia dati xoPort → xoPort: Impostazioni di importazione prodotti, ogni campo dell’articolo è indicato con il proprio nome tecnico e ogni nodo del file (node_…) è dotato di un pulsante Sì/No. Ciò che è impostato su «No» non viene importato dall’importazione XML dei prodotti per nessun articolo. Il numero articolo e l’ID vengono sempre letti.

• Se il sistema di gestione merci fornisce, ad esempio, un supplemento che si desidera gestire nel negozio, disattivare il campo corrispondente, ad esempio shipping_surcharge.
• L’importazione crea nuovi articoli solo se node_categories e node_languages sono attivati. Di default sono già attivi.

Categorie

Nella schermata delle categorie, la scheda «Interfaccia dati xoPort» presenta i pulsanti «Aggiorna nome», «Aggiorna descrizione», «Aggiorna campi SEO» e «Aggiorna immagine categoria». Questi pulsanti si applicano all’importazione delle categorie in formato XML; in caso di nuova creazione, il sistema riprende tutti i dati dal file.

Il campo «Filtro xoPort»

Nella scheda «Altro» dell’articolo si trova il campo «Filtro xoPort». Non serve a proteggere nulla, ma assegna l’articolo alle esportazioni: inserite una o più parole chiave, separate da punto e virgola. Un Porter con lo stesso «Filtro di esportazione» esporterà quindi solo gli articoli con quella parola chiave, e i feed di prodotto possono così essere limitati a determinati articoli o escluderne altri.

• Dove: nella schermata del cliente, scheda «Dati cliente», campo «Numero cliente individuale (esterno)», fino a 64 caratteri. L’interfaccia XML e l’API REST compilano il campo durante l’importazione dei clienti; l’importazione clienti via XML individua gli account tramite questo numero.
• Sui documenti: con Impostazioni → Checkout → Dettagli cliente → Usa numero cliente esterno come numero cliente proprio su true (impostazione predefinita), la fattura e gli altri documenti riportano questo numero al posto dell’ID cliente. La presenza del numero cliente sui documenti è regolata da Impostazioni → Design → Documenti → Numero cliente. Gli ordini degli ospiti non riportano alcun numero cliente.
• Modifica dell’assegnazione: inserisci il nuovo numero nell’account del cliente. Al momento del salvataggio, il negozio verifica che nessun altro account lo abbia già e, in caso contrario, segnala “Il cliente … ha già questo numero cliente!”. I documenti leggono il numero dall’account al momento della creazione, quindi un documento appena generato mostrerà il numero modificato.

Maggiori informazioni sull’ID cliente e sul numero proprio sono disponibili nella guida Gestione clienti.

Dopo un aggiornamento del sistema di gestione merci, la causa risiede solitamente in nomi di file, nomi di stato o campi modificati oppure in un nuovo indirizzo Internet. Controllare i messaggi della dashboard, «Visualizza utilizzo» al momento dell’accesso e la risposta dell’interfaccia. Se la situazione rimane poco chiara, inviarci l’ora e la risposta.