FAQ - Webservice Integração - Importação de Despesas

 Validações do WebMethod consultarDespesas 

 Este método realiza as seguintes validações: 

 

 

 Verificação da senha da central (obrigatória). 

 

 

 Verificação da existência do cliente com base em CPF/CNPJ, senha e ID da central. 

 

 

 Validação do formato e existência da placa do veículo (se fornecida). 

 

 

 Validação da data inicial (formato válido e existência). 

 

 

 Validação da data final (formato válido e existência). 

 

 

 Caso algum dos dados esteja incorreto, mensagens de erro específicas são retornadas. 

 

 

 

 Perguntas Frequentes – WebMethod  consultarDespesas 

 1. O que acontece se a senha da central estiver incorreta no método consultarDespesas ? Será retornado um erro indicando "Senha inválida". 

 2. O que significa o erro "cliente com CPF/CNPJ não cadastrado"? Indica que o CPF/CNPJ informado não está registrado na central ou que a senha está incorreta. 

 3. Posso omitir a placa do veículo na consulta de despesas? Sim. A placa é opcional. Se não for informada, as despesas serão listadas para todos os veículos do cliente. 

 4. O que acontece se eu informar a placa do veículo em um formato inválido? Será retornado o erro "Veiculo de placa XXX não é válido. Informe a placa no formato XXX-NNNN". 

 5. Quais formatos de data são aceitos no consultarDespesas ? Apenas o formato yyyy-MM-dd é aceito. Datas em outros formatos gerarão erro. 

 6. O que acontece se a data inicial for inválida? Será retornada a mensagem "Data inicial inválida". 

 7. E se a data final estiver incorreta ou nula? Será retornado erro: "Data final inválida". 

 8. O método consultarDespesas valida o vínculo entre cliente e veículo? Sim, ele valida se a placa informada está associada ao cliente autenticado. 

 9. Se a placa estiver correta, mas não pertencer ao cliente, o que ocorre? Será retornado erro dizendo que o veículo não é válido. 

 10. O método consultarDespesas retorna despesas para um intervalo de datas? Sim, todas as despesas entre a data inicial e final informadas são retornadas. 

 11. E se não houver nenhuma despesa no intervalo? O método retorna sucesso, porém com a lista de despesas vazia. 

 12. O método pode lançar erro geral? Sim, em casos de falhas internas, será retornado "Erro Geral do Consulta de Despesas". 

 13. Preciso do CNPJ completo com formatação? Sim, o método espera o CNPJ no formato xx.xxx.xxx/xxxx-xx . 

 14. O método consultarDespesas valida a senha do cliente? Sim, a senha do cliente é obrigatória e validada junto ao CPF/CNPJ. 

 15. Posso usar CPF no lugar do CNPJ? Sim, o método aceita tanto CPF quanto CNPJ, desde que válidos e cadastrados. 

 

 Validações do WebMethod  importarDespesas 

 Este método realiza as seguintes validações detalhadas: 

 

 

 Verificação se a lista de despesas foi enviada e contém ao menos um item. 

 

 

 Validação da senha da central. 

 

 

 Verificação da existência do cliente com CPF/CNPJ e senha. 

 

 

 Para cada despesa: 

 

 

 Condutor preenchido 

 

 

 Data preenchida e válida 

 

 

 Hora preenchida e válida 

 

 

 Nome informado 

 

 

 Odômetro > 0 

 

 

 Placa do veículo informada 

 

 

 Quantidade preenchida 

 

 

 Tipo ou tipo genérico informado 

 

 

 Valor informado 

 

 

 Tipo de combustível informado se for abastecimento externo 

 

 

 Tipo de combustível compatível com o veículo 

 

 

 Quantidade de combustível dentro da capacidade do tanque 

 

 

 Odômetro e horímetro coerentes com as despesas anteriores/posteriores 

 

 

 Fornecedor com CNPJ/CPF válido, nome (caso for cadastrar), e existente ou a ser cadastrado corretamente 

 

 

 

 

 

 Perguntas Frequentes – WebMethod  importarDespesas 

 1. O que acontece se a lista de despesas estiver vazia no importarDespesas ? Será retornado erro: "A lista de despesas deve conter pelo menos um elemento." 

 2. Como é validado o condutor? O método exige que o campo de condutor esteja preenchido em cada despesa. 

 3. Preciso informar a data da despesa? Sim. A data é obrigatória e deve estar no formato válido. 

 4. E se a hora estiver em formato incorreto? Será retornado erro: "Hora inválida da despesa X". 

 5. Qual o erro se o nome da despesa estiver ausente? Erro: "Informe o NOME da despesa X". 

 6. Posso registrar uma despesa com odômetro igual a zero? Não. O campo deve ser maior que zero para ser aceito. 

 7. A placa do veículo é obrigatória na importação? Sim. Deve ser informada e válida para cada despesa. 

 8. O que ocorre se a quantidade for nula? Será retornado erro indicando que a quantidade da despesa deve ser informada. 

 9. E se eu esquecer de preencher o tipo da despesa? Erro: "Informe o TIPO da despesa X". 

 10. Como funciona a validação de tipo de combustível? Se for abastecimento externo, o tipo de combustível deve ser informado, compatível com o veículo e dentro da capacidade do tanque. 

 11. O que acontece se o tipo de combustível não for compatível? Erro: "Combustível não compatível com o veículo da despesa X". 

 12. O método importarDespesas verifica odômetro com despesas anteriores? Sim. O sistema impede valores inferiores aos das despesas anteriores e superiores aos das posteriores. 

 13. Posso importar despesas com fornecedor novo? Sim, desde que esteja marcado para cadastrar e com CNPJ/CPF e nome preenchidos corretamente. 

 14. O que acontece se o CPF ou CNPJ do fornecedor for inválido? Erro: "CPF ou CNPJ inválido do Fornecedor da despesa X". 

 15. O método pode lançar erro geral? Sim, será retornado "Erro Geral do Importador de Despesas" com detalhes do problema.