Integrazione HubSpot in Italia
Invia contatti, kit merch deal-driven ed eventi di spedizione tra HubSpot e Corp-Merch per l'Italia — pensato per IVA 22% via SdI.
Architettura — HubSpot come record CRM
HubSpot resta il sistema di record per contatti, account e deal; Corp-Merch consuma trigger deal-driven (won/closed, rinnovo, promoter NPS) per inviare kit merch in Italia. La mappatura è in dashboard: stage deal → bundle prodotto → ship-to. L'IVA 22% è calcolata sull'entità di fatturazione dell'account e fatturata via SdI; l'id fattura torna sul deal HubSpot.
Come integrarlo — Workflow e API HubSpot
Installa l'app Corp-Merch dal marketplace HubSpot; ambito agli oggetti: Contact, Account, Opportunity/Deal, più un oggetto custom 'Shipment' che creiamo all'installazione. Azioni di workflow: Invia kit merch (sync), Reinvia su errore (async con retry), Emetti fattura (SdI). I webhook si iscrivono a deal.stage_changed e un evento sintetico 'merch.fulfilled' torna nella timeline HubSpot.
Operatività e casi limite — Validazione indirizzi, opt-out, resi
La validazione indirizzi gira al cambio di stage deal così i rep in Italia vedono la qualità dell'indirizzo prima di triggerare una spedizione; gli opt-out dal record contatto sono rispettati a invio. I resi tornano come attività e la fattura SdI viene stornata automaticamente. Chiavi di idempotenza da deal id + workflow execution id evitano duplicati.
Domande frequenti
Quale edizione HubSpot serve?
Qualsiasi edizione che supporti app e workflow custom. Enterprise ha ambienti sandbox + production e SSO.
Possiamo tenere HubSpot come fonte di verità contatti?
Sì — Corp-Merch legge da HubSpot e scrive solo l'oggetto Shipment.
Come è gestita l'IVA?
L'IVA 22% è calcolata sull'entità di fatturazione dell'account; le fatture sono emesse via SdI dopo il fulfillment.
Supportate oggetti custom?
Sì — l'oggetto 'Shipment' è creato all'installazione; estendilo con campi custom e li riportiamo da Corp-Merch.
Dove si vede l'IVA 22%?
Sul record deal, sull'oggetto Shipment e nella dashboard Corp-Merch prima del push — voce per voce così finance può validare.