Introdução
Esta tela permite registrar, consultar, importar via CSV e visualizar detalhes dos Vouchers utilizados nos processos de entrega de pedidos.
Um voucher representa o controle individual de entregas feitas por motorista e veículo para um determinado cliente.
Funcionalidades Principais
| Funcionalidade | Descrição |
|---|---|
| Registrar Voucher | Cadastro manual ou via importação (arquivo CSV). |
| Importar CSV | Inserção rápida de múltiplos vouchers. |
| Filtrar Período | Pesquisar vouchers emitidos entre duas datas. |
| Visualizar Detalhes | Abrir um modal com as informações completas de um voucher. |
| Auditar Logs | Consultar histórico de alterações no voucher. |
| Excluir Voucher | Remover registros incorretos diretamente da lista. |
Campos do Voucher
| Campo | Descrição |
|---|---|
| ID | Identificador interno do voucher. |
| Voucher | Número de controle fornecido pelo cliente ou sistema. |
| Cliente | Nome do cliente associado à entrega. |
| Entrega | Data da entrega. |
| Motorista | Nome do motorista responsável pela entrega. |
| Veículo | Identificação do veículo usado. |
| Chegada | Hora de chegada no local. |
| Saída | Hora de saída do local. |
| Quantidade | Volume entregue. |
| Unitário | Valor unitário negociado (não exibido para Motorista/Entregador). |
| Total | Valor total da entrega (não exibido para Motorista/Entregador). |
| Pedido | Número do pedido vinculado ao voucher (se existir). |
Tipos de Usuário e Acessos
| Perfil | Permissões |
|---|---|
| Administrador/Comercial | Cadastra, edita, visualiza valores financeiros, importa CSV. |
| Motorista/Entregador | Apenas cadastra vouchers básicos sem valores financeiros. |
Modais Disponíveis
- Lançar Voucher: Cadastro de novo voucher individual.
- Upload CSV: Envio de múltiplos vouchers de uma vez.
- Detalhes do Voucher: Consulta rápida dos dados sem sair da página.
- Logs de Alteração: Consulta das últimas 90 alterações nos vouchers.
Comportamentos Inteligentes
- Cliente selecionado ativa a verificação automática da necessidade de informar forma de pagamento.
- Produto selecionado traz automaticamente o preço da tabela especial do cliente.
- Quantidade alterada recalcula o total baseado no preço vigente do produto para o cliente.
- Validação de Data: Ao sair do campo, bloqueia datas fora do intervalo permitido (entre hoje e 60 dias atrás).
Importação de Arquivo CSV
- Formato esperado:
.csv - Campos obrigatórios no CSV:
- Cliente
- Voucher
- Data
- Motorista
- Veículo
- Produto
- Quantidade
- Valores (caso o usuário tenha permissão)
- Após importação, exibe alertas de sucesso ou erro.
Observações Técnicas
- Utiliza Select2 para selects com busca dinâmica.
- Utiliza DataTables para a listagem paginada e responsiva.
- Validação adicional com Jquery Validation e SweetAlert2 para alertas mais amigáveis.
✅ Após salvar ou importar vouchers, o sistema atualiza a tabela automaticamente para facilitar o acompanhamento das entregas.