Pular para o conteúdo
DemanderDemanderDemander Docs
Claro
Português

3. Seu aplicativo > Como cadastrar clientes via aplicativo? (PlugSales)

Este artigo visa explicar como cadastrar clientes através do aplicativo, utilizando o PlugBot para realizar a inserção correta dos dados no banco de dados.

Acessando o PlugBot

Para cadastrar clientes através do aplicativo, o processo é simples.

Primeiramente, abra o PlugBot no navegador.

Captura da tela 1

O número 8088 exibido no acesso pode variar conforme a porta definida no momento da instalação do PlugBot.

Após acessar:

  • Vá até a aba Clientes

Localize o campo de SQL livre para preenchimento

GIF demonstrativo

Nesse campo será configurado o comando SQL responsável por inserir os clientes cadastrados no aplicativo diretamente no seu banco de dados.

Configurando o SQL de inserção

No campo de SQL livre, deve ser inserida a query responsável pela inserção dos clientes.

Para que o cadastro funcione corretamente, é necessário obedecer aos parâmetros de entrada enviados pelo aplicativo, respeitando suas tipagens.

Parâmetros disponíveis

  • TIPOPESSOA Campo string que recebe o tipo de pessoa: Pessoa Física ou Pessoa Jurídica.

  • NOME Campo string que recebe o nome ou razão social do cliente.

  • CPFCNPJ Campo string que recebe o CPF ou CNPJ do cliente.

  • EMAIL Campo string que recebe o e-mail do cliente.

  • TELEFONE Campo string que recebe o telefone do cliente.

  • CEP Campo string que recebe o CEP do cliente.

  • CIDADE Campo string que recebe a cidade do cliente.

  • UF Campo string que recebe o estado (UF) do cliente.

  • ENDERECO Campo string que recebe o endereço do cliente.

  • NUMERO Campo string que recebe o número do endereço.

  • BAIRRO Campo string que recebe o bairro.

  • IDUSUARIO Campo inteiro que recebe o ID do usuário logado no aplicativo.

  • TABELAPRECO Campo inteiro que recebe o ID da tabela de preço selecionada no cadastro.

  • COMPLEMENTO Campo string que recebe o complemento do endereço.

  • INSCRICAOESTADUAL Campo string que recebe a inscrição estadual do cliente.

Exemplo de SQL de inserção

Após configurar os parâmetros corretamente, o SQL ficará semelhante ao exemplo abaixo:

INSERT INTO CLIENTES

(tipo_pessoa, razao, cnpj, email, telefone, cep, cidade, uf, endereco, id_vendedor, id_tabela_preco, complemento_end, inscricao_estadual)

VALUES

(‘[TIPOPESSOA]’, ‘[NOME]’, ‘[CPFCNPJ]’, ‘[EMAIL]’, ‘[TELEFONE]’, ‘[CEP]’, ‘[CIDADE]’, ‘[UF]’, ‘[ENDERECO]’, [IDUSUARIO], [TABELAPRECO], ‘[COMPLEMENTO]’, ‘[INSCRICAOESTADUAL]’)

Após inserir a query no campo correspondente, clique em Salvar configurações para gravar os dados.

Cadastrando clientes pelo aplicativo

Com a configuração salva, o cadastro de clientes poderá ser realizado diretamente no aplicativo PlugSales.

GIF demonstrativo

Para cadastrar:

  • Acesse a aba Clientes no aplicativo
  • Clique no botão “+” para adicionar um novo cliente
  • Preencha os campos solicitados
  • Salve o cadastro

Uma nova janela será exibida para preenchimento das informações do cliente.

Captura da tela 4

Uma nova janela será exibida para preenchimento das informações do cliente.

Campos opcionais e obrigatórios

Seção intitulada “Campos opcionais e obrigatórios”

Os campos obrigatórios para cadastro são:

  • Tipo de Pessoa
  • Nome
  • Tabela de Preço (quando essa opção estiver habilitada no PlugBot)

Os demais campos podem ser preenchidos conforme a necessidade.

Validação do cadastro

Após concluir o cadastro no aplicativo, o processo será executado automaticamente.

Para confirmar que a inserção ocorreu com sucesso:

  • Verifique o log do PlugBot
  • Procure por uma mensagem indicando a execução do SQL sem erros

Em seguida, consulte o banco de dados e confirme a inserção do novo cliente

Captura da tela 5

Se o processo ocorrer corretamente, o cliente estará disponível na base de dados e pronto para utilização no sistema.