Estoque e Compras

Guia para estoquistas — entrada de mercadorias, fornecedores e controle de validade.

Acesso

Disponível para papéis: estoquista, gerente e proprietário.

Menu: Estoque, Fornecedores, Produtos.

No PDV Gerencial WPF, produtos e saldos ficam em Produtos e estoque; fornecedores, pedidos

e recebimentos ficam em Compras e fornecedores. As telas Angular equivalentes continuam

disponíveis e usam a mesma API.

Cadastro de produtos

A lista mostra todos os produtos da loja, com preço e ações de editar/ajustar/desativar:

Novo produto

1. Acesse Produtos
2. Clique em + Novo produto
3. Preencha:
4. Nome — como aparece no PDV
5. Preço de venda
6. Código de barras (EAN) — essencial para scan no caixa
7. SKU — código interno (opcional)
8. Unidade — un, kg, l, etc.
9. Imagem (URL) — foto do produto exibida no caixa (opcional)
10. Salve

Foto do produto

Cole o endereço (URL) de uma imagem no campo Imagem — uma prévia aparece ao lado do campo.

No caixa, a foto é exibida na busca e nos itens da venda, ajudando o operador a confirmar o

produto certo. Produto sem foto mostra um ícone de pacote (nada quebra).

Dicas de onde obter a URL:

• Consulta por código de barras (Cosmos): quando configurada pelo administrador, a consulta

de um EAN desconhecido já traz descrição, NCM, marca e foto sugerida.

