Armazéns
A tela de Armazéns é onde você cadastra as divisões lógicas do estoque dentro de cada Centro de Distribuição. Um armazém não é necessariamente uma sala separada — pode ser apenas uma forma de agrupar produtos pela situação do estoque: vendável, em quarentena, com avaria, em devolução, etc. Cada armazém pertence a um CD e tem um tipo que indica a situação desse estoque.
A tela apresenta a lista dos armazéns com as colunas Armazém, Tipo (Saudável, Divergência, Quarentena, Recebimento, Falta, Vencido, Auditoria, Avaria, Devolução, Ressuprimento, Outlet), Principal venda, Somar qtde., Principal recebimento, Faturar por (a empresa faturadora), Centro de distribuição, Conta e # (o código do armazém). Ao criar um armazém novo, o sistema cria simultaneamente um endereço padrão com o mesmo nome dentro dele — esse endereço serve como destino default em movimentações que não especificam endereço.
A exclusão é soft (marca como Inativo) e fica bloqueada quando o armazém tem endereços cadastrados ou aparece em de/para de armazém (Hub Estoque). Recomendamos sempre inativar em vez de excluir, e nunca apagar armazéns com histórico de movimentação.
Índice
Conceito
- O que é um Armazém?
- Quais são os tipos de armazém e quando usar cada um?
- Qual a diferença entre Principal venda e Principal recebimento?
- O que é Empresa Faturadora?
- Por que o sistema cria um endereço padrão junto com o armazém?
Antes de cadastrar
Cadastro
- Como criar um armazém?
- Quais campos são obrigatórios?
- O que faz a opção "Somar quantidade"?
- Como editar um armazém?
- O que acontece ao trocar o centro de distribuição de um armazém?
- Como inativar um armazém?
- Por que não consigo inativar um armazém?
Exemplos
- Exemplo 1 — Operação simples (1 CD, 1 armazém Saudável)
- Exemplo 2 — Operação com avariado e devolução
- Exemplo 3 — Operação 3PL com empresa faturadora
Diagnóstico
- Recebi "Armazém possui endereço cadastrado e não pode ser excluído"
- Recebi "Armazém tem de/para de armazém e não pode ser excluído"
- Recebi "Empresa destino transferência não tem armazém ativo para recebimento"
Boas práticas
Referência rápida
O que é um Armazém?
É a camada intermediária entre o Centro de Distribuição e o Endereço. Você pode pensar em armazém como um "compartimento lógico" do CD que segrega o estoque por finalidade:
- Estoque pronto para venda → Armazém Saudável.
- Produto avariado aguardando análise → Armazém Avaria.
- Devolução recebida → Armazém Devolução.
- Produto recebido aguardando conferência → Armazém Recebimento.
Cada armazém pertence a um único CD, mas um CD pode ter quantos armazéns precisar. Dentro do armazém ficam os Endereços físicos (vagas, prateleiras, bins).
📍 Onde: menu lateral → Logística → Armazéns.
Quais são os tipos de armazém e quando usar cada um?
O idworks tem 11 tipos fixos de armazém. Cada um indica uma situação do estoque:
| Tipo | Para que serve | Costuma somar no disponível? |
|---|---|---|
| 1 — Saudável | Estoque normal, vendável, pronto para separação. | Sim |
| 2 — Divergência | Produto com divergência operacional (faltou ou sobrou em inventário). | Não |
| 3 — Quarentena | Aguardando liberação (análise de qualidade, teste, perícia). | Não |
| 4 — Recebimento | Estoque temporário do recebimento de compra antes de ser endereçado. | Não |
| 5 — Falta | Produto apontado como faltante em inventário. | Não |
| 6 — Vencido | Produto fora da validade. | Não |
| 7 — Auditoria | Separado para auditoria interna ou externa. | Não |
| 8 — Avaria | Produto avariado/danificado. | Não |
| 9 — Devolução | Estoque vindo de devoluções de clientes (antes da triagem). | Não |
| 10 — Ressuprimento | Estoque em trânsito de reposição (entre armazéns). | Não |
| 11 — Outlet | Produto de segunda qualidade. | Conforme a operação |
Quem decide se o saldo do armazém entra no disponível é a opção Somar quantidade, qualquer que seja o tipo — veja O que faz a opção "Somar quantidade"?. O tipo descreve a situação do estoque e é usado por alguns fluxos (por exemplo, o recebimento automático de pedido de transferência só procura armazém Saudável), mas não decide sozinho se o saldo vende.
Recomendação: comece com 1-3 armazéns (Saudável + 1 ou 2 dos outros, conforme a operação) e adicione conforme a maturidade do processo.
Qual a diferença entre Principal venda e Principal recebimento?
São duas opções independentes, cada uma marcando o armazém que o sistema preenche sozinho em situações diferentes:
| Opção | Quando o sistema usa |
|---|---|
| Principal venda | Armazém preenchido automaticamente em todo o sistema quando não há um de/para específico, em pedidos e recebimentos manuais, ou sempre que for preciso escolher um armazém. |
| Principal recebimento | Armazém que já vem preenchido quando um recebimento novo é criado no centro de distribuição dele. |
Apenas um armazém por conta pode ser o Principal venda. Quando você marca outro, o sistema desmarca o anterior automaticamente — mesmo que ele seja de outra empresa da conta.
O Principal recebimento é um por centro de distribuição: cada CD pode ter o seu. Ao marcar um armazém, o sistema desmarca só o Principal recebimento anterior do mesmo CD; os dos outros CDs continuam como estão. Vale ao criar e ao editar o armazém: se você troca o CD de um armazém marcado como Principal recebimento, ele passa a ser o do CD novo, substitui o que estava lá, e o CD de antes fica sem Principal recebimento. Assim cada CD recebe a compra no armazém que você escolheu para ele.
Configuração típica:
- Principal venda = Armazém Saudável principal.
- Principal recebimento = Armazém Recebimento (para a compra entrar no armazém temporário antes da conferência) ou Armazém Saudável (se você não usa fluxo de conferência).
- Mais de um CD: marque um Principal recebimento em cada CD. O Principal venda continua sendo um só para a conta.
O que é Empresa Faturadora?
Campo opcional usado em operações 3PL (terceirização logística) ou multi-empresa. Indica qual empresa do grupo fatura as movimentações daquele armazém — útil quando você opera estoque para terceiros ou tem várias razões sociais no mesmo CD.
A empresa precisa estar associada à conta autenticada via cadastro de empresas relacionadas. Operações single-company deixam vazio.
Por que o sistema cria um endereço padrão junto com o armazém?
Quando você cria um armazém novo, o sistema executa dois cadastros em sequência:
- Insere o armazém em si.
- Insere um endereço padrão dentro dele com o mesmo nome do armazém, marcado como endereço padrão do armazém.
Esse endereço serve como destino default quando alguma movimentação especifica o armazém mas não o endereço. Garante que toda entrada/saída sempre tenha um endereço amarrado, mesmo em fluxos simples.
Depois disso você pode cadastrar mais endereços dentro do armazém (em Logística → Endereços) para refinar a organização física.
Pré-requisitos
| Passo | O que configurar | Onde |
|---|---|---|
| 1 | Pelo menos um Centro de Distribuição ativo | Logística → Centro de Distribuição |
| 2 | (opcional) Empresa faturadora cadastrada como relacionada | Configurações → Minhas Empresas |
CDs sem nenhum armazém ainda criado podem ser usados — você cria o primeiro armazém aqui.
Como criar um armazém?
- Acesse Logística → Armazéns.
- Clique em Novo Registro no canto superior direito.
- Preencha:
- Conta (só aparece quando você tem mais de uma conta; os outros campos só liberam depois de escolhê-la).
- Centro de distribuição (selecione da lista).
- Nome armazém.
- Tipo armazém (Saudável, Avaria, Quarentena etc.).
- Faturar por — a empresa faturadora (opcional).
- Principal venda, se for o caso.
- Somar quantidade (vem como Não — veja explicação abaixo).
- Principal recebimento, se for o caso.
- Endereço (seção recolhida, opcional): CEP com o botão Buscar, Logradouro, Número, Complemento, Bairro, Cidade e UF.
- Salvar.
O armazém é sempre salvo como ativo — não há campo de situação no cadastro. O sistema cria o armazém e o endereço padrão homônimo automaticamente.
Pela API, se o CD não for informado, o armazém vai para o CD padrão da empresa; sem CD padrão, a criação é recusada com Empresa não tem centro de distribuição padrão.
Quais campos são obrigatórios?
- Conta — só no cadastro novo e só quando você tem mais de uma conta. Sem ela o sistema avisa Por Favor, O campo *CONTA precisa ser preenchido.
- Centro de distribuição.
- Nome armazém.
- Tipo armazém.
Faturar por, Endereço, Principal venda, Somar quantidade e Principal recebimento podem ficar em branco ou como vêm, mas Principal venda e Principal recebimento costumam ser definidos no primeiro cadastro.
O que faz a opção "Somar quantidade"?
Opção que controla se o estoque deste armazém soma no saldo agregado dos SKUs:
- Sim: o saldo do armazém entra no total exibido em relatórios de estoque e na previsão de cobertura.
- Não (como a opção vem num cadastro novo): o armazém continua recebendo entradas/saídas normalmente, mas o saldo dele não entra no total agregado.
O estoque enviado aos canais de venda não segue esta opção: ele vem do armazém do de/para da integração ou, quando preenchido, do parâmetro Armazéns para somar quantidade da integração.
Use Não para armazéns de estoque imobilizado (vencido, auditoria, devolução em análise) — você quer saber que o produto está lá, mas não quer que ele influencie decisões de compra/venda.
Como editar um armazém?
- Localize na lista.
- Editar (lápis) ou duplo clique.
- Ajuste o que precisa.
- Salvar.
Na edição, a Conta não pode ser trocada. O Centro de distribuição pode, mas, se o armazém já tem movimentação ou saldo, o sistema pede confirmação antes — veja a seção abaixo.
Quando o salvamento dá certo, a janela fecha e a lista atualiza só a linha do armazém que você editou. As outras linhas não são recarregadas: se você marcou Principal venda ou Principal recebimento, o armazém que perdeu a marcação continua aparecendo como marcado até você recarregar a página.
O que acontece ao trocar o centro de distribuição de um armazém?
O saldo e o histórico de movimentação de um armazém contam no centro de distribuição ao qual o armazém pertence. Por isso, trocar o CD de um armazém não muda só o cadastro:
- Armazém sem movimentação e sem saldo (por exemplo, recém-cadastrado): a troca é salva direto.
- Armazém com movimentação ou com saldo: ao clicar em Salvar, nada é gravado ainda. Abre a confirmação Trocar o centro de distribuição do armazém?, que diz quantas movimentações o armazém tem e/ou em quantos produtos está com saldo — inclusive saldo negativo ou só valor de estoque (a partir de 100.000 movimentações, a mensagem mostra "mais de 100.000").
- Trocar mesmo assim: salva a edição com o CD novo. Todo o histórico e o saldo do armazém passam para o CD novo de uma vez: relatórios, painel e a restrição de usuários por CD passam a contar tudo no CD novo, inclusive o movimento de pedidos antigos. Os pedidos em si continuam no CD de antes.
- Cancelar: nenhuma alteração é salva — nem a do CD, nem as dos outros campos que você mudou nessa edição. A janela de edição continua aberta.
O aviso só fecha pelos botões: Esc e o clique fora dele não fecham. Depois de clicar em Trocar mesmo assim, Cancelar fica desabilitado e o X some enquanto o sistema grava, para a troca não seguir no servidor com o aviso já fechado. Se a gravação falhar (por exemplo, por erro de conexão), o aviso fecha e o sistema mostra a mensagem de erro; a janela de edição continua aberta com o que você preencheu, e Salvar tenta de novo.
Se o sistema não conseguir conferir a movimentação do armazém, ele não troca o CD e avisa Não foi possível conferir a movimentação do armazém para trocar o centro de distribuição. Tente de novo.
O campo Centro de distribuição é obrigatório: se você limpar e salvar, o sistema não grava e avisa Por Favor, O campo *CENTRO DE DISTRIBUIÇÃO precisa ser selecionado.
Quer manter o histórico no CD atual? A própria confirmação sugere criar um armazém no CD novo e transferir o saldo para ele, em vez de trocar o CD do armazém antigo. Atenção: a transferência entre armazéns da tela Movimentação Estoque só aceita armazéns do mesmo centro de distribuição e recusa armazéns de CDs diferentes com Centro de distribuição de origem diferente do destino. Para levar o saldo para outro CD, use um pedido com tipo de pedido de transferência (O que é a opção Transferência?): o pedido sai do armazém de origem e o idworks abre sozinho o recebimento no CD de destino, que precisa ter um armazém Saudável — veja Recebi "Empresa destino transferência não tem armazém ativo para recebimento".
Como inativar um armazém?
A "exclusão" é na verdade um soft delete: o sistema marca o armazém como Inativo, desliga a opção Somar quantidade e desmarca Principal venda (libera para outros armazéns). A marcação de Principal recebimento não é tirada — se o armazém removido era o Principal recebimento, marque outro armazém do mesmo CD.
- Clique em Remover (lixeira) na linha.
- Confirme.
O armazém não é apagado e o histórico dele continua, mas:
- Some da lista desta tela e da lista de armazéns disponíveis para seleção em outras telas.
- Não conta no saldo agregado (a opção Somar quantidade fica desligada).
- Deixa de ser o Principal venda.
Não há como reativar pela tela: para recuperar um armazém removido, contate o suporte.
Por que não consigo inativar um armazém?
Duas verificações bloqueiam:
| Verificação | Mensagem |
|---|---|
| Tem endereço vinculado? | Armazém possui endereço cadastrado e não pode ser excluído |
| Aparece como destino em de/para de armazém (Hub Estoque)? | Armazém tem de/para de armazém e não pode ser excluído |
Solução: vá em Logística → Endereços, filtre pelo armazém e exclua/movimente os endereços; ou edite o vínculo de Hub Estoque em Hub Estoque. Depois volte e tente novamente.
Exemplo 1 — Operação simples (1 CD, 1 armazém Saudável)
Cenário: pequena loja começando agora, sem fluxo de avaria/quarentena formal.
| Campo | Valor |
|---|---|
| Nome armazém | Armazém Principal |
| Centro de distribuição | CD Único |
| Tipo armazém | Saudável |
| Principal venda | Sim |
| Somar quantidade | Sim |
| Principal recebimento | Sim |
| Faturar por | (vazio) |
Resultado: todo recebimento de compra cai aqui, todas as vendas saem daqui, todo saldo entra na conta agregada. Setup mínimo.
Exemplo 2 — Operação com avariado e devolução
Cenário: e-commerce com volume razoável, separa o avariado e a devolução.
Três armazéns no mesmo CD:
| Nome | Tipo | Principal venda | Somar quantidade | Principal recebimento |
|---|---|---|---|---|
| Armazém Saudável | Saudável | Sim | Sim | Sim |
| Armazém Avaria | Avaria | Não | Não | Não |
| Armazém Devolução | Devolução | Não | Não | Não |
Resultado: vendas saem só do Saudável; avariados e devoluções ficam visíveis para gestão mas não inflam o saldo "vendável". Quando um produto avariado é restaurado, transfere para o Saudável.
Exemplo 3 — Operação 3PL com empresa faturadora
Cenário: você opera o estoque de duas empresas no mesmo galpão (mesma estrutura física, faturamento separado).
| Nome | Centro de distribuição | Tipo | Faturar por | Principal venda |
|---|---|---|---|---|
| Armazém Empresa A — Saudável | CD Compartilhado | Saudável | Empresa A | Sim |
| Armazém Empresa B — Saudável | CD Compartilhado | Saudável | Empresa B | Não |
Só um armazém da conta pode ser o Principal venda: marcar o da Empresa B desmarca o da Empresa A.
Resultado: cada empresa enxerga "seu" armazém e seu estoque; relatórios financeiros separam por empresa faturadora. Mesmo CD físico, contabilidades distintas.
Recebi "Armazém possui endereço cadastrado e não pode ser excluído"
O armazém tem pelo menos um endereço cadastrado dentro dele. Lembre que o sistema cria automaticamente um endereço padrão com o mesmo nome no momento em que o armazém é salvo — então armazéns recém-criados já têm pelo menos um.
Solução:
- Vá em Logística → Endereços.
- Filtre por Armazém = o armazém que quer excluir.
- Exclua/transfira todos os endereços (inclusive o padrão homônimo, se já não tem saldo).
- Volte e tente novamente.
Recebi "Armazém tem de/para de armazém e não pode ser excluído"
Este armazém aparece como destino em algum vínculo de Hub Estoque (operações com hub central + armazéns satélites).
Solução: abra Hub Estoque e ajuste/remova o vínculo onde esse armazém é destino. Depois volte e tente novamente.
Recebi "Empresa destino transferência não tem armazém ativo para recebimento"
Acontece em pedidos de transferência: depois que a nota é autorizada (ou quando a transferência é lançada sem nota), o idworks tenta criar sozinho o recebimento no destino — e não encontrou armazém para receber a mercadoria.
O armazém de destino precisa atender às três condições ao mesmo tempo:
| Condição | Onde conferir |
|---|---|
| Ser do tipo Saudável | Coluna Tipo na lista de Armazéns |
| Estar ativo | Armazém removido pela lixeira fica inativo e some da lista de Armazéns |
| Estar dentro do CD de destino da transferência | Coluna Centro de distribuição na lista de Armazéns |
Solução: abra Logística → Armazéns, pesquise na coluna Centro de distribuição pelo CD que vai receber a mercadoria e confirme que existe ali um armazém Saudável. A lista só mostra armazéns ativos: se não houver nenhum Saudável nesse CD, cadastre um (para recuperar um armazém removido, só pelo suporte).
Quando o destino da transferência é uma outra empresa do grupo, o armazém precisa estar cadastrado na empresa de destino, sempre dentro do CD que recebe.
Onde o sistema procura esse armazém depende de como ele descobriu o CD de destino:
| Como o CD de destino foi encontrado | Onde o armazém Saudável ativo é procurado |
|---|---|
| Pelo cliente do pedido — o cliente está na lista Clientes para transferência do CD que recebe (cadastro do Centro de Distribuição) | Na própria conta do pedido, dentro do CD de destino. Nesse caminho o campo Empresa faturadora do armazém não entra na busca. |
| Pelo CNPJ do destinatário — o documento do cliente bate com uma empresa relacionada | Entre os armazéns cuja Empresa faturadora é a empresa de destino, dentro do CD de destino. |
Na prática: para transferência entre CDs da mesma conta usando Clientes para transferência, basta existir um armazém Saudável ativo no CD que recebe — não é preciso preencher Empresa faturadora. Para transferência entre empresas diferentes do grupo, o armazém do destino precisa estar com a Empresa faturadora correta, senão a busca não o encontra e a mensagem aparece.
Boas práticas para os armazéns
Armazéns bem separados por finalidade mantêm o saldo vendável limpo e evitam vender o que não deveria. Recomendações:
- Reserve o tipo Saudável para o que realmente vende. Quem leva o saldo para o disponível é a opção Somar quantidade, não o tipo — deixe-a ligada só nos armazéns cujo saldo pode ser vendido e coloque avaria, quarentena, devolução e vencido em armazéns do tipo certo para não somar no disponível o que não pode sair. O que vai para os canais de venda é definido pelo de/para da integração (ou pelo parâmetro Armazéns para somar quantidade dela), não por esta opção.
- Desligue "Somar quantidade" para estoque imobilizado. Em armazéns de vencido, auditoria ou devolução em análise, deixe a opção em Não: você continua vendo o produto, mas ele não infla o total que orienta compra e venda.
- Aponte o Principal recebimento para onde a mercadoria deve entrar. Se você confere o recebimento antes de liberar, marque o armazém de Recebimento como Principal recebimento; se não usa conferência, aponte direto para o Saudável. Com mais de um CD, defina um Principal recebimento em cada um.
- Inative em vez de excluir armazéns com histórico. A remoção é um soft delete e fica bloqueada se houver endereços ou de/para de Hub Estoque — nunca tente apagar um armazém que já teve movimentação; inative e siga.
- Lembre que cada armazém novo já nasce com um endereço. O sistema cria automaticamente um endereço padrão homônimo — por isso um armazém recém-criado já não exclui direto; refine os endereços depois em Logística → Endereços.
- Use Empresa faturadora só em operação 3PL ou multi-empresa. Preencha quando fatura estoque para terceiros ou tem várias razões sociais no mesmo CD; operação de uma empresa só deve deixar o campo vazio.
Resumo de parametrizações
A tela de Armazéns não tem parametrizações próprias que mudem seu comportamento.
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Sem o privilégio, o botão Novo Registro aparece desabilitado (com o aviso "Você não tem privilégio para executar esta ação" ao passar o mouse), enquanto os botões de edição e exclusão da linha nem aparecem.
| Privilégio | Libera |
|---|---|
| Visualizar Estoque (CD) | Acessa a tela e a lista de armazéns. Sem este privilégio, o item de menu nem aparece. |
| Criar estoque (CD) | Botão Novo Registro habilitado. |
| Editar estoque (CD) | Botão de edição (lápis) em cada linha e a edição por duplo clique. |
| Deletar estoque (CD) | Botão de exclusão (lixeira) em cada linha. |