As integrações via API do Pcontrol possibilitam registrar automaticamente as informações relacionadas às perdas de vendas, tornando o acompanhamento dos resultados mais eficiente e detalhado. Essa funcionalidade permite que dados de oportunidades encerradas sejam enviados diretamente para o Pcontrol, garantindo que cada perda seja devidamente catalogada e analisada. Com isso, a equipe comercial pode identificar padrões, compreender os principais motivos de desistência e adotar estratégias mais assertivas para reduzir perdas futuras e aprimorar o desempenho nas negociações.

1 – Acessando a API escolha a opção Negociações Perdidas na opção Encaminhar Para:

2 – Confira se a opção Negociações Perdidasestá selecionada e então clique em salvar.

3 – A Integração será salva e ela será listada na lista de integrações, atenção Código/Token gerado. Na coluna ações clique no botão detalhes, ícone de um olho.

4 – Veja o endpoint da API do Pcontrol e um código JSON de exemplo que você pode copiar e colar.

5 – Usando o Postman como plataforma de testes de API, acesse a aba Authorization e então na opção Auth Type, escolha Bearer Token.

  • Código/Token do Pcontrol é o Token que deverá ser enviado na requisição POST
  • Endpoint do Pcontrol é a URL que deverá ser usada para o envio da requisição à API do Pcontrol

6 – Cole o código JSON, no campo Body na opção RAW com JSON no tipo Text no Postman. 

7 – Na API de negociações ganhas e perdidas, o campo data_fechamento pode ser enviado, no formato ano-mes-dia, ex: 2025-10-15. Se a data não for enviada a data do envio da requisição será cadastrada como data de ganho da negociação.

8- Na requisição é também é possível enviar uma lista de produtos. Eles devem ser enviados em forma de array e devem ser enviados os códigos SKU dos produtos cadastrados no Pcontrol.

9 – Após enviar a requisição, o retorno deve ser um HTTP Status Code 200 com a mensagem “Dados enviados para fila de cadastro com sucesso”.

Atenção: O lead enviado na requisição cai em uma fila e será cadastrado no Pcontrol em alguns minutos. O cadastro não é instantâneo a partir do envio da requisição.

10 – Acessando o relatório de negociações perdidas no Pcontrol, o lead enviado é encontrado no período referente.

Úteis:

Endpoint:

https://api.pctrlx.com.br/lead/cadastrar

Código JSON:

{
"nome": "Maria Pereira",
"cnpj": "98.765.432/0001-10",
"razao_social": "Pereira Atacadista e Distribuição Ltda.",
"nome_fantasia": "Pereira Atacadista",
"email": "maria.pereira@pereiraatacado.com.br",
"telefone": 1133345566,
"celular": 11991234567,
"cep": "09120030",
"endereco": "Rua das Flores",
"numero": "820",
"complemento": "Loja 03",
"bairro": "Vila Metalúrgica",
"cidade": "São Bernardo do Campo",
"uf": "SP",
"data_fechamento": "2025-11-01",
"observacao": [
"Preferência de contato: WhatsApp",
"Atendimento: Segunda a Sexta das 08:00 às 17:00",
"Contato comercial: Costa",
"Condições de pagamento: 30/60 dias"
],
"produtos": [
"SKU-001",
"SKU-015"
],
"campos_personalizados": {
"total_funcionarios": 3,
"setor": "Atacado e Distribuição"
}
}