Pacote do Protheus
O CRM serve a configuração da integração, versionada com o código: o Protheus pergunta se há versão nova, e o ajuste vai para todos sem patch em cada cliente.
integrações
O CRM conversa com o seu ERP e com o resto da empresa
Chave de API para o ERP ler e gravar, webhooks para avisar na hora quem precisa saber, e o estoque e os preços do ERP valendo dentro do pedido.
Uma chave de API para o ERP
A chave vale para todas as rotas de integração: lembretes, notas fiscais e títulos, e o que o ERP envia — empresas, contatos, produtos, preços, categorias, vendedores, estoque, pedidos, tarefas e ligações.
- O segredo aparece uma única vez; o banco guarda só o hash. A lista mostra quem criou e o último uso, e a chave é revogável.
- Chamadas idempotentes pelo código do registro no ERP: repetir atualiza em vez de duplicar.
- Leitura incremental, por consulta, paginada por cursor, só do que mudou desde a última vez.
- Documentação OpenAPI/Swagger própria.
O CRM como força de vendas
O vendedor lança o pedido no CRM, o ERP o lê e devolve o número que deu a ele. O pedido lançado no ERP chega ao CRM pelo mesmo caminho.
- Pedido com número do ERP é um pedido integrado; o ERP lê tudo, inclusive arquivados, filtrando por etapa e por alteração.
- Dá para impedir que a tela altere um pedido já integrado. A integração do ERP nunca é travada.
- Tarefas e ligações também vão e voltam, ligadas ao pedido pelo código do ERP.
- Pagamento não passa pelo pedido: o recebimento é o título, atualizado pelo ERP.
Estoque que vem do ERP
O saldo é do ERP. O CRM calcula o que ainda dá para vender, descontando os pedidos em andamento que o ERP ainda não viu.
- Três políticas — só informar, avisar no pedido ou bloquear acima do saldo — na organização e em cada produto, que também pode não controlar.
- Saldo velho, acima do limite de horas, não barra o pedido; com o controle desligado, nada é exibido nem barrado.
- Quem edita o produto corrige o saldo à mão, e o próximo envio do ERP o substitui.
- O portal mostra “Disponível” ou “Indisponível” e, se a organização quiser, a quantidade.
Preço mínimo e tabelas de preço
O tipo de preço é a tabela de preço do ERP. Cada preço de produto pode ter mínimo, oferta e o código da linha no ERP.
- Venda abaixo do mínimo é permitida ou não, por tipo de preço. Onde não é, o pedido recusa o item.
- Oferta com preço promocional e último dia opcional, por tipo de preço.
- O ERP mantém os tipos de preço e os preços por API.
- A integração do ERP nunca é barrada pelo mínimo: o pedido dele já foi aprovado lá.
Vendedores e códigos do ERP
Quem vendeu é um cadastro próprio: serve a comissão e a meta, e nem todo vendedor precisa ter login.
- Com ou sem usuário (há representante externo), com comissão, meta mensal e código do ERP.
- O pedido guarda o vendedor separado do responsável. Criar sem vendedor usa o vendedor ativo de quem cria.
- Vendedor não amplia a visibilidade de pedidos: o escopo de cada papel continua mandando.
- Código do ERP em contatos, empresas, produtos, categorias, tipos de preço e vendedores, único por organização.
Webhooks por objeto e operação
O CRM avisa um endereço quando algo é incluído, alterado ou excluído. Você escolhe o objeto, a operação, a autenticação e vê ao lado o JSON que será enviado.
- Oito objetos: empresas, contatos, produtos, cards (pedidos), notas fiscais, títulos, tarefas e ligações.
- Mais de um webhook por operação, cada um com a sua fila, o seu log e a sua assinatura.
- Autenticação nenhuma, Basic, Bearer ou cabeçalho à escolha; os segredos ficam cifrados.
- Na alteração, o evento leva o registro e o estado anterior, e dá para enviar só quando certos campos mudarem.
Envio confiável, e com prova
Cada evento entra numa fila e cada tentativa fica no log, com o JSON enviado, o status e o começo da resposta.
- Assinatura HMAC-SHA256 com carimbo de tempo em cada envio: o destino recusa um envio velho ou repetido.
- Falhou? Novas tentativas depois de 1, 5 e 15 minutos. Depois disso, o evento fica como falho, e dá para reenviar um ou todos de uma vez.
- O reenvio sai com o mesmo id e o mesmo JSON, para o destino deduplicar.
- Falhas seguidas demais desativam o webhook sozinho, e o limite é configurável. O log guarda 30 dias.
Mais do que a lista de rotas
O que acontece em volta da integração, para ela não virar um projeto de TI sem fim.
Notas e títulos por API
O ERP envia notas com as parcelas, e as baixas dadas à mão não somem. O XML da NF-e também entra por API, para o cliente certo.
Categorias de produto
Idempotentes pelo código do ERP: sem categoria-mãe é categoria, com ela é subcategoria. O produto aponta para a categoria pelo mesmo código.
Só endereço público
Webhook para rede interna é recusado ao salvar e ao enviar, com a mesma guarda das consultas de CNPJ e CEP.