Menu - Frotas - Controle de Estoque


Controle de Estoque - Categoria de Peças/Produtos

Visão Geral

O módulo de Categorias de Produtos faz parte do sistema de gerenciamento de frota da plataforma CONCEPT RASTREAMENTO. Este módulo permite aos usuários organizar seus produtos em categorias lógicas, facilitando a navegação, busca e gerenciamento do inventário. Para acessar a opção utilize o menu FROTAS e a seção CONTROLE DE ESTOQUE e  opção CATEGORIAS DE PEÇAS.

Interface do Usuário

Tela de Pesquisa (Lista de Categorias)

A tela principal apresenta um layout organizado em duas seções principais:

  1. Seção de Filtros: Localizada na parte superior, permite refinar a busca de categorias.
  2. Tabela de Resultados: Exibe as categorias encontradas com suas informações principais.

Elementos da Tela de Pesquisa

Tela de Edição/Cadastro

A tela de edição/cadastro permite criar novas categorias ou modificar categorias existentes.

Elementos da Tela de Edição/Cadastro

Funcionalidades e Regras de Negócio

Pesquisa de Categorias

Cadastro de Categorias

Exclusão de Categorias

Controle de Acesso

Fluxo de Trabalho

Pesquisar Categorias

  1. Acesse a tela de listagem de categorias
  2. Opcional: Preencha os campos de filtro por nome e/ou descrição
  3. Clique no botão de pesquisa (ícone de lupa)
  4. Os resultados serão exibidos na tabela abaixo
  5. Para limpar os filtros, clique no botão "Limpar Filtros"

Criar Nova Categoria

  1. Na tela de listagem, clique no botão "Novo" (ícone de mais)
  2. Preencha o campo "Nome" (obrigatório)
  3. Opcional: Preencha o campo "Descrição"
  4. Clique no botão "Gravar"
  5. Se todos os campos obrigatórios estiverem preenchidos, a categoria será criada e você retornará à tela de listagem
  6. Se houver erros de validação, eles serão exibidos no topo da tela

Editar Categoria Existente

  1. Na tela de listagem, clique na linha da categoria que deseja editar
  2. A tela de edição será aberta com os dados da categoria selecionada
  3. Modifique os campos desejados
  4. Clique no botão "Gravar"
  5. Se todos os campos obrigatórios estiverem preenchidos, as alterações serão salvas e você retornará à tela de listagem

Excluir Categoria

  1. Na tela de listagem, clique na linha da categoria que deseja excluir
  2. Na tela de edição, clique no botão "Excluir"
  3. O sistema verificará se existem produtos associados a esta categoria
  4. Se não houver produtos associados, a categoria será excluída e você retornará à tela de listagem
  5. Se houver produtos associados, uma mensagem de erro será exibida informando a impossibilidade de exclusão

Exportar para CSV

  1. Na tela de listagem, aplique os filtros desejados (opcional)
  2. Clique no botão "Exportar para CSV" (ícone de salvar)
  3. O sistema gerará um arquivo CSV com os dados exibidos na tabela
  4. O arquivo será baixado automaticamente com o nome "CategoriaProduto.csv"

Detalhes Técnicos (Invisíveis para o Usuário)

A interface se comunica com o backend através de endpoints REST específicos que executam operações CRUD (Create, Read, Update, Delete) nas categorias de produtos. Os dados são transmitidos usando o formato URL-encoded e as respostas são processadas em formato JSON.

As operações são autenticadas e verificadas contra as permissões do usuário atual, utilizando o ID do cliente e da empresa armazenados no estado da aplicação.

Perguntas Frequentes

1. Por que não consigo excluir uma categoria?

As categorias que possuem produtos associados não podem ser excluídas. Você precisa primeiro remover ou reclassificar todos os produtos associados a essa categoria antes de poder excluí-la.

2. Como sei quantos produtos estão associados a uma categoria?

Ao tentar excluir uma categoria com produtos associados, o sistema exibirá uma mensagem informando a quantidade de produtos vinculados.

3. É possível mover produtos de uma categoria para outra?

Sim, isso é possível através do módulo de gerenciamento de produtos. Selecione o produto desejado, edite suas informações e altere a categoria associada.

4. Quais filtros posso usar para encontrar uma categoria específica?

Você pode filtrar as categorias pelo nome e/ou pela descrição. Basta preencher os campos correspondentes na seção de filtros e clicar no botão de pesquisa.

5. Quem pode criar novas categorias no sistema?

Apenas usuários com permissões de gravação ou capacidade Master podem criar, editar ou excluir categorias. Se você não tem acesso a essas funcionalidades, entre em contato com o administrador do sistema.

6. Por que vejo o botão "Excluir" cinza (desabilitado)?

O botão "Excluir" só fica ativo para categorias já existentes (que possuem um ID) e quando o usuário tem permissões adequadas. Se você está criando uma nova categoria, este botão não estará disponível.

7. Como exportar apenas algumas categorias para CSV?

Utilize os filtros disponíveis para restringir a lista de categorias apenas àquelas que deseja exportar. Em seguida, clique no botão "Exportar para CSV". Apenas as categorias exibidas na tabela serão incluídas no arquivo exportado.

Controle de Estoque - Peças/Produtos

Descrição da Interface

