Configurazione dell'account API in Xentral
-
In Xentral, vai su: "Administration" > "System" > "API Account".
-
All'interno dell'Account API, clicca su "New".
-
Configura le impostazioni dell'integrazione API:
- Abilita le opzioni "Active" e "UTF8 Clean".
- Crea una "Designation" e una "Password".
- Abilita "All Permissions".
-
Invia i seguenti dettagli a Hive:
- Nome utente (specificato sopra).
- Password (specificata sopra).
- URL dell'istanza di Xentral (visibile nel browser, ad esempio:
randomtext123.xentral.biz).
Configurazione del magazzino in Xentral per la sincronizzazione dell'inventario
- In Xentral, vai su: "Fulfillment" > "Warehouse Management".
- Clicca su "New" per aggiungere un nuovo magazzino dedicato agli articoli gestiti da Hive.
- Accedi al magazzino appena creato: "Storage Locations" > "Create New Storage Location".
- Dopo aver creato la nuova area di stoccaggio, invia la Designation (ad esempio: HIVE001) a Hive.
Progetti e struttura di stoccaggio
Durante l'integrazione di Xentral in Hive, dovrai fornire dettagli su come i Progetti ("Projects") vengono utilizzati nella tua istanza di Xentral. Hive filtra i progetti di Xentral in base alla loro funzione, che può includere sincronizzazione di ordini, prodotti, o entrambi.
Ad esempio:
- ID Project: 1 → Contiene SKU che Hive deve gestire.
- ID Project: 2 → Riceve ordini che Hive deve elaborare.
Puoi scegliere un'installazione semplice, con un solo progetto per ordini e prodotti, o una configurazione avanzata con più marchi e fonti di ordini. Durante la configurazione, condividi uno schema base della struttura della tua istanza di Xentral.
Per trovare il Project ID numerico (non il nome testuale), segui le istruzioni in Xentral.
Configurazione dei prodotti
Le seguenti informazioni sui prodotti devono essere compilate in Xentral e saranno sincronizzate con Hive:
- "Prodotto" → "Dettagli":
- Nome del prodotto (Item).
- Codice SKU (Numero Articolo).
- Codice a barre.
- Codice HS (Tariffa doganale).
- Paese d'origine.
- Immagini del prodotto*.
- Costo di produzione.
* Per inviare immagini dei prodotti a Hive, il file immagine deve essere impostato come "Shopbild".
Evidenziati in verde: i dettagli degli SKU che Hive può sincronizzare da Xentral.
Sincronizzazione dell'inventario
-
Nella sezione "Item Options", seleziona la casella "Stock Item" per sincronizzare le informazioni di inventario con Hive.
-
Per sincronizzare i costi di produzione tramite l'API di Xentral, aggiungi queste informazioni nella sezione "Calculate and adopt the new calculated purchase price".
Flusso di gestione degli ordini
- Gli ordini vengono importati dalla fonte in Xentral. Per essere elaborati, devono essere contrassegnati come completati e generare una Bolla di consegna (Lieferschein) (Delivery Note).
- Poiché Xentral non fornisce timestamp, Hive elabora gli ordini una volta al giorno invece che con il principio FIFO (First In, First Out) ogni ora.
Modifica e annullamento ordini
- Gli ordini vengono importati in Hive ogni ora in blocchi.
- Gli aggiornamenti sugli ordini vengono sincronizzati per le ultime 24 ore. Le cancellazioni vengono sincronizzate per gli ultimi 30 giorni.
Sincronizzazione manuale degli ordini
Puoi sincronizzare manualmente un ordine tramite l'Hive App.
- Vai su "Orders", seleziona un ordine e clicca su "Resync Order" per sincronizzare rapidamente le modifiche rispetto all'intervallo standard (60 minuti).
Tracciamento
Le informazioni di tracciamento vengono inviate a Xentral via API subito dopo che l'ordine è stato elaborato e spedito da Hive. Se ci sono più spedizioni associate a un ordine, verranno inviati più numeri di tracciamento.
Tipologia di ordine
È possibile separare ordini B2B e B2C in base ai progetti in Xentral. Hive può configurare i progetti in modo che tutti gli ordini di ciascun progetto siano trattati come ordini B2B, semplificando la gestione e garantendo una chiara separazione tra i tipi di ordini.