Guida all'installazione

Guida all'installazione di Holded by Vexco

Holded by Vexco si installa dal Marketplace di HubSpot, si collega a Holded con una API key e si configura con una procedura guidata in 7 passi. Questa guida spiega come installarla, collegare Holded, configurarla, usarla, scollegarla e disinstallarla, e cosa succede ai vostri dati in ogni caso. Per il dettaglio di ogni schermata, con le immagini, consultate come funziona l'app.

Requisiti

  • Un account HubSpot (qualsiasi edizione) e un utente autorizzato a installare app (super amministratore).
  • Un account Holded con accesso alle API (Settings › Developers).
  • Per vedere fatture e ordini come oggetti di HubSpot, il vostro account deve avere questi oggetti. Sono autorizzazioni facoltative: senza, l'app salva i dati nella trattativa.
  • Per le azioni nei flussi di lavoro: HubSpot Professional o Enterprise e l'autorizzazione facoltativa di automazione.
  • Le schermate dell'app sono in spagnolo o in inglese, secondo la lingua di HubSpot di ogni utente: con HubSpot in italiano la vedrete in inglese. Per questo, in questa guida citiamo le etichette inglesi, anche per i menu di HubSpot, che nel vostro account potrebbero comparire in italiano.

1. Installare l'app

  1. Nel Marketplace di HubSpot aprite Holded by Vexco e premete Install (oppure usate il link di installazione).
  2. Scegliete l'account HubSpot in cui installarla.
  3. Controllate le autorizzazioni e premete Connect app. Quelle per fatture, ordini e automazione (automation) sono facoltative. Se avete installato l'app prima del 12/11/2026, un super amministratore deve attivare quella di automazione in Settings › Integrations › Connected apps › Holded by Vexco › Data permissions e ricollegare l'app.
  4. HubSpot vi porta alle impostazioni dell'app, dove parte la procedura guidata.
Schermata delle autorizzazioni di HubSpot durante l'installazione di Holded by Vexco
Figura 1La schermata delle autorizzazioni di HubSpot durante l'installazione.

2. Collegare Holded

  1. In Holded andate in Settings › Developers › New API key. Assegnate le autorizzazioni dei moduli che userete (ve le indica la procedura guidata) e copiate la chiave: Holded la mostra una sola volta.
  2. Nella procedura guidata incollatela in Holded API key, date un nome alla società (utile se ne collegate più di una) e premete Validate and connect. L'app verifica subito la chiave e le sue autorizzazioni.
Passo Connect Holded della procedura guidata di configurazione
Figura 2Il passo «Connect Holded» della procedura guidata.

3. Configurare con la procedura guidata

La procedura guidata salva ogni passo: potete chiuderla e riprendere un altro giorno. Finché non attivate la sincronizzazione nell'ultimo passo (Activate), non si sincronizza nulla.

  1. Plan and modules. Durante i 14 giorni di prova è tutto attivo; poi scegliete ciò che vi serve.
  2. Template. Commercial, Invoicing, Complete o Custom. Attiva i flussi consigliati; potete cambiarne qualsiasi in seguito.
  3. Review fields. Per ogni flusso vedete quali campi si copiano, in che direzione e quando. L'app verifica che ogni campo sia compatibile con la sua destinazione.
  4. Duplicates. Analyze duplicates conta quali record verranno collegati (per codice fiscale o email), quali verranno creati e quali richiedono una vostra decisione. Non scrive nulla.
  5. Initial load. Scegliete quale storico portare, come (Link only, Link and fill gaps o Full load) e da quale data; prima potete simulare.
  6. Activate. Consigliamo di partire in sola lettura (solo Holded → HubSpot) per qualche giorno e poi attivare i due sensi.
Controllo dei flussi e della direzione di ciascuno nella procedura guidata
Figura 3Il controllo dei flussi e della direzione di ciascuno.

Poi, in Settings › Holded defaults scegliete la serie di numerazione di ogni tipo di documento, il conto di tesoreria, il magazzino e il canale di vendita. L'app non sceglie mai «il primo della lista» al posto vostro e non emette fatture senza una serie scelta.

