Skip to main content

FAQ - Webservice Importação de Despesas

 Validações do WebMethod consultarDespesas

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

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

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

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

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

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

  6. 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:

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

  2. Validação da senha da central.

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

  4. 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.

Back to top