Capítulo E2 — Depósitos

Do que se trata

Depósitos são os locais onde seus produtos ficam guardados. Antes de controlar saldo, o sistema precisa saber quantos depósitos você tem e onde cada um fica.

Até uma empresa pequena quase sempre tem pelo menos um depósito (o escritório, a loja, o estoque nos fundos). Empresas maiores podem ter vários — matriz, filial, e-commerce, ou mercadoria em consignação com terceiro.

Antes de começar

Nada. A tela de Depósitos é a primeira coisa que você deve configurar no módulo de Estoque.

Os 4 tipos de depósito

O sistema trabalha com 4 tipos diferentes. Escolha de acordo com a sua realidade:

Dica: Se sua operação é só um endereço (escritório, consultório, loja única), um depósito Físico marcado como Padrão é suficiente. Depois você pode criar mais se precisar.

Passo a passo — cadastrar seu primeiro depósito

1. Entre no menu Estoque

No menu lateral esquerdo, clique em Estoque. Você vai ver uma tela com 4 atalhos: Saldos, Depósitos, Transferências e Saldo Inicial.

2. Clique em Depósitos

Na primeira vez que você entrar, a lista estará vazia:

3. Clique em "+ Novo depósito"

Tanto o botão no topo direito quanto o botão verde no meio da tela abrem o formulário.

4. Preencha os campos

5. Clique em "Criar depósito"

O depósito aparece na listagem com uma estrela indicando que ele é o padrão:

Campos obrigatórios de cada tipo

• Físico: só o nome. Endereço e CNPJ emissor são opcionais.
• Virtual: só o nome. Não aceita endereço nem CNPJ emissor.
• Consignação: nome e o consignatário (pessoa cadastrada em Pessoas que ficou com a mercadoria).

Regras importantes

• Tipo não muda depois de criado. Se errou o tipo, você precisa criar um novo e desativar o errado.
• Só um depósito Físico pode ser Padrão. Se você marcar outro como padrão, o anterior perde essa condição automaticamente.
• Depósito de trânsito é do sistema. Você vê ele na listagem (pra entender o fluxo de transferências) mas não pode editar nem desativar.

Editando um depósito

Clique nos três pontinhos (⋯) ao lado de qualquer depósito pra abrir o menu:

• Editar — muda nome, código, endereço e flag de saldo negativo. Tipo não é editável.
• Marcar como padrão — só disponível em depósitos Físicos e ativos que ainda não são o padrão.
• Desativar — só funciona se o depósito estiver com saldo zero em todos os produtos. Se tiver mercadoria ainda, o sistema bloqueia com uma mensagem lembrando os produtos com saldo.
• Reativar — volta um depósito que estava desativado.

Onde esse depósito vai aparecer

• Nas vendas / emissão de NF-e: se o produto controla estoque, o sistema baixa do depósito padrão automaticamente.
• No Saldo Inicial (Cap. E4): você vai escolher o depósito onde o estoque inicial de cada produto está.
• No Kardex e Saldos (Cap. E5): os saldos aparecem separados por depósito.
• Nas Transferências (Cap. E7): quando você transfere mercadoria de um lugar pro outro.

Capítulo E3 — Produtos com controle de estoque

Do que se trata

Nem todo produto precisa ter saldo controlado. Serviços, taxas, descontos e itens que você vende sob encomenda normalmente ficam sem controle de estoque. Já mercadoria física (peças, insumos, livros, alimentos) quase sempre precisa ser controlada.

O EmitindoAI deixa você escolher produto por produto. Essa decisão afeta:

• Listagens de saldo: só aparecem produtos marcados como controlados
• Emissão de NFe: o saldo é baixado automaticamente na venda
• Alertas: o sistema bloqueia emissão se faltar saldo (a menos que você tenha autorizado saldo negativo)

Antes de começar

• Ter pelo menos um depósito cadastrado (ver Cap. E2 — Depósitos)
• Ter o produto cadastrado em Cadastros → Produtos

Passo a passo — ativar controle de estoque

1. Entre em Produtos

No menu lateral, vá em Produtos (seção Cadastros).

2. Localize a coluna "Estoque" na tabela

Quando o módulo de Estoque está ligado no workspace, aparece uma coluna "Estoque" com uma caixinha pra marcar em cada linha.

3. Clique na caixinha do produto

Marcar/desmarcar é imediato — não precisa salvar. A caixinha azul significa que o produto passa a ser controlado.

O que acontece ao marcar:

• A partir de agora, toda entrada/saída desse produto (venda, ajuste, compra) vai afetar o saldo.
• O produto aparece nas telas Saldos, Kardex e Saldo Inicial do módulo Estoque.
• Na emissão de NFe com o produto, o sistema valida o saldo antes de enviar pra Receita.

O que acontece ao desmarcar:

• Movimentações existentes continuam no histórico mas o produto some das telas de controle.
• Só desmarque quando tiver certeza que não precisa mais rastrear esse item.

Quando cadastrar um produto novo

Se você acabou de ativar o módulo de Estoque, provavelmente vai cadastrar produtos agora. Na tela de novo produto:

Campos importantes:

Depois de salvar, volte à listagem e marque o controle de estoque na coluna correspondente.

E se eu tenho 50 produtos e quero marcar todos?

Hoje o sistema faz um por vez. Pra empresas com catálogo grande, recomendamos:

1. Criar/importar os produtos primeiro
2. Filtrar pela categoria que precisa de controle (usar a busca por código ou descrição)
3. Marcar os que precisam

Edição em lote é uma melhoria no roteiro — quando lançada, você poderá selecionar múltiplos produtos e marcar de uma vez.

Regras importantes

• Por padrão, produto NOVO começa sem controle de estoque. Se quiser controlar, tem que marcar.
• Produto sem controle é invisível pro estoque. Ele não aparece nas listagens de saldo nem no kardex.
• Marcar e desmarcar é seguro. Não apaga histórico. Mas desmarcar não é o mesmo que desativar — veja abaixo.

