Mapeando seu primeiro pedido com PlugSales – Central de Atendimento

< Antes Próximo >

Para realizar pedidos através do PlugSales, é necessário realizar o mapeamento das operações. Essas operações são realizadas diretamente pelo PlugBot em seu sistema de dados (banco ou arquivos texto), e são elas:

Inserir o novo pedido;
Consultar ID do novo pedido;
Inserir itens ao novo pedido.

Nota: Se você ainda não mapeou os outros recursos do PlugSales, sugerimos que leia os seguintes artigos antes de prosseguir o mapeamento dos Pedidos:
- Como mapear usuários?
- Como mapear produtos?
- Como mapear clientes?
- Como mapear formas de pagamento?
- Como mapear dados financeiros?
- Como mapear comissões?

Para iniciar a configuração dessas operações, você deve acessar a aba de PEDIDO.

SQL para criar novo pedido

Essa SQL será executada sempre que um novo pedido for emitido pelo aplicativo PlugSales e o mesmo for enviado para a Nuvem PlugMobile (caso tenha conexão com a internet).

Para que a inserção do novo pedido seja realizada corretamente, o SQL deve receber os parâmetros enviados do aplicativo.

Parâmetros enviados pelo aplicativo:

USUARIO (número inteiro)
- Esse parâmetro retorna o ID do usuário que está emitindo o pedido (vendedor).
- O ID retornado será o mesmo informado na aba de USUÁRIO.
CLIENTE (número inteiro)
- Esse parâmetro retorna o ID do cliente selecionado no pedido.
- O ID retornado neste parâmetro será o mesmo informado na aba CLIENTE.
DATA (texto)
- Esse parâmetro retorna a data do pedido no formato AAAA-MM-DD.
- A data retornada neste parâmetro será de acordo com a data selecionada no pedido.
HORA (texto)
- Esse parâmetro retorna a hora do pedido no formato HH:MM.
- A hora retornada neste parâmetro será de acordo com a hora selecionada no pedido.
OBSERVACAO (texto)
- Esse parâmetro retorna as observações que o usuário pode ter feito para o pedido.
PRAZO_PEDIDO (texto)
- Esse parâmetro retorna o prazo do pedido definido pelo vendedor na hora da venda.
PAGAMENTO (número real)
- Esse parâmetro retorna o ID da forma de pagamento selecionado no pedido.
- O ID retornado neste parâmetro será o mesmo informado na aba FORMA DE PAGAMENTO.
VALOR_DESCONTO (número real)
- Esse parâmetro retorna o valor de desconto concedido para este pedido.
TOTAL_PEDIDO (número real)
- Esse parâmetro retorna o valor total do pedido.
TABELAPRECO (número inteiro) (OPCIONAL)
- Caso você utilize tabelas de preço, este parâmetro retorna o ID da tabela de preço selecionada no momento da emissão do pedido.
TIPO_OPERACAO (número inteiro) (OPCIONAL)
- Caso você utilize tipo de operação, este parâmetro retorna o ID da operação selecionada no momento da emissão do pedido.
CONDICAO_PAGAMENTO (número inteiro) (OPCIONAL)
- Caso você utilize condições de pagamento, este parâmetro retorna o ID da condição de pagamento selecionada no momento da emissão do orçamento.
NOVO_SALDO (número real) (OPCIONAL)
- Caso utilize saldo para controle de descontos dos usuários, este parâmetro irá disponibilizar o saldo atualizado do vendedor após realizar um pedido.
- O valor do saldo será o mesmo configurado em SALDO POR USUÁRIO.

Como esses parâmetro são enviados do aplicativo PlugSales para o seu PlugBot, a SQL que você informar para inserir o novo pedido tem acesso a eles.

Você pode utilizá-los para armazenar essas informações no seu banco de dados. Veja abaixo um exemplo de SQL para inserção de um novo pedido:

/* Exemplo em um banco MySQL */
INSERT INTO TbPedidos (id_usuario, id_cliente, data_pedido, hora, observacao, id_forma_pagamento, valor_desconto, valor_total_pedido, id_tabela_preco) values ([USUARIO], [CLIENTE], '[DATA]', '[HORA]', '[OBSERVACAO]', [PAGAMENTO], [VALOR_DESCONTO], [TOTAL_PEDIDO], [TABELAPRECO])

Nota: os parâmetros que são do tipo texto devem ser colocados entre "aspas" (ou 'apóstrofo', dependendo da sintaxe do seu banco de dados) e caso seja identificado nesses parâmetros os caracteres especiais ' " | \ , quebras de linha ou emojis , os mesmos serão removidos para evitar conflitos com algum meio de integração.

Tem como adicionar campos personalizados no momento de fazer um pedido?

"SQL para consultar ID_PEDIDO do novo pedido"

Após o PlugBot ter inserido o novo pedido no seu banco, é necessário saber o ID desse pedido para que seja possível adicionar os itens utilizando o mesmo valor no ID do pedido.

Para isso, informe o SQL que retorna o ID do último pedido inserido. O retorno desse SQL precisa ser um registro com uma coluna: "ID_PEDIDO".

Em situações em que o ID da tabela de pedidos é um campo numérico com auto increment, o SQL poderia ser:

/* Exemplo em um banco MySQL */
SELECT id AS ID_PEDIDO FROM TbPedidos ORDER BY id DESC LIMIT 1

"SQL para inserir itens ao pedido"

Com o pedido inserido no banco e seu ID em mãos, chegou o momento do PlugBot receber os itens desse pedido e inserí-los no banco.

Para isso, a SQL tem acesso aos seguintes parâmetros que são enviados do aplicativo:

ID_PEDIDO (número inteiro)
- Esse campo deve informar o ID do pedido que o item pertence.
PRODUTO (número inteiro)
- Esse campo deve informar o ID do produto que esse item se refere.
QUANTIDADE (numérico)
- Esse campo deve informar a quantidade pedida desse produto.
VALOR_UNITARIO (número real)
- Esse campo deve informar o preço unitário do produto do item.
VALOR_DESCONTO (número real)
- Esse campo deve informar o valor de desconto concedido a esse item.
VALOR_TOTAL (número real)
- Esse campo deve informar o valor total desse item, que é obtido a partir do valor unitário, valor de desconto e quantidade comprada.
OBSERVACAO (texto)
- Esse campo deve informar as observações desse produto.
TABELA_PRECO (número inteiro) (OPCIONAL)
- Caso você utilize tabelas de preço com a possibilidade de escolher produtos de diferentes tabelas, esse campo deve informar o ID da tabela de preço que esse item se refere.
ID_OPCAO (número inteiro) (OPCIONAL)
- Caso utilize opções de produto, esse campo deve informar o ID da opção escolhida sobre o produto que será adicionado, configurado em OPÇÕES PARA PRODUTOS.
ID_GRADE (número inteiro) (OPCIONAL)
- Caso utilize tabelas de grade de produtos, esse campo deve informar o ID da grade escolhida sobre o produto que será adicionado, configurado em GRADE DE PRODUTOS.

A SQL executada para essa função poderia ser a seguinte:

/* Exemplo em um banco MySQL */
INSERT INTO TbItensPedido (id_pedido, id_produto, qtde, vlr_unit, vlr_desc, vlr_total, observacao, tabela_preco) VALUES ([ID_PEDIDO], [PRODUTO], [QUANTIDADE], [VALOR_UNITARIO], [VALOR_DESCONTO], [VALOR_TOTAL], '[OBSERVACAO]', [TABELA_PRECO])