Manual robusto de utilizacao
VASI Commerce
Gestao de vendas, CRM, producao, compras, estoque, financeiro e fiscal para uma doceria.
Como usar este manual
Este manual foi escrito para quem vai operar o VASI Commerce no dia a dia. Ele evita termos tecnicos quando a pessoa nao precisa deles e mostra exemplos preenchidos com dados ficticios da empresa Doceria Aurora Ficticia.
Ideia central: a atendente faz uma acao simples, e o sistema cuida das rotinas por tras: estoque, CRM, financeiro, producao, compras, fiscal, auditoria e dashboard.
Para atendente
Use principalmente Nova Venda, Pedidos, Clientes, Produtos e WhatsApp.
Para doceira
Use Producao e Lista de Compras. Nao e necessario abrir fiscal ou financeiro.
Para gerente
Acompanhe dashboard, excecoes, pedidos, estoque, compras e financeiro basico.
Para administrador
Configure regras, permissoes, fiscal, XML, relatorios e auditoria.
Acesso de treinamento local
A base local de exemplo pode ser criada pelo script node scripts/seed-commerce-manual-demo.js. Ela cria apenas dados ficticios.
Empresa
Doceria Aurora Ficticia
Usuario
treinamento@aurora.local
Senha
Aurora@123456
Ambiente
Uso para treinamento, manual e homologacao interna.
Estes dados sao ficticios. Nao use CPF, CNPJ, telefone ou email real em treinamento.
Perfis de usuario
Atendente
- Nova venda
- Pedidos
- Clientes
- Consulta de produtos
- Mensagens WhatsApp
Doceira / Producao
- Pedidos para produzir
- Agenda de entregas
- Lista de compras
- Status da producao
Caixa
- Recebimentos
- Formas de pagamento
- Vendas do dia
- Saldos em aberto
Gerente
- Aprovacoes
- Estoque
- Compras
- Financeiro basico
- Relatorios
Administrador
- Configuracoes
- Permissoes
- Fiscal
- Exportacao XML
- Auditoria
Fluxos principais
Venda de balcao
- Buscar cliente ou consumidor nao identificado
- Adicionar produtos
- Informar pagamento
- Escolher nota
- Finalizar
Encomenda
- Selecionar cliente
- Informar entrega
- Adicionar produtos
- Receber sinal
- Liberar producao
- Entregar e receber saldo
Producao
- Ver pedidos de hoje
- Abrir pedido
- Marcar em producao
- Marcar pronto
- Avisar atendimento
Compras
- Ver sugestoes
- Adicionar itens
- Enviar fornecedor
- Receber mercadoria
- Atualizar estoque
Fiscal mensal
- Conferir notas
- Corrigir pendencias
- Exportar XML
- Enviar ZIP ao contador
Telas printadas e explicadas
Os prints abaixo usam dados ficticios e foram preparados para mostrar como a operacao deve aparecer para treinamento.
Tela 1 | Todos
Login e escolha da empresa
Entrar no VASI e escolher a empresa correta antes de operar.
Como usar
- Informe email e senha.
- Escolha a empresa quando aparecer a lista.
- Clique em Entrar.
- Confira o nome da empresa no topo.
Exemplo preenchido
Usuario treinamento@aurora.local acessando a empresa Doceria Aurora Ficticia.
- treinamento@aurora.local
- Senha
- Aurora@123456
- Empresa
- Doceria Aurora Ficticia
Cuidados
Nunca compartilhe senha. Se entrar na empresa errada, saia e entre novamente.
Tela 2 | Administrador, Gerente, Atendente, Doceira
Dashboard comercial
Ver rapidamente vendas, pedidos, producao, contas, estoque e alertas.
Como usar
- Abra Gestao Comercial.
- Entre em Dashboard.
- Leia os cards principais.
- Clique no alerta que precisa de acao.
Exemplo preenchido
A gerente abre o dia e identifica 3 pedidos em producao, 4 itens abaixo do minimo e R$ 642,50 a receber.
Cuidados
O dashboard resume a operacao. Use os menus detalhados para corrigir ou atualizar cada item.
Tela 3 | Atendente e Caixa
Nova venda de balcao
Registrar uma venda rapida sem exigir conhecimento fiscal ou financeiro.
Como usar
- Busque o cliente ou use consumidor nao identificado.
- Adicione os produtos pela galeria.
- Confira desconto ou acrescimo.
- Informe pagamento.
- Escolha se emite nota.
- Finalize.
Exemplo preenchido
Maria comprou 2 fatias de bolo e 2 refrigerantes, pagou no PIX e nao pediu nota.
- Cliente
- Maria Oliveira
- Produto
- Fatia Bolo Ninho com Morango
- Quantidade
- 2
- Pagamento
- PIX
- Emitir nota
- Nao
Cuidados
Ao finalizar, o sistema baixa estoque, atualiza CRM, gera financeiro e registra a situacao fiscal.
Tela 4 | Atendente
Galeria de produtos
Escolher produtos por categoria, nome, codigo ou foto.
Como usar
- Use as categorias no topo.
- Digite nome ou codigo se preferir.
- Clique no produto.
- Ajuste quantidade no carrinho.
Exemplo preenchido
A atendente filtra Bolos e adiciona Bolo Brigadeiro 2kg ao carrinho.
Cuidados
Produtos inativos ou sem permissao de venda nao aparecem para a atendente.
Tela 5 | Atendente, Gerente e Producao
Pedidos sob encomenda
Acompanhar orcamentos e encomendas por status, data e cliente.
Como usar
- Abra Pedidos.
- Filtre por data ou status.
- Clique no pedido.
- Atualize sinal, producao ou entrega conforme sua permissao.
Exemplo preenchido
Pedido #18 de Maria esta em producao e deve ser entregue amanha as 15:30.
Cuidados
Pedidos sem sinal ficam bloqueados para producao quando essa regra estiver ativa.
Tela 6 | Atendente
Criar pedido sob encomenda
Montar um pedido futuro com data, entrega, observacoes, anexos e regra de sinal.
Como usar
- Selecione o cliente.
- Informe data e horario.
- Escolha retirada ou entrega.
- Adicione produtos.
- Anexe referencias.
- Receba o sinal ou registre excecao.
- Libere para producao.
Exemplo preenchido
Maria encomendou um Bolo Brigadeiro 2kg com topo personalizado para aniversario da Sofia.
- Cliente
- Maria Oliveira
- Entrega
- Amanha as 15:30
- Modalidade
- Entrega propria
- Taxa
- R$ 18,00
- Status
- Producao liberada
Cuidados
Se o sinal for obrigatorio, a producao so recebe o pedido depois da confirmacao ou liberacao autorizada.
Tela 7 | Atendente, Gerente e Administrador
Clientes e CRM
Cadastrar clientes e acompanhar relacionamento comercial automaticamente.
Como usar
- Busque por nome, telefone ou WhatsApp.
- Abra o cadastro.
- Confira dados basicos.
- Use a classificacao e politica comercial.
- Veja sugestoes de contato.
Exemplo preenchido
Maria aparece como recorrente, com ultima compra ha 2 dias e preferencia por bolo com pouco granulado.
- Nome
- Maria Oliveira
- (31) 98888-7777
- Classificacao
- Recorrente
- Politica de sinal
- Regra padrao
Cuidados
CPF, CNPJ e endereco completo sao importantes quando o cliente quer nota fiscal.
Tela 8 | Atendente e Gerente
Historico comercial do cliente
Ver compras, pedidos, pagamentos, notas, produtos e pendencias em um so lugar.
Como usar
- Abra o cliente.
- Entre em Historico Comercial.
- Confira vendas e pedidos.
- Use Relacionamento para decidir o proximo contato.
Exemplo preenchido
Ao abrir Maria, a atendente ve a ultima compra, pedido em producao e mensagem pronta para confirmar entrega.
Cuidados
Nao precisa calcular ticket medio ou dias sem comprar; o sistema faz isso sozinho.
Tela 9 | Administrador, Gerente e Producao
Produtos e ficha tecnica
Controlar produtos, precos, estoque, fiscal e receitas.
Como usar
- Cadastre categoria.
- Cadastre produto.
- Marque se controla estoque.
- Informe se produz internamente.
- Cadastre ficha tecnica quando for produzido.
Exemplo preenchido
Bolo Brigadeiro 2kg tem preco de venda, estoque, NCM e ingredientes cadastrados.
- Codigo
- BOLO-BRIG-2KG
- Categoria
- Bolos
- Tipo
- Produzido
- NCM
- 19059090
Cuidados
A ficha tecnica alimenta custo, estoque, producao e sugestao de compras.
Tela 10 | Doceira e Gerente
Producao da doceira
Mostrar o que precisa produzir sem expor financeiro ou fiscal.
Como usar
- Abra Producao.
- Veja Hoje, Amanha e Semana.
- Clique no pedido.
- Leia produto, quantidade e observacao.
- Marque Em producao ou Pronto.
Exemplo preenchido
A doceira ve pedido #18, foto de referencia, observacao e botao para marcar pronto.
Cuidados
Pedido aguardando sinal aparece separado para nao ser produzido por engano.
Tela 11 | Doceira, Compras e Gerente
Lista de compras
Montar uma lista simples de mercado com sugestoes automaticas.
Como usar
- Abra Lista de Compras.
- Leia sugestoes.
- Clique em Adicionar ou Ignorar.
- Inclua itens manuais.
- Marque como comprado quando chegar.
Exemplo preenchido
O sistema sugeriu leite condensado, chocolate e caixa de bolo por estoque baixo e pedidos da semana.
Cuidados
A sugestao explica o motivo para a doceira decidir com seguranca.
Tela 12 | Gerente, Producao e Administrador
Estoque
Acompanhar saldo de produtos, ingredientes, embalagens e movimentacoes.
Como usar
- Abra Estoque.
- Veja produtos abaixo do minimo.
- Consulte movimentos.
- Registre ajuste com motivo quando necessario.
Exemplo preenchido
Chocolate nobre esta abaixo do minimo e entra como sugestao de compra.
Cuidados
Ajustes de estoque ficam registrados na auditoria.
Tela 13 | Caixa, Gerente e Administrador
Financeiro comercial
Ver recebimentos, sinais, saldos em aberto e vendas faturadas.
Como usar
- Abra Financeiro.
- Filtre contas a receber.
- Registre recebimento.
- Confira status Pago, Parcial ou Em aberto.
Exemplo preenchido
Pedido de Maria tem sinal pago de R$ 111,50 e saldo previsto para a entrega.
Cuidados
Pagamento misto e parcial sao aceitos, mas nao podem passar do total.
Tela 14 | Administrador e Fiscal
Fiscal
Controlar venda com nota, sem nota, aguardando emissao, erros e XMLs.
Como usar
- Abra Fiscal.
- Filtre por mes e status.
- Confira pendencias.
- Emita, cancele ou baixe XML conforme permissao.
Exemplo preenchido
Venda corporativa da Festa & Co gerou NF-e em homologacao e XML armazenado.
Cuidados
Para PJ, revise CNPJ, razao social, IE, endereco e email fiscal antes de emitir.
Tela 15 | Administrador e Fiscal
Exportacao mensal de XML
Gerar o arquivo mensal compactado para enviar ao contador.
Como usar
- Abra Fiscal.
- Entre em Exportar XML.
- Escolha empresa, mes e ano.
- Marque se inclui DANFE.
- Verifique alertas.
- Baixe o ZIP.
Exemplo preenchido
Para junho de 2026, o arquivo gerado segue o padrao 062026.zip.
- Mes
- Junho
- Ano
- 2026
- Modelo
- NF-e e NFC-e
- Status
- Emitida
- Incluir DANFE
- Sim
Cuidados
Se houver nota com erro ou aguardando emissao, corrija antes de exportar.
Tela 16 | Gerente e Administrador
Relatorios
Analisar vendas, clientes, producao, compras, fiscal e financeiro.
Como usar
- Abra Relatorios.
- Escolha periodo.
- Analise o grupo desejado.
- Use os dados para decidir compra, campanha ou promocao.
Exemplo preenchido
A gerente consulta produtos mais vendidos e clientes sem compra ha 60 dias.
Cuidados
Relatorio mostra o que aconteceu; dashboard mostra o que precisa de acao agora.
Tela 17 | Administrador
Configuracoes comerciais
Definir regras da empresa sem complicar a tela da atendente.
Como usar
- Abra Configuracoes.
- Revise regras comerciais.
- Configure producao, fiscal e compras.
- Salve e teste com venda ficticia.
Exemplo preenchido
A empresa exige 50% de sinal em encomendas e permite venda sem nota conforme permissao.
- Exigir sinal
- Sim
- Produzir apos sinal
- Sim
- Permitir desconto
- Sim, ate 15%
- Permitir venda sem nota
- Sim
Cuidados
Configuracoes mudam o comportamento automatico do sistema. Altere com cuidado.
Tela 18 | Administrador
Permissoes por perfil
Controlar o que cada perfil pode ver e fazer.
Como usar
- Abra usuarios/permissoes.
- Escolha o usuario.
- Libere o modulo Comercial.
- Marque as acoes internas necessarias.
- Use Gerenciar somente para quem pode abrir Configuracoes.
- Salve e teste o acesso com o perfil.
Exemplo preenchido
Um caixa pode receber Venda e Caixa; o responsavel fiscal recebe Fiscal; Configuracoes permanece oculta sem a acao Gerenciar.
Cuidados
Abrir e fechar Caixa, emitir ou cancelar notas, XML, descontos e Configuracoes devem ficar restritos ao trabalho de cada usuario.
Tela 19 | Atendente e Gerente
Mensagens WhatsApp
Usar mensagens prontas para confirmar pedido, pedir sinal, avisar pronto e reativar cliente.
Como usar
- Abra o cliente ou pedido.
- Escolha o template.
- Confira a mensagem.
- Clique para abrir WhatsApp.
- Envie pelo canal configurado.
Exemplo preenchido
A atendente envia mensagem de sinal para Maria com valor total, sinal e chave PIX preenchidos.
- Template
- Solicitacao de sinal
- Cliente
- Maria Oliveira
- Chave PIX
- pix@doceriaaurora.example
- Mensagem
- Pedido registrado com sucesso
Cuidados
No inicio, o envio pode ser por link. A integracao automatica fica preparada para etapa futura.
Rotina diaria recomendada
- Atendente abre Dashboard e confere pedidos do dia.
- Caixa confere formas de pagamento e vendas abertas.
- Doceira abre Producao e separa Hoje, Amanha e Aguardando sinal.
- Gerente verifica estoque baixo, pedidos atrasados e saldo a receber.
- No fim do dia, revise vendas sem nota, contas abertas e pedidos para amanha.
Rotina semanal e mensal
Semanal
- Gerar sugestao de compras pelos pedidos futuros
- Conferir clientes sem comprar
- Ver produtos mais vendidos
- Revisar estoque minimo
Mensal
- Conferir notas emitidas
- Ver vendas sem nota
- Exportar XML
- Salvar 062026.zip ou competencia correspondente
- Enviar ao contador
Erros comuns e como resolver
Pedido nao libera producao
Confira se o sinal foi pago, se o cliente e VIP ou se ha autorizacao gerencial.
Produto sem estoque
Veja Estoque, registre entrada ou peca liberacao se a empresa permitir venda sem estoque.
Nota com pendencia
Confira CPF/CNPJ, razao social, endereco, NCM, CFOP e configuracao fiscal.
Desconto bloqueado
O usuario pode nao ter permissao ou o desconto passou do limite configurado.
XML nao exporta
Resolva notas com erro ou aguardando emissao antes de gerar o ZIP mensal.
Checklists finais
Antes de vender
- Produtos cadastrados
- Precos revisados
- Estoque inicial conferido
- Formas de pagamento ativas
Antes de encomendar
- Cliente cadastrado
- Data e horario informados
- Regra de sinal conferida
- Observacoes e fotos anexadas
Antes de produzir
- Sinal recebido ou dispensado
- Ingredientes disponiveis
- Observacoes lidas
- Lista de compras atualizada
Antes de fechar o mes
- Notas emitidas conferidas
- Canceladas revisadas
- Vendas sem nota revisadas
- XML mensal exportado
Glossario simples
Sinal
Entrada paga pelo cliente para liberar uma encomenda.
Saldo
Valor que ainda falta receber depois do sinal ou pagamento parcial.
Ficha tecnica
Receita do produto com ingredientes, quantidades, perdas e custo.
XML
Arquivo fiscal da nota, usado pelo contador.
DANFE
Representacao visual da nota fiscal em PDF.
CRM
Historico e relacionamento com o cliente.