O módulo apresenta uma interface para gerenciamento de produtos no controle de estoque de uma frota e faz parte do sistema de gerenciamento de frota da plataforma CONCEPT RASTREAMENTO. A interface está em português brasileiro e segue um design claro e organizado, com uma barra lateral de navegação escura à esquerda e área principal de trabalho à direita. A interface permite pesquisar, visualizar, criar, editar e excluir produtos do estoque. Para acessar a opção utilize o menu FROTAS e a seção CONTROLE DE ESTOQUE e  opção PEÇAS.

Elementos da Interface

Tela de Pesquisa (Peças)

Seção de Filtros

Botões de Ação

Tabela de Resultados

Tela de Cadastro/Edição (Peça)

Seção de Erros

Formulário Principal

Botões de Ação

Tabela de Depósitos

Propósito e Fluxo de Trabalho

Este módulo permite o gerenciamento completo de produtos no sistema de controle de estoque. O fluxo de trabalho típico inclui:

  1. Pesquisa de produtos: O usuário pode filtrar a lista de produtos por código, nome ou categoria.
  2. Visualização de produtos: Os resultados são exibidos em uma tabela com informações essenciais.
  3. Criação de novo produto: O usuário pode adicionar novos produtos preenchendo o formulário.
  4. Edição de produto: Ao selecionar um produto na tabela, o usuário pode editar suas informações.
  5. Exclusão de produto: Produtos podem ser excluídos, desde que não tenham movimentações associadas.
  6. Exportação de dados: Os dados podem ser exportados para CSV para análise externa.

Instruções Passo a Passo

Como Pesquisar Produtos

  1. Acesse a tela de pesquisa de produtos.
  2. Na seção "Filtros", preencha um ou mais campos de filtro (Código, Nome, Categoria).
  3. Clique no botão de pesquisa (ícone de lupa).
  4. Os resultados serão exibidos na tabela abaixo.
  5. Para limpar os filtros, clique no botão "Limpar Filtros" (ícone de arquivo).

Como Criar um Novo Produto

  1. Na tela de pesquisa, clique no botão "Novo" (ícone de adição).
  2. No formulário, preencha os campos obrigatórios:
    • Selecione uma categoria da lista suspensa
    • Digite um nome para o produto
    • Selecione uma unidade de medida
  3. Preencha os campos opcionais conforme necessário:
    • Código do produto
    • Descrição
    • Estoque mínimo
    • Estoque máximo
  4. Confirme se o produto deve estar ativo marcando a checkbox "Ativo?".
  5. Clique no botão "Gravar" para salvar o novo produto.
  6. Se houver erros de validação, corrija os campos indicados e tente gravar novamente.

Como Editar um Produto Existente

  1. Na tela de pesquisa, localize o produto desejado utilizando os filtros.
  2. Clique na linha do produto na tabela para abrir a tela de edição.
  3. Modifique os campos desejados. Note que o "Estoque Atual" não pode ser editado diretamente.
  4. Clique no botão "Gravar" para salvar as alterações.
  5. Para retornar à tela de pesquisa sem salvar, clique no botão "Voltar".

Como Excluir um Produto

  1. Na tela de pesquisa, localize e selecione o produto desejado.
  2. Na tela de edição, clique no botão "Excluir".
  3. Confirme a exclusão quando solicitado.
  4. Note que produtos com movimentações associadas não podem ser excluídos. O sistema exibirá uma mensagem de erro neste caso.

Como Exportar Dados para CSV

  1. Na tela de pesquisa, defina os filtros desejados para obter os registros a exportar.
  2. Clique no botão "Exportar Para CSV" (ícone de salvar).
  3. O arquivo será gerado com o nome "Produto.csv" e disponibilizado para download.

Validações e Regras de Negócio

  1. Campos Obrigatórios:

    • Categoria
    • Nome
    • Unidade de Medida

  2. Validações de Estoque:

    • O estoque mínimo não pode ser superior ao estoque máximo
    • O estoque atual é calculado automaticamente com base nas movimentações

  3. Exclusão de Produtos:

    • Produtos com movimentações associadas não podem ser excluídos
    • O sistema verifica a quantidade de movimentações antes de permitir a exclusão

  4. Permissões de Acesso:

    • As ações de gravar e excluir são controladas por permissões de usuário
    • Usuários com capacidade "Master" têm acesso completo
    • Outros usuários dependem das permissões do seu grupo

  5. Depósitos:

    • O sistema registra a quantidade de produto em cada depósito
    • O estoque atual total é a soma das quantidades em todos os depósitos

Perguntas Frequentes

O que significa o campo "Unidade de Medida"?

A unidade de medida define como a quantidade do produto é mensurada (ex: unidade, metro, litro, quilo). Este campo é obrigatório e ajuda a padronizar as medições no sistema.

Por que não consigo excluir um produto?

Produtos que possuem movimentações associadas (entradas, saídas, transferências) não podem ser excluídos. O sistema impede a exclusão para manter a integridade do histórico de estoque.

Como ajustar o estoque atual de um produto?

O estoque atual é calculado automaticamente com base nas movimentações. Para ajustar o estoque, é necessário registrar uma movimentação (entrada ou saída) no módulo de movimentação de estoque.

O que acontece se o estoque ficar abaixo do mínimo?

O sistema não impede que o estoque fique abaixo do mínimo, mas esta informação pode ser utilizada para relatórios de reposição e alertas de estoque baixo.

Como organizar produtos por categoria?

