Integración HubSpot en España
Envía contactos, kits merch impulsados por deals y eventos de envío entre HubSpot y Corp-Merch para España — con IVA 21% vía FACe/SII (AEAT).
Arquitectura — HubSpot como registro CRM
HubSpot se mantiene como sistema de registro para contactos, cuentas y deals; Corp-Merch consume triggers deal-driven (won/closed, renovación, promoter NPS) para enviar kits merch en España. El mapping se configura en el dashboard: stage del deal → bundle de producto → ship-to. El IVA 21% se calcula sobre la entidad de facturación de la cuenta y se factura vía FACe/SII; el id de factura vuelve al registro del deal en HubSpot.
Cómo integrarlo — Workflows y API de HubSpot
Instala la app Corp-Merch desde el marketplace de HubSpot; con alcance a objetos: Contact, Account, Opportunity/Deal, más un custom Object 'Shipment' que creamos en la instalación. Acciones de workflow: Enviar kit merch (sync), Reenviar en fallo (async con retry), Emitir factura (FACe/SII). Los webhooks se suscriben a deal.stage_changed y un evento sintético 'merch.fulfilled' vuelve a la timeline HubSpot.
Operación y casos límite — Validación de direcciones, opt-outs, devoluciones
La validación de direcciones se ejecuta al cambiar de stage, así los reps en España ven la calidad de la dirección antes de disparar un envío; los opt-outs del registro de contacto se respetan al enviar. Las devoluciones vuelven como actividades y la factura FACe/SII se abona automáticamente. Las claves de idempotencia por deal id + workflow execution id evitan duplicados.
Preguntas frecuentes
¿Qué edición de HubSpot necesitamos?
Cualquier edición que soporte custom apps y workflows. Enterprise tiene entornos sandbox + producción y SSO.
¿Podemos mantener HubSpot como fuente de verdad de contactos?
Sí — Corp-Merch lee de HubSpot y solo escribe el objeto Shipment.
¿Cómo se gestiona el IVA?
El IVA 21% se calcula sobre la entidad de facturación de la cuenta; las facturas se emiten vía FACe/SII tras el fulfillment.
¿Soportáis custom objects?
Sí — el objeto 'Shipment' se crea en la instalación; extiéndelo con campos custom y se devuelven desde Corp-Merch.
¿Dónde se ve el IVA 21%?
En el registro del deal, en el objeto Shipment y en el dashboard Corp-Merch antes del push — desglosado para que finanzas valide.