Integração HubSpot em Portugal
Envie contactos, kits merch ligados a deals e eventos de envio entre HubSpot e Corp-Merch para Portugal — para IVA 23% via Portal das Finanças (AT).
Arquitectura — HubSpot como registo CRM
HubSpot mantém-se o sistema de registo para contactos, contas e deals; Corp-Merch consome triggers deal-driven (won/closed, renovação, promoter NPS) para enviar kits merch em Portugal. Mapeamento configurado no dashboard: stage do deal → bundle de produto → ship-to. O IVA 23% é calculado sobre a entidade de facturação da conta e facturado via AT; o id de factura volta para o deal HubSpot.
Como integrar — Workflows e API HubSpot
Instale a app Corp-Merch a partir do marketplace HubSpot; com âmbito a objectos: Contact, Account, Opportunity/Deal, mais um objecto custom 'Shipment' criado na instalação. Acções de workflow: Enviar kit merch (sync), Reenviar em falha (async com retry), Emitir factura (AT). Webhooks subscrevem deal.stage_changed e um evento sintético 'merch.fulfilled' volta à timeline HubSpot.
Operação e casos extremos — Validação de moradas, opt-outs, devoluções
A validação de moradas corre na transição de stage para os reps em Portugal verem a qualidade da morada antes de accionar um envio; opt-outs no registo do contacto são respeitados no envio. Devoluções voltam como actividades e a factura AT é creditada automaticamente. Chaves de idempotência por deal id + workflow execution id evitam duplicados.
Perguntas frequentes
Qual edição HubSpot precisamos?
Qualquer edição que suporte apps e workflows custom. Enterprise tem ambientes sandbox + produção e SSO.
Podemos manter HubSpot como fonte de verdade dos contactos?
Sim — Corp-Merch lê de HubSpot e só escreve o objecto Shipment.
Como é gerido o IVA?
O IVA 23% é calculado sobre a entidade de facturação da conta; facturas emitidas via Portal das Finanças (AT) após fulfillment.
Suportam objectos custom?
Sim — o objecto 'Shipment' é criado na instalação; estenda com campos custom que voltam do Corp-Merch.
Onde aparece o IVA 23%?
No registo do deal, no objecto Shipment e no dashboard Corp-Merch antes do push — discriminado para o finance validar.