Panoramica dell'integrazione
L'integrazione di Hive con WooCommerce è nativa e offre aggiornamenti in tempo reale tramite webhook. Qualsiasi aggiornamento nel tuo negozio si rifletterà nella Hive App pochi secondi dopo.
Come integrare WooCommerce a Hive
Per collegare il tuo negozio WooCommerce alla Hive App, dovrai creare una nuova chiave "REST API" nel tuo negozio WooCommerce e condividere con Hive l'"URL", la "Chiave cliente" e il "Segreto cliente" creando un ticket al supporto clienti nella Hive App sulla pagina di "supporto".
Per creare una chiave "REST API" nel tuo negozio WooCommerce, segui i passaggi seguenti:
- In Woocommerce, vai alla scheda WooCommerce, cerca l'icona Woo e seleziona "Impostazioni".
- Naviga e clicca sulla scheda "Avanzate".
- Nella sezione "Configurazione della pagina", trova la scheda "API REST".
- Clicca su "Aggiungi chiave".
- Aggiungi "Hive Technologies" come descrizione e dai i permessi di "lettura/scrittura", quindi clicca su "Genera chiave API".
- Copia e invia a Hive il tuo "URL", "chiave del consumatore" e "segreto del consumatore" creando un ticket nella Hive App nella pagina di "supporto".
⚠️ Se stai integrando un altro negozio WooCommerce dopo che abbiamo iniziato a evadere i tuoi ordini, ti preghiamo di informare Hive tramite l'assistenza clienti per allinearti sulla data di inizio dell'evasione degli ordini per questo negozio aggiuntivo.
Come importare il catalogo in Hive
Affinché Hive sappia quali SKU elaborare da un negozio, è necessario mapparli con gli SKU di Hive.
Dopo aver integrato il tuo WooCommerce, i tuoi prodotti saranno importati tramite webhook pochi secondi dopo nella Hive App. Una volta importati, inizia a mappare i tuoi prodotti nella Hive App, in modo che Hive sappia quali prodotti fisici spedire dagli ordini sincronizzati da questo nuovo negozio.
Per maggiori informazioni su come mappare i prodotti del negozio con gli SKU di Hive, clicca qui.
Come impostare la sincronizzazione dell'inventario
Hive può sincronizzare le quantità dell'inventario con il tuo WooCommerce. In questo modo avrai una panoramica accurata del tuo inventario in WooCommerce e potrai evitare un eccesso di vendite. I numeri dell'inventario vengono sincronizzati con WooCommerce ogni ora. La sincronizzazione dell'inventario sarà attivata solo quando Hive avrà iniziato a evadere gli ordini. Se non vuoi attivare questa funzione, contatta l'Assistenza clienti.
- Nota: la sincronizzazione dell'inventario e la sincronizzazione degli ordini non sono correlate. Senza la sincronizzazione dell'inventario, gli ordini arriveranno comunque in Hive. La sincronizzazione dell'inventario è dedicata all'invio dei conteggi dell'inventario a WooCommerce.
Come vengono trasmesse le informazioni di tracciamento a WooCommerce?
Le informazioni di tracciamento delle spedizioni vengono trasmesse a WooCommerce non appena l'ordine viene contrassegnato come "spedito" in Hive. Quando Hive evade un ordine nel centro di evasione, segna l'ordine come "completato" e invia al tuo WooCommerce il corriere, l'URL di tracciamento e il numero di tracciamento della spedizione.
Dettagli sull'integrazione
- Dati SKU importati da WooCommerce
I seguenti campi SKU vengono importati da WooCommerce in Hive:
- Peso
- Costo/Costo di produzione
- Stato
Il costo di produzione è un campo importante da compilare in WooCommerce. Insieme al codice HS e al paese di origine, è necessario per passare le autorità doganali per le spedizioni al di fuori dell'UE. Senza uno di questi campi, l'ordine verrà bloccato nel Centro di evasione finché non aggiornerai le informazioni della SKU.
- Nota: i campi SKU "Paese di origine" e "Codice HS" non sono ancora importati da WooCommerce. Se stai pensando di effettuare spedizioni al di fuori dell'UE, ti invitiamo a compilarli direttamente nella Hive App.
- Nota: attualmente non importiamo il campo "Codice a barre" (EAN) da WooCommerce. Per aiutarci a identificare meglio le tue SKU, ti preghiamo di compilare questi campi nella Hive App.
- Dettagli sulla sincronizzazione degli ordini e dei prodotti
Gli ordini e gli aggiornamenti dei prodotti con l'integrazione di WooCommerce avvengono in tempo reale, poiché la connessione avviene tramite webhook.
Questi sono gli endpoint API che utilizziamo attualmente:
GET /wp-json/wc/v3/settings/products/<id>
- Per importare le impostazioni del prodotto
GET /wp-json/wc/v3
- Per verificare che l'URL e la chiave API funzionino correttamente
GET /wp-json/wc/v3/prodotti
- Per importare prodotti
GET /wp-json/wc/v3/prodotti/<product_id>/variazioni
- Per importare le varianti di un prodotto
POST /wp-json/wc/v3/prodotti/<product_id>/variati/batch
- Per aggiornare il conteggio dell'inventario
GET /wp-json/wc/v3/ordini
- Per importare gli ordini
GET /wp-json/wc/v3/ordini/<id>
- Per importare un ordine specifico
PUT /wp-json/wc/v3/ordini/<id>
- Per aggiornare lo stato dell'ordine
GET /wp-json/wc/v3/ordini/<id>/note
- Per recuperare le note dell'ordine
POST /wp-json/wc/v3/ordini/<id>/note
- Per creare una nuova nota d'ordine con il numero di tracking/URL
GET /wp-json/wc-shipment-tracking/v3
- Per rilevare la presenza del plugin di tracciamento delle spedizioni a pagamento
GET /wp-json/wc-shipment-tracking/v3/orders/<order_id>/shipment-trackings/
- Per ottenere tutte le spedizioni
POST /wp-json/wc-shipment-tracking/v3/orders/<order_id>/shipment-trackings/
- Per creare una nuova spedizione
GET /wp-json/wc/v3/webhooks
- Per verificare se gli URL dei nostri webhook sono registrati
POST /wp-json/wc/v3/webhooks/batch
- Per registrare gli URL dei nostri webhook, se sono mancanti
In questa pagina di WooCommerce puoi trovare maggiori informazioni sugli endpoint API che utilizziamo.
- Possiamo abilitare il FIFO?
Riceviamo i timestamp di data e ora da WooCommerce, il che ci permette di seguire una logica First-in-First-out (FIFO) per gli ordini importati da WooCommerce.
Caratteristiche non supportate
Attualmente l'integrazione non supporta le seguenti funzioni:
- Trasferimento in batch delle informazioni di tracking da Hive a WooCommerce
- Trasferimento delle informazioni di tracciamento del numero di serie da Hive a WooCommerce
- Caricamento dei documenti da WooCommerce a Hive per gli ordini B2B In alternativa, puoi aggiungere i documenti manualmente nella Hive App. Tutti i passaggi sono spiegati in questa FAQ.
- Annuncio delle spedizioni di riassortimento
- Contrassegnare gli articoli "in attesa" in WooCommerce
- In alternativa, puoi utilizzare le "Order Action" della Hive App per contrassegnare gli ordini "in attesa".
Guida alla disinstallazione
Puoi revocare la nostra chiave API dal tuo WooCommerce per porre fine alla nostra collaborazione. Per farlo, segui i seguenti passaggi:
- In Woocommerce, vai alla scheda WooCommerce, cerca l'icona Woo e seleziona "Impostazioni".
- Naviga e clicca sulla scheda "Avanzate".
- Nella sezione "Configurazione della pagina", trova la scheda "API REST".
- Trova la chiave "Hive Technologies
- Clicca su "Revoca"