"Permitir saldo negativo" (opcional, avançado)

Em casos raros, você pode querer que um produto aceite vender mais do que tem em estoque (ex: pré-venda, drop shipping). Isso fica em Configurações avançadas do produto — normalmente deixe desligado.

Dica: se o depósito tiver "Permitir saldo negativo" ligado, essa opção vale pra todos os produtos daquele depósito, independente da configuração de cada produto.

Onde isso vai aparecer

• Estoque → Saldos (Cap. E5): só produtos com controle aparecem aqui
• Estoque → Kardex: idem
• Vendas / NFe: se o produto for controlado, o saldo baixa automaticamente
• Relatórios fiscais (livro de inventário): considera só produtos com controle

Capítulo E4 — Saldo Inicial

Do que se trata

Quando você começa a usar o módulo de Estoque, o sistema não sabe quanto de cada produto você já tem em cada depósito. O Saldo Inicial é a tela onde você informa isso uma vez — produto por produto, depósito por depósito.

Depois dessa carga inicial, todas as entradas e saídas futuras passam a ser automáticas: nota fiscal emitida baixa estoque, nota cancelada devolve, ajustes manuais entram pelo histórico (kardex).

Antes de começar

1. Ter cadastrado pelo menos um depósito (Cap. E2)
2. Ter marcado os produtos com controle de estoque ativo (Cap. E3)
3. Ter à mão o custo unitário de cada produto (normalmente o valor da última nota de compra)

Regra fundamental

O Saldo Inicial só pode ser registrado UMA vez por combinação produto × depósito. Depois disso, toda alteração tem que ser feita como entrada ou ajuste (ver Cap. E6). Isso serve pra preservar a confiabilidade do custo médio e do histórico.

Se errar um saldo inicial, a correção é via ajuste — não dá pra editar.

Passo a passo

1. Entre em Estoque → Saldo Inicial

No menu do Estoque, clique em Saldo Inicial.

2. Preencha os campos

3. Clique em "Registrar saldo inicial"

