As integrações via API do Pcontrol permitem registrar automaticamente as informações de vendas concluídas com sucesso, garantindo que cada ganho seja contabilizado e acompanhado em tempo real. Essa automação facilita a atualização do funil comercial, elimina tarefas manuais e assegura maior precisão nos dados registrados. Além disso, possibilita uma visão mais clara sobre o desempenho das equipes e os resultados alcançados, auxiliando na análise de indicadores, na tomada de decisões estratégicas e na otimização dos processos de vendas.

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

2 – Confira se a opção Negociações Ganhas está 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 ganhas no Pcontrol, o lead enviado é encontrado no período referente.

Úteis:

Endpoint:

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

Código JSON:

{
"nome": "João da Silva",
"cnpj": "12.345.678/0001-95",
"razao_social": "Silva Comércio Ltda.",
"nome_fantasia": "Silva Comércio",
"email": "joao.silva@silvacomercio.com.br",
"telefone": 1133224455,
"celular": 11998877666,
"cep": "09010010",
"endereco": "Avenida Portugal",
"numero": "150",
"complemento": "Sala 502",
"bairro": "Centro",
"cidade": "Santo André",
"uf": "SP",
"data_fechamento": "2025-10-15",
"observacao": [
"Contato preferencial: e-mail",
"Horário de atendimento: 09:00-18:00",
"Responsável financeiro: Maria Oliveira",
"Cliente desde 2023"
],
"produtos": [
"SKU-001",
"SKU-015",
"SKU-RETAIL-02"
],
"campos_personalizados": {
"total_funcionarios": 25,
"setor": "Comércio varejista"
}
}