Cadastro de Depósito

Módulo: Estoque Caminho na aplicação: Menu > Estoque > Depósitos > "Novo depósito" ou ícone Editar em um depósito Última atualização: 20/04/2026

Para que serve

Permite criar e editar depósitos de estoque vinculados a uma filial. Um depósito representa um local físico (galpão, prateleira, câmara fria, etc.) onde os produtos são armazenados. O código pode ser gerado automaticamente (prefixo DEP + número sequencial) se não for informado.

Quem pode usar

Todos os usuários com acesso ao módulo Estoque.

Como usar (passo a passo)

Criar um novo depósito

1. Acesse Menu > Estoque > Depósitos e clique em Novo depósito.
2. Selecione a Filial à qual o depósito pertence.
3. Informe o Código (opcional) — se vazio, o sistema gera automaticamente no padrão DEP<id_interno>.
4. Preencha a Descrição (obrigatória).
5. Selecione o Tipo (Principal ou Secundário).
6. Ative ou desative os toggles Depósito principal da filial e Ativo conforme necessário.
7. Opcionalmente, preencha as Observações.
8. Clique em Criar.
9. O sistema salva o depósito e redireciona para a tela de edição do registro criado.

Editar um depósito existente

1. Na Lista de Depósitos, clique no ícone Editar (lápis) na linha desejada.
2. Faça as alterações. O campo Filial não pode ser alterado após a criação.
3. Clique em Salvar.
4. O sistema atualiza o registro e recarrega os dados sem fechar a tela.

Campos da tela

Seção: Identificação

Campo	Obrigatório	O que preencher	Observações
Filial	Sim	Selecionar da lista	Não editável após a criação
Código	Não	Até 20 caracteres	Gerado automaticamente como DEP<id_interno> se vazio; único por filial
Descrição	Sim	Texto até 255 caracteres	Nome descritivo do local
Tipo	Sim	Principal ou Secundário	Padrão na criação: Secundário
Depósito principal da filial	Não	Ligado/desligado	Apenas um por filial; marcar aqui desmarca o anterior automaticamente
Ativo	Não	Ligado/desligado	Padrão na criação: Ativo
Observações	Não	Texto livre até 500 caracteres	Informações adicionais

Validações e regras

• A Filial é obrigatória e não pode ser alterada após a criação.
• A Descrição é obrigatória (máximo 255 caracteres).
• O Código é opcional; se informado, deve ter no máximo 20 caracteres e ser único por filial. Se deixado em branco, o backend gera DEP<id_interno>.
• O campo Tipo é obrigatório; padrão Secundário na criação.
• Apenas um depósito pode ser principal por filial
• Ao salvar na criação, o sistema navega para a rota de edição (/estoque/depositos/:id/editar) sem criar duplicata ao recarregar.
• Ao salvar na edição, o sistema recarrega os dados do backend e mantém o usuário na mesma tela.

Mensagens de erro e o que fazer

Mensagem	Causa	Como resolver
"Selecione a filial"	Filial não selecionada	Selecione uma filial
"Obrigatorio"	Descrição em branco	Preencha a descrição
"Deposito atualizado"	Edição salva com sucesso	—
"Deposito criado"	Criação bem-sucedida	—
"Erro ao carregar deposito"	Falha ao buscar o registro para edição	Recarregue a página
Mensagem retornada pela API	—	Leia a mensagem e corrija os dados

Integrações e dependências

• Depende do cadastro de filiais da empresa.
• Depósitos criados aqui ficam disponíveis para seleção em Movimentações de Estoque, Saldos de Estoque e Kardex.

Dúvidas frequentes

O código que digitei não foi salvo — o sistema gerou outro. Se o campo Código foi deixado em branco ou apagado antes de salvar, o backend gera automaticamente o código DEP<id_interno>. Para usar um código personalizado, preencha o campo antes de clicar em Criar.

Posso alterar a filial de um depósito já criado? Não. A filial é fixada na criação. Se necessário, crie um novo depósito na filial correta.

Como transferir estoque entre depósitos? Registre uma saída do depósito de origem e uma entrada no depósito de destino em Movimentações de Estoque

O que significa o toggle "Depósito principal da filial"? Indica que este é o depósito padrão da filial para operações que não especificam um depósito. Só pode haver um por filial.

Histórico de alterações

Data	Alteração
20/04/2026	Documento inicial criado.