Questa integrazione fa per te se i tuoi ordini nascono in Holded: vendite a negozi o distributori, ordini per telefono o per email che inserisci come ordine di vendita. Appena ne crei uno, ci arriva per essere preparato. E in Holded vedi sempre a che punto è: lo stato, il corriere, il numero di tracking e lo stock reale che hai nel nostro magazzino.
Se vendi con un negozio online (Shopify, WooCommerce…) e usi Holded solo per fatturare, non ti serve questa integrazione: collega il tuo negozio e basta.
Prima di iniziare
Devi essere amministratore dell'account Holded.
Tutti i piani di Holded includono l'API, ognuno con una quota di chiamate al mese. Lo spieghiamo più sotto, in «La quota dell'API di Holded».
Un account Holded può essere collegato a un solo account Furgox.
1. Crea la chiave API in Holded
In Holded, vai su Impostazioni → API.
Clicca Genera nuova chiave e dalle un nome riconoscibile, ad esempio
Furgox.Seleziona questi permessi:
inventory:sales-orders.readinventory:sales-orders.writeinventory:products.readinventory:products.writeinventory:warehouses.readinventory:warehouses.writecontacts:contacts.readdevelopers:webhooks.readdevelopers:webhooks.write
Copia la chiave. Holded la mostra una sola volta: se chiudi la finestra senza copiarla, dovrai generarne un'altra.
2. Incollala in Furgox
Nel tuo pannello, apri Integrazioni, clicca Collega un negozio e scegli Holded. Incolla la chiave e clicca Collega Holded.
Vedrai una casella, selezionata di default: creare il magazzino «Furgox» come magazzino predefinito. Lasciala selezionata se tutta la tua merce è da noi: così i nuovi ordini usano quel magazzino in Holded senza doverlo scegliere ogni volta.
3. Cosa facciamo al collegamento
Controlliamo la chiave e i suoi permessi. Se ne manca uno, ti diciamo quale.
Creiamo nel tuo Holded il magazzino «Furgox» (se ne hai già uno con quel nome, usiamo quello). Lì vedrai lo stock reale del nostro magazzino.
Attiviamo gli avvisi di Holded per sapere subito di ogni ordine di vendita nuovo o modificato.
Leggiamo il tuo catalogo, con varianti, SKU e codici a barre.
Cosa succede da ora in poi
Ordini
Ogni ordine di vendita che crei in Holded ci arriva in pochi secondi. Entrano gli ordini in sospeso creati a partire dal collegamento; le bozze e gli ordini più vecchi no. Le righe di servizi, come le spese di spedizione, non si preparano: solo i prodotti.
L'indirizzo di consegna è quello dell'ordine. Se l'ordine usa quello del cliente, lo prendiamo dalla sua scheda in Holded: il suo indirizzo di spedizione o, se non c'è, quello di fatturazione.
Se preferisci controllare ogni ordine prima che venga preparato, attiva Accetto io gli ordini nella scheda di Holded del tuo pannello.
Stato e tracking in Holded
Nella sezione tracking dell'ordine, in Holded, segui ogni passaggio: in preparazione, preparato, spedito, consegnato, incidente, reso o annullato.
Quando esce dal magazzino scriviamo il corriere e il numero di tracking e lo segniamo come spedito. Alla consegna annotiamo anche la data di consegna.
Stock
Il magazzino «Furgox» del tuo Holded mostra le unità reali del nostro magazzino, man mano che entra merce ed escono ordini. Tocchiamo solo i prodotti già arrivati da Furgox: quello che non ci hai ancora mandato resta com'è.
Quando un ordine viene segnato come spedito, Holded scala lo stock dal magazzino dell'ordine. Se l'ordine era in un altro tuo magazzino di Holded, gli restituiamo quelle unità, perché in realtà sono uscite dal nostro.
Prodotti
Il tuo catalogo di Holded è il riferimento: quando crei o modifichi un prodotto lo vediamo subito. I pack non vengono importati come prodotto a sé: si preparano i loro componenti. Altro in Cosa facciamo con il tuo catalogo.
La quota dell'API di Holded
Holded limita le chiamate alla sua API in base al piano: circa 500 al mese in Starter, 2.000 in Basic, 7.500 in Standard e di più nei piani superiori. Per questo gli ordini ci arrivano tramite avvisi, che non consumano quota, e scriviamo in Holded solo quando cambia qualcosa.
Anche così, ogni ordine usa circa cinque chiamate: leggere l'ordine e il cliente, scrivere lo stato e la spedizione. Il piano Starter basta per circa 100 ordini al mese. Se ne spedisci di più, conviene un piano superiore.
Se la quota del mese si esaurisce, sospendiamo la sincronizzazione finché Holded non la rinnova e ti avvisiamo nel pannello. Nel frattempo continuiamo a preparare gli ordini già arrivati.
Cosa non facciamo
Non creiamo fatture né tocchiamo la tua contabilità in Holded: la fatturazione resta uguale.
Non cambiamo i tuoi SKU di Holded: ogni prodotto è collegato tramite il suo identificativo interno.
Se annulli o elimini un ordine in Holded prima che lo prepariamo, lo annulliamo. Se era già preparato, ti avvisiamo per vederlo insieme.
Se qualcosa non va
«Holded non ha accettato la chiave»
Holded risponde allo stesso modo a una chiave copiata male e a una a cui manca un permesso. Controlla di averla incollata intera e che tutti i permessi della lista siano selezionati. Nel dubbio, generane una nuova.
«Holded non ci permette di ricevere gli avvisi dei nuovi ordini»
Holded permette a un solo strumento di ricevere ogni tipo di avviso. Se ne hai già un altro collegato, controlliamo i tuoi ordini ogni 30 minuti invece che subito, consumando più quota. Se quell'altro strumento non lo usi più, eliminalo in Impostazioni → Webhooks di Holded e ricollega.
Un ordine non mi arriva
Controlla che non sia una bozza e che sia in sospeso.
Gli ordini con data precedente al collegamento non entrano.
Se l'ordine non ha indirizzo, né nell'ordine né nella scheda del cliente, o i suoi prodotti non sono nel tuo catalogo, ti avvisiamo nel pannello. Correggilo in Holded ed entrerà da solo.
Ho rigenerato o eliminato la chiave in Holded
La chiave vecchia smette di funzionare e la scheda passa da sola a Scollegato. Clicca Ricollega e incolla quella nuova: il collegamento esistente si aggiorna, senza perdere ordini né storico. Altro in Sincronizzare, scollegare o eliminare un negozio.
Dubbi sui permessi o sulla quota? Scrivici dalla chat del pannello e lo vediamo insieme.