Quando CRM e ERP não conversam, o vendedor fecha no HubSpot e alguém redigita cliente, produtos e condição no Omie. Depois, faturamento e pagamento não voltam para o comercial, que perde contexto da conta.
A integração deve definir propriedade de cada dado. HubSpot organiza relacionamento e negociação; Omie mantém cadastro operacional, pedido, fiscal e financeiro. Sincronizar tudo nos dois sentidos cria conflito.
Evento de entrada
Um webhook do HubSpot pode avisar quando o negócio muda para ganho. O integrador busca negócio, empresa, contatos, produtos e line items associados, valida campos obrigatórios e cria uma ordem de processamento idempotente.
Antes de criar, procura o cliente no Omie por código de integração ou CNPJ. Atualizações cadastrais seguem uma matriz de autoridade: por exemplo, razão social fiscal vem do ERP, enquanto cargo do contato permanece no CRM.
Produtos e pedido
Produtos do HubSpot e Omie precisam de uma chave comum. Nome não é chave. SKU ou código de integração associa line item ao produto, e preço, quantidade, desconto e condição passam pelas tolerâncias aprovadas.
A API Omie oferece clientes, produtos e pedidos de venda. O pedido recebe a identificação do negócio HubSpot; o negócio recebe o identificador Omie, criando rastreabilidade sem depender de busca por texto.
Retorno ao HubSpot
Mudanças relevantes do Omie — pedido criado, faturado, cancelado ou recebido — atualizam propriedades do negócio ou um objeto específico. Webhook Omie ou consulta incremental pode iniciar esse retorno, conforme o evento disponível.
O HubSpot permite objetos customizados e associações, mas objetos customizados dependem do plano Enterprise. Em planos menores, propriedades do negócio e atividades podem ser suficientes; essa limitação precisa entrar no desenho.
Conflito e duplicidade
Cada direção tem campos autorizados. Uma alteração no HubSpot depois do pedido criado pode abrir solicitação, em vez de sobrescrever documento em processamento. Reenvio de webhook usa o ID do negócio e a versão para não duplicar.
Falhas aparecem em fila com ação: CNPJ inválido, produto sem de/para, cliente duplicado ou condição inexistente. Corrigir e reprocessar não exige mudar o negócio de etapa outra vez.
Piloto
Comece por uma pipeline, uma empresa Omie e negócios com catálogo padronizado. Deixe proposta personalizada, múltiplas moedas e alterações pós-faturamento para uma fase posterior.
Precisamos de propriedades HubSpot, associações, exemplos de negócios ganhos, cadastros Omie e política de autoridade. O sucesso é eliminar redigitação sem retirar o controle de faturamento do ERP.