O Pipedrive descreve o negócio e seus produtos; o ERP precisa de cliente fiscal, itens cadastrados, condição e regras de pedido. A integração fecha essa passagem sem obrigar o vendedor a repetir o trabalho.
O desenho começa definindo em qual etapa o documento pode nascer e quais mudanças posteriores ainda são permitidas.
Webhooks do deal
A API permite criar webhook para create, change ou delete em objetos como deal e product. Webhooks v2 são o padrão desde março de 2025 e a subscription_url deve ser pública, válida e sem redirecionamento.
O receptor responde rápido, registra evento e busca o deal completo. Permissões do usuário associado ao webhook influenciam quais eventos são enviados.
Produtos do negócio
DealProducts vincula produto ao deal com quantidade, preço, desconto e impostos. A API v2 lista e adiciona esses itens. O produto possui código, unidade, variações e preços em moedas.
Código do produto ou campo customizado faz o de/para com o ERP. Desconto e preço fora de regra entram em aprovação; o middleware não altera silenciosamente a negociação.
Criação e retorno
O integrador localiza organização/cliente, cria orçamento ou pedido e salva o ID do deal como referência. ID do ERP volta para campo customizado ou nota no Pipedrive.
Eventos repetidos não duplicam: a chave combina deal e versão/etapa. Alteração depois da criação atualiza apenas enquanto o estado do ERP permitir.
Conflitos
CRM é fonte da negociação antes do aceite; ERP é fonte de faturamento e entrega. Campos com donos diferentes não são sincronizados nos dois sentidos.
Produto sem código, empresa sem documento e moeda incompatível aparecem em fila. O vendedor recebe instrução específica e pode reprocessar.
Piloto
Começamos com um pipeline, uma moeda e deals com produtos. O ERP recebe orçamento pendente, reduzindo risco operacional.
Precisamos de campos, produtos, webhooks, API do ERP e negócios de amostra. O sucesso é passagem rastreável e sem redigitação, com resposta clara para exceções.