Aparece uma confirmação com o número do movimento (ex: #1, #2…) e o formulário mantém o produto e depósito selecionados — assim você acelera a entrada em lote (se tiver 20 produtos no mesmo depósito, só troca a quantidade e o custo).

4. Repita pra cada produto × depósito

Se tiver 40 produtos controlados em 1 depósito, são 40 entradas. Se tiver 40 produtos em 2 depósitos, são até 80 — mas só os produtos que realmente têm saldo em cada depósito (se um produto não fica no depósito B, pula).

Dica de produtividade: abra a tabela do seu estoque atual (Excel, planilha do filho, sistema antigo) do lado da tela e vá batendo. Leva ~10 segundos por entrada se você tem os dados à mão.

O que acontece por trás

Quando você clica em Registrar, o sistema:

1. Cria uma entrada no kardex do produto com tipo "Saldo Inicial" (fica pra sempre no histórico)
2. Atualiza a projeção de saldo pra (produto, depósito) = quantidade
3. Atualiza o custo médio do produto com o valor informado
4. A próxima entrada de compra vai fazer a média ponderada com esse custo

Erros comuns

E se um produto não tem saldo? Preciso cadastrar?

Não. Só cadastre saldo inicial dos produtos que realmente têm mercadoria no depósito. Produtos sem saldo inicial começam com 0 automaticamente — as entradas futuras (compra, ajuste) é que vão criar movimento.

Onde o saldo inicial aparece depois

• Estoque → Saldos (Cap. E5): produto passa a listar com a quantidade informada
• Estoque → Kardex: primeira linha do histórico é o "Saldo Inicial"
• Custo médio do produto: atualizado imediatamente

Capítulo E5 — Saldos e Kardex

Do que se trata

Estas são as duas telas de consulta do estoque:

• Saldos — lista geral de todos os produtos com sua quantidade atual em cada depósito. É a tela que você abre pra responder "quanto tenho de X?".
• Kardex — extrato cronológico de movimentos de um produto específico. Mostra cada entrada e saída desde o saldo inicial. É a tela que você abre pra responder "por que esse saldo está assim?".

Ambas são somente leitura — não dá pra editar movimentos por aqui (use os capítulos E6, E7 e E8 pra movimentar).

Saldos

Como entrar

Menu lateral → Estoque → Saldos.

O que tem na tela

4 cards no topo (totalizadores):

Os totalizadores respeitam os filtros aplicados abaixo. Se filtrar por um depósito específico, os números refletem só esse depósito.

Filtros:

• Busca (pelo código do produto ou descrição) — atualização ao vivo conforme você digita
• Depósito — pra ver só o saldo de um lugar
• Sinal — Todos / Saldo positivo / Saldo zero / Saldo negativo

Tabela:

Botão "Novo ajuste"

No topo direito tem o atalho pra registrar um ajuste de entrada/saída sem precisar abrir um produto específico. Detalhes em Cap. E6 — Ajustes.

Kardex (extrato de um produto)

Como entrar

Da tela de Saldos, clique em qualquer linha de produto. O Kardex daquele produto abre.

O que tem na tela

Header:

• Nome do produto + código + unidade + se controla estoque
• Botão "Novo ajuste" pra entrada/saída direta no produto

3 cards de resumo:

Saldo por depósito:

Lista cada depósito que tem saldo desse produto, com quantidade, custo médio nesse depósito e valor total no depósito.

Tabela de Movimentos (kardex propriamente dito):

Lista todos os movimentos do produto, mais recentes primeiro:

Filtros do kardex

• Depósito — pra ver só os movimentos de um depósito específico
• Tipo — Todos / Entradas / Saídas / Saldo inicial

Movimentos estornados

Quando uma NFe é cancelada, o estoque volta automaticamente. Visualmente, no kardex você vê:

• O movimento original (a saída pela NFe) fica com risco e desbotado — indicando que foi estornado
• Aparece um novo movimento de entrada com badge "Estorno" apontando pro original

Isso preserva a auditoria — nada é deletado, só marcado.

Como usar no dia-a-dia

Saldo em data (futuro)

Pra extrair "saldo em uma data específica" (ex: pro contador montar livro de inventário), aguarde o relatório dedicado em Estoque → Relatórios (em desenvolvimento). Por enquanto a tela mostra sempre o saldo atual.

Capítulo E6 — Ajustes manuais (Entrada e Saída)

Do que se trata

Ajuste manual é quando você precisa mexer no saldo sem uma venda, compra com nota fiscal ou transferência envolvida. Dois casos típicos:

• Entrada — compra avulsa sem nota, devolução informal, achado de inventário, produção interna. Quer dizer: o saldo aumenta.
• Saída (ajuste) — perda, quebra, furto, descarte, ajuste de inventário. Quer dizer: o saldo diminui.

Tanto entrada quanto saída ficam registradas no kardex com um número sequencial e uma observação — ninguém conta "sumiu do estoque" depois. Tudo tem rastro.

Como entrar

Tem dois caminhos — os dois abrem o mesmo modal:

1. Da tela Saldos, topo direito → botão "Novo ajuste".
2. Do kardex de um produto específico, topo direito → botão "Novo ajuste".

A diferença: se você entrar pelo kardex do produto, o campo "Produto" já vem preenchido.

O modal

No topo do modal tem dois botões grandes de escolha:

Clique no que quer fazer. O modal muda de cor (verde pra Entrada, vermelho pra Saída) pra te lembrar do que está fazendo.

Fazendo uma Entrada

Exemplo: você comprou 5 unidades extras de uma agenda sem nota, pra repor o estoque.

1. Modal aberto → clica em Entrada.
2. Preenche:
   • Produto — começa digitando o nome ou código, aparece a lista.
   • Depósito — onde a mercadoria vai entrar.
   • Quantidade — 5.
   • Custo unitário (R$) — 50,00. (Obrigatório na entrada — é o preço que você pagou por unidade.)
   • Observação — "Compra avulsa — reposição". (Opcional mas muito recomendado — ajuda auditoria depois.)

3. Clica Registrar movimento.
4. Aparece um toast verde "Entrada registrada". O modal fecha.
5. O kardex se atualiza na hora — o novo movimento aparece no topo com Δ +5.

Como o custo médio fica depois da entrada

O custo médio ponderado do depósito se recalcula. Exemplo:

• Antes: 28 × R$ 45,00 = R$ 1.260,00 (custo médio R$ 45,00)
• Entrada: 5 × R$ 50,00 = R$ 250,00
• Depois: 33 unidades com valor total R$ 1.510,00 → custo médio R$ 45,76

É por isso que custo médio é "médio" — ele reflete tudo que você tem no depósito, ponderado pelo que pagou em cada entrada.

Fazendo uma Saída (ajuste)

Exemplo: 2 unidades chegaram quebradas e você precisa dar baixa.

1. Modal aberto → clica em Saída (ajuste).
2. Preenche:
   • Produto e Depósito — o mesmo padrão da entrada.
   • Quantidade — 2.
   • Custo unitário (R$) — opcional na saída. Se deixar em branco, o sistema usa o custo médio atual do depósito (recomendado). Se informar, ele respeita esse valor específico.
   • Observação — "Quebra na entrega — 2 unidades danificadas". (Opcional mas crítica pra auditoria.)

3. Clica Registrar movimento.
4. Toast verde "Saída registrada". Modal fecha.
5. Kardex atualizado — movimento com Δ −2 em vermelho.

O custo médio não muda em saídas

Saída consome ao custo médio atual — não afeta o custo unitário do que sobrou. Só entrada e saldo inicial ajustam o custo médio.

Validações que o sistema faz

Se alguma das regras abaixo não bater, o sistema recusa o ajuste e explica por quê:

Casos de uso recomendados

Como auditar depois

Todo ajuste manual aparece no kardex com:

• Origem: "Entrada manual" ou "Ajuste de inventário"
• Observação: o que você digitou
• Usuário: quem registrou (no backend; na tela mostra só a origem)
• Data e hora: precisão de minutos

Se precisar estornar um ajuste errado, não existe botão "desfazer" — registre o movimento oposto com observação explicando (ex: "Estorno do ajuste #15 — registrado por engano").

Quando NÃO usar ajuste manual

Se a operação tem documento fiscal, prefira o fluxo específico:

• Compra com nota → NFe recebida (Cap. E8) — traz produto, quantidade e custo do XML
• Venda → NFe emitida (Cap. E8) — baixa o estoque atomicamente
• Transferência entre depósitos seus → Cap. E7 (tem trânsito e recebimento)

Ajuste manual é a válvula de escape pra tudo o que não tem documento — use com parcimônia e sempre com observação clara.

Capítulo E7 — Transferências entre depósitos

Do que se trata

Transferência é quando você move mercadoria de um depósito seu pra outro depósito seu. Não é venda, não é compra, não é ajuste — é só uma mudança de localização.

O sistema oferece dois modos:

Como entrar

Menu lateral → Estoque → Transferências.

A tela tem duas abas no topo:

• Todas — lista tudo, do mais recente pro mais antigo
• Pendentes — filtra só as transferências "em trânsito" aguardando recebimento (aparece um badge com a contagem)

Botão "Nova transferência" no topo direito abre o modal.

Fazendo uma Transferência simples

Exemplo: você tem 2 depósitos no mesmo endereço (Escritório Principal e Filial Sul), quer mover 3 agendas de um pro outro.

1. Clica Nova transferência.
2. Preenche:
   • Produto — selecione pelo nome ou código
   • De (origem) — depósito de onde sai
   • Para (destino) — depósito que recebe
   • Quantidade — 3
   • Com trânsito (2 etapas) — não marque
   • Observação — "Reposição da filial" (opcional)

3. Clica Transferir.
4. Toast "Transferência concluída". O modal fecha e a transferência aparece na lista como Simples.

O que aconteceu nos bastidores:

O sistema criou 2 movimentos no kardex vinculados pelo mesmo identificador:

• Saída de 3 UN do depósito origem
• Entrada de 3 UN no depósito destino

O custo médio do depósito destino se atualiza ponderando a entrada.

Fazendo uma Transferência com trânsito (2 etapas)

Exemplo: você tem uma filial em outra cidade e vai mandar 4 agendas por transportadora. A mercadoria sai hoje mas só chega semana que vem. Durante esse tempo ela está no caminho — nem mais na origem, nem ainda no destino.

O sistema tem um depósito especial chamado "Em Trânsito" que segura a mercadoria nesse interim.

1. Clica Nova transferência.
2. Preenche os mesmos campos (produto, origem, destino, quantidade).
3. Marca a caixinha "Com trânsito (2 etapas)" — aparece uma explicação.
4. Observação — "Envio por transportadora — chega semana que vem".

Repare que o botão agora diz "Registrar remessa" (não mais "Transferir") — isso sinaliza que é só a 1ª metade da operação.

5. Clica Registrar remessa.
6. A transferência aparece na lista com badge "Em trânsito" e destino mostra "aguarda recebimento":

O que aconteceu:

• Saída de 4 UN do Escritório Principal
• Entrada de 4 UN em "Em Trânsito" (depósito invisível do sistema)
• Aba "Pendentes" ganha o badge 1

Confirmando o recebimento

Quando a mercadoria chegar, abra a aba Pendentes:

Clica Confirmar recebimento no item. Isso faz:

• Saída de 4 UN de "Em Trânsito"
• Entrada de 4 UN no destino final (Filial Sul)

A transferência muda pra badge "Concluída (com trânsito)" e some da aba Pendentes:

Agora o saldo reflete tudo:

No exemplo acima — partindo de 33 UN no Escritório Principal — ficou:

• Escritório Principal: 23 UN (saíram 3 + 3 + 4)
• Estoque Filial Sul: 10 UN (entraram 3 + 3 + 4)
• Em Trânsito: 0 UN (subiu e desceu no processo)

Regras e validações

Kardex depois da transferência

Cada transferência gera 2 movimentos (simples) ou 4 movimentos (com trânsito — 2 na remessa + 2 no recebimento). No kardex do produto, a coluna Origem mostra "Transferência".

Como todos os movimentos carregam o mesmo ID de transferência, auditar fica fácil — dá pra rastrear um envio inteiro.

Casos de uso recomendados

Como NÃO usar transferência

• Venda → é NFe, não transferência
• Devolução pra fornecedor → é NFe de devolução + estoque baixa via saga (Cap. E8)
• Ajuste de quebra ou perda → Cap. E6
• Movimentar consignação → NFe fiscal, não operação interna

Capítulo E8 — NFe e Estoque (integração automática)

Do que se trata

Quando você emite uma NFe de venda pra um produto que controla estoque, o sistema automaticamente dá baixa no estoque. Quando a NFe é cancelada, o estoque volta sozinho (estorno).

Não tem "botão de movimentar estoque" pra NFe — é tudo feito em uma única operação, sem você precisar apertar nada. O próprio ato de emitir a NFe é o que movimenta.

Este capítulo explica o que acontece nos bastidores pra você entender o que aparece no kardex quando emite uma nota.

Os 3 momentos da saga

Momento 1 — ANTES de enviar pra SEFAZ

Quando você clica "Emitir NFe", antes de o sistema mandar qualquer coisa pra receita federal, ele valida o saldo:

• Pega o depósito padrão do workspace
• Pra cada item da nota que controla estoque, verifica se tem saldo suficiente
• Se faltar saldo em algum item:
  • Se o depósito ou o produto permitem saldo negativo → a nota é emitida assim mesmo e o saldo fica negativo no kardex
  • Se nenhum dos dois permite → a emissão é bloqueada com mensagem clara, exemplo:

    "Estoque insuficiente: produto 'Agenda executiva A5 capa dura' tem 5 no depósito 'Escritório Principal', emissão precisa de 10"

Essa verificação é por item — se 9 itens passam e 1 falha, a NFe inteira é bloqueada (nada de emitir parcial).

Momento 2 — APÓS SEFAZ autorizar

Se a SEFAZ autorizou a nota (status "autorizada"), o sistema imediatamente cria no kardex um movimento de Saída por cada item controlado:

• Depósito: o padrão do workspace
• Tipo: Saída
• Quantidade: a do item da nota
• Custo unitário: o custo médio atual do produto naquele depósito (não o preço de venda da nota)
• Origem: "NFe emitida #XXX"

Você vê o kardex atualizado assim que a nota fica autorizada — não precisa fazer nada, não precisa esperar cron, é síncrono.

Momento 3 — APÓS cancelamento

Se você cancelar a NFe mais tarde (dentro do prazo legal), o sistema faz o caminho inverso:

• Localiza os movimentos originais da nota
• Pra cada um, cria um movimento de Entrada com badge "Estorno"
• O saldo volta ao que era antes

Os movimentos originais não são apagados — ficam com risco e desbotados no kardex, pra preservar a auditoria. Aparece um novo par (entrada de estorno) em cima.

O que precisa estar configurado

Pra saga funcionar, 3 coisas precisam estar no lugar:

Se faltar depósito padrão, o sistema bloqueia a emissão com:

"Estoque: nenhum depósito padrão configurado no workspace — marque um depósito físico como padrão antes de emitir NFe com produtos controlados"

Quais NFes mexem no estoque e quais não

Controlado por 2 gates:

• TipoOperacao.movimentaEstoque — venda, devolução-cliente, etc movimentam. Bonificação, remessa, simples-faturamento normalmente não.
• Produto.controlaEstoque — serviço não movimenta; produto controlado sim.

Se qualquer dos dois for false, o item passa direto — sem bloqueio, sem movimento.

Resumo em tabela:

Visualizando no kardex

Abra o kardex do produto (Cap. E5) e veja a coluna Origem:

• "NFe emitida #123" — saída automática da nota autorizada
• "Estorno" com badge laranja — entrada de reversão após cancelamento
• Linha com risco e desbotada — movimento original estornado

O #123 é o número da nota — clicando nele não abre nada no MVP (em futuras versões poderá levar direto pra tela da nota).

Quando algo dá errado

"Estoque insuficiente: produto X tem Y, emissão precisa de Z"

Saldo do produto no depósito padrão é menor que a quantidade na nota.

Como resolver:

1. Registrar entrada que falta (Cap. E6 ou via NFe recebida de compra)
2. OU permitir saldo negativo no produto ou no depósito (Cap. E2/E3)
3. OU trocar pro produto certo / corrigir a quantidade na nota

"Depósito padrão não configurado"

Nenhum depósito físico está marcado como padrão.

Como resolver: Cap. E2 → menu "..." num depósito físico ativo → "Marcar como padrão".

"Depósito padrão está desativado"

O depósito padrão foi desativado e não foi passado pra outro.

Como resolver: Cap. E2 → marcar outro físico como padrão, ou reativar o anterior.

Nota autorizada mas estoque não mexeu?

Isso é raro mas pode acontecer se:

• O TipoOperacao dessa NFe não movimenta estoque (verificar cadastro)
• Nenhum produto da nota tinha "Controla estoque" ligado
• Houve falha crítica entre SEFAZ autorizar e registrar o movimento — nesse caso, contate suporte: a equipe tem log de incidentes e pode registrar manualmente.

Regra de consistência: NFe autorizada pela SEFAZ nunca é "desautorizada" — se o registro de estoque falhar, a nota continua válida. A correção é manual (ajuste com observação "Correção saga NFe #X falha"), nunca rollback da nota.

Custo médio e NFe

Quando a saída é registrada, o custo médio fica como está (custo médio histórico do depósito). A saída consome ao custo médio — não recalcula.

Quando a entrada de estorno acontece, o sistema usa o mesmo custo unitário do movimento original (guardado no kardex). Isso garante que cancelar e re-emitir não distorce o custo médio futuro.

Contagem

Cada NFe pode gerar de 0 a N movimentos no kardex:

• Nota só com serviços → 0
• Nota com 1 produto controlado → 1
• Nota com 3 produtos controlados → 3
• Nota com 5 itens (3 produtos + 2 serviços) → 3

O cancelamento gera a mesma quantidade em movimentos de estorno.

Capítulo E9 — Proteções contra perda de dados (guards)

Do que se trata

O módulo de estoque tem uma série de proteções automáticas pra evitar que você perca dados ou deixe o sistema em estado inconsistente. Esses "guards" aparecem quando você tenta fazer operações que parecem inofensivas mas podem corromper a contabilidade do estoque.

Este capítulo lista o que é bloqueado e por quê — pra você entender os erros que pode ver e saber como sair deles.

Guards em depósitos

Não pode desativar depósito com saldo > 0

O que acontece: você clica em "Desativar" num depósito e aparece o diálogo de confirmação.

Se você confirmar e o depósito tem qualquer produto com saldo diferente de zero, o sistema recusa com mensagem tipo:

"Depósito possui 3 produto(s) com saldo não-zero — zere os saldos antes de desativar"

Por quê: desativar um depósito com saldo seria esconder estoque "real" do sistema — no dia-a-dia ninguém ia ver aquele depósito, mas o saldo ficaria flutuando. Auditoria vira um caos.

Como resolver:

• Transferir o saldo pra outro depósito (Cap. E7) — preferível
• OU registrar saídas de ajuste (Cap. E6) pra zerar, se a mercadoria não existe mais
• Depois, volte e desative

Não pode desativar o depósito padrão

O que acontece: se você tentar desativar o depósito que tem a estrela "Padrão", o sistema recusa:

"Depósito padrão não pode ser desativado — marque outro como padrão primeiro"

Como resolver: no menu "..." de outro depósito físico ativo, clique "Marcar como padrão". A estrela muda pra ele. Aí você pode desativar o anterior.

Depósito "Em Trânsito" é intocável

O depósito do sistema "Em Trânsito" (com badge "Sistema") não tem menu de ações — nem editar, nem desativar, nem marcar como padrão:

Por quê: é usado automaticamente pelas transferências em 2 etapas (Cap. E7). Se você desativasse ou editasse, transferências em andamento quebrariam.

Guards em produtos

Não pode desligar "Controla estoque" se tem movimentos

O que acontece: você abre um produto pra editar, desmarca "Controla estoque" e tenta salvar. Se o produto tem qualquer movimento no kardex (mesmo saldo inicial), o sistema recusa:

"Produto possui movimentos de estoque — não pode desligar controle. Considere desativar o produto."

Por quê: desligar o controle deixaria os movimentos passados "órfãos" — o kardex teria histórico, mas o saldo atual não seria calculado. Inconsistência.

Como resolver:

• Se o produto acabou — desative em vez de desligar controle. Movimentos ficam preservados.
• Se o produto nunca devia ter controle e foi erro — zere o saldo primeiro e depois desligue.

Não pode deletar produto com movimentos

Delete de produto é bloqueado pelo sistema quando existe qualquer movimento vinculado. A mensagem é direta — o produto participa da contabilidade do estoque e não pode sumir.

Como resolver: sempre prefira desativar em vez de deletar. Produto inativo some das listas de seleção mas mantém o histórico.

Guards em movimentos (kardex)

Movimentos são imutáveis

Você não pode editar nem deletar um movimento do kardex. Não existe botão de editar nas linhas do kardex (Cap. E5).

Por quê: kardex é o livro-razão do estoque — editar um movimento do passado recalcularia todo o custo médio pra frente. Auditoria quebra.

Como resolver: se registrou errado, faça um movimento inverso (entrada se a original foi saída, e vice-versa) com observação tipo "Estorno do #15 — registrado por engano".

Saldo inicial é único por produto × depósito

Você só pode registrar 1 movimento de "Saldo inicial" pra cada combinação produto × depósito (Cap. E4). Se tentar registrar um segundo, o sistema recusa:

"Saldo inicial já registrado para este produto neste depósito — use ajuste (Cap. E6)"

Por quê: saldo inicial é a foto do início — se pudesse ser registrado 2 vezes, o kardex teria 2 pontos de origem e o custo médio ficaria inconsistente.

Como resolver: use Ajuste (Cap. E6) pra qualquer correção depois da carga inicial.

Guards em transferências

Origem ≠ destino

Não dá pra transferir um depósito pra ele mesmo — valida no formulário antes mesmo de enviar.

Saldo suficiente na origem

Transferência que deixaria o depósito origem com saldo negativo é bloqueada, a não ser que o depósito OU o produto permitam saldo negativo (Cap. E2 e E3).

Confirmar recebimento só uma vez

Transferência "Em trânsito" só aceita uma confirmação de recebimento. Se alguém clicar de novo, o sistema recusa com:

"Transferência já foi concluída"

Depósito consignação não participa

Depósitos do tipo "Consignação" não aparecem nos dropdowns de transferência — consignação move via NFe fiscal (CFOP 5.917/6.917), não via transferência interna.

Guards em NFe

Já cobertos no Cap. E8, em resumo:

• Pré-emissão: saldo insuficiente bloqueia a NFe (a não ser que saldo negativo esteja permitido)
• Pós-emissão: se autorizou na SEFAZ, o movimento precisa entrar — qualquer falha vira incidente de suporte, não rollback
• Depósito padrão obrigatório: sem um padrão físico ativo, nenhuma NFe com produto controlado emite

Por que tantos guards?

Contabilidade de estoque é simples de destruir. Um único movimento incorreto, um saldo ajustado fora do kardex, um produto com controle desligado na hora errada — qualquer um desses cria uma inconsistência que é cara de corrigir depois (especialmente se você precisa defender o saldo pra contador, fiscal ou auditoria).

Os guards estão ali pra forçar você a fazer as coisas pela porta da frente: ajuste, transferência, desativação. Isso sempre deixa rastro no kardex, sempre mantém o saldo consistente, sempre é auditável.

Quando você vê um guard bloquear uma operação, a resposta raramente é "como forço isso" — é "como consigo fazer pela porta da frente". O manual dos capítulos anteriores tem o caminho.

Resumo dos guards

Capítulo F1 — O que é um Lançamento Financeiro

Do que se trata

No EmitindoAI tudo que envolve dinheiro passa por um único conceito: o lançamento.

• Uma fatura que você emitiu e o cliente ainda não pagou → lançamento
• O boleto do aluguel que vence no dia 15 → lançamento
• O dinheiro que entrou no caixa e você deu baixa → lançamento
• Uma transferência que você fez do Bradesco pro Santander → dois lançamentos vinculados
• O saldo inicial quando você cadastrou uma conta nova → lançamento

Unificar tudo sob um mesmo conceito facilita pra gente, mas você não precisa se preocupar com isso — no dia-a-dia você verá telas específicas (Contas a Receber, Contas a Pagar, Caixa) que trabalham sobre esse mesmo conceito por baixo.

Este capítulo explica os dois atributos que definem cada lançamento (Tipo e Situação) pra você entender o que vê nas telas.

Os 2 atributos fundamentais

1. Tipo — o que o lançamento é

São 6 tipos, organizados em 3 pares:

Duas coisas importantes pra você entender:

1. Receber vira Recebido sozinho. Você não "muda o tipo" — o sistema faz isso automaticamente quando você dá baixa completa num título. O mesmo pra Pagar → Pago. Se a baixa é parcial, o título continua Receber (só com saldo menor).

2. Entrada e Saída podem ter duas origens:

• Avulsos (sem título pai) — ex: saldo inicial do portador, tarifa bancária, transferência entre suas contas, ajuste manual
• Filhos de uma liquidação — quando você dá baixa num Receber, nasce 1 Entrada que "aponta pro Receber pai". Quando faz baixa parcial, o Receber continua aberto (com saldo menor) e o Entrada registra a parte que caiu

Esse detalhe da origem você vê no detalhe do lançamento, campo "Lançamento original" (quando é filho) ou "Origem" (quando é avulso). No dia-a-dia operando o sistema você raramente precisa se preocupar — a tela de Contas a Receber resolve tudo com um botão "Liquidar" e o sistema cria a estrutura certa por trás.

2. Situação — o estado atual do lançamento

São 7 situações possíveis (3 principais, 4 específicas):

No dia-a-dia você lida basicamente com as 3 primeiras. As 4 específicas aparecem nos detalhes de liquidações mais complexas ou em templates de recorrência.

A situação muda conforme a operação acontece. Um Receber começa Aberto → ao ser totalmente pago, o sistema muda o tipo pra Recebido (situação continua Liquidado). Uma transferência nasce já com saldo zero e situação Transferencia.

Projetado vs Confirmado

Na tela de Caixa (Cap. F7) você vai ver dois termos importantes. A classificação é por tipo, não por situação:

• Confirmado — lançamentos com tipo Recebido, Pago, Entrada ou Saída. Já representam movimento real de dinheiro, independentemente da situação (Liquidado, Transferência, Juros, Multa ou Desconto). Somam no saldo real.
• Projetado — lançamentos de título em aberto: tipo Receber ou Pagar com situação Aberto (saldo > 0). Ainda não aconteceu, mas está previsto.

Exemplo da tela de caixa:

Entradas R$ 645,00 — R$ 300,00 confirmado + R$ 345,00 projetado

Isso significa: no mês, já entraram R$ 300 de verdade (movimentos Entrada/Recebido), e ainda tem R$ 345 previstos em Receber Abertos que vão cair quando forem pagos.

De onde vêm os lançamentos

Todo lançamento carrega um campo Origem que diz de onde ele nasceu. As possibilidades:

Saldo inicial do portador não é um lançamento — é um campo do próprio portador (ver Cap. F2).

Lançamentos com origem diferente de "manual" carregam referências cruzadas (contratoId, ordemServicoId etc). Isso ajuda na auditoria — o sistema sabe, por exemplo, que "o lançamento #8 veio da parcela 3/12 do contrato CT-00001".

Exemplos práticos

Cenário 1 — Você emitiu uma NFS-e pro cliente (pagamento total)

1. Hoje: você emite NFS-e por R$ 1.000 → nasce #50 Receber, Aberto com vencimento daqui 10 dias, saldo R$ 1.000
2. Daqui 10 dias: cliente paga o boleto integral → nasce #51 Entrada, Liquidado com pai #50, valor R$ 1.000
3. Como o saldo de #50 zerou, o sistema muda automaticamente o tipo de Receber pra Recebido

No fim: título #50 fica Recebido Liquidado, e o movimento #51 é o filho que efetivou a baixa.

Cenário 2 — Fornecedor mandou o boleto da luz

1. Você cadastra em Contas a Pagar → nasce Pagar, Aberto com vencimento no dia 15
2. Dia 15 você paga → vira Pago, Liquidado

Cenário 3 — Transferência entre suas contas

Transferência de R$ 300 do Bradesco pro Santander gera 2 lançamentos vinculados:

• #34 → Saída, Transferência no Bradesco, valor −R$ 300
• #35 → Entrada, Transferência no Santander, valor +R$ 300

Eles ficam linkados — o detalhe de um aponta pro outro (veja Cap. F7).

Cenário 4 — Correção de saldo (quando o extrato não bateu)

Você percebe que no Santander faltou R$ 50 (talvez uma tarifa que esqueceu de lançar). Registra uma Saída avulsa no valor de R$ 50 com categoria "Tarifas bancárias" → nasce Saída, Liquidado no Santander.

Cenário 5 — Baixa parcial com juros (quando as coisas ficam interessantes)

Um cliente tem um Receber de R$ 1.000 vencido, e você combina que ele paga R$ 400 agora e o resto depois. Também cobra R$ 20 de juros pelo atraso.

Quando você clica "Liquidar parcialmente" e informa R$ 400 + R$ 20 de juros:

1. Nasce #60 Entrada, Liquidado com pai = o Receber original, valor R$ 400
2. Nasce #61 Entrada, Juros (situação especial "Juros") com pai = mesmo Receber, valor R$ 20
3. O Receber original continua Aberto, mas agora com saldo R$ 600 (os 1000 − 400 baixados)

Quando o cliente pagar o resto dos R$ 600:

4. Nasce #75 Entrada, Liquidado com pai = o Receber, valor R$ 600
5. O saldo do Receber zera → tipo muda pra Recebido

No fim, olhando pro kardex desse cliente, você vê:

• O título (Receber → Recebido) com valor original R$ 1.000
• 3 filhos: R$ 400 (parte 1), R$ 20 (juros), R$ 600 (parte 2) — somam R$ 1.020 de Entrada no seu caixa
• Tudo rastreável e auditável

Por que essa estrutura unificada

Duas vantagens práticas pra você:

1. O saldo dos portadores é sempre preciso — qualquer lançamento (título liquidado, movimento avulso, transferência) atualiza o saldo automaticamente.
2. Relatórios consolidados funcionam de verdade — "quanto entrou de verdade este mês" cobre tudo: pagamentos de NFS-e, entradas manuais, recebimentos de contratos. Nada fica de fora.

Você não precisa escolher "qual tipo de tela usar" — o sistema sempre aponta pra tela certa (CR, CP, Caixa) de acordo com o tipo/situação do lançamento.

Capítulo F2 — Portadores (contas bancárias, caixas e carteiras)

Do que se trata

Portador é onde o dinheiro fica. Pode ser:

• Conta bancária (ex: Bradesco Ag 0537 CC 12345-6)
• Caixa físico (dinheiro no cofre, gaveta)
• Carteira digital (PayPal, Mercado Pago, PIX com agente)

Todo lançamento que envolve entrada ou saída de dinheiro aponta pra um portador. O saldo de cada portador é calculado pela soma dos lançamentos ligados a ele.

Você precisa ter pelo menos 1 portador cadastrado antes de começar a operar o financeiro.

Como entrar

Menu lateral → Portadores (seção Financeiro).

O que tem na tela

Cada portador aparece como um card com:

• Nome (apelido que você escolheu)
• Tipo (caixa/carteira ou identificação bancária)
• Badge "Ativo" (inativos só aparecem se marcar o checkbox no topo)
• Saldo inicial + data em que foi configurado
• Botão "Configurar banco" — pra conectar integração de cobrança (boleto/PIX via Cora, Asaas, Sicoob, Inter — tema de outro capítulo)
• Botão "Mais ações" (ícone ···) — editar, desativar

Cadastrando um portador novo

1. Clica no botão "Novo Portador" no topo direito.
2. Preenche o formulário:

3. Clica "Criar portador".

O novo card aparece na lista:

Como o saldo inicial entra nas contas

O saldo inicial não é um lançamento — é um campo próprio do portador. O sistema calcula o saldo atual somando:

saldo atual = saldo inicial + entradas confirmadas − saídas confirmadas

É por isso que, no Caixa (Cap. F7), a linha "Saldo de abertura" aparece com esse valor — ela não é um lançamento na lista, é um cálculo sintético.

Implicações práticas:

• Se você editar o saldo inicial depois, o saldo atual se recalcula na hora
• A data do saldo inicial marca a partir de quando os lançamentos confirmados começam a contar pra abertura do mês

Dicas de quando usar cada tipo

Portador × Integração bancária

Atenção: portador é só "onde o dinheiro fica" — não é a mesma coisa que "integração bancária pra emitir boleto/PIX".

• Você pode ter um portador Bradesco sem integração (usa pra controle interno de saldo, não emite cobrança por ele)
• Pode ter integração Cora (emite boleto/PIX) ligada ao portador "Cora" — cobranças emitidas caem nesse portador quando pagas
• Pode ter integração Asaas num portador só

Cada portador tem no máximo 1 integração ativa. Configure em "Configurar banco" no card do portador. (Detalhes de cada provedor em capítulo dedicado — Cora, Asaas, Sicoob, Inter.)

Editar, desativar, ordenar

No botão "Mais ações" (···) de cada card:

• Editar — mudar apelido, saldo inicial (com atenção!), dados bancários
• Desativar — some da maioria das listas de seleção, mas mantém histórico de lançamentos
• Reativar — voltar um inativo pra operação

Cuidado ao editar saldo inicial

Se você já tem lançamentos vinculados ao portador e muda o saldo inicial, o saldo atual recalcula (saldo inicial + entradas − saídas). Isso é útil pra correção de abertura, mas pense antes — talvez seja melhor fazer um ajuste de entrada ou saída (Cap. F7).

Guards e regras

Capítulo F7 — Caixa (lançamentos consolidados)

Do que se trata

A tela de Caixa é onde você vê todos os lançamentos do workspace num único lugar, organizados por mês. É a tela operacional do dia-a-dia financeiro — lê tudo, filtra, transfere entre contas.

Não é pra cadastrar títulos longos (use Contas a Receber e Contas a Pagar). É pra ver o movimento e fazer ajustes rápidos.

Como entrar

Menu lateral → Caixa (seção Financeiro).

O que tem na tela

1. Cards de totalizadores (topo)

Leitura do card "Saldo Final": o valor grande reflete a variação dos projetados sobre a abertura; o subtítulo confirmado reflete a variação do que já caiu de fato. Os dois podem estar distantes — é normal ter muito projetado ainda a cair.

2. Header com navegação

• Botão "Transferência" — abre modal pra transferir entre portadores (detalhe abaixo)
• Botão "Recarregar" — reconsulta dados (útil se alguém lançou em outra aba)
• Setas e "Abril 2026" — navegar entre meses

3. Lateral esquerda — lista de Portadores

Cada portador mostra:

• Abertura — saldo no início do mês
• Atual — saldo agora (considera confirmados até hoje)
• Projetado — saldo no fim do mês se tudo previsto cair

Clicar num portador filtra a tabela só com os lançamentos dele. Clicar em "Todos" volta pra visão consolidada.

4. Tabela de lançamentos

Filtros no topo da tabela:

• Buscar por descrição — texto livre
• Todos / Confirmados / Projetados — toggles

Rodapé mostra N lançamento(s).

Transferência entre portadores

Exemplo: mover R$ 300 do Bradesco pro Santander.

1. Clica "Transferência" no topo direito.
2. Preenche:

3. Clica "Salvar transferência".

O que acontece: o sistema cria 2 lançamentos vinculados (par):

• Um Saída, situação Transferência, no portador origem (valor negativo)
• Uma Entrada, situação Transferência, no portador destino (valor positivo)

Ambos nascem com saldo zero (não há nada em aberto) e com a data que você informou (default: hoje). O caixa trata qualquer Entrada/Saída como Confirmado — ou seja, a transferência é contabilizada imediatamente no saldo dos portadores. Se a data for anterior ao mês aberto no caixa, o valor entra no saldo de abertura; se for dentro do mês, aparece como linha na tabela; se for futura, só aparece quando você navegar pra esse mês.

Resultado na tela

Depois de salvar:

Repare:

• 2 linhas novas com status Confirmado, uma com −R$ 300 e outra com +R$ 300
• Saldo do Bradesco caiu de R$ 1.500 pra R$ 1.200 (lateral esquerda)
• Saldo do Santander subiu de R$ 0 pra R$ 300
• Saldo Final consolidado não mudou (dinheiro foi redistribuído, não entrou nem saiu da empresa)

Detalhe de um lançamento

Clica no ícone de olho (👁️) na linha do lançamento pra ver detalhes:

Campos mostrados:

Ações:

• Sair — fecha o modal
• Excluir — comportamento depende do que o lançamento é:
  • Transferência (situação Transferencia) → o par inteiro é removido junto
  • Filho principal de uma liquidação (Entrada/Saida com pai) → remove esse filho e os filhos de juros/multa/desconto do mesmo pagamento, e o pai volta a ficar Aberto (se estava Recebido/Pago, regride pra Receber/Pagar)
  • Filho só de juros/multa/desconto → bloqueado; exclua o pagamento principal (que cascateia os acessórios juntos)
  • Título (Receber/Pagar/Recebido/Pago) com filhos ainda vinculados → bloqueado; exclua primeiro os pagamentos/filhos
  • Lançamento avulso sem vínculos (Entrada/Saída isolados, título sem filhos) → apagado direto

Como ler o mês

O caixa sempre mostra um mês por vez. Navegue com as setas ao lado de "Abril 2026" pra ir pra fevereiro ou junho, por exemplo.

• Saldo de abertura = saldos iniciais dos portadores + lançamentos confirmados com data anterior ao mês selecionado
• Todos os lançamentos com data dentro do mês aparecem na tabela; os com data anterior entram na abertura; os com data posterior ficam ocultos até você navegar pra o mês correspondente
• Saldo final (subtítulo "Confirmado") = abertura + variação dos lançamentos já confirmados. Reflete o saldo "real" considerando só movimentos concretos

Casos de uso no dia-a-dia

Casos que não são pra fazer aqui