Collega Unleashed e sincronizza prodotti e livelli di magazzino
Collega il tuo account Unleashed (gestione magazzino) al CRM e mantieni prodotti e saldi di magazzino aggiornati automaticamente, senza creare duplicati.
Puoi collegare il tuo account Unleashed al CRM. Una volta collegato, il CRM importa da Unleashed prodotti (creando o aggiornando un Prodotto) e livelli di magazzino (come rettifica nel tuo Magazzino), mantenendo tutto collegato tramite l'id Unleashed. Una nuova sincronizzazione non crea mai duplicati: aggiorna il record già esistente.
Il modello è BYO ("porta il tuo account"): usi il tuo account Unleashed e la tua coppia API. Non vediamo mai la tua API Key (serve solo a firmare le chiamate) e non c'è alcun costo da parte nostra. L'integrazione parte inerte: non succede nulla finché non configuri le credenziali e la attivi. In questa prima fase, la sincronizzazione è IN INGRESSO (da Unleashed verso il CRM), tramite polling periodico.
Requisiti
- Un account Unleashed con accesso API.
- Una coppia API (API ID e API Key) generata in Unleashed.
- In Sellio, essere amministratore (permesso di gestione impostazioni) per salvare le credenziali in Impostazioni → Integrazioni.
Passo 1: genera l'API ID e l'API Key in Unleashed
- In Unleashed, apri Integrazione e poi API.
- Genera/copia l'API ID e l'API Key. L'API Key è un segreto: conservala al sicuro, non viene mostrata di nuovo.
Passo 2: incolla le credenziali nel CRM
- Apri Impostazioni → Integrazioni e trova la scheda "Unleashed (gestione magazzino)".
- Incolla l'API ID e l'API Key. L'API Key viene memorizzata cifrata e non viene mai più mostrata.
- Facoltativo: inserisci un codice Deposito per usare solo il saldo di quel deposito. Lascia vuoto e il CRM sommerà lo stock di tutti i depositi.
- In "Entità e direzione", scegli se importare Prodotti e Livelli di magazzino da Unleashed (o disattivare ciascuno).
- Clicca su "Salva connessione" e poi su "Attiva".
Passo 3: sincronizza
- Clicca su "Sincronizza ora" per importare subito i dati da Unleashed.
- Da quel momento, la sincronizzazione gira in autonomia a intervalli brevi (ogni pochi minuti) per mantenere lo stock quasi in tempo reale, più un passaggio di sicurezza giornaliero.
- Sulla scheda, osserva crescere il contatore "Collegamenti per entità" man mano che i prodotti vengono collegati.
Cosa viene sincronizzato
- Prodotti: il codice prodotto (SKU), la descrizione, il prezzo di vendita, il costo e lo stato (attivo/inattivo). Se hai già un prodotto con lo stesso SKU nel CRM, viene riutilizzato (nessun duplicato).
- Livelli di magazzino: il saldo di ogni prodotto diventa una rettifica nel tuo Magazzino, allineando il saldo del CRM a quello di Unleashed. Ogni rettifica viene registrata nella cronologia movimenti del prodotto, così nulla va perso o viene sovrascritto alla cieca.
Sicurezza e privacy
L'API Key viene memorizzata cifrata e non viene mai mostrata. Viene usata solo per firmare ogni chiamata (HMAC), quindi il segreto non viaggia mai in rete. La connessione parte inerte e sincronizza solo dopo essere stata configurata e attivata.
Come testare
- Dopo aver salvato e attivato, clicca su "Sincronizza ora" e attendi la conferma.
- Apri l'elenco Prodotti e la schermata Magazzino e verifica che i prodotti e i saldi di Unleashed siano comparsi.
- Sulla scheda, osserva crescere il contatore "Collegamenti per entità".
Risoluzione dei problemi
- Non sincronizza nulla: conferma che l'integrazione sia "Attiva" e che almeno un'entità sia impostata su "Importa da Unleashed".
- Errore di credenziali durante la sincronizzazione: reinserisci l'API ID e l'API Key (la Key non viene mai restituita dal server, quindi incollala per intero).
- Lo stock non compare: lo stock viene applicato solo ai prodotti che esistono nel CRM. Imposta anche "Prodotti" su "Importa da Unleashed" perché i prodotti vengano creati per primi, oppure assicurati che lo SKU del CRM corrisponda a quello di Unleashed.
- Il saldo è diverso da quello atteso: verifica di aver impostato il deposito giusto (o di averlo lasciato vuoto per sommarli tutti).