Início rápido
Quick start — primeiro contato em 30 minutos
Para quem quer ver o ERP funcionando antes de mergulhar nas 15 seções completas. Aqui você cadastra uma empresa mínima, um cliente, um produto, faz uma venda, gera uma NF-e simulada — tudo em meia hora. Depois, volte ao 00-index.md para o roteiro completo.
Ambiente esperado: dev-standalone (demonstração). NF-e e demais documentos fiscais são simulados — não vão à SEFAZ real.
O que você vai conseguir ao final
- ✅ Uma empresa cadastrada (matriz).
- ✅ Um cliente cadastrado.
- ✅ Um produto cadastrado.
- ✅ Um pedido de venda faturado.
- ✅ Uma NF-e simulada com chave de acesso.
- ✅ Uma conta a receber gerada automaticamente.
Tempo estimado: 30 minutos (45 minutos se for sua primeira vez).
Passo 1 — Cadastrar sua empresa (~10 min)
- Menu lateral → Cadastros fiscais → Empresas.
- Clique em "Nova empresa" — abre o assistente de 3 passos.
- Passo 1 (empresa):
- CNPJ raiz: 11222333 (8 dígitos) — tabule e a razão social autopreenche.
- CRT: 3 — Regime Normal.
- Natureza jurídica: digite "LTDA" → escolha 2046.
- Classificação tributária: 99.
- Responsável legal: nome + CPF 296.936.410-78.
- Avançar.
- Passo 2 (matriz):
- CNPJ completo: 11222333000181.
- CEP 01310-100 (tabule — endereço autopreenche São Paulo).
- CNAE principal: busque "desenvolvimento" → 6201501.
- Salvar.
- Passo 3: clique em "Concluir" (sem adicionar filial agora).
Quer cadastro fiscal completo (sub-cadastros, IEST, CSC, contas bancárias)? Veja 01 — Cadastro fiscal próprio.
Passo 2 — Cadastrar 1 cliente (~3 min)
- Menu lateral → Cadastros gerais → Parceiros.
- Novo parceiro:
- Tipo: Pessoa jurídica.
- CNPJ: 44555666000181.
- Razão social: Cliente Exemplo Ltda.
- Papel: marque Cliente.
- Salvar.
- Confirmar: você é redirecionado para a edição do parceiro, com check verde "Salvo às HH:MM:SS" ao lado do botão.
Detalhes completos (PF, fornecedores, papéis múltiplos) em 02 — Cadastros gerais.
Passo 3 — Cadastrar 1 produto (~3 min)
- Menu lateral → Cadastros gerais → Produtos.
- Novo produto:
- Código: PROD-001.
- Nome: Notebook ACME 14".
- NCM: 8471.30.12.
- Unidade de medida: UN.
- Tipo: Produto físico.
- Salvar.
Quer cadastros mais ricos? Veja 02 — Cadastros gerais.
Passo 4 — Fazer um pedido de venda + faturar (~10 min)
- Menu lateral → Vendas → Pedidos.
- Novo pedido:
- Cliente: Cliente Exemplo Ltda.
- Vendedor: você (auto-preenchido).
- Item: PROD-001, quantidade 1, preço R$ 4.500,00.
- Condição de pagamento: À vista (ou outra cadastrada).
- Forma de pagamento: PIX.
- Almoxarifado de origem: o primeiro da lista (precisa existir um — se não, volte e crie em Estoque → Almoxarifados).
- Salvar e confirmar.
- O pedido fica Aguardando aprovação ou Aprovado direto (depende de alçada cadastrada).
- Se ficar aguardando, abra-o e clique em "Aprovar".
- Com o pedido Aprovado, clique em "Faturar":
- Confirme os dados fiscais (CFOP, NCM, CST sugeridos).
- Confirmar emissão.
Detalhes de aprovação por alçada, faturamento parcial, devolução em 08 — Vendas.
Passo 5 — Conferir o que aconteceu (~4 min)
Em paralelo, o sistema gerou:
- ✅ NF-e modelo 55 — vá em Fiscal → Saída → NF-e. Você vê a nota com status Autorizada (simulação) + chave de acesso de 44 dígitos + DANFE para impressão.
- ✅ Conta a receber — vá em Financeiro → Contas a receber. A conta do Cliente Exemplo Ltda aparece com R$ 4.500,00 e vencimento de acordo com a condição.
- ✅ Baixa de estoque — vá em Estoque → Movimentos. O produto PROD-001 tem 1 unidade a menos no almoxarifado.
- ✅ Lançamento contábil — vá em Contabilidade → Razão, filtre pela conta Receita de Vendas. Aparece o crédito do faturamento + débito em Clientes a receber.
O que aprendemos
Em 30 minutos, você:
- Conheceu o fluxo principal do ERP: cadastros → operação → financeiro → fiscal → contabilidade em cadeia.
- Viu que o sistema faz ligações automáticas — uma única ação (faturar) gera ≥4 efeitos coordenados.
- Identificou onde estão os menus principais (Cadastros, Vendas, Estoque, Fiscal, Financeiro, Contabilidade).
Próximo passo
Cada um dos 5 passos acima é o resumo de uma página completa. Quando quiser mergulhar:
Passo | Página completa |
|---|---|
1 | Cadastro fiscal próprio01 — Cadastro fiscal próprio |
2 + 3 | Cadastros gerais (parceiros e produtos)02 — Cadastros gerais |
4 | Vendas e CRM08 — Vendas |
5 (NF-e) | Fiscal — saída09 — Fiscal saída |
5 (conta a receber) | Financeiro — títulos (contas a pagar e a receber)04 — Financeiro documentos |
5 (estoque) | Estoque07 — Estoque |
5 (razão) | Contabilidade11 — Contabilidade |
Para entender por que cada peça existe, veja o 00-index.md com as 15 seções na ordem do happy path.
Para vocabulário (CFOP, NCM, alçada, encontro de contas, etc.), veja o glossario.md.
Erros comuns no quick start
- Wizard de empresa preso no passo 2 — verifique se a razão social foi preenchida no passo 1 (com o tab no CNPJ raiz). Se não autopreencheu, digite manualmente.
- Faturar diz "Almoxarifado obrigatório" — você precisa ter pelo menos 1 almoxarifado cadastrado em Estoque → Almoxarifados, vinculado à matriz. Crie um simples (ALM-MTZ-01) e tente de novo.
- NF-e fica em "Em processamento" e não muda — em dev-standalone a autorização é simulada e quase instantânea. Se ficou parado, recarregue a tela; provavelmente já está Autorizada.
- "Cliente bloqueado" — em primeiro uso não deve aparecer. Se aparecer, verifique se o parceiro foi salvo com papel "Cliente" marcado (passo 2).