3. Erros de inserção no PlugSales
Este guia apresenta os principais erros de inserção que podem impedir o funcionamento correto do PlugSales/PlugBot e como identificar e corrigir cada um deles.
Erros de inserção no PlugSales
Seção intitulada “Erros de inserção no PlugSales”Erro de sintaxe SQL
Seção intitulada “Erro de sintaxe SQL”O erro de sintaxe é um dos mais comuns. Ele ocorre quando há algum caractere ou comando incorreto na query SQL.
Um exemplo simples é a presença de um “;” antes da palavra VALUES, que já é suficiente para impedir a inserção de um cliente, pedido ou orçamento.
Ao encontrar esse erro:
- Verifique se a sintaxe do INSERT está correta.
- Confira se não há caracteres indevidos.
- Certifique-se de que valores string estejam entre aspas simples (‘’).
- Campos numéricos não devem conter aspas.
Se tiver dificuldade em localizar o erro, copie a query e execute diretamente no banco de dados. Muitos SGBDs indicam exatamente onde está o erro, facilitando a correção.
Erro de data type (tipo de dados)
Seção intitulada “Erro de data type (tipo de dados)”Erros de tipo de dados também são bastante comuns e geralmente ocorrem quando o tipo de informação enviada não corresponde ao tipo do campo no banco.
Cada parâmetro do PlugBot retorna um tipo específico de dado. Essa informação pode ser visualizada ao posicionar o mouse sobre o parâmetro no PlugBot.
Verifique se:
- Campos string estão sendo inseridos em campos string.
- Campos numéricos estão sendo inseridos em campos INT, FLOAT ou similares.
- Datas estão no formato esperado pelo banco.
Uma forma simples de validar é copiar a query e executá-la diretamente no banco de dados.
Parâmetros utilizados
Seção intitulada “Parâmetros utilizados”Outro ponto importante é validar se a quantidade de parâmetros corresponde à quantidade de campos informados no INSERT.
Exemplo:
- 8 campos informados
- 9 parâmetros enviados
Isso causará erro de inserção.
Verifique também:
- Se os nomes dos parâmetros estão corretos
- Se não há erros de digitação
- Se os parâmetros personalizados estão configurados corretamente
Importante: Os parâmetros devem sempre ser descritos em letras maiúsculas.
Campos do banco de dados
Seção intitulada “Campos do banco de dados”Erros de digitação no nome dos campos também são comuns. Por isso, valide:
- Se o campo realmente existe no banco
- Se o nome está escrito corretamente
- Se o campo corresponde ao valor que será inserido
Campos string e tamanho de caracteres
Seção intitulada “Campos string e tamanho de caracteres”Em campos do tipo string (VARCHAR), é comum ocorrer erro quando o tamanho do valor enviado é maior que o permitido pelo campo.
Exemplo: Se um campo é varchar(20), ele suporta no máximo 20 caracteres. Se a query tentar inserir um valor com mais de 20 caracteres, ocorrerá erro.
Outro exemplo:
- Campo UF no banco: varchar(2)
- Valor enviado: “PARANÁ” (6 caracteres)
Isso gerará erro de inserção.
Para corrigir:
-
Ajuste o tamanho do campo no banco de dados ou
-
Utilize SUBSTRING para enviar apenas a quantidade permitida de caracteres
Condições especiais do banco
Seção intitulada “Condições especiais do banco”Alguns bancos possuem regras adicionais, como:
- Campos NOT NULL obrigatórios
- Procedures de inserção
- Triggers automáticas
- Validações internas
Nesses casos, é necessário verificar se todos os dados obrigatórios estão sendo enviados corretamente.
Caso alguma informação esteja faltando, adapte o SQL de inserção para atender todas as exigências da tabela ou função executada.
Se, após essas validações, o erro persistir, recomendamos executar a query diretamente no banco de dados para identificar com mais precisão a causa e realizar os ajustes necessários.