HubSpot e ERP compartilham algumas informações, mas têm papéis diferentes. O CRM conhece empresa, contatos, negócio e atividades; o ERP conhece cadastro fiscal, pedido, faturamento, estoque e recebimento.
Uma integração sustentável não tenta espelhar todos os campos. Ela sincroniza eventos de negócio e mantém associações e IDs para o usuário navegar entre os sistemas.
Modelo no HubSpot
Objetos padrão incluem companies, contacts, deals, products e line items. Associações ligam os registros e podem receber rótulos. A API de associações permite criar e consultar essas relações.
Pedidos podem ser representados em propriedades do deal ou em objeto customizado. Custom objects requerem plano Enterprise e têm esquema, propriedades e associações próprios; a arquitetura deve caber na assinatura existente.
Gatilhos por webhook
A Webhooks API assina criação, alteração de propriedade e mudança de associação em objetos do CRM. O app precisa dos escopos correspondentes e endpoint HTTPS público.
Um evento de deal ganho cria uma ordem idempotente. O backend busca propriedades e associações necessárias em vez de depender apenas do payload do webhook.
Cliente e pedido no ERP
CNPJ ou ID externo localiza o cliente. Uma matriz decide quais campos o CRM pode criar e quais só o ERP altera. Produtos usam SKU/código; line items fornecem quantidade, preço e desconto.
O adaptador chama a API suportada pelo ERP e devolve ID, número e status. Erros de cadastro aparecem numa fila com link para o deal.
Retorno operacional
Faturamento, entrega e pagamento podem atualizar o deal ou um objeto Pedido associado. Webhook do ERP é preferível quando existe; consulta incremental garante reconciliação.
Mudanças geradas pelo integrador são marcadas para não formar loop. Documento faturado não é sobrescrito por uma edição tardia do CRM.
Escopo inicial
Use uma pipeline, uma empresa do ERP e catálogo com SKUs. Comece em orçamento/pedido pendente e retorne somente número e status.
Precisamos do plano HubSpot, app, propriedades, associações, API do ERP e exemplos. Medimos tempo de passagem, cadastros duplicados, erros por campo e reconciliação.