• Carga inicial: produtos importados por planilha podem vir com a coluna de imagem preenchida.
• Manual: copie o endereço da imagem no site do fabricante (botão direito → "Copiar endereço

da imagem"). Use sempre endereços https://.

Importar uma planilha de produtos

Na página Produtos, clique em Importar planilha e selecione um arquivo .xlsx ou .csv.

O sistema primeiro apresenta uma prévia e não grava nada nessa etapa. Confira produtos prontos,

avisos, cadastros já existentes, linhas inválidas e duplicidades antes de confirmar.

O SKU do produto importado é o próprio código de barras da planilha — o mesmo código que o

operador bipa no caixa. Se o arquivo também tiver uma coluna de código interno, ela é ignorada e a

prévia avisa na linha; o código interno só vira SKU quando a linha não traz código de barras.

Quando um código se repete no mesmo arquivo, a primeira linha é considerada e as seguintes aparecem

como Duplicado e são desconsideradas. Código que não seja um GTIN válido continua pesquisável

como SKU, mas não é enviado como EAN na NFC-e. O saldo inicial é lançado somente na loja

selecionada e gera um movimento de estoque auditável.

Linhas inválidas bloqueiam a confirmação. Produtos sem NCM são aceitos com aviso e precisam ser

classificados antes da operação fiscal em produção, com apoio do contador ou pela NF-e do fornecedor.

Produtos cadastrados antes dessa regra mantêm o SKU antigo, e reimportar a planilha não os

corrige — eles são reconhecidos como já cadastrados e ignorados. O administrador pode alinhar o

catálogo inteiro de uma vez (o procedimento está no manual técnico, em Carga de catálogo); a

operação mostra antes o que mudaria e não altera produtos sem código de barras.

Editar ou desativar

• Clique no produto na lista para editar
• Desativar remove da busca do caixa (não apaga histórico)

Fornecedores

1. Acesse Compras e fornecedores no gerencial WPF, ou Fornecedores no Angular
2. Cadastre nome, razão social, CNPJ ou CPF, inscrição estadual, contato e cidade/UF
3. Fornecedores ativos aparecem nos pedidos novos
4. Desativar preserva pedidos e entradas anteriores

Pedido de compra no gerencial WPF

1. Selecione a loja no cabeçalho
2. Em Compras e fornecedores, escolha fornecedor e previsão de entrega
3. Busque os produtos e ajuste quantidade e custo previsto
4. Clique em Criar pedido — ele permanece em rascunho e não movimenta estoque
5. Revise e use Marcar como enviado para atribuir o número sequencial da loja
6. Quando a mercadoria chegar, selecione o pedido e confira quantidade, custo, lote e validade
7. Clique em Receber mercadorias e confirme a operação

Somente o último passo cria a entrada, aumenta o saldo, atualiza o último custo e registra os lotes

e movimentos. Pedido cancelado permanece no histórico e não movimenta estoque.

Entrada de mercadoria

Registra compra de fornecedor e atualiza estoque.

1. Acesse Estoque
2. Clique em Nova entrada
3. Selecione o fornecedor
4. Informe número da nota fiscal
5. Adicione itens:
6. Produto (busca por nome ou código)
7. Quantidade
8. Custo unitário
9. Lote e validade (quando aplicável)
10. Confirme a entrada

O saldo do produto aumenta automaticamente.

Importar NF-e do fornecedor

1. Em Estoque, cole o XML da nota (ou envie o arquivo .xml) e clique em Importar XML
2. O sistema casa os produtos pelo código de barras ou pelo código do fornecedor
3. Além de quantidade e custo, a nota traz NCM, CEST e origem — e o sistema ajuda a

aproveitá-los (veja abaixo)

1. Revise a entrada e confirme

Economiza digitação em compras grandes — e evita que produto novo entre sem classificação fiscal.

Aproveitando os dados fiscais da nota

Depois de importar, podem aparecer três blocos de ação:

• 🟢 Produtos sem NCM — quando um produto que você já tem está sem NCM e a nota traz o do

fornecedor, um botão "Completar NCM/CEST com a NF-e" preenche de uma vez. Ele só preenche o

que está vazio: nada que você já cadastrou é alterado.

• 🟡 NCM diferente — quando o NCM da nota diverge do que você cadastrou, o sistema **avisa e

mantém o seu**. Não troca sozinho: o NCM do fornecedor também erra, então confira com seu contador

antes de mudar.

• ⬜ Itens novos — para o que ainda não existe no seu catálogo, o botão "Cadastrar" cria o

produto já com NCM, CEST e origem vindos da nota, e o inclui na entrada. O produto entra

sem preço de venda (isso é decisão sua, não do fornecedor) — defina depois em Produtos.

O que a nota do fornecedor NÃO define: o CFOP e o CST/CSOSN da nota são da operação e

do regime tributário dele, não seu. Um fornecedor no Regime Normal usa códigos diferentes dos

seus, do Simples. Por isso esses campos não são copiados — o produto usa o padrão fiscal da

sua loja (ou o que você definir no cadastro). Só o que pertence à mercadoria — NCM, CEST e origem —

vem da nota.

Lotes e validade

Para produtos perecíveis e medicamentos:

• Informe lote e data de validade na entrada
• Consulte Lotes a vencer em Estoque
• Alerta padrão: 30 dias (configurável na consulta)

Priorize venda dos itens mais próximos do vencimento (FEFO).

Ajuste de inventário

Quando o saldo físico difere do sistema:

1. Estoque → Ajustar saldo
2. Selecione o produto
3. Informe a quantidade real contada
4. Descreva o motivo (inventário, perda, etc.)

Receitas e produção (padaria)

Se sua loja é padaria:

Ficha técnica (Receitas)

1. Receitas → Nova receita
2. Nome (ex.: "Pão de forma")
3. Ingredientes com quantidades
4. Produto final e rendimento

Produção

1. Produção → Nova ordem
2. Selecione a receita
3. Informe quantos lotes produzir
4. O sistema consome insumos e gera o produto acabado

Boas práticas

• Cadastre código de barras em todos os produtos possíveis
• Faça entradas no mesmo dia da recebimento da mercadoria
• Confira lotes e validades na conferência
• Rode inventário periódico (mensal/trimestral)
• Mantenha fornecedores atualizados

Relatórios úteis

• Lotes a vencer (Estoque)
• Histórico de entradas (Estoque → Entradas)

Para relatórios gerenciais completos, consulte o Guia do Gerente.