I punti chiave
- HubSpot non sviluppa un connettore proprio per Holded: Holded documenta un collegamento tramite Zapier e nel Marketplace di HubSpot ci sono app realizzate da partner, tra cui Holded by Vexco.
- Holded by Vexco si installa con OAuth su qualsiasi edizione di HubSpot; le 21 azioni di workflow richiedono HubSpot Professional o Enterprise.
- La configurazione ha 7 passaggi (Connect Holded, Plan and modules, Template, Review fields, Duplicates, Initial load, Activate) e salva i progressi.
- Il modo consigliato di partire è spuntare «Start read-only (Holded → HubSpot only)»: per qualche giorno i dati vanno solo da Holded a HubSpot.
- Le schermate dell'app sono in spagnolo o in inglese: chi usa HubSpot in italiano le vede in inglese.
Le tre strade per collegare Holded e HubSpot
HubSpot non sviluppa un connettore proprio per Holded. Holded, nella sua pagina dedicata a HubSpot, descrive un collegamento tramite Zapier per contatti, aziende e trattative. In pratica le opzioni sono tre e la scelta dipende da due domande: quanti dati devono passare da un sistema all'altro e chi manterrà il collegamento nel tempo.
| Strada | Come funziona | Adatta a | Chi la mantiene |
|---|---|---|---|
| Zapier o Make | Automazioni «trigger → azione» costruite da voi, partendo dai modelli che Holded elenca | Uno o due flussi semplici, in un solo senso | Voi: ogni Zap o scenario va rivisto quando cambiano campi o processi |
| App del Marketplace di HubSpot | Un'app installata con OAuth che sincronizza aziende, contatti, catalogo, documenti e incassi | Il processo standard: si vende in HubSpot, si fattura in Holded | Lo sviluppatore dell'app; voi decidete flussi e campi |
| Integrazione su misura | Codice scritto da un'agenzia o dal vostro team sulle API di Holded e HubSpot | Processi fuori standard: oggetti personalizzati, logiche tra più società, pagamenti particolari | Chi l'ha sviluppata: hosting, monitoraggio e aggiornamenti quando cambiano le API |
Holded by Vexco è una delle app realizzate da partner per Holded presenti nel Marketplace; non è un prodotto ufficiale di Holded né di HubSpot. Se volete un confronto puntuale, trovate le pagine Holded by Vexco o Zapier e Make e app o integrazione su misura. Qui seguiamo la seconda strada, passo per passo.
Perché il tema riguarda anche le aziende italiane
Holded è un gestionale spagnolo per PMI: fatturazione, contabilità, tesoreria, magazzino, progetti e un CRM proprio. Non ha un sito in italiano, ma lo usano molte società spagnole, comprese controllate e filiali di gruppi italiani, perché emette le fatture secondo le regole fiscali spagnole. Lo scenario tipico è questo: il team commerciale, spesso in Italia, lavora in HubSpot; l'amministrazione della società spagnola fattura e incassa in Holded. Senza collegamento qualcuno ricopia clienti e importi a mano e chi vende non sa se il cliente ha pagato.
Tre dettagli pratici per chi lavora dall'Italia:
- Lingua dell'app: le schermate di Holded by Vexco sono in spagnolo o in inglese, in base alla lingua di HubSpot di ogni utente. Con HubSpot in italiano le vedete in inglese: per questo in questa guida citiamo le etichette in inglese.
- Più società: allo stesso account HubSpot si possono collegare più aziende di Holded, ognuna con le sue serie di numerazione e i suoi conti. La prima collegata è quella predefinita; il numero massimo dipende dal piano.
- Fatturazione italiana: l'app lavora solo con Holded. Le fatture che la società italiana emette tramite SDI con il proprio gestionale restano fuori da questa integrazione.
Cosa serve prima di iniziare
- HubSpot: un account di qualsiasi edizione. L'installazione la fa un super amministratore.
- Workflow: HubSpot Professional o Enterprise solo se volete usare le 21 azioni di workflow dell'app, perché i workflow di HubSpot richiedono una di queste edizioni.
- Holded: un account con accesso alle API. La chiave si genera in Holded → Settings → Developers → New API key e Holded la mostra una sola volta: copiatela subito.
- Configurazione di Holded: serie di numerazione e almeno un conto di tesoreria, se volete creare documenti e registrare incassi da HubSpot; un funnel nel CRM di Holded, se sincronizzerete le opportunità.
- Una decisione: chi comanda su cosa. Di solito Holded per catalogo, fatture e incassi; HubSpot per trattative e attività commerciali.
Le API di Holded hanno un limite di 100 richieste al minuto per chiave e una quota mensile visibile nel vostro account. L'app mostra le chiamate usate e tiene una riserva per l'operatività quotidiana, così i caricamenti massivi non la consumano tutta.
Installare Holded by Vexco dal Marketplace
Si parte dalla scheda di Holded by Vexco nel Marketplace di HubSpot oppure dal link di installazione diretto. HubSpot vi chiede di approvare i permessi tramite OAuth: quelli per gli oggetti Fatture e Ordini e per le azioni di workflow sono facoltativi. Se non li accettate l'app funziona lo stesso e salva i dati delle fatture sulla trattativa. Subito dopo si apre la configurazione guidata.
La prova gratuita dura 14 giorni, con tutti i moduli attivi e senza carta fino alla scadenza. I pacchetti e i moduli sono descritti nella pagina dei prezzi di Holded by Vexco; per chi vende in HubSpot e fattura in Holded il pacchetto consigliato è Fatturazione.
I 7 passaggi della configurazione guidata
La procedura salva i progressi: potete chiuderla e riprenderla dove l'avevate lasciata. Fino al passaggio 7 non si sincronizza nulla.
- Connect Holded: incollate la chiave API. L'app la convalida subito e vi dice quali moduli consentono i suoi permessi. Qui potete collegare anche altre aziende di Holded.
- Plan and modules: scegliete un pacchetto o componete il piano per moduli e indicate quante aziende di Holded collegare. Quello che non è nel piano non si sincronizza.
- Template: Commercial, Invoicing, Complete o Custom. Il modello accende i flussi adatti; per vendere in HubSpot e fatturare in Holded il punto di partenza è Invoicing. Riapplicare un modello non cancella le vostre modifiche.
- Review fields: per ogni flusso vedete i campi, il senso e come si calcolano. L'app controlla che ogni valore entri nel tipo di destinazione e blocca il salvataggio se trova errori, per esempio due campi che scrivono la stessa proprietà.
- Duplicates: con «Analyze duplicates» l'app confronta i due sistemi in sola lettura e vi dice quanti record collegherà, quanti creerà da ogni lato e quanti richiedono una vostra decisione. I dettagli sono nell'articolo su come evitare i clienti duplicati tra Holded e HubSpot.
- Initial load: decidete se portare i dati esistenti, quali flussi, in che modalità («Link only», «Link and fill gaps» o «Full load») e, per i documenti, l'intervallo di date. Potete iniziare con un campione o simulare senza scrivere nulla.
- Activate: un riepilogo di cosa succederà e gli avvisi sulla configurazione mancante, come l'assenza di un conto di tesoreria o di una serie di numerazione, con l'indicazione di dove sistemarla.
Ogni passaggio è illustrato con le schermate nella pagina come funziona Holded by Vexco; la procedura completa, dalla chiave API alla disinstallazione, è nella guida di installazione.
Partire in sola lettura
L'ultimo passaggio si chiude con una casella e un pulsante. Se spuntate «Start read-only (Holded → HubSpot only)» prima di premere «Activate sync», l'app porta i dati da Holded a HubSpot ma non scrive nulla in Holded. È il modo più prudente di iniziare: per qualche giorno controllate in HubSpot aziende, contatti, prodotti e fatture, risolvete i casi nella casella di revisione e verificate i valori predefiniti. Quando i dati vi convincono, nella scheda Status premete «Turn on both directions».
Consiglio: in sola lettura la scheda «Holded» delle trattative mostra «View only» e nasconde tutte le azioni che scrivono in Holded. È il comportamento previsto: le azioni ricompaiono quando attivate entrambi i sensi.
Cosa controllare dopo l'attivazione
- Stato di salute: nella scheda Status trovate il semaforo verde, giallo o rosso, l'ultima sincronizzazione riuscita, gli elementi in revisione e i lavori falliti.
- Casella di revisione: i possibili duplicati e i conflitti di dati non si risolvono da soli. Ogni caso ha i suoi pulsanti: «Merge», «Create new» e «Ignore», oppure «Keep Holded» e «Keep HubSpot».
- Schede sui record: aggiungete la scheda «Holded» alla vista di aziende e contatti e la scheda «Holded · Stock» a quella dei prodotti, dalla libreria delle schede di HubSpot (filtro «Apps»). Nell'anteprima di aziende e contatti potete aggiungere «Holded · Info», con saldo e scaduto. Sulle trattative create una tab «Holded» e aggiungete «Holded by Vexco».
- Holded defaults: nelle impostazioni, serie di numerazione per tipo di documento, conto di tesoreria, metodo di pagamento e canale di vendita. L'app non sceglie mai «il primo della lista»: senza serie o conto il documento non si crea e l'app ne spiega il motivo.
- Una trattativa di prova: segnatela come vinta e controllate in Holded la bozza di fattura con voci, cliente e serie corretti. Il processo è spiegato nell'articolo su come creare la fattura in Holded dalla trattativa vinta.
- Registro attività: ogni sincronizzazione e ogni azione degli utenti, con il valore prima e dopo campo per campo e, in caso di errore, il dettaglio tecnico e cosa farà l'app.
Sui tempi: le modifiche che arrivano via webhook si copiano in pochi secondi; le opportunità del CRM di Holded, gli eventi e i progetti si controllano ogni pochi minuti, perché Holded non invia notifiche per questi oggetti. Un passaggio notturno recupera quello che fosse sfuggito.
Quando conviene un'altra strada
Zapier o Make restano una buona scelta se vi basta un flusso semplice, per esempio creare in Holded i nuovi contatti di HubSpot, o se li usate già per molti altri strumenti. I passaggi e i limiti, dal polling ai campi personalizzati, sono nell'articolo su come collegare Holded e HubSpot con Zapier.
Un'integrazione su misura ha senso quando il processo esce dallo standard: oggetti personalizzati, logiche tra più società del gruppo, flussi di pagamento particolari. Vexco Solutions sviluppa anche questo tipo di progetti: trovate l'approccio nella pagina sulle integrazioni HubSpot di Vexco e un esempio concreto nel caso di successo Holded e HubSpot. Per una richiesta su misura potete scrivere dalla scheda Contact dell'app. Se leggete lo spagnolo, sul blog di Vexco c'è anche un approfondimento su come integrare HubSpot con Holded (in spagnolo).
Holded by Vexco
Installatela dal Marketplace di HubSpot, collegate la vostra società in Holded e partite in sola lettura. Non si sincronizza nulla finché non lo attivate voi.
Prova gratisDomande frequenti
Holded ha un'integrazione ufficiale con HubSpot?
No, non esiste un connettore nativo. Holded documenta un collegamento tramite Zapier per contatti, aziende e trattative, mentre nel Marketplace di HubSpot ci sono app realizzate da partner. Holded by Vexco è una di queste ed è sviluppata da Vexco Solutions, non da Holded né da HubSpot.
Holded by Vexco è disponibile in italiano?
No. Le schermate dell'app sono in spagnolo o in inglese: ogni utente le vede in spagnolo se il suo HubSpot è in spagnolo e in inglese in tutti gli altri casi, quindi anche con HubSpot in italiano. Il supporto risponde per email a pau.romani@vexcosolutions.com.
Serve HubSpot Professional per collegare Holded?
Dipende da cosa vi serve. Per installare l'app e sincronizzare aziende, contatti, documenti e incassi basta qualsiasi edizione di HubSpot. Le 21 azioni di workflow richiedono HubSpot Professional o Enterprise, perché i workflow di HubSpot sono disponibili solo in queste edizioni.
Si possono collegare più società di Holded allo stesso HubSpot?
Sì. Allo stesso account HubSpot si possono collegare più aziende di Holded, ognuna con le sue serie, i suoi conti e i suoi valori predefiniti; la prima collegata è quella predefinita. Il numero dipende dal piano, e durante la prova si arriva fino a 3.
La prova gratuita richiede una carta di credito?
No. La prova dura 14 giorni con tutti i moduli attivi e la carta si chiede solo alla scadenza. Se non attivate un piano la sincronizzazione va in pausa e non si cancella nulla: riprende appena pagate un piano.
Che cosa succede ai dati già presenti nei due sistemi?
Nulla, finché non lo decidete voi. Al passaggio 5 l'app analizza i duplicati in sola lettura e al passaggio 6 scegliete se e come caricare i dati esistenti; con la modalità «Link only» collega i record che esistono da entrambi i lati senza creare né modificare nulla.