Primeiro, é necessário cadastrar as categorias no módulo de categorias. Depois, ao criar ou editar um produto, selecione a categoria apropriada no campo "Categoria".

Qual a diferença entre excluir um produto e desativá-lo?

Desativar um produto (desmarcando "Ativo?") mantém o registro no sistema, mas indica que não está mais em uso. A exclusão remove completamente o produto do sistema, mas só é possível se não houver movimentações associadas.

Como funciona a exportação para CSV?

A exportação gera um arquivo CSV com os dados dos produtos exibidos na tabela. Se filtros estiverem aplicados, apenas os registros filtrados serão exportados. O arquivo usa ponto-e-vírgula (;) como separador.

Por que o estoque está distribuído em depósitos?

O sistema permite controlar o estoque em múltiplos locais físicos (depósitos). Isso é útil para empresas com várias unidades ou que precisam rastrear a localização exata dos produtos.

Controle de Estoque - Compras

Introdução

O módulo de Compras de Peças faz parte do sistema de gerenciamento de frota da plataforma CONCEPT RASTREAMENTO, permitindo o registro, acompanhamento e controle de todas as compras de peças e produtos relacionados à manutenção de veículos e equipamentos. Este módulo integra-se com o controle de estoque, fornecedores e pagamentos, oferecendo uma visão completa do ciclo de aquisição de materiais. Para acessar a opção utilize o menu FROTAS e a seção CONTROLE DE ESTOQUE e  opção COMPRAS DE PEÇAS.

Interface e Elementos

Tela Principal de Listagem

A tela principal apresenta uma lista de compras de peças já registradas no sistema, com as seguintes áreas:

Seção de Filtros

Tabela de Resultados

Tela de Cadastro/Edição

A tela de cadastro/edição de compras é dividida em seções:

Dados Principais

Botões de Ação

Seção de Itens

Modal de Adição de Item

Modal de Parcelas (quando pagamento parcelado)

Fluxo de Trabalho

Processo de Compra de Peças

  1. Pesquisa e Visualização:

    • O usuário pode iniciar pesquisando compras existentes usando os filtros disponíveis
    • Por padrão, o sistema exibe as compras do mês atual
    • É possível visualizar detalhes clicando em uma linha da tabela

  2. Cadastro de Nova Compra:

    • O usuário clica no botão "Novo" na tela de listagem
    • Seleciona o fornecedor e o depósito (ambos obrigatórios)
    • Informa o valor total, data de entrada e opcionalmente a nota fiscal
    • Define se o pagamento será à vista ou parcelado
    • Se for à vista, informa a data de pagamento
    • Se for parcelado, adiciona as parcelas no modal específico

  3. Adição de Itens:

    • Clica no botão "+" na seção de itens
    • Seleciona a peça no modal
    • Informa quantidade e valor unitário
    • Confirma a inclusão
    • Repete o processo para cada item necessário

  4. Finalização:

    • Verifica se todos os dados obrigatórios foram preenchidos
    • Clica em "Gravar" para salvar a compra
    • O sistema atualiza o estoque automaticamente

Instruções Passo a Passo

Como Cadastrar uma Nova Compra

  1. Na tela de listagem, clique no botão "+" (Novo)
  2. Selecione o fornecedor no dropdown (ou adicione um novo clicando no botão "+")
  3. Selecione o depósito onde as peças serão armazenadas
  4. Informe o valor total da compra
  5. Defina a data de entrada da compra
  6. Caso seja pagamento à vista, informe a data de pagamento
  7. Se for pagamento parcelado:
    • Marque a opção "Pagamento Parcelado"
    • Clique em "Ver Parcelas"
    • Para cada parcela:
      • Informe a data prevista de pagamento
      • Digite o valor da parcela
      • Se já foi paga, informe a data de pagamento
      • Clique em "+" para adicionar
  8. Informe o número da nota fiscal (se disponível)
  9. Adicione observações se necessário
  10. Para adicionar itens:
    • Clique no botão "+" na seção de itens
    • Selecione a peça no dropdown
    • Informe a quantidade e o valor unitário
    • Clique em "Inserir" ou "Inserir e Limpar"
    • Repita para cada item
  11. Clique em "Gravar" para salvar a compra

Como Filtrar Compras

  1. Na tela de listagem, preencha os filtros conforme necessário:
    • Nome do fornecedor (total ou parcial)
    • Selecione o tipo de data (entrada ou pagamento)
    • Defina o período inicial e final
    • Escolha o status de pagamento (Pagas, Não Pagas ou Todas)
  2. Clique no botão de pesquisa (ícone de lupa)
  3. A tabela será atualizada com os resultados correspondentes
  4. Para limpar os filtros, clique no botão "Limpar Filtros"

Como Editar uma Compra Existente

  1. Na tela de listagem, localize a compra desejada
  2. Clique sobre a linha correspondente
  3. A tela de edição será aberta com os dados da compra
  4. Realize as alterações necessárias
  5. Para editar itens:
    • Para remover, clique no ícone de lixeira do item
    • Para adicionar novos, use o botão "+" na seção de itens
  6. Para editar parcelas (se for pagamento parcelado):
    • Clique em "Ver Parcelas"
    • Altere os valores, datas ou adicione novas parcelas
  7. Clique em "Gravar" para salvar as alterações

Como Excluir uma Compra

  1. Na tela de listagem, localize a compra desejada
  2. Clique sobre a linha correspondente
  3. Na tela de edição, clique no botão "Excluir"
  4. Confirme a exclusão quando solicitado

