HubSpot integration in Spain
Push contacts, deal-driven merch and shipment events between HubSpot and Corp-Merch for Spain — built around VAT 21% via FACe/SII.
Architecture — HubSpot as the CRM record
HubSpot stays the system of record for contacts, accounts and deals; Corp-Merch consumes deal-driven triggers (won/closed, renewal, NPS promoter) to send merch kits in Spain. The mapping is configured in the dashboard: deal stage → product bundle → ship-to. VAT 21% is computed against the account billing entity and invoiced via FACe/SII; the invoice id is pushed back to the HubSpot deal record.
How to wire it up — Workflows and the HubSpot API
Install the Corp-Merch app from the HubSpot marketplace; scope it to objects: Contact, Account, Opportunity/Deal, plus a custom Object 'Shipment' that we create on install. Workflow actions: Send merch kit (sync), Resend on failure (async with retry), Issue invoice (FACe/SII). Webhooks subscribe to deal.stage_changed and a synthetic 'merch.fulfilled' event posts back to the HubSpot timeline.
Operations and edge cases — Address validation, opt-outs, returns
Address validation runs at deal-stage transition so reps in Spain see address quality before triggering a shipment; opt-outs from the contact record are honoured at send-time. Returns post back as activities and the FACe/SII invoice is credited automatically. Idempotency keys derived from deal id + workflow execution id prevent duplicates.
FAQ
Which edition of HubSpot do we need?
Any edition that supports custom apps and workflows. Enterprise gets sandbox + production environments and SSO.
Can we keep HubSpot as the source of truth for contacts?
Yes — Corp-Merch reads from HubSpot and only writes the shipment object back.
How are taxes handled?
VAT 21% is computed against the account billing entity; invoices are issued via FACe/SII after fulfillment.
Do you support custom objects?
Yes — the 'Shipment' object is created on install; you can extend it with custom fields and they will flow back from Corp-Merch.
Where is VAT 21% shown?
On the deal record, on the Shipment object, and in the Corp-Merch dashboard before push — itemised so finance can validate.