Após realizar a integração com seu banco de dados, você tem a possibilidade de habilitar seu PlugBot para começar a sincronizar seus orçamentos, ou seja, todos os orçamentos que forem criados no aplicativo serão salvos no seu banco de dados.

Primeiramente, você deve ir até a aba de Configurações ⚙, e habilitar a opção Deseja sincronizar orçamentos?

Com a opção habilitada uma nova aba Orçamento estará disponível para ser configurada.

SQL para criar novo orçamento

Essa query será executada sempre que um novo orçamento for emitido ou quando um orçamento que já foi sincronizado for alterado 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 orçamento 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 orçamento.
• 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 orçamento.
• OBSERVACAO (texto)
  • Esse parâmetro retorna as observações que o usuário pode ter feito para o orçamento.
• PRAZO_ORCAMENTO (texto)
  • Esse parâmetro retorna o prazo que o usuário pode ter feito para o orçamento.
• PAGAMENTO (número real)
  • Esse parâmetro retorna o ID da forma de pagamento selecionado no orçamento.
  • 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 orçamento.
• TOTAL_ORCAMENTO (número real)
  • Esse parâmetro retorna o valor total do orçamento.
• ORCAMENTO (número inteiro)
  • Esse parâmetro retorna o ID do orçamento salvo na Nuvem PlugMobile.
  • Caso o orçamento seja alterado, será criado um novo registro em seu banco de dados e este parâmetro poderá ser utilizado para identificar os registros que foram criados por um mesmo orçamento. 
• VERSAO (número inteiro)
  • Esse parâmetro retorna a versão do orçamento.
  • Caso seja um novo orçamento esse campo terá o valor 0.
  • Caso seja feita uma alteração no orçamento, esse campo será incrementado. 
• 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.
• 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 orçamento.
• 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 orçamento.

Veja abaixo um exemplo de SQL para a inserção de orçamentos:

/* Exemplo em um banco MySQL */
INSERT INTO orcamentos(id_orcamento, id_usuario, id_cliente, data, hora, observacao, prazo_pedido, tipo_operacao, pagamento, valor_desconto, total_pedido, versao) VALUES ('[ORCAMENTO]', [USUARIO], [CLIENTE], '[DATA]', '[HORA]', '[OBSERVACAO]', '[PRAZO_ORCAMENTO]', '[TIPO_OPERACAO]', [PAGAMENTO], '[VALOR_DESCONTO]', '[TOTAL_ORCAMENTO]', [VERSAO])

SQL para consultar ID_ORCAMENTO do novo orçamento

Essa query será utilizada para buscar o ID do último orçamento inserido e utilizar para adicionar os itens desse orçamento.

O retorno dessa query deve ser um único registro com a propriedade ID_PEDIDO.

/* 
Exemplo em um banco MySQL 
Considerando que a tabela orcamentos tenha uma coluna id de tipo numérico com auto increment.
*/
SELECT id AS ID_ORCAMENTO FROM orcamentos ORDER BY id DESC LIMIT 1

SQL para inserir itens ao orçamento

Essa query será utilizada para inserir os itens do orçamento.

Parâmetros enviados pelo aplicativo:

• ID_ORCAMENTO (número inteiro)
  • Esse campo deve informar o ID do orçamento que o item pertence.
• PRODUTO (número inteiro)
  • Esse campo deve informar o ID do produto que esse item se refere.
• QUANTIDADE (número inteiro)
  • 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 à partir dos 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.

Veja abaixo um exemplo de SQL para a inserção de itens:

/* Exemplo em um banco MySQL */
INSERT INTO itens_orcamento (id_orcamento, id_produto, quantidade, valor_unit, valor_desc, valor_total, observacao, tabela_preco) VALUES ([ID_ORCAMENTO], [PRODUTO], [QUANTIDADE], [VALOR_UNITARIO], [VALOR_DESCONTO], [VALOR_TOTAL], '[OBSERVACAO]', [TABELA_PRECO])

SQL para atualizar orçamento que foi excluído

Caso algum orçamento seja excluído no aplicativo, essa query será executada para que possa atualizar o orçamento com essa informação.

Parâmetros enviados pelo aplicativo:

• ID_ORCAMENTO (número inteiro)
  • Esse campo deve informar o ID do orçamento que foi excluído.

/* Exemplo em um banco MySQL */
UPDATE orcamentos SET observacao = 'DESCARTADO' WHERE id = [ID_ORCAMENTO]