Validações e Regras de Negócio

O sistema implementa as seguintes validações e regras de negócio:

Campos Obrigatórios

Regras Específicas

Perguntas Frequentes

Como cadastrar um novo fornecedor durante o registro de uma compra?

Na tela de cadastro de compra, ao lado do campo Fornecedor, clique no botão "+" para abrir o modal de cadastro de fornecedor. Preencha os dados necessários e confirme para adicionar o novo fornecedor, que ficará imediatamente disponível para seleção.

O valor total da compra precisa ser igual à soma dos itens?

Não necessariamente. O valor total da compra é informado manualmente e pode incluir outros custos como frete ou impostos que não estão diretamente associados aos itens. É importante que o valor total represente o montante efetivamente pago ao fornecedor.

Como registrar o pagamento de uma parcela após a compra já ter sido cadastrada?

Localize a compra na tela de listagem, clique para editar, e se for uma compra parcelada, clique em "Ver Parcelas". Na lista de parcelas, encontre a que deseja marcar como paga, informe a data de pagamento no campo correspondente e salve as alterações.

É possível alterar uma compra de pagamento à vista para parcelado após o cadastro?

Sim, ao editar uma compra, você pode marcar a opção "Pagamento Parcelado" e então cadastrar as parcelas. O sistema removerá a data de pagamento única e solicitará o cadastro das parcelas.

Como o sistema atualiza o estoque quando uma compra é registrada?

Quando uma compra é gravada, o sistema automaticamente adiciona as quantidades dos itens ao estoque do depósito selecionado. Se a compra for alterada, o sistema ajusta as diferenças. Se for excluída, as quantidades são removidas do estoque.

Por que não consigo excluir uma compra?

Existem algumas razões possíveis:

Como exportar a lista de compras para análise externa?

Na tela de listagem, aplique os filtros desejados para encontrar as compras que deseja exportar. Em seguida, clique no botão "Exportar para CSV" (ícone de disquete). O sistema gerará um arquivo CSV com os dados exibidos na tabela.

É possível registrar compras parceladas com datas diferentes para cada parcela?

Sim, ao cadastrar um pagamento parcelado, cada parcela pode ter sua própria data prevista de pagamento e, quando paga, sua própria data efetiva de pagamento. Isso permite um controle detalhado do fluxo de caixa.

Considerações Adicionais

O módulo de Compras de Peças é integrado com outros componentes do sistema, como:

A interface foi projetada para ser intuitiva e eficiente, facilitando o registro rápido de compras e permitindo um controle detalhado dos gastos com peças e produtos para a frota.

Controle de Estoque - Depósito de Peças/Produtos

1. Descrição da Interface

O módulo apresenta uma interface para gerenciamento de depósitos de produtos, que faz parte do sistema de gerenciamento de frota da plataforma CONCEPT RASTREAMENTO. A interface é dividida em duas telas principais: uma tela de listagem de depósitos (com filtros e uma tabela de resultados) e uma tela de edição/criação de depósitos (com campos para inserção de dados e lista de produtos associados ao depósito).

A interface possui um design limpo e intuitivo, com um menu de navegação vertical à esquerda e o conteúdo principal ocupando a maior parte da tela. Os elementos visuais incluem cartões (cards) que agrupam funcionalidades relacionadas, campos de entrada de dados, botões de ação e tabelas para exibição de informações. Para acessar a opção utilize o menu FROTAS e a seção CONTROLE DE ESTOQUE e  opção DEPÓSITO DE PEÇAS.

2. Elementos da Interface

Tela de Listagem (Depósitos de Peças)

Seção de Filtros

Tabela de Resultados

Tela de Edição (Depósito de Peças)

Seção de Dados do Depósito

Seção de Produtos no Depósito

Seção de Validação

3. Propósito e Fluxo de Trabalho

Propósito

O sistema serve para gerenciar depósitos de produtos (peças) utilizados na manutenção de uma frota de veículos. Permite criar, editar, listar e excluir depósitos, além de visualizar os produtos armazenados em cada depósito e suas respectivas quantidades.

Fluxo de Trabalho Principal

  1. Listagem de Depósitos:

    • O usuário visualiza todos os depósitos cadastrados
    • Pode aplicar filtros para encontrar depósitos específicos
    • Pode criar um novo depósito ou selecionar um existente para edição

  2. Criação/Edição de Depósito:

    • O usuário preenche ou altera os dados do depósito (nome, opção de desconsiderar saldo)
    • Se estiver editando um depósito existente, pode visualizar os produtos associados e suas quantidades
    • Ao salvar, o sistema valida os dados e exibe mensagens de erro se necessário
    • Ao excluir, o sistema verifica se não há produtos associados antes de permitir a exclusão

  3. Exclusão de Depósito:

    • O usuário só pode excluir um depósito se não houver produtos associados a ele
    • O sistema exibe uma mensagem de erro se a exclusão não for possível

4. Instruções Passo a Passo

Como Consultar Depósitos

  1. Acesse a tela de listagem de depósitos
  2. (Opcional) Preencha os filtros desejados:
    • Digite um nome ou parte do nome no campo "Nome"
    • Marque a opção "Desconsiderar Saldo" se desejar filtrar por essa característica
  3. Clique no botão de pesquisa (ícone de lupa)
  4. Visualize os resultados na tabela abaixo
  5. Para limpar os filtros, clique no botão com ícone de arquivo