4. Usare l'app

  • Le modifiche di HubSpot e di Holded si copiano in pochi secondi, nella direzione configurata. Opportunità, eventi e progetti di Holded si controllano a intervalli di pochi minuti, e ogni notte c'è un passaggio di verifica.
  • Quando una trattativa è vinta, l'app crea in Holded il documento previsto dalle impostazioni (per impostazione predefinita, una fattura in bozza). Potete anche crearlo, convertirlo, emetterlo o inviarlo dalla tab Holded della trattativa, con la proprietà Holded action o da un flusso di lavoro.
  • Le fatture emesse in Holded compaiono in HubSpot associate alla loro azienda e trattativa, con stato dell'incasso e PDF. Gli incassi aggiornano il saldo della trattativa e dell'azienda.
  • In Status vedete lo stato della sincronizzazione e gli avvisi, la coda, i casi da rivedere e l'utilizzo del piano; potete mettere tutto in pausa con un clic. Il registro attività mostra ogni modifica con il prima e il dopo, e la casella di revisione vi interpella solo quando ci sono dubbi.
Tab Status dell'app con lo stato della sincronizzazione e gli avvisi
Figura 4La tab Status: stato della sincronizzazione, avvisi e numeri a colpo d'occhio.

5. Aggiungere le schede ai record

HubSpot non mostra le schede di un'app finché non le aggiungete alla vista del record:

  1. Aprite un'azienda o un contatto e premete Customize.
  2. Modificate la vista, premete + nella barra laterale → Card library → filtrate per Apps → Holded → Add. Salvate.
  3. Nei prodotti, fate lo stesso con la scheda Holded · Stock.
  4. Per vedere saldo e scaduto senza aprire il record, aggiungete Holded · Info all'anteprima di aziende e contatti.
  5. Nelle trattative, create una tab «Holded» e aggiungete la scheda Holded by Vexco.
Scheda «Holded by Vexco» nella tab Holded di una trattativa
Figura 5La scheda «Holded by Vexco» in una trattativa.

6. Scollegare

  • Mettere in pausa: Status › Pause all. La sincronizzazione si ferma nei due sensi finché non riprendete.
  • Scollegare una società di Holded: Connection › Disconnect. Potete anche scegliere di cancellare i dati che l'app conserva di quella società (collegamenti, cronologia e impostazioni).
  • Per revocare l'accesso da Holded, eliminate la API key in Settings › Developers.
Cosa succede ai vostri dati

La sincronizzazione si ferma nei due sensi. Tutto ciò che è già in HubSpot e in Holded resta com'è; l'app non cancella nulla in nessuno dei due.

7. Disinstallare

  1. In HubSpot andate in Settings › Integrations › Connected apps.
  2. Su Holded by Vexco premete Actions › Uninstall e confermate (guida di HubSpot).
Cosa succede ai vostri dati

La sincronizzazione si ferma subito. Record, proprietà e documenti di HubSpot e di Holded restano come sono. L'app smette di usare le vostre credenziali e cancella definitivamente ciò che conserva del vostro account (chiavi cifrate, collegamenti e cronologia) dopo 30 giorni; se preferite che avvenga prima, usate Connection › Delete data and uninstall oppure scriveteci.

Dati sincronizzati

HubSpotHoldedDirezione
AziendeContatti di tipo azienda (clienti) e fornitoriNei due sensi (fornitori: Holded → HubSpot)
ContattiContatti privati e persone di contattoNei due sensi
TrattativePreventivi, proforma, ordini, DDT e fatture creati dalla trattativa; opportunità del CRM; progettiNei due sensi
Trattative (facoltativo)Preventivi, proforma, fatture e DDT di Holded, ognuno come una trattativaHolded → HubSpot
Prodotti e vociProdotti, servizi, varianti e stockHolded → HubSpot
FattureFatture, note di credito, scontrini e incassiHolded → HubSpot (incassi: nei due sensi)
OrdiniOrdini di vendita, DDT e ordini di acquistoHolded → HubSpot
RiunioniEventi del calendario del CRMHolded → HubSpot
ProprietariDipendenti (assegnazione)Sola lettura in HubSpot

Avete dubbi? Scriveteci a pau.romani@vexcosolutions.com (dal lunedì al venerdì, dalle 9 alle 18, ora di Madrid) o dalla tab Contact dell'app. Altro aiuto nella pagina del supporto.

Prova gratis

Holded e HubSpot, finalmente allineati

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.

14 giorni gratis con tutto attivo · Senza carta · Prezzi IVA esclusa