Como Criar um Novo Depósito

  1. Na tela de listagem, clique no botão "Novo" (ícone de adição)
  2. Na tela de edição, preencha o campo "Nome" (obrigatório)
  3. (Opcional) Marque a opção "Desconsiderar Saldo" se necessário
  4. Clique no botão "Gravar" para salvar o novo depósito
  5. Se houver algum erro de validação, corrija-o e tente novamente
  6. Após salvar com sucesso, o sistema retornará à tela de listagem

Como Editar um Depósito Existente

  1. Na tela de listagem, clique na linha do depósito que deseja editar
  2. Na tela de edição, altere os campos desejados:
    • Modifique o nome do depósito
    • Marque ou desmarque a opção "Desconsiderar Saldo"
  3. Visualize os produtos associados ao depósito na tabela inferior
  4. Clique no botão "Gravar" para salvar as alterações
  5. Para retornar sem salvar, clique no botão "Voltar"

Como Excluir um Depósito

  1. Na tela de listagem, clique na linha do depósito que deseja excluir
  2. Na tela de edição, clique no botão "Excluir"
  3. O sistema verificará se é possível excluir o depósito:
    • Se não houver produtos associados, o depósito será excluído
    • Se houver produtos associados, o sistema exibirá uma mensagem de erro
  4. Após a exclusão bem-sucedida, o sistema retornará à tela de listagem

Como Exportar a Lista de Depósitos para CSV

  1. Na tela de listagem, aplique os filtros desejados (opcional)
  2. Clique no botão "Exportar para CSV" (ícone de salvar)
  3. O sistema gerará um arquivo CSV com os dados exibidos na tabela
  4. O arquivo será nomeado como "DepositoPecas.csv"

5. Regras de Negócio

  1. Validação de Nome:

    • O campo "Nome" é obrigatório para todos os depósitos
    • Se o usuário tentar salvar um depósito sem nome, o sistema exibirá uma mensagem de erro

  2. Exclusão de Depósito:

    • Um depósito só pode ser excluído se não houver produtos associados a ele
    • O sistema verifica a quantidade de produtos associados antes de permitir a exclusão
    • Se houver produtos associados, o sistema exibe uma mensagem informando a quantidade de produtos que impedem a exclusão

  3. Desconsiderar Saldo:

    • A opção "Desconsiderar Saldo" permite que o depósito seja usado sem considerar o saldo dos produtos para fins de cálculos ou reservas

  4. Permissões de Acesso:

    • As ações de gravar e excluir só estão disponíveis para usuários com permissão de gravação ou capacidade master
    • O sistema verifica as permissões do usuário logado antes de habilitar os botões correspondentes

  5. Visualização de Produtos:

    • O sistema exibe automaticamente todos os produtos associados ao depósito na tabela de produtos
    • A quantidade de cada produto é mostrada na coluna "QTD"

6. Perguntas Frequentes

O que significa a opção "Desconsiderar Saldo"?

A opção "Desconsiderar Saldo" indica que o depósito não será considerado nos cálculos de saldo de estoque. Isso pode ser útil para depósitos temporários, depósitos de manutenção ou outros casos especiais onde os produtos não devem afetar o saldo total disponível.

Por que não consigo excluir um depósito?

Não é possível excluir um depósito que possua produtos associados. Isso acontece para manter a integridade dos dados, já que os produtos precisam estar sempre associados a um depósito. Para excluir o depósito, primeiro transfira ou remova todos os produtos associados a ele.

Como posso ver quantos produtos existem em um depósito?

Ao acessar a tela de edição de um depósito, a tabela na parte inferior exibirá todos os produtos associados ao depósito e suas respectivas quantidades.

É possível transferir produtos entre depósitos?

Esta funcionalidade não está disponível diretamente nesta tela. Para transferir produtos entre depósitos, é necessário utilizar a função de movimentação de estoque disponível em outra parte do sistema.

Os usuários têm permissões diferentes para gerenciar depósitos?

Sim, o sistema possui controle de permissões. Apenas usuários com permissão de gravação ou capacidade master podem criar, editar ou excluir depósitos. Todos os usuários podem visualizar a lista de depósitos e seus detalhes.

Como faço para exportar a lista de depósitos?

Na tela de listagem, clique no botão "Exportar para CSV" (ícone de salvar). O sistema exportará todos os depósitos exibidos na tabela para um arquivo CSV chamado "DepositoPecas.csv".

Posso filtrar os depósitos por algum critério específico?

Sim, a tela de listagem oferece filtros por nome e pela opção "Desconsiderar Saldo". Preencha os campos desejados e clique no botão de pesquisa para aplicar os filtros.

7. Fluxos de Exceção

Tentativa de Salvar sem Nome

  1. Usuário tenta salvar um depósito sem preencher o campo "Nome"
  2. Sistema exibe mensagem de erro: "Nome obrigatório"
  3. Usuário deve corrigir o erro e tentar novamente

Tentativa de Excluir Depósito com Produtos

  1. Usuário tenta excluir um depósito que possui produtos associados
  2. Sistema verifica a quantidade de produtos associados
  3. Sistema exibe mensagem de erro: "Não é possível remover o depósito, pois existe(m) X produto(s) associado(s)."
  4. Usuário deve remover os produtos do depósito antes de tentar excluí-lo novamente

Erro de Autenticação

  1. Se a sessão do usuário expirar durante as operações
  2. Sistema identifica código 99 na resposta
  3. Sistema redireciona automaticamente para a tela de login

Erro no Servidor

  1. Se ocorrer qualquer erro no servidor durante as operações
  2. Sistema captura o erro e registra no log
  3. Sistema exibe uma mensagem genérica: "Erro ao [operação] depósito"

8. Considerações Adicionais

Controle de Estoque - Movimentação

Descrição da Interface

O mídulo apresentado é uma interface para gerenciamento de movimentação de estoque e faz parte do sistema de gerenciamento de frota da plataforma CONCEPT RASTREAMENTO. A aplicação permite controlar a transferência de produtos entre depósitos e veículos, com diferentes tipos de movimentações possíveis. A interface possui um design limpo e organizado, com áreas bem definidas para filtros de busca, visualização de registros em formato de tabela e formulários para cadastro/edição. Para acessar a opção utilize o menu FROTAS e a seção CONTROLE DE ESTOQUE e  opção MOVIMENTAÇÃO DE ESTOQUE.

Elementos da Interface

Tela de Pesquisa de Movimentações

Cabeçalho:

Seção de Filtros:

Botões de Ação (na seção de filtros):

Tabela de Resultados:

Rodapé da Tabela:

Tela de Cadastro/Edição de Movimentação

Cabeçalho:

Seção Principal:

Botões de Ação (na seção principal):

Seção de Itens da Movimentação:

Modal de Inserção de Item:

Propósito e Fluxo de Trabalho

O sistema de Movimentação de Estoque tem como propósito controlar o fluxo de produtos entre depósitos e veículos em uma empresa de gestão de frotas. Ele permite registrar diferentes tipos de operações como aquisições, transferências, saídas, baixas e retornos.

Fluxo Principal:

  1. Pesquisa de Movimentações:

    • O usuário acessa a tela de pesquisa onde pode aplicar filtros como período, tipos de movimentação, produtos, depósitos ou veículos
    • Ao clicar em pesquisar, o sistema exibe os resultados na tabela
    • Os registros podem ser exportados para CSV ou selecionados para visualização/edição

  2. Cadastro de Nova Movimentação:

    • O usuário clica no botão "Novo" na tela de pesquisa
    • Seleciona o tipo de movimentação desejado
    • Dependendo do tipo selecionado, campos específicos são exibidos ou ocultados
    • Preenche a data e outros campos necessários
    • Adiciona um ou mais itens (produtos) à movimentação
    • Confirma a operação clicando em "Gravar"

  3. Visualização de Movimentação:

    • Ao selecionar um registro na tabela de resultados, o sistema redireciona para a tela de detalhes
    • Os dados são exibidos em modo de visualização, não permitindo alterações em registros já gravados

Instruções Passo a Passo

Como Pesquisar Movimentações

  1. Acesse a tela de "Movimentações de Estoque"
  2. Configure os filtros desejados:
    • Selecione depósitos de origem/destino (opcional)
    • Escolha veículos de origem/destino (opcional)
    • Selecione um produto específico (opcional)
    • Defina o tipo de movimentação (opcional)
    • Configure o período de pesquisa (por padrão, o mês atual)
  3. Clique no botão com ícone de lupa (Pesquisar)
  4. Os resultados serão exibidos na tabela abaixo

Como Cadastrar uma Nova Movimentação

  1. Na tela de pesquisa, clique no botão com ícone de "+" (Novo)
  2. Selecione o tipo de movimentação desejado
  3. Preencha a data da movimentação
  4. Dependendo do tipo selecionado, preencha os campos adicionais:
    • Para "MOVIMENTAÇÃO": selecione depósito origem e depósito destino
    • Para "SAÍDA PARA VEÍCULO": selecione depósito origem e veículo destino
    • Para "RETIRADA DO VEÍCULO": selecione veículo origem e depósito destino
    • Para "AQUISIÇÃO": apenas data e observação são necessários
  5. Adicione itens à movimentação:
    • Clique no botão "+" na seção "Itens da movimentação"
    • Selecione o produto desejado
    • Informe a quantidade
    • Clique em "Inserir" ou "Inserir e Limpar" para adicionar mais itens
  6. Preencha uma observação se necessário
  7. Clique em "Gravar" para salvar a movimentação

Como Exportar Dados para CSV

  1. Na tela de pesquisa, configure os filtros desejados e realize a pesquisa
  2. Clique no botão com ícone de disquete (Exportar para CSV)
  3. O arquivo será gerado e baixado automaticamente

Regras de Negócio e Validações

Com base nos códigos analisados, as seguintes regras de negócio e validações são aplicadas:

  1. Tipos de Movimentação:

    • MOVIMENTAÇÃO: Transferência entre depósitos físicos
    • SAÍDA: Saída de produto de um depósito
    • RETIRADA: Retirada de produto de um veículo para um depósito
    • BAIXA: Baixa de produto no estoque
    • SAÍDA PARA VEÍCULO: Transferência de um depósito para um veículo
    • RETIRADA DO VEÍCULO: Transferência de um veículo para um depósito
    • AQUISIÇÃO: Entrada de novos produtos no estoque
    • ALTERAÇÃO DE COMPRA: Ajustes em registros de compra

  2. Validações Obrigatórias:

    • Tipo de movimentação é obrigatório
    • Data da movimentação é obrigatória
    • Depósito de origem é obrigatório quando o tipo é MOVIMENTAÇÃO, SAÍDA ou BAIXA
    • Depósito de destino é obrigatório quando o tipo é MOVIMENTAÇÃO ou RETIRADA
    • Veículo de origem é obrigatório quando o tipo é RETIRADA
    • Veículo de destino é obrigatório quando o tipo é SAÍDA
    • Pelo menos um item deve ser adicionado à movimentação

  3. Validações de Negócio:

    • Não é permitido que o depósito de origem seja igual ao depósito de destino
    • O produto movimentado deve existir no depósito de origem
    • A quantidade movimentada não pode ser maior que o saldo disponível no depósito de origem
    • Ao selecionar um veículo como origem ou destino, o sistema verifica/cria automaticamente um depósito associado ao veículo

  4. Comportamentos Específicos:

    • Os campos são exibidos/ocultados dinamicamente de acordo com o tipo de movimentação selecionado
    • Na pesquisa de veículos, é possível filtrar por placa, marca, modelo ou condutor
    • O sistema carrega por padrão as movimentações do mês atual
    • Registros já cadastrados não podem ser alterados, apenas visualizados
    • Ao buscar produtos disponíveis para movimentação, o sistema filtra apenas os que existem no depósito de origem selecionado

Perguntas Frequentes

1. Como faço para transferir produtos entre depósitos?

Para transferir produtos entre depósitos, selecione o tipo de movimentação "MOVIMENTAÇÃO", escolha o depósito de origem e o depósito de destino, adicione os produtos que deseja transferir com suas respectivas quantidades e clique em "Gravar".

2. Como registro a retirada de produtos de um veículo?

Selecione o tipo de movimentação "RETIRADA DO VEÍCULO", escolha o veículo de origem e o depósito de destino, adicione os produtos que estão sendo retirados do veículo com suas respectivas quantidades e clique em "Gravar".

3. Por que não consigo visualizar alguns produtos ao tentar adicionar itens?

Os produtos exibidos dependem do depósito de origem selecionado. Apenas produtos com saldo disponível naquele depósito são mostrados. Verifique se o depósito selecionado possui os produtos desejados.

4. Como faço para registrar a entrada de novos produtos no estoque?

Selecione o tipo de movimentação "AQUISIÇÃO", escolha o depósito de destino, adicione os produtos adquiridos com suas respectivas quantidades e clique em "Gravar".

5. É possível alterar uma movimentação já registrada?

Não, uma vez que a movimentação é gravada, ela não pode ser alterada. Caso seja necessário corrigir algum erro, deve-se registrar uma nova movimentação compensatória.

6. Por que recebo o erro "O estoque atual não é suficiente"?

Este erro ocorre quando a quantidade que você está tentando movimentar é maior que o saldo disponível no depósito de origem. Verifique o saldo atual no depósito e ajuste a quantidade a ser movimentada.

7. Como posso ver o histórico de movimentações de um produto específico?

Na tela de pesquisa, selecione o produto desejado no filtro "Peça" e clique em pesquisar. Serão exibidas todas as movimentações relacionadas àquele produto no período especificado.

8. É possível transferir produtos diretamente entre veículos?

Não diretamente. Para transferir produtos entre veículos, é necessário primeiro retirar os produtos do veículo de origem para um depósito (usando "RETIRADA DO VEÍCULO") e depois transferir do depósito para o veículo de destino (usando "SAÍDA PARA VEÍCULO").

9. Como pesquiso movimentações de um período específico?

Na tela de pesquisa, configure o intervalo de datas nos campos de "Período" (data início e data fim) e clique em pesquisar.

10. Como identifico veículos na lista de seleção?

Os veículos são identificados pela placa, modelo e, quando disponível, por um rótulo adicional. A lista exibe estas informações e permite pesquisar por qualquer um destes dados.

Controle de Estoque - Peças em Veículos

Descrição da Interface

O modulo apresenta uma interface para gerenciamento de peças e produtos em veículos da frota e faz parte do sistema de gerenciamento de frota da plataforma CONCEPT RASTREAMENTO. A interface segue um padrão visual consistente com cores predominantemente azuis e brancas, com um menu lateral escuro à esquerda. A solução permite gerenciar o estoque de peças distribuídas entre os diferentes veículos da frota, facilitando o controle logístico dos recursos. Para acessar a opção utilize o menu FROTAS e a seção CONTROLE DE ESTOQUE e  opção PEÇAS EM VEÍCULOS.

Elementos da Interface

Tela de Pesquisa (Peças por Veículos)

Seção de Filtros

Tabela de Resultados

Tela de Detalhes (Peças por Veículo)

Seção de Identificação

Tabela de Peças do Veículo

Propósito e Fluxo de Trabalho

O propósito desta interface é permitir o gerenciamento e consulta do estoque de peças distribuídas entre os veículos da frota. Este módulo é parte de um sistema maior de controle de frota e estoques.

Fluxo Principal:

  1. O usuário acessa a tela de pesquisa "Peças por Veículos"
  2. Pode filtrar os veículos por placa (opcional)
  3. Clica no botão de pesquisa para listar os veículos conforme os filtros
  4. A tabela é preenchida com os veículos encontrados
  5. O usuário seleciona um veículo clicando na linha correspondente
  6. O sistema direciona para a tela de detalhes do veículo selecionado
  7. Na tela de detalhes, são exibidas todas as peças associadas ao veículo e suas respectivas quantidades
  8. O usuário pode retornar à tela de pesquisa através do botão "Voltar"

Instruções Passo a Passo

Como Pesquisar um Veículo

  1. Acesse a tela "Peças por Veículos"
  2. No campo "Placa do Veículo", digite a placa completa ou parcial do veículo
  3. Clique no botão de pesquisa (ícone de lupa)
  4. A tabela exibirá os veículos correspondentes ao critério de pesquisa

Como Limpar os Filtros

  1. Na tela "Peças por Veículos", clique no botão limpar filtros (ícone de arquivo)
  2. Todos os campos de filtro serão resetados para seus valores padrão
  3. A pesquisa não é executada automaticamente, clique no botão de pesquisa para exibir todos os veículos

Como Exportar Dados para CSV

  1. Realize a pesquisa desejada para filtrar os veículos
  2. Clique no botão exportar para CSV (ícone de salvar)
  3. O sistema gerará um arquivo CSV chamado "VeiculosPecas.csv" com os dados da tabela
  4. O arquivo será baixado automaticamente para seu computador

Como Visualizar as Peças de um Veículo

  1. Na tabela de resultados, clique na linha do veículo desejado
  2. O sistema abrirá a tela de detalhes do veículo
  3. A tabela inferior exibirá todas as peças associadas ao veículo e suas quantidades
  4. Para retornar à lista de veículos, clique no botão "Voltar"

Regras de Negócio e Validações

  1. Autenticação:

    • Todas as operações requerem um usuário autenticado
    • O sistema verifica a credencial do usuário em cada requisição
    • Se detectada uma sessão inválida (código 99), o usuário é redirecionado para a tela de login

  2. Permissões:

    • As operações são restritas ao cliente e empresa do usuário logado
    • O ID do cliente e empresa são enviados em cada requisição

  3. Pesquisa:

    • A pesquisa considera apenas veículos (flag "considerarApenasVeiculos" = true)
    • É possível filtrar por nome/placa do veículo de forma parcial
    • A ordenação padrão não é especificada na interface

  4. Visualização de Detalhes:

    • Os detalhes do veículo são recuperados pelo ID
    • A listagem de peças é obtida de um endpoint específico
    • O sistema trata adequadamente quando há apenas um item ou múltiplos itens

  5. Exportação:

    • A exportação para CSV usa o ponto e vírgula (;) como separador de colunas
    • O nome do arquivo é fixo: "VeiculosPecas.csv"

Perguntas Frequentes

Como faço para encontrar um veículo específico?

Para localizar um veículo específico, digite a placa completa ou parcial no campo "Placa do Veículo" e clique no botão de pesquisa (ícone de lupa). O sistema retornará todos os veículos que correspondam ao critério informado.

O que significa a quantidade exibida para cada peça?

A quantidade exibida representa o saldo atual da peça disponível naquele veículo específico. Este número reflete o estoque móvel que está alocado ao veículo.

Como posso exportar apenas informações de veículos específicos?

Primeiro, aplique os filtros desejados para exibir apenas os veículos que deseja incluir na exportação. Em seguida, clique no botão de exportar para CSV. O arquivo gerado conterá apenas os registros que estão sendo exibidos na tela.

Por que não consigo adicionar ou editar as quantidades de peças?

Esta tela é projetada apenas para consulta do estoque atual. Para ajustar quantidades ou transferir peças entre veículos, você deve utilizar o módulo de movimentação de estoque do sistema.

O sistema atualiza automaticamente os dados exibidos?

Não, o sistema não atualiza automaticamente os dados. Para ver informações atualizadas, é necessário executar a pesquisa novamente clicando no botão de pesquisa.

Como identifico se uma peça está com estoque baixo?

O sistema atualmente não possui indicadores visuais para estoque baixo na interface de consulta. É recomendável estabelecer procedimentos operacionais para definir níveis mínimos de estoque para cada tipo de peça.

É possível ver o histórico de movimentações de uma peça em um veículo?

Esta funcionalidade não está disponível nesta tela. Para verificar o histórico de movimentações, acesse o módulo de "Histórico de Movimentações" do sistema.

Aspectos Técnicos e Funcionamento

O sistema é estruturado em uma arquitetura cliente-servidor, onde:

  1. A interface de usuário é construída com componentes responsivos que se adaptam conforme o tamanho da tela.

  2. O carregamento de dados ocorre de forma assíncrona, permitindo que o usuário continue interagindo com a interface enquanto os dados são recuperados.

  3. Os dados são recuperados do servidor via requisições HTTP POST, enviando parâmetros como o ID do cliente, ID da empresa, filtros aplicados e configurações de paginação.

  4. O sistema trata diferentes cenários de resposta:

    • Quando não há dados para exibir
    • Quando há apenas um registro
    • Quando há múltiplos registros
    • Quando ocorre um erro de autenticação

  5. A interface utiliza um grid avançado para exibição dos dados que permite:

    • Redimensionamento de colunas
    • Ordenação de dados
    • Seleção de linhas para navegação

  6. A tela de detalhes mantém a consistência visual com a tela principal, facilitando a navegação e usabilidade.

  7. A exportação para CSV é realizada diretamente no navegador, sem necessidade de processamento adicional no servidor.

Este módulo se integra com o restante do sistema de controle de frota, permitindo uma gestão eficiente dos recursos distribuídos entre os veículos.