# Manual do usuário — N4STi Gestão

## Administração da plataforma, grupos e empresas

O acesso global `contato@n4sti.com.br` é o **Super Admin da plataforma**. Ele entra em **Sistema** para criar um grupo econômico, sua primeira empresa, o primeiro administrador e os módulos contratados. Por segurança, esse perfil não abre vendas, estoque, financeiro, notas ou outros dados operacionais dos clientes.

- Um **grupo econômico** reúne empresas que pertencem à mesma administração. Exemplo: o Grupo N4STi pode conter várias empresas e compartilhar cadastros mestres de pessoas e produtos.
- Cada **empresa** mantém separados os documentos e movimentos operacionais, como pedidos, notas, estoque, financeiro e configurações de impressão.
- Uma organização independente, como a Rheys, deve ser criada em outro grupo. Nenhum cadastro ou movimento atravessa grupos.
- O administrador do grupo pode criar empresas e usuários, limitar as empresas/estabelecimentos acessíveis e atribuir permissões. Um mesmo e-mail pode participar de mais de um grupo e alternar o grupo no topo do sistema.

Use sempre o menor nível de acesso necessário. Não transforme o Super Admin da plataforma em usuário operacional de um cliente.

### Módulos e submódulos da empresa

Em **Sistema**, clique em **Módulos** na linha da empresa. Cada módulo tem os seus submódulos logo abaixo, por exemplo:

- **Orçamento, Pedidos e Vendas:** Frente de caixa (PDV), Orçamentos, Pedidos, Comissões e metas;
- **Financeiro:** contas e baixas, Controle de caixa, Cobrança (CNAB);
- **Documentos fiscais:** NF-e/NFC-e e NFS-e.

Desligar o módulo esconde tudo dele. Com o módulo ligado, desmarque só o submódulo que a empresa não usa, por exemplo a Frente de caixa para quem não vende no balcão. O submódulo desligado some do menu e da escolha de acessos dos usuários e fica bloqueado também pelo endereço. Ao religar, os usuários voltam a ter o acesso que já tinham.

### Normas fiscais

Em **Sistema > Normas fiscais**, o Super Admin acompanha os documentos oficiais que mudam as notas fiscais. As fontes são duas:

- as notas técnicas de NF-e e NFC-e do Portal Nacional da NF-e;
- a documentação técnica da NFS-e Nacional.

O servidor consulta as duas fontes todos os dias. Também é possível clicar em **Verificar agora**. Cada documento novo fica **pendente de análise** e aparece como aviso no topo da área Sistema.

Quando sai uma versão nova de uma nota técnica, as versões anteriores ainda pendentes ficam marcadas como substituídas. Assim só a última precisa ser lida. Depois de analisar um documento, escreva a conclusão (por exemplo: "sem impacto" ou "ajustar o XML até 01/01/2027") e clique em **Analisado**. As versões implementadas pelo sistema estão registradas em `docs/NORMAS_FISCAIS.md`.

### Excluir um grupo

A exclusão de um grupo é definitiva e é feita no servidor, dentro da pasta do sistema:

1. `cd /var/www/html`
2. `php bin/console group:delete <id>`: mostra o que seria excluído.
3. `php bin/console group:delete <id> "Nome exato do grupo" --ensaio`: exclui e desfaz, para conferir.
4. `php bin/console group:delete <id> "Nome exato do grupo" --executar`: exclui de fato.

Todos os cadastros, movimentos e arquivos do grupo são apagados. Também são apagados os usuários que só pertenciam a ele. O Super Admin nunca é excluído. Faça um backup antes.

### Empresa de demonstração

O grupo **Demonstração** tem a empresa fictícia **Tecelagem Horizonte** e o usuário `demo@n4sti.com.br`, para apresentar o sistema. O grupo é separado dos clientes: quem entra como demo não enxerga nenhuma outra empresa. Todos os módulos têm dados lançados pelas próprias telas, no perfil das empresas têxteis:
- clientes, fornecedores, transportadoras, tinturaria e representantes;
- tecidos e malhas controlados por peça, fios, aviamentos e camisas;
- orçamentos, pedidos confirmados e despachados por romaneio;
- compras, produção e industrialização externa;
- contas a pagar e a receber, cheques, caixa e vendas no PDV;
- almoxarifado, devolução, agenda e NF-e em rascunho.

A demonstração é criada pelo comando `php bin/console demo:showcase <senha>`, uma única vez. A senha do usuário demo é informada no comando e não fica registrada no sistema.

## Aparência e navegação

- Campos técnicos (SKU, GTIN, NCM, códigos de serviço, CSC e outros) têm um **?** ao lado do nome: pare o mouse sobre ele para ver para que serve o campo.
- O resultado de cada ação aparece num aviso no canto superior direito, que some sozinho (o tempo pausa com o mouse em cima) ou fecha pelo **X**.

- O sistema abre no **tema claro**. O interruptor com sol e lua, no topo, muda para o tema escuro, e a escolha fica guardada neste navegador.
- No menu lateral, clique numa seção para abri-la; só uma fica aberta por vez, e a seção da tela atual já vem aberta. Use **Buscar no menu** (ou a tecla `/`) para achar uma tela pelo nome; Enter abre o primeiro resultado e Esc limpa a busca.
- Datas aparecem no formato brasileiro e no horário de Brasília, por exemplo `25/09/2026 17:44`.
- Campos de data abrem um calendário: as setas trocam o mês, **Hoje** preenche a data atual e **Limpar** apaga o campo. Esc fecha sem alterar.
- Impressos (nota, orçamento, pedido, romaneio, cupom e etiquetas) abrem numa aba com os botões **Imprimir** e **Fechar**. Para gerar PDF, escolha "Salvar como PDF" no diálogo de impressão do navegador.
- Telas de detalhe e de formulário têm, no alto à direita, o botão **Voltar** para a listagem (ex.: **Voltar aos produtos**, **Voltar aos pedidos**). A listagem volta com a pesquisa, os filtros e a página que estavam abertos. Em janela anônima ou com o armazenamento do navegador bloqueado, volta sem os filtros.
- No **Painel**, os indicadores de Empresas e Usuários só aparecem para quem pode ver esses cadastros. Orçamentos, pedidos e itens com saldo em estoque contam só a empresa selecionada no topo; produtos contam o catálogo do grupo.
- Listagens longas mostram "1–50 de 230" no rodapé e os números das páginas; os filtros continuam valendo ao trocar de página.

## Configurações

**Sistema › Configurações** reúne as configurações da empresa por assunto:
- **Operação do dia a dia** (em destaque, no topo): pedidos, frente de caixa (PDV), produtos, condições e formas de cobrança e impressoras;
- **Integrações**, com o estado de cada conexão: certificado digital, NF-e / NFC-e (SEFAZ), NFS-e (prefeitura), cobrança por API do banco, e-mail de envio e assistente de IA. O ambiente da NF-e / NFC-e e o da NFS-e são independentes: a empresa pode emitir NFS-e em produção e NF-e ainda em homologação;
- **Empresa e acesso**: dados da empresa e usuários;
- **Impressos**: orçamento, pedido, cupom e etiqueta;
- **Vendas**: regras de comissão;
- **Financeiro**: contas bancárias, categorias e avisos de vencimento;
- **Fiscal**: perfis, regras de impostos e numeração das notas;
- **Acompanhamento**: e-mails enviados e auditoria.

Cada item mostra o estado atual (por exemplo "Certificado vence em 20 dias", "Homologação (testes)", "Não configurado") e a ação **Configurar** (ou **Abrir**, nos de acompanhamento). Estados em laranja pedem atenção. Use a busca no topo para achar uma configuração pelo nome. Só aparecem as configurações que o seu usuário pode acessar.

### E-mails enviados

**Sistema › E-mails** lista os e-mails do sistema (notas fiscais, avisos de vencimento, recuperação de senha, acesso de usuário novo), com horário de Brasília, destinatário, anexos e situação:
- **ENVIADO**: o servidor de e-mail aceitou a mensagem. Não é confirmação de que chegou à caixa do destinatário (pode cair no spam ou ser recusada depois);
- **PENDENTE**: registrado e ainda sem tentativa concluída;
- **FALHOU**: não saiu; o motivo aparece embaixo. "Não enviado: servidor de e-mail do sistema não configurado" significa que a mensagem só ficou registrada. **Reenviar** tenta de novo com os mesmos anexos e o resultado aparece no aviso do canto da tela.

Filtre por período (dias de Brasília) e situação.

Por onde cada e-mail sai:
- notas fiscais e avisos de vencimento saem pelo **E-mail de envio da empresa** (Configurações › Integrações). Sem ele, os avisos de vencimento usam o servidor de e-mail do sistema;
- recuperação de senha e acesso de usuário novo saem pelo servidor de e-mail do sistema, configurado pelo suporte N4STi. Enquanto ele não estiver configurado, a tela mostra um aviso no topo.

O e-mail de acesso de usuário novo não leva a senha: ela é combinada com quem criou o acesso, ou trocada por **Esqueci minha senha**.

### Auditoria

**Sistema › Auditoria** mostra quem fez o quê e quando: o evento por extenso (ex.: "Cliente/fornecedor alterado", "Pedido de venda confirmado"), o responsável, o horário de Brasília, o registro afetado e a empresa. Em **Detalhes** aparecem os campos alterados com o valor de antes e o de depois (na criação, os valores gravados), o código original do evento e o IP. Senhas e chaves nunca aparecem. Filtre por período para achar um evento.

## Ajuda e assistente de suporte

O botão **?** no topo abre a Ajuda da tela atual e o assistente de suporte. Escreva a dúvida como falaria com o suporte, por exemplo "como emito uma NF-e de devolução?". Enter envia e Shift+Enter quebra a linha.

A resposta mostra de onde veio:
- **Resposta da base desta empresa:** uma resposta que já resolveu dúvida parecida aqui. Não gasta créditos de IA.
- **Trechos do manual:** o assistente está sem IA ativada, ou o limite do mês acabou.
- **Resposta da IA:** gerada com base no manual e nas respostas já aprovadas.

Marque **Resolveu** quando a resposta ajudar: ela é guardada e passa a responder perguntas parecidas de todos da empresa, sem gastar créditos. **Não resolveu** tira da base uma resposta que deixou de servir. Numa resposta da base, **Perguntar à IA** busca uma resposta nova.

A IA não vê os dados da sua empresa (clientes, notas, valores). Se ela precisar de uma informação, consulte na tela e conte na pergunta. Nunca informe senhas nem chaves ao assistente.

### Ativar a IA do assistente

Em **Sistema › Configurações › Assistente de IA** (administrador do grupo):
1. Crie uma chave de API na sua conta da Anthropic (console.anthropic.com, em API Keys) ou da OpenAI (platform.openai.com, em API keys). O consumo é cobrado pelo provedor, na conta da empresa.
2. Escolha o provedor, cole a chave e ligue **Usar IA nas respostas**. O modelo em branco usa o padrão do provedor.
3. Se quiser controlar o gasto, informe um **limite de tokens por mês**. Ao atingir, o assistente volta a responder só pelo manual até o mês virar.
4. Clique em **Testar conexão**.

A chave fica cifrada e não aparece de novo; só os quatro últimos caracteres são mostrados. Na mesma tela ficam o uso do mês e as **respostas aprendidas**, que podem ser conferidas e removidas.

## Antes de começar

1. Entre no sistema e confira no topo o **Grupo**, a **Empresa** e o **Estabelecimento** selecionados.
2. Em **Empresas**, cadastre a matriz, pelo menos um endereço e um depósito físico.
3. Os módulos da empresa são liberados pelo **Administrador Geral da plataforma**, em **Sistema › Grupos e empresas**, no botão **Módulos** de cada empresa. O administrador do grupo não altera essa lista em **Dados da empresa**. As dependências são ligadas automaticamente:
   - Compras exige Estoque e Financeiro;
   - Produção exige Produtos e Estoque;
   - Industrialização externa exige Produtos, Estoque e Financeiro;
   - Multicanal exige Produtos, Vendas e Estoque.
4. Cadastre usuários e conceda apenas as permissões necessárias.

### Acesso aos menus por usuário

Em **Usuários**, abra o usuário e use o quadro **Acesso aos menus**:

- Marque os menus que ele pode abrir. Os menus que o papel do usuário já libera vêm marcados.
- Desmarcar um menu bloqueia também a tela pelo endereço e as ações dela (incluir, alterar, baixar), só para esse usuário.
- Marcar um menu que o papel não dá libera apenas a consulta. Para incluir e alterar, use um papel com essa permissão.
- Use a caixa ao lado do nome da seção, ou **Marcar todos**, para mudar vários de uma vez.
- Ninguém pode tirar de si mesmo o acesso a **Usuários**.
- Só aparecem os menus que a empresa tem liberados. Se a empresa não tem Vendas, a seção Vendas não aparece; se tem Vendas sem Frente de caixa, só a Frente de caixa some.
- Ao criar um usuário, informe nome, e-mail e senha; o sistema abre em seguida o quadro **Acesso aos menus** desse usuário.

## Pessoas

Cadastre clientes, fornecedores, transportadoras e industrializadores. Uma mesma pessoa pode ter mais de um papel.

Na listagem:
- o nome mostrado é o **nome fantasia**; sem nome fantasia (comum em pessoa física), aparece o nome/razão social. A razão social aparece logo abaixo quando é diferente;
- **Pesquisar** encontra por nome fantasia, razão social, CPF ou CNPJ, com ou sem pontuação (`52.419.873` e `52419873` dão o mesmo resultado);
- **Tipo** mostra os papéis por extenso ("Cliente e fornecedor", "Transportadora") e também filtra a lista;
- **Situação** mostra ATIVO ou INATIVO e filtra a lista;
- CPF e CNPJ aparecem com máscara.

**Ativo:** no cadastro, desmarque **Ativo** e salve para inativar a pessoa. Pessoa inativa continua no histórico (pedidos, notas, títulos), mas deixa de aparecer na escolha de cliente/fornecedor dos documentos novos. Para reativar, marque de novo e salve. Ao salvar, criar ou alterar endereço, telefone ou condições comerciais, o aviso de confirmação aparece no canto da tela.

**Escolher cliente/fornecedor nos documentos:** no lançamento financeiro, no orçamento, no pedido, na NF-e/NFC-e, no tomador da NFS-e, no PDV, nos cheques, no extrato e no filtro da baixa de títulos, digite pelo menos 2 letras ou números no campo e escolha na lista. A busca é a mesma da listagem (nome fantasia, razão social, CPF ou CNPJ, com ou sem pontuação) e só mostra cadastros ativos; no orçamento, no pedido e na NFS-e, só quem tem o papel de cliente. Setas ↑/↓ e Enter escolhem pelo teclado; Esc fecha a lista.

Atalhos de preenchimento (também em Empresas):
- **Consultar CNPJ:** digite o CNPJ e clique na lupa ao lado. Razão social, nome fantasia, e-mail e telefone vêm da Receita Federal (consulta pública da BrasilAPI), e a situação cadastral aparece abaixo do campo. A inscrição estadual ativa na UF do CNPJ também é preenchida, pela consulta pública do CNPJ.ws, que aceita até 3 consultas por minuto. A inscrição municipal não tem fonte pública nacional (cada prefeitura mantém a sua) e deve ser digitada. A consulta vale só para CNPJ; para CPF, preencha os dados manualmente. Depois de salvar, o endereço e o telefone da Receita ficam sugeridos nos quadros de endereço e telefone; confira e clique em Adicionar.
- **CEP:** nos endereços, o CEP vem primeiro. Ao completar os 8 dígitos, rua, bairro, cidade e UF são preenchidos; falta só o número.
- **Telefone:** a máscara brasileira é automática: (11) 98765-4321 ou (11) 3322-4455. Para número estrangeiro, comece com + e o código do país (ex.: +1 415 555 0100); nesse caso, fica sem máscara.

Para documentos fiscais, confira antes de salvar:

- pessoa física: CPF com 11 dígitos;
- pessoa jurídica: CNPJ com 14 caracteres. O CNPJ alfanumérico (letras nas 12 primeiras posições, emitido pela Receita desde julho de 2026) é aceito;
- o sistema confere os dígitos verificadores do CPF e do CNPJ e recusa documento digitado errado;
- razão social/nome, inscrição estadual quando aplicável;
- endereço completo, município, UF e CEP com 8 dígitos;
- e-mail para envio de documentos.

## Produtos

Em **Produtos**, só o **nome** é obrigatório. Os outros campos são cobrados pelo módulo que precisa deles, na hora do uso:

| Campo | Em branco | Onde passa a ser exigido |
|---|---|---|
| SKU | o sistema cria um código interno (PRD-… ou SERV-…) | vínculo com anúncio de marketplace, que pede SKU próprio |
| Unidade | vira UN (unidade) | não é exigida |
| NCM | fica vazio | emissão de NF-e/NFC-e (8 dígitos), ou no cadastro se a empresa ligar "exigir NCM" |
| Código municipal, código nacional e descrição do serviço | ficam vazios | emissão de NFS-e |

Na página do produto, o quadro **Pronto para uso** mostra o que ainda falta para cada módulo ativo da empresa (NF-e, NFS-e, marketplace). Quando aplicável, informe também preço, tipo, CEST, GTIN/EAN, marca, categoria, cor e tamanho.

- Para produto do tipo **Serviço**, a unidade é opcional; se ficar em branco, o sistema usa `UN`.
- O SKU, quando informado, deve ser único no grupo e é a chave preferencial para integrações.
- Não reutilize um SKU para produtos diferentes.
- NCM deve conter 8 dígitos.
- GTIN/EAN não é o mesmo que SKU.
- Para Mercado Livre, mantenha o mesmo SKU no anúncio e no N4STi.

### Busca e categorias

Na lista de produtos, busque por nome, SKU, código de barras, código externo ou por campos adicionais marcados como pesquisáveis. Categorias podem ter subcategorias (ex.: Tecidos › Malhas); filtrar pela categoria principal mostra também as subcategorias.

### Configurações do catálogo

Em **Produtos > Configurações**:

- **Apelidos**: troque "Cor", "Tamanho" e "Embalagem" pelos nomes usados na empresa (ex.: Desenho, Numeração, Rolo).
- **Casas decimais do preço**: 2 (padrão), 3 ou 4, para produtos vendidos por metro, grama ou unidade fracionada. Vale para a listagem e o cadastro de produtos (preço e custo das variações), para os preços comerciais e para o preço sugerido nos itens de orçamento e pedido. Nos campos de digitação, o preço aparece sem separador de milhar (ex.: `1234,50`). Se um preço foi gravado com mais casas do que a configuração (ex.: `10,1234` com 2 casas), o campo mostra todas as casas gravadas, para o valor não ser arredondado ao salvar de novo.
- **Exigir NCM**: impede salvar mercadoria sem NCM.
- **Campos adicionais**: crie campos próprios (composição, gramatura, largura, referência do cliente). Marque "Usar na busca" para encontrá-los na lista e "Enviar na NF-e" para que o valor saia na informação adicional do item da nota, junto com a informação fiscal do produto.

### Fornecedores e embalagem

Em **Produtos > Preços e fornecedores**, informe para cada fornecedor o código do produto nele, a unidade em que ele vende (ex.: CX, RL) e o **fator de embalagem**: quantas unidades do seu cadastro vêm em uma unidade do fornecedor (caixa com 12 = 12).

## Estoque

Use **Entrada/Ajuste** para informar saldo inicial ou correções justificadas. As operações seguintes devem nascer dos documentos de compra, venda, produção ou industrialização.

Os saldos são separados em disponível, reservado, bloqueado, em trânsito, com terceiro, em produção e avariado. Nunca considere “com terceiro” como disponível para venda.

### Endereçamento

Em **Estoque > Endereços**, cadastre as posições físicas de cada depósito. Use códigos curtos e previsíveis, como `A-01-02` para corredor A, estante 01 e posição 02. A prioridade menor deve representar o endereço que será visitado primeiro na separação.

### Inventário físico

1. Abra **Estoque > Inventários** e selecione o depósito.
2. Conte os produtos e salve a contagem. Campos vazios continuam pendentes; quantidade zero significa que o item foi contado e não foi encontrado.
3. Quando todos os itens forem contados, o documento muda para **Aguardando aplicação**.
4. Revise as divergências positivas e negativas.
5. Clique em **Aplicar ajustes**. O sistema compara a contagem com o saldo disponível atual, registra movimentos auditáveis e encerra o inventário.

Somente um inventário pode permanecer aberto por depósito. Depois de aplicado, ele não pode ser editado ou reaplicado.

### Lotes, séries e validades

1. Abra o produto e, na tabela de variantes, clique em **Configurar** na coluna Rastreabilidade.
2. Escolha **Lote e validade** ou **Número de série**. Defina se fabricação e validade são obrigatórias e quantos dias de validade restando são exigidos.
3. Cadastre ao menos um endereço em **Estoque > Endereços**.
4. Ao registrar a entrada, informe endereço, lote ou série, fabricação, validade e código de agregação quando utilizado.
5. Consulte **Estoque > Lotes e séries** para acompanhar saldos e vencimentos em ordem FEFO.

Uma entrada serializada aceita uma unidade por número de série. Depois que uma variação possuir movimentos rastreáveis, o tipo de controle não poderá ser alterado. O saldo principal e o saldo rastreável são gravados na mesma transação para impedir divergências.

### Peças e rolos

Para tecidos, fios e materiais vendidos por metro ou quilo em rolos:

1. Cadastre o produto com unidade **M** (metro) ou **KG** e, na variante, escolha Rastreabilidade **Peça/rolo**.
2. Em **Estoque > Peças e rolos > Entrada de peças**, escolha produto, endereço, lote de fabricação e fornecedor, e preencha uma linha por peça: metros, largura, peso bruto, tara (ou o peso líquido direto) e o número da peça no fornecedor. O total de peças, metros e quilos aparece antes de salvar.
3. Cada peça recebe um número sequencial da empresa (000001, 000002...). Imprima as etiquetas com código de barras (100 × 60 mm).

O saldo fica na unidade do produto: metragem para produto em metros, peso líquido para produto em kg. A outra medida é calculada pelo fator kg/metro de cada peça, porque cada rolo pesa diferente. Vendas, requisições, expedição e produção baixam das peças mais antigas automaticamente; devoluções voltam para a mesma peça. Para corte, retalho ou perda, abra a peça e use **Baixa manual**.

### Peças de terceiros

Peças que chegam do fornecedor ou da tinturaria com numeração própria entram em **Entrada de peças** com o fornecedor ou industrializador e o **número da peça no terceiro**. A peça recebe também o número N4STi, e qualquer um dos dois serve na leitura (expedição, inventário e revisão) e na busca. Em **Peças e rolos**, marque **Somente de terceiros** para ver só essas peças.

### Inventário de peças por leitura

Em **Estoque › Inventário de peças**:
1. Abra uma contagem para o depósito. Se quiser, limite a um produto ou a um lote.
2. Leia as etiquetas (o leitor envia com Enter). Informe o setor ou corredor, se quiser separar. Cada leitura mostra na hora se **confere**, se a peça está **em outro depósito**, **fora do filtro**, **sem saldo** ou se o **código é desconhecido**. Leitura errada pode ser retirada.
3. **Encerre a leitura**: aparecem as peças esperadas e não lidas.
4. **Aplique ao estoque**: as peças não encontradas são baixadas. Peças reservadas para pedido ou bloqueadas não são baixadas; elas ficam listadas para resolver.

### Revisão de peças

Em **Estoque › Revisão de peças**, leia a peça, toque nos defeitos encontrados (cada um com 1 a 4 pontos, que dá para ajustar) e informe a posição em metros, se quiser. A nota é a soma dos pontos por 100 m² da peça (comprimento × largura); sem largura, conta por 100 m.
- Até 28 pontos: **1ª qualidade**; até 40: **2ª qualidade**; acima: **reprovada**. Os limites mudam em **Defeitos e limites**.
- A peça reprovada fica **bloqueada** e a expedição recusa a leitura dela. Uma nova revisão que aprove libera a peça.
- A qualidade aparece na lista e na ficha da peça, com o histórico de revisões.

## Almoxarifado

1. Cadastre os departamentos.
2. Crie a requisição e informe os itens.
3. Aprove ou rejeite conforme a permissão do usuário.
4. Atenda a requisição para efetivar a saída.

Uma requisição cancelada ou rejeitada não deve baixar estoque.

## Orçamentos

1. Selecione o cliente e adicione os itens.
2. Informe validade, desconto, frete, condição de pagamento, representante e transportadora quando necessários.
3. Salve uma nova versão quando houver renegociação.
4. Use **Visualizar/Imprimir** antes de enviar ao cliente.
5. Ao aceitar, converta o orçamento em pedido sem apagar seu histórico.

### Configurar o impresso

Em **Configurações › Impressos**, escolha **Orçamento**, **Pedido**, **Cupom do PDV** ou **Etiqueta de peça**. À direita aparece a **prévia real** do impresso com dados de exemplo, atualizada a cada mudança.

- **Posição e tamanho, direto na prévia**:
  - arraste qualquer bloco para onde quiser; ele encaixa numa grade de 12 colunas;
  - puxe a alça do canto inferior direito para aumentar ou diminuir o bloco;
  - blocos podem ficar lado a lado ou com espaço entre eles. Se um bloco for solto sobre outro, o de baixo desce sozinho;
  - no orçamento e no pedido, o cabeçalho é formado por três blocos independentes: **Logo**, **Dados da empresa** e **Título e número**, além da **Linha divisória**;
  - a tabela de itens cresce conforme a quantidade de itens e empurra para baixo o que estiver abaixo dela, inclusive em várias páginas.
- **Blocos** (lista à esquerda):
  - o olho mostra ou oculta o bloco; os blocos com cadeado são obrigatórios. Um bloco que volta a aparecer entra no fim da folha;
  - clique no bloco para abrir as opções. Exemplos: colunas da tabela de itens, linhas dos totais, alinhamento do logo e do título, texto livre (dados bancários, PIX, condições gerais) e títulos das assinaturas;
  - clicar num bloco da prévia abre esse bloco na lista.
- **Rodapé**: no orçamento e no pedido, "Documento gerado pelo N4STi Gestão em (data e hora)" e "Página X de Y" saem no fim de **cada página** impressa. O **Texto do rodapé** da Aparência (ex.: razão social, endereço, telefones e e-mail) sai em linha própria, acima dessa frase, sem se misturar com ela. Texto longo ocupa mais de uma linha, e a margem de baixo cresce para caber.
- **Aparência**:
  - orçamento e pedido: cor de destaque, tamanho da letra, margens e rodapé;
  - cupom: papel de 80 ou 58 mm e impressão automática ao abrir;
  - etiqueta: tamanho da etiqueta.
- **Salvar layout** aplica às próximas impressões desta empresa. **Restaurar padrão** volta ao modelo do sistema. O aviso "Alterações não salvas" lembra de salvar antes de sair.

## Pedidos e vendas

1. Selecione cliente, depósito e itens.
2. Confira disponibilidade, preços, descontos, frete e pagamento.
3. Confirme o pedido para reservar estoque e gerar os efeitos financeiros previstos.
4. Encaminhe para expedição.
5. Use a visualização para conferência e impressão.

**Confirmação do pedido:** análise de crédito, reserva de estoque, título a receber e comissão acontecem juntos. Se qualquer etapa for recusada (crédito bloqueado, estoque insuficiente, sem depósito ativo, valor que não gera parcela), nada é gravado: o pedido continua em rascunho e a mensagem diz o motivo. Clicar duas vezes em **Confirmar**, ou confirmar o mesmo pedido em duas abas, não reserva o estoque duas vezes nem gera dois títulos ou duas comissões.

**Cancelar o pedido** exige o motivo. O cancelamento libera a reserva de estoque, cancela o título a receber ainda sem baixa e a comissão em aberto, tudo de uma vez. É recusado, sem mudar nada, quando o pedido já foi despachado (use a devolução de venda), tem nota fiscal autorizada ou em processamento (cancele a nota antes), tem pagamento registrado (estorne antes), tem título com baixa ou comissão já fechada. Cancelar de novo um pedido cancelado não faz nada.

### Tipos de pedido

- **Venda**: o padrão. Gera conta a receber e comissão.
- **Piloto**: peça piloto enviada ao cliente. Funciona como venda, mas pode usar outra operação fiscal (CFOP).
- **Amostra grátis**: reserva e baixa o estoque normalmente, mas não gera conta a receber, pagamento nem comissão, e não conta na meta do representante.

Devolução não é um tipo de pedido: use **Devoluções** no pedido despachado.

### Nota fiscal do pedido

No pedido confirmado, **Gerar nota fiscal** mostra só as notas possíveis para os itens:

- **NF-e** ou **NFC-e** com os produtos do pedido. Os serviços ficam fora.
- **NFS-e** com os serviços do pedido.

Pedido com produtos e serviços gera as duas notas: a NF-e dos produtos e a NFS-e dos serviços. Cada pedido tem uma NF-e e uma NFS-e; para emitir de novo, cancele a nota anterior.

### Configurações de pedidos

Em **Pedidos › Configurações**:

- **Não permitir o mesmo produto em duas linhas**: com esta opção marcada, o pedido não é salvo quando a mesma variante (produto, cor e tamanho) aparece duas vezes. O sistema pede para somar as quantidades.
- **Mostrar os vencimentos no impresso**: o impresso passa a listar as parcelas. No rascunho é uma previsão pela condição de pagamento; depois da confirmação, são os vencimentos reais do título.
- **Observação padrão**: texto que já vem preenchido em todo pedido novo.
- **Operação fiscal por tipo**: ao gerar a NF-e de um pedido, a operação (CFOP e natureza) do tipo já vem escolhida. Exemplo: amostra grátis → "Remessa de amostra grátis" (5.911/6.911).

### Comissões de representantes

Em **Vendas › Comissões**:

1. Em **Regras**, cadastre os percentuais. Vale a primeira regra ativa, na ordem, que casar com o representante e com o desconto dado no item. Exemplo: "Desconto acima de 10%: 2%" (ordem 10) e "Padrão: 5%" (ordem 100). Sem nenhuma regra, nenhuma comissão é gerada.
2. Escolha quando a comissão é liberada:
   - **na venda**;
   - **no recebimento do cliente** (padrão). Neste caso, a comissão é liberada na proporção do que já foi pago do título da venda.
3. A comissão nasce sozinha:
   - quando o pedido com representante é confirmado;
   - quando a venda do PDV com representante é recebida no caixa.
   A base é o valor do item, já com o desconto geral da venda rateado. A devolução no PDV estorna a comissão proporcionalmente, e cancelar o pedido cancela a comissão.
4. Para pagar o representante, use **Fechar comissões**: informe o representante, a data de corte e o vencimento. Entram só as comissões totalmente liberadas. O sistema lança a conta a pagar ao representante no financeiro. Comissões ainda não liberadas ficam para o próximo fechamento.

Uma venda cuja comissão já foi fechada não pode ser cancelada antes de o fechamento ser estornado.

### Metas de vendas

Em **Vendas › Metas**, informe a meta mensal de cada representante. A tela mostra o realizado do mês e o percentual atingido; o realizado soma os pedidos confirmados e as vendas do PDV concluídas.

## Expedição

Abra os pedidos confirmados, confira os itens, volumes e transportadora e registre o despacho. O despacho deve baixar uma única vez o estoque reservado.

Para produtos com lote/série, abra **Separar** antes do despacho. A guia mostra os lotes vinculados à reserva do pedido; confira fisicamente código, validade, endereço e quantidade. O despacho baixa os mesmos lotes da reserva. A conferência e os volumes ainda não são registrados digitalmente.

### Expedição por cliente com leitura de peças

Use quando vários pedidos do mesmo cliente saem juntos ou quando o produto é controlado por peça/rolo.

1. Em **Expedição**, clique em **Expedição por cliente (peças)** e escolha o cliente. Os pedidos com saldo a expedir já vêm marcados; os que estão em outra expedição aberta aparecem bloqueados. Escolha **Entrega** ou **Retirada pelo cliente**.
2. **Leia a etiqueta** de cada peça (o leitor envia sozinho com Enter). A peça vai para o primeiro item do mesmo produto que ainda tem saldo, e a tela mostra, por item, o pedido, o que já saiu, o que está nesta expedição e o que falta.
   - Uma peça que passa da quantidade do pedido entra inteira, com aviso.
   - Peças de outro produto, repetidas ou de outra expedição são recusadas com a explicação.
   - Uma peça pode ser retirada no × ao lado dela.
3. Nos produtos sem peça/lote, digite a quantidade e clique em **Salvar quantidades**.
4. **Romaneio** imprime a lista de peças com metros e pesos, e tem espaço para a assinatura de quem recebe.
5. **Fechar e despachar**: gera uma remessa por pedido (a NF-e continua sendo emitida pelo pedido) e baixa do estoque exatamente as peças lidas, liberando a reserva dos pedidos. Os pesos das peças já vêm somados.

Pedidos que estão numa expedição por cliente aberta não aparecem na fila de separação pedido a pedido. **Cancelar** uma expedição aberta devolve os pedidos para a fila; nada é baixado do estoque antes do fechamento.

## Devolução de venda

1. Abra um pedido já despachado e clique em **Devoluções**.
2. Selecione o item e informe a quantidade recebida, limitada ao que foi expedido e ainda não devolvido.
3. Se o produto é rastreável, escolha o lote/série expedido e o endereço de recebimento.
4. Escolha **Bloqueado para inspeção** quando a condição física ainda não foi conferida; só marque **Disponível para venda** quando o item puder voltar ao estoque comercial.
5. Descreva o motivo e registre a entrada.

O registro físico não gera reembolso nem nota fiscal automaticamente. A regularização financeira e fiscal aparece como pendente e deve ser tratada separadamente; o fluxo completo de troca ainda está em desenvolvimento.

## Compras

1. Crie o pedido para um fornecedor e depósito.
2. Aprove o pedido.
3. Registre cada recebimento, inclusive parcial, com documento e vencimento.
4. O recebimento gera entrada de estoque e conta a pagar pelo valor recebido.

Não informe quantidade superior ao saldo pendente do item.

Se o produto usa lote ou série, preencha também o endereço, código e as datas exigidas. Uma série é recebida por unidade. Para lotes diferentes no mesmo item, faça recebimentos separados; o valor a pagar é gerado por recebimento efetivo.

### Notas de entrada (NF-e de fornecedor)

Use **Compras › Notas de entrada** para dar entrada em qualquer nota de fornecedor, com ou sem pedido de compra.

1. **Importe o XML**: arraste um ou vários arquivos para a área indicada. O sistema confere se a nota é para a empresa selecionada e se já não foi importada.
2. **Confira**: a tela já vem preenchida.
   - **Fornecedor**: é localizado pelo CNPJ; se não existir, é cadastrado com o endereço do XML.
   - **Produtos**: cada item é vinculado pelo código do fornecedor (com o fator de embalagem) ou pelo código de barras. Os itens que sobrarem ficam marcados em vermelho. Use a busca para vincular, ou marque **Uso e consumo** para itens que não entram no estoque.
   - **Embalagem**: o fator converte a unidade da nota para a unidade do estoque. Exemplo: 10 rolos de 50 m = 500 m.
   - **Custo**: o custo da nota já inclui frete, seguro, outras despesas, IPI e ICMS-ST, menos o desconto. Escolha como atualizar o custo do produto: custo desta compra, manter o atual ou média ponderada com o saldo em estoque.
   - **Preço**: informe o markup (o preço sugerido aparece na hora) ou digite o preço. Marque **Atualizar preço** para gravar no produto.
   - **Pedido de compra**: se o fornecedor informou o número do pedido na nota, ele já vem escolhido. Na entrada, as quantidades são baixadas do pedido.
   - **Parcelas**: vêm das duplicatas do XML. A barra inferior avisa se a soma não bate com o total da nota.
3. **Lance a entrada**. O botão fica disponível quando não há pendências. O lançamento:
   - dá entrada no estoque (com lote e endereço, ou uma peça por item nos produtos controlados por peça);
   - atualiza o custo e, se marcado, o preço;
   - cria a conta a pagar;
   - memoriza o código do fornecedor, para a próxima nota vir vinculada.

Você pode **Salvar conferência** e continuar depois, ou **Descartar** a importação. Uma nota lançada pode ser **cancelada** com motivo:
- o estoque volta a sair e a conta a pagar é cancelada;
- se a conta já tiver pagamento, estorne o pagamento antes;
- o custo do produto não volta ao valor anterior.

O custo e o markup de cada variante aparecem na tela do produto.

#### Notas na SEFAZ (distribuição de DF-e)

Na aba **Na SEFAZ**, clique em **Buscar na SEFAZ** para listar as NF-e emitidas contra o CNPJ da empresa. Isso exige o certificado digital A1 cadastrado na empresa.

- **Resumo**: a SEFAZ entrega primeiro só um resumo. Use **Dar ciência e baixar XML** para registrar a ciência da operação e receber o XML completo.
- **Dar entrada**: leva o XML para a conferência de Notas de entrada.
- **Mais ações** (⋯):
  - confirmar a operação;
  - desconhecer a operação;
  - registrar operação não realizada, com motivo de pelo menos 15 caracteres;
  - ocultar a nota da lista.
- Notas canceladas pelo emitente ficam marcadas como **Cancelada** e não podem dar entrada.
- Quando não há notas novas, a SEFAZ exige uma pausa de 1 hora antes da próxima busca. O botão mostra quando a busca volta a ficar disponível.

## Financeiro e bancos

As vendas geram contas a receber; compras e serviços de industrialização geram contas a pagar. Despesas e receitas avulsas (aluguel, energia, serviços) são lançadas manualmente.

### Contas financeiras

Em **Financeiro > Cobrança (CNAB)**, cadastre cada banco, caixa ou cofre. Informe o banco de cobrança apenas nas contas que emitem boleto por CNAB; caixa e cofre ficam sem banco. Defina a conta padrão e o saldo inicial.

### Condições de pagamento e formas de cobrança

Toda empresa já começa com formas de cobrança (Dinheiro, PIX, cartões, Boleto, Cheque, Transferência e Crediário), condições de pagamento (À vista, 7, 15, 28, 30, 45 e 60 dias, 15/30, 30/45, 30/60, 30/45/60, 30/60/90, 30/60/90/120 e 30/60/90/120/150), plano de contas gerencial e as unidades de medida da tabela da SEFAZ. Tudo pode ser editado ou desativado.

Em **Financeiro > Condições e cobranças**:

- **Condição de pagamento** define as parcelas: digite o atalho `30/60/90` ou preencha os dias de cada parcela. Sem percentual, o valor é dividido em partes iguais; com percentual, as linhas precisam somar 100%.
- **Forma de cobrança** (boleto, PIX, cartão, dinheiro, cheque) diz como o valor é recebido e para qual conta vai por padrão.

### Lançar conta a pagar ou a receber

1. Em **Contas a pagar e receber**, clique em **A receber** ou **A pagar**.
2. Escolha cliente/fornecedor, descrição, valor, emissão e, se houver, documento, categoria, centro de custo e representante.
3. Escolha uma condição de pagamento ou informe o primeiro vencimento, a quantidade de parcelas e o intervalo. A prévia mostra cada parcela antes de salvar. No intervalo mensal, um vencimento no dia 31 cai no último dia dos meses mais curtos.
4. Marque **Título de previsão** para compromissos ainda não confirmados. Previsões ficam fora dos vencidos e da DRE, e aparecem no fluxo de caixa só quando você pedir.

### Baixar títulos

- **Um título**: abra o título, marque as parcelas, ajuste o valor de cada uma para baixa parcial e informe motivo, conta, data, juros/multa e desconto.
- **Vários títulos de uma vez**: em **Baixa de títulos**, filtre por cliente/fornecedor e vencimento, marque as parcelas, ajuste valores, juros e desconto por linha e clique em **Baixar selecionadas**. O total do principal e o valor que entra ou sai da conta aparecem antes de confirmar. Tudo vira um lote, que pode ser consultado e estornado de uma vez.
- **Motivos**: *Pagamento/recebimento* movimenta a conta pelo valor + juros − desconto. *Abatimento*, *Encontro de contas*, *Perda/incobrável* e *Cancelamento do saldo* reduzem o título sem mexer em nenhuma conta.
- Contas a receber e a pagar não podem ser baixadas no mesmo lote.
- Para desfazer, use **Estornar** (na baixa ou no lote) com motivo claro. Baixa conciliada com o extrato precisa ter a conciliação desfeita antes.
- Título sem baixa pode ser **cancelado** com motivo. Título com baixa não se cancela: encerre o saldo com uma baixa de motivo *Cancelamento do saldo*.
- Nunca exclua uma baixa confirmada para "corrigir saldo".

### Extrato, lançamentos avulsos e transferências

Em **Extrato e lançamentos**, escolha a conta e o período para ver saldo anterior, cada movimento e o saldo acumulado.

- **Lançamento avulso** registra entradas e saídas sem título: tarifa, rendimento, depósito, retirada.
- **Transferência** move valor entre duas contas da empresa e aparece nos dois extratos. Transferências não contam como receita nem despesa no fluxo de caixa.
- Para corrigir, estorne com motivo; numa transferência, o estorno desfaz as duas pontas.

### Conciliação bancária

1. Em **Extrato e lançamentos > Conciliar com o banco**, escolha a conta e importe o arquivo OFX baixado do banco. O mesmo arquivo não é importado duas vezes.
2. Ao importar, o sistema já concilia as linhas que têm **uma única** baixa ou lançamento de mesmo valor com até 3 dias de diferença.
3. Para as demais, escolha a sugestão (mesmo valor, até 7 dias) e clique em **Conciliar**.
4. Tarifas e rendimentos que ainda não estão no sistema: use **Criar lançamento a partir desta linha**, que lança e concilia de uma vez.
5. Linhas que não dizem respeito à empresa podem ser **ignoradas**. Qualquer conciliação pode ser desfeita.

Use CNAB para remessas e retornos somente após configurar corretamente a conta de cobrança.

Em **Financeiro > Fluxo de caixa**, compare por mês o previsto pelo vencimento de cada parcela em aberto e o realizado pelo que passou nas contas (com juros, descontos e lançamentos avulsos). O relatório mostra os vencidos separadamente; não equivale à DRE.

### Banco Inter: integrar boleto com PIX (sem remessa e retorno)

A integração com o Banco Inter emite boletos com PIX direto pela API do banco. Quando o cliente paga, a baixa é automática no Financeiro. Não é preciso gerar remessa nem importar retorno.

A tela **Financeiro > Cobrança por API** serve para qualquer banco com API de cobrança. Hoje o banco disponível é o Banco Inter. Outros bancos vão aparecer na lista **Banco** conforme forem integrados, com o mesmo funcionamento. Banco sem API continua com remessa e retorno (CNAB).

#### Como integrar o Banco Inter: passo a passo no Internet Banking

1. No Internet Banking PJ do Inter, abra **Soluções para sua empresa > Nova integração** e crie a integração (exemplo de nome: "Gestão N4STi").
2. Marque as permissões de **Boleto com PIX** (emitir, consultar e cancelar boletos).
3. Aguarde a liberação do banco. Depois de liberada, baixe a chave da integração. Ela traz o **Client ID**, o **Client Secret** e dois arquivos: o certificado (`.crt`) e a chave (`.key`).
4. O arquivo **Certificado Webhook** (`ca.crt`) não é usado no sistema.

#### Como integrar o Banco Inter: cadastro no sistema

1. Abra **Financeiro > Cobrança por API**. O mesmo atalho fica em **Configurações > Financeiro > Cobrança por API (Banco Inter)**. Em **Banco**, escolha **Banco Inter**.
2. Em **Conta financeira**, escolha a conta do Inter ou **Criar a conta do banco**. Nessa opção, o sistema cria a conta "Banco Inter" com agência 0001 e a conta corrente informada.
3. Informe a **conta corrente no banco** (só números) e o **ambiente**: **Produção** para a integração criada no Internet Banking, **Sandbox** só para testes com credenciais de sandbox.
4. Defina **multa (%)**, **juros ao mês (%)** e em quantos dias após o vencimento o boleto é **baixado no banco** (0 a 60). Depois desse prazo o cliente não consegue mais pagar o boleto.
5. Clique em **Salvar**. A integração pode ser cadastrada antes da liberação do banco. Ela fica **aguardando credenciais** e a tela mostra o que falta.
6. Quando o Inter liberar, clique em **Completar** e informe o Client ID e o Client Secret. Envie o `.crt` e o `.key` e salve. O selo muda para **pronta para emitir**.
7. Clique em **Testar conexão**. Se der erro, confira Client ID, Client Secret, certificado, chave e ambiente.
8. Clique em **Cadastrar aviso**. O sistema informa ao Inter o endereço que recebe os avisos de pagamento (webhook). Sem esse passo, a baixa só acontece na conferência de hora em hora.

#### Emitir boleto do Banco Inter pelo título

- Abra o título a receber. O card **Boleto com PIX (cobrança por API)** tem um botão **Emitir boleto da parcela N** para cada parcela em aberto. O botão só aparece com a integração pronta para emitir.
- O boleto sai com o valor em aberto da parcela. Se a parcela já venceu, o vencimento do boleto passa a ser o dia da emissão.
- O cliente precisa ter CPF/CNPJ, endereço, cidade, UF e CEP. O sistema usa o endereço de cobrança, se houver, e o telefone financeiro.
- Depois de emitido, há quatro botões:
  - **PDF** abre o boleto do Inter, para enviar ao cliente.
  - **Copiar linha** copia a linha digitável.
  - **Copiar PIX** copia o PIX copia e cola.
  - **Consultar** busca a situação no Inter na hora.
- A linha digitável também entra nos avisos de vencimento por e-mail.
- **Cancelar** cancela o boleto no banco. Depois disso, pode-se emitir outro para a mesma parcela. Uma parcela tem só um boleto ativo por vez.

#### Baixa automática do boleto Inter

- Quando o cliente paga, por boleto ou por PIX, o Inter avisa o sistema. O sistema confere a cobrança no banco e baixa a parcela:
  - na conta do Inter;
  - na data do recebimento;
  - com o motivo **Retorno bancário**.
- O que for pago acima do valor da parcela entra como juros/multa. Pagamento menor baixa só o que entrou e deixa o restante em aberto.
- De hora em hora, uma rotina confere os boletos em aberto. Assim, um aviso perdido não deixa uma parcela paga em aberto.
- Boleto **marcado como recebido** manualmente no app do Inter não é baixado sozinho, porque o dinheiro pode ter entrado por fora. Faça a baixa pelo título.
- Se a parcela já estava quitada quando o pagamento entrou, o boleto mostra um aviso de possível pagamento em duplicidade. Confira e devolva o valor ao cliente, se for o caso.

**A baixa automática não aconteceu?** Confira nesta ordem:

1. No título, clique em **Consultar** no boleto. Se o Inter já mostrar o pagamento, a baixa acontece na hora.
2. Em **Financeiro > Cobrança por API**, veja se aparece o selo **aviso de pagamento cadastrado**. Se não aparecer, clique em **Cadastrar aviso**.
3. Veja se o boleto foi pago e não apenas **marcado como recebido** no app do Inter. Marcado como recebido não baixa sozinho.
4. Veja se o boleto pago foi gerado pela **recorrência do Inter**. Boleto da recorrência não tem baixa automática.
5. Leia a mensagem em vermelho embaixo do boleto. Ela informa, por exemplo, conta inativa ou parcela já quitada.

#### Boleto recorrente do Inter e boleto do sistema (duplicidade)

- O **gerador de boletos recorrentes** do Internet Banking do Inter não tem ligação com o sistema. Se o mesmo cliente tiver a recorrência no Inter e o boleto emitido pelo sistema, ele recebe **dois boletos** pela mesma conta.
- O boleto gerado pela recorrência do Inter **não dá baixa automática**. O aviso chega ao sistema, mas fica registrado como cobrança emitida fora do sistema, porque não há como saber a qual título ele pertence. A baixa desse pagamento é manual.
- Não é preciso cancelar toda a recorrência do Inter, só a dos clientes cobrados pelo sistema:
  1. No Inter, encerre a recorrência do cliente e cancele os boletos futuros já gerados por ela.
  2. Passe a emitir os boletos desse cliente pelo título no sistema.
  3. Os boletos do mês já enviados podem ser pagos normalmente, com baixa manual. Também podem ser cancelados no Inter e emitidos de novo pelo sistema.
- Cobranças que não estão no sistema podem continuar na recorrência do Inter.

#### Erros comuns na integração com o Banco Inter

- **Integração aguardando credenciais:** falta o Client ID, o Client Secret, o certificado ou a chave. Use **Completar**.
- **Não foi possível autenticar no Inter:** credenciais de um ambiente usadas no outro (sandbox × produção), Client Secret errado, ou certificado e chave de outra integração.
- **A chave enviada não corresponde ao certificado:** o `.crt` e o `.key` precisam ser da mesma integração.
- **O certificado do Inter está vencido:** gere uma nova chave da integração no Internet Banking e envie os arquivos novos.
- **Complete o cadastro do cliente para emitir o boleto:** falta CPF/CNPJ, endereço, cidade, UF ou CEP do cliente.
- **O Inter só emite cobrança a partir de R$ 2,50:** valor mínimo do banco.

### Boletos a pagar (código de barras)

- **Ao lançar uma conta a pagar**: passe o leitor ou cole a linha digitável no campo **Código de barras do boleto**. O sistema confere os dígitos e preenche o valor e o vencimento.
- **Contas de consumo e tributos** (códigos que começam com 8) também são aceitos. Esses códigos não trazem vencimento.
- **No título**, o card **Boletos das parcelas** guarda um código para cada parcela. Se o valor ou o vencimento do boleto forem diferentes da parcela, aparece um aviso. O botão **Copiar linha** copia a linha digitável para pagar no banco.
- O vencimento é calculado pela regra FEBRABAN, incluindo o recomeço do fator em 22/02/2025.

### Avisos de vencimento por e-mail

Em **Financeiro › Avisos de vencimento**:

1. Informe com quantos dias **antes** do vencimento e com quantos dias de **atraso** o cliente recebe o e-mail. Exemplo: antes "3" e depois "1, 5". O valor "0" antes envia no próprio dia.
2. Ajuste o assunto e a mensagem. Os marcadores ({cliente}, {valor}, {vencimento}, {linha_digitavel}...) são trocados pelos dados de cada parcela.
3. Ligue **Enviar avisos automaticamente**.

A tela mostra os avisos do dia, inclusive os clientes sem e-mail cadastrado. Também é possível **Enviar agora**.

- Cada aviso sai uma única vez por parcela.
- O e-mail financeiro do cliente tem preferência sobre o e-mail geral.
- Títulos quitados e previsões não recebem aviso.
- O envio pode ser acompanhado em **Sistema › E-mails**. Enquanto o servidor de e-mail do sistema não estiver configurado, os avisos aparecem lá como **FALHOU** ("Não enviado: servidor de e-mail do sistema não configurado") e não chegam ao cliente.

### Cheques

Em **Financeiro › Cheques**.

**Receber cheques**
1. Escolha o cliente e o título a receber. O sistema lista os títulos em aberto; sem título, o valor entra como lançamento avulso.
2. Informe cada cheque. Passar o leitor ou digitar o **CMC7** (a linha de números na parte de baixo do cheque) preenche banco, agência, conta e número. Ao usar **Outro cheque**, o número seguinte do talão já vem sugerido.
3. O total mostra se o título será quitado ou se ainda fica saldo em aberto.

O valor fica na conta **Cheques em carteira**, criada automaticamente e visível no extrato, até o depósito.

**Na lista de recebidos**
- **Depositar**: selecione vários cheques, escolha a conta e a data. O valor sai da carteira e entra no banco. Os pré-datados aparecem marcados.
- **Repassar**: entrega os cheques a um fornecedor, pagando o título a pagar escolhido (ou só registrando o repasse).
- No cheque, **Devolvido pelo banco**: escolha a alínea. O valor sai do banco e o cheque volta para a carteira. Depois é possível **Reapresentar no banco** ou **Cobrar do cliente**; a cobrança tira o cheque da carteira e cria um título a receber.
- **Marcar compensado**: registra que o banco confirmou o cheque. Não movimenta valores.

**Cheques emitidos**: registre o cheque da empresa, pagando o título do fornecedor pela conta do talão. O cheque pode ser marcado como compensado ou cancelado; o cancelamento estorna o pagamento.

O histórico de cada cheque mostra todas as operações com data e conta.

### Controle de caixa físico

1. Acesse **Financeiro > Controle de caixa** e abra o caixa do estabelecimento, informando o fundo inicial contado.
2. Registre **suprimento** para dinheiro colocado no caixa ou **sangria** para retirada, sempre com motivo.
3. No fechamento, informe o dinheiro efetivamente contado. Se houver diferença, descreva a conferência; o sistema preserva valor esperado, contado e diferença.

Vendas do PDV recebidas em dinheiro entram automaticamente no caixa aberto do estabelecimento, e devoluções em dinheiro saem dele. PIX, cartão e crediário não passam pelo caixa físico: vão para a conta bancária ou para contas a receber.

## Frente de caixa (PDV)

Antes da primeira venda, o responsável pelo caixa acessa **Vendas > Frente de caixa (PDV) > Configurar** e escolhe o depósito de onde saem os produtos. Se nenhum cliente padrão for escolhido, o sistema cria o cliente "Consumidor final". Cadastre também as formas de recebimento em **Financeiro > Condições e cobranças**:

- **Dinheiro**: tipo Dinheiro, "Entra direto no caixa/banco".
- **PIX e débito**: "Entra direto no caixa/banco", com a conta bancária padrão.
- **Crediário, cartão parcelado e boleto**: "Gera conta a receber"; ao receber, escolha a condição (ex.: 30/60).

Papéis prontos: **Vendedor de balcão** (monta a pré-venda) e **Operador de caixa** (recebe, cancela, devolve e emite a NFC-e).

### Vender

1. Clique em **Nova venda** (tecla F2).
2. Leia o código de barras ou digite SKU/nome e tecle Enter (F4 volta ao campo). Ler o mesmo produto de novo soma a quantidade.
3. Ajuste quantidade, preço e desconto por item; informe desconto geral, CPF/CNPJ na nota e vendedor, se houver.
4. Clique em **Enviar ao caixa**, ou em **Salvar pré-venda** para continuar depois.

### Receber no caixa

1. Abra o caixa do estabelecimento em **Financeiro > Controle de caixa**.
2. Abra a venda "No caixa", informe uma ou mais formas de recebimento e, no dinheiro, o valor entregue pelo cliente. O troco é calculado na tela.
3. A soma das formas precisa ser igual ao total. Clique em **Concluir venda** (F10).

Ao concluir: o estoque sai do depósito do PDV (lote e série incluídos), o dinheiro entra no caixa, PIX/débito entram na conta, e crediário/cartão viram contas a receber com as parcelas da condição. Produto sem saldo não é vendido; serviços não baixam estoque.

Depois de concluída, imprima o **Cupom** (não fiscal, para impressora térmica de 80 mm) ou clique em **Emitir NFC-e**, que abre a nota já preenchida com os itens, descontos e forma de pagamento da venda.

### Cancelar e devolver

- Pré-venda ainda não concluída pode ser cancelada com motivo; nada foi baixado.
- Venda concluída não se cancela: registre uma **devolução**. Informe a quantidade devolvida de cada item e escolha **devolver em dinheiro** (sai do caixa aberto) ou **gerar crédito** para o cliente (fica em contas a pagar, para usar depois como encontro de contas). O desconto geral da venda é descontado proporcionalmente do valor devolvido. Itens com lote voltam para o mesmo lote e endereço de onde saíram.

## Produção interna

1. Cadastre a ficha técnica com produto final, rendimento, componentes e perdas.
2. Aprove a versão; uma versão aprovada fica congelada para preservar rastreabilidade.
3. Crie a ordem de produção.
4. Libere para reservar materiais.
5. Conclua para consumir componentes e gerar a entrada do produto acabado.

Quando o produto acabado exige lote ou série, informe código, endereço, fabricação e validade (se obrigatórias) no formulário de conclusão. Uma OP serializada conclui uma unidade por número de série.

## Industrialização externa

1. Cadastre o parceiro com papel **Industrializador**.
2. Crie a ordem, produto final, quantidade prevista, insumos e custo do serviço.
3. Envie: os materiais saem do disponível e ficam em trânsito.
4. Confirme a chegada: os materiais passam para “com terceiro”.
5. Registre cada retorno parcial, conciliando produto final, material consumido, devolvido e perdido.
6. Informe o custo daquele retorno e vencimento para gerar a conta a pagar.

O saldo não conciliado permanece com o industrializador.

## NF-e e NFC-e

Configure na empresa: CRT, ambiente, séries, certificado A1 e, para NFC-e, ID do CSC e CSC.

Depois de enviar o certificado, a tela da empresa mostra os botões **Testar NF-e** e **Testar NFS-e**; **Testar NFC-e** aparece quando o ID do CSC e o CSC estão preenchidos. O teste consulta o status do serviço na SEFAZ da UF da empresa, no ambiente configurado, com o certificado cadastrado. Nenhum documento é emitido e a numeração não muda. A resposta "107 — Serviço em Operação" confirma certificado, senha e comunicação.

**Numeração.** A SEFAZ não informa qual foi o último número usado. Ao migrar de outro sistema, informe em **Empresas › Certificado digital e notas fiscais** o **Próximo número NF-e** e o **Próximo número NFC-e** (o número seguinte ao último emitido em cada série). O valor atual aparece em **Sistema › Configurações › Numeração das notas**. Se o número já foi usado, a SEFAZ rejeita com **539** e a mensagem indica onde ajustar.

Antes de emitir, o sistema valida e explica separadamente:

- dados da empresa e cliente;
- CPF/CNPJ, IE, endereço, CEP e UF;
- NCM, CFOP, unidade, quantidade e preço;
- CSOSN de 3 dígitos para Simples Nacional ou CST de 2 dígitos para Regime Normal;
- certificado e arquivo correspondente.

Use **Visualizar** e **Prévia XML** antes da emissão. Comece sempre em homologação. Rejeições permanecem registradas para correção; documentos autorizados não são editados.

### Perfis fiscais prontos

Toda empresa já vem com 13 perfis fiscais, montados a partir de notas reais autorizadas: vendas (revenda, produção própria e NFC-e), industrialização (remessa, retorno de insumos e cobrança do beneficiamento), devoluções, amostra grátis, bonificação, conserto e outras saídas. Eles ficam em **Fiscal › Perfis fiscais** e podem ser ajustados.
- Empresa do Simples Nacional (CRT 1) recebe CSOSN; do regime normal, CST.
- No regime normal, os perfis tributados vêm marcados com **Falta alíquota**: informe a alíquota interna de ICMS da sua UF. As alíquotas interestaduais ficam nas **Regras fiscais**.
- A análise que originou os perfis está em `docs/ANALISE_PERFIS_FISCAIS.md`.

### Como o imposto de cada item é calculado

1. **Perfil de operação** (Fiscal > NF-e > Perfis): CFOP dentro e fora do estado, CST e alíquotas padrão da operação, e o IBS/CBS padrão.
2. **Cadastro fiscal do produto**: CST, alíquotas, origem e cBenef próprios do produto substituem os do perfil.
3. **Regras fiscais** (Fiscal > Regras fiscais): ajustes por imposto com condições opcionais (operação, UF de destino, CFOP, início do NCM, contribuinte e origem). São aplicadas da menor para a maior ordem; a posterior sobrescreve só o que preencher. Exemplos: alíquota interestadual por UF; redução de base e cBenef para um grupo de NCM; exclusão do ICMS da base de PIS/COFINS; cClassTrib diferente por CFOP.

As bases e os valores são recalculados ao criar a nota e quando **Recalcular impostos** é marcado na edição. Sem recálculo, os valores digitados de ICMS, IPI, PIS e COFINS são mantidos; o IBS/CBS é atualizado pelas alíquotas informadas no item.

### IBS e CBS (reforma tributária)

Informe no perfil o CST do IBS/CBS (ex.: 000), o cClassTrib (ex.: 000001, da tabela oficial) e as alíquotas. Em 2026: CBS 0,9% e IBS estadual 0,1%. A base é o valor do item (produto + frete + seguro + outras − desconto) menos ICMS, PIS e COFINS. Os valores aparecem no item e no total da nota, mas não somam ao valor total em 2026. Nota com IBS/CBS é gerada no leiaute PL_010; o sistema recusa CST e cClassTrib que não pertencem um ao outro. **Confirme as regras e alíquotas com o contador antes de emitir em produção.**

### Apuração de impostos

Em **Fiscal > Apuração de impostos**, escolha o mês para ver ICMS, ICMS-ST, IPI, PIS, COFINS, CBS e IBS das notas autorizadas: débitos das saídas, créditos das notas próprias de entrada e o saldo, com detalhe por CFOP. O crédito das notas de fornecedores entra com a escrituração de entrada. O resumo apoia a conferência; SPED e guias continuam com o contador.

## NFS-e

A NFS-e é emitida pelo **Emissor Nacional** (Sistema Nacional NFS-e): o sistema monta a DPS (Declaração de Prestação de Serviço), assina com o certificado A1 da empresa e envia direto ao Ambiente Nacional. Não há mais RPS para a prefeitura.

**Antes da primeira nota**, em **Empresas**, na parte fiscal, informe:

- inscrição municipal;
- série da DPS (só números) e próximo número;
- alíquota efetiva do Simples Nacional, se a empresa for optante (vai na nota como percentual aproximado de tributos);
- regime especial de tributação, quando houver.

Depois clique em **Testar NFS-e Nacional**. O sistema confere o certificado e se o município da empresa tem convênio com o Sistema Nacional. O teste também informa por onde a nota vai: pelo Emissor Nacional ou, como em Americana, pelo sistema da prefeitura no leiaute nacional. A NFS-e tem ambiente próprio, separado da NF-e: **Ambiente da NFS-e** em Homologação emite sem valor fiscal; passe para Produção depois de uma nota de teste autorizada.

**Emitir:**

1. Em **Fiscal > NFS-e**, clique em **Nova NFS-e** e selecione o tomador.
2. Informe a competência e o código IBGE do município da prestação.
3. Informe o **código de tributação municipal**, com 3 dígitos (por exemplo, 078), e o **código de tributação nacional**, com 6 dígitos (item, subitem e desdobro da LC 116; por exemplo, 14.01.01 vira 140101). Informe o NBS quando houver. Na dúvida, use os códigos de uma NFS-e que a empresa já emitiu pela prefeitura.
4. Descreva o serviço e informe o valor, o ISS, a retenção e os tributos federais retidos.
5. Em **IBS/CBS**, confira o cClassTrib (o formulário sugere 000001, tributação integral) e escolha o indicador da operação (local da prestação). É obrigatório desde 01/10/2026: municípios como Americana já rejeitam a nota sem ele. Os valores são calculados pelo sistema autorizador.
6. Salve, confira o **XML da DPS** e clique em **Transmitir NFS-e**.

Se faltar algum dado, a tela lista o que corrigir antes de enviar. O número da DPS só é reservado na transmissão. Uma nota rejeitada mantém o número e pode ser corrigida e transmitida de novo.

**Depois de autorizada**, a nota mostra o número da NFS-e e a chave de acesso, com os botões:

- **DANFSe**: abre o PDF oficial do Ambiente Nacional. Quando a nota foi gerada pelo sistema próprio do município e o PDF não está disponível, o sistema monta o DANFSe a partir do XML autorizado, pronto para imprimir.
- **Consultar situação**: se a conexão cair durante o envio, confere no Ambiente Nacional se a nota foi gerada, antes de transmitir de novo.
- **Cancelar**: escolha o motivo (erro na emissão, serviço não prestado ou outros) e escreva uma justificativa de pelo menos 15 caracteres.

### Enviar nota por e-mail

Na NF-e, na NFC-e ou na NFS-e **autorizada**, clique em **Enviar por e-mail**. Vão o XML e o PDF (DANFE, DANFCE ou DANFSe, com o logo da empresa).

- Se o cliente tem e-mail no cadastro (o fiscal e o geral), o sistema mostra os endereços e envia ao confirmar.
- Se não tem, abre uma janela para digitar um ou mais e-mails, separados por vírgula. **Enviar para outro e-mail** abre a mesma janela quando você quer mandar a nota para outro endereço, por exemplo uma nota avulsa ao contador. O fechamento do mês vai por **Envio ao contador**.
- Cada envio fica em **Sistema > E-mails**, com remetente, destinatários, anexos para baixar e a situação. Um envio com falha pode ser reenviado com os mesmos anexos.

Antes do primeiro envio, configure o **e-mail de envio da empresa** (veja abaixo).

### Envio ao contador

Em **Fiscal > Envio ao contador**, escolha o mês e clique em **Ver notas**. A tela mostra, por tipo (NF-e, NFC-e e NFS-e), quantas notas foram autorizadas e canceladas e o valor total, com a lista das notas.

- **Baixar ZIP:** pacote com os XML das notas autorizadas e canceladas do mês, os XML de cancelamento e o `resumo.csv` (abre no Excel).
- **Enviar XML:** manda o mesmo ZIP por e-mail ao contador, pelo e-mail de envio da empresa. O resumo por tipo vai no corpo da mensagem.
- Em **Contador**, grave o nome do escritório e o e-mail (vários separados por vírgula); o envio já vem com ele preenchido.

Só entram notas emitidas em produção. Se o pacote passar de 15 MB, baixe o ZIP e envie por outro meio.

### E-mail de envio da empresa

Em **Configurações > E-mail de envio**, informe a conta que o sistema usa para enviar:

- **E-mail do remetente:** use um endereço próprio para o sistema, por exemplo `naoresponda@suaempresa.com.br`.
- **Nome do remetente:** aparece para o cliente, por exemplo "Pro Redes Informática".
- **Servidor SMTP, porta e segurança:** fornecidos pelo provedor do e-mail. Normalmente é a porta 587 com TLS, ou a 465 com SSL.
- **Usuário e senha** da conta. A senha fica cifrada; em branco, a gravada é mantida.
- **Responder para:** e-mail que alguém lê, como financeiro@ ou comercial@. As respostas do cliente vão para ele, e não para o naoresponda.
- **Cópia oculta:** opcional, guarda uma cópia de cada envio numa caixa da empresa.

Clique em **Enviar e-mail de teste** para conferir. Para os e-mails não caírem no spam, o domínio precisa ter SPF e DKIM configurados no provedor; peça isso a quem administra o domínio.

Limitações atuais:

- o leiaute 1.01 não aceita tomador com CNPJ alfanumérico;
- a retenção de PIS/COFINS ainda não é enviada;
- municípios com emissor próprio fora do Sistema Nacional não são atendidos.

### Antes da primeira nota fiscal de uma empresa

Estes pontos saíram das primeiras emissões reais em homologação. Conferir tudo antes evita rejeições.

**NFS-e**
- Copie a **inscrição municipal**, o **código de tributação nacional** e o **código municipal** de uma NFS-e que a empresa já emitiu pela prefeitura. Não use valores estimados.
  - Inscrição municipal diferente da cadastrada na prefeitura: rejeição **X345**. Inscrição em branco: **X141**.
  - Exemplo: a Pro Redes usava 14.01.01 / 078 (manutenção de computadores), e não 01.07.01.
- Informe o **IBS/CBS**, mesmo no Simples Nacional. Sem ele, municípios como Americana rejeitam com **L2124**.
- Use **Testar NFS-e** para saber se o município emite pelo Emissor Nacional ou pelo sistema próprio.

**NF-e**
- A **numeração** tem de continuar de onde o sistema anterior parou, em cada série. Se o número já foi usado, a SEFAZ rejeita com **539** (duplicidade), mesmo em homologação.
- **Cliente contribuinte:** se o CNPJ tem inscrição estadual ativa, informe a IE no cadastro. Use a consulta de CNPJ, que já traz a IE. Sem ela, a SEFAZ-SP rejeita com **232**. Cliente sem IE é não contribuinte, e a nota vai automaticamente como consumidor final (evita a **696**).
- **"90 – Sem pagamento":** só para remessas, bonificações e devoluções. Nas vendas, informe a forma de pagamento real.

**NFC-e**
- O cliente é opcional. Sem cliente, a nota sai para **consumidor não identificado**, sem destinatário. Se o comprador pedir CPF ou CNPJ na nota, selecione o cadastro dele; o endereço é opcional.
- O **Testar NFC-e** responder 107 não garante a emissão: a SEFAZ também exige que o CNPJ esteja **credenciado para NFC-e** no ambiente usado. Sem o credenciamento, a emissão é rejeitada com **245**. Em SP, o credenciamento e o CSC são feitos no portal da NFC-e da SEFAZ, separadamente para homologação e produção.

### Rejeições da SEFAZ e da prefeitura

| Código | Onde | Significado | Como resolver |
|---|---|---|---|
| 245 | NFC-e | CNPJ do emitente não cadastrado | Credencie a empresa para NFC-e no portal da SEFAZ, no ambiente usado (homologação ou produção) |
| 232 | NF-e | IE do destinatário não informada | Consulte o CNPJ do cliente e grave a inscrição estadual |
| 539 | NF-e | Duplicidade: número já usado | Ajuste o próximo número da série em Empresas |
| 696 | NF-e | Não contribuinte sem consumidor final | Já tratado automaticamente; confira o indicador de IE do cliente |
| 904 | NF-e | Valor de pagamento indevido | "Sem pagamento" já envia valor zero; nas vendas use a forma real |
| X345 | NFS-e | Inscrição municipal não vinculada ao CNPJ | Corrija a inscrição municipal em Empresas |
| X141 | NFS-e | Inscrição municipal não informada | Preencha a inscrição municipal em Empresas |
| L2124 | NFS-e | IBS/CBS não informado | Preencha cClassTrib e indicador da operação |

O sistema já corrige sozinho três exigências do leiaute que também causavam rejeição:
- frete, seguro, desconto e outras despesas zerados deixam de ser enviados no item;
- o indicativo do intermediador (434) é informado;
- a nota é enviada no modo síncrono, que a SEFAZ-SP exige para uma nota por vez (452).

## Glossário fiscal e de cadastro

Termos que aparecem nos cadastros e nas notas, com o campo correspondente no sistema.

- **GTIN / EAN (código de barras):** número do código de barras do produto (8, 12, 13 ou 14 dígitos), registrado na GS1. Em **Produtos**, campo **GTIN/EAN**. Produto sem código de barras vai na nota como "SEM GTIN".
- **GTIN tributável:** código de barras da *unidade tributável*, a unidade usada para calcular o imposto, quando ela é diferente da unidade vendida (por exemplo, vende a caixa e tributa a unidade). Em **Produtos**, campo **GTIN tributável**. Em branco, vale o GTIN comercial; é o caso comum quando as duas unidades são iguais.
- **SKU:** código interno do produto. Opcional: em branco, o sistema cria um. É exigido para vender em marketplace.
- **NCM:** classificação fiscal da mercadoria (8 dígitos). Obrigatório na NF-e e na NFC-e. O contador ou o fornecedor informam o NCM correto.
- **CEST:** código de substituição tributária, exigido para alguns NCM.
- **CFOP:** código da operação (venda, devolução, remessa…), vem do perfil fiscal.
- **CRT:** regime da empresa na nota: 1 Simples Nacional, 2 Simples com excesso de sublimite, 3 regime normal. Em **Empresas**.
- **CSOSN / CST:** situação tributária do ICMS (CSOSN no Simples, CST no regime normal) e de PIS, COFINS e IPI.
- **IBS e CBS:** tributos da reforma tributária que substituem ICMS, ISS, PIS e COFINS aos poucos. **cClassTrib** é a classificação da operação (000001 = tributação integral) e o CST do IBS/CBS vem junto dela.
- **Indicador de IE / contribuinte:** 1 = contribuinte com inscrição estadual; 2 = isento; 9 = não contribuinte. Cliente não contribuinte é sempre consumidor final.
- **Consumidor final:** quem compra para uso próprio, sem revender. Muda o cálculo do imposto (e o DIFAL entre estados).
- **Chave de acesso:** número de 44 dígitos (NF-e/NFC-e) ou 50 dígitos (NFS-e) que identifica a nota em qualquer consulta.
- **Protocolo:** número da autorização dada pela SEFAZ. Nota sem protocolo não vale.
- **DANFE / DANFCE / DANFSe:** documentos auxiliares em PDF da NF-e, da NFC-e e da NFS-e. O documento fiscal de fato é o XML.
- **Homologação / produção:** homologação é o ambiente de testes, sem valor fiscal; produção vale de verdade. NF-e e NFS-e têm ambientes separados em **Empresas**.
- **CSC:** código de segurança do contribuinte, exigido para emitir NFC-e (QR Code). A empresa gera o CSC no portal da NFC-e da SEFAZ do estado.
- **DPS:** Declaração de Prestação de Serviço, o documento que o sistema envia para gerar a NFS-e.
- **Código de tributação nacional / municipal (NFS-e):** item da lista de serviços (6 dígitos, ex.: 14.01.01) e o desdobramento do município (3 dígitos, ex.: 078).
- **NBS:** Nomenclatura Brasileira de Serviços (9 dígitos, ex.: 1.1502.20.00).
- **Certificado A1:** arquivo .pfx da empresa, com senha, que assina as notas. Vale um ano; o sistema avisa antes de vencer.
## Multicanal e Mercado Livre

1. Crie o aplicativo no Mercado Livre.
2. Cadastre exatamente as URLs de retorno e webhook mostradas na tela.
3. Informe App ID e Secret Key e conclua o OAuth.
4. Sincronize os pedidos.
5. Confira pedidos externos pendentes antes de convertê-los em vendas internas.

O vínculo de produto deve ser feito por SKU/GTIN inequívoco. Pedidos pagos entram no fluxo comercial; cancelamentos e devoluções devem cancelar o pedido interno e recompor estoque conforme a etapa. Tokens e segredos nunca aparecem novamente em tela.

## Mensagens de erro

As mensagens seguem o padrão **área + campo + correção**, por exemplo: “Item 2: NCM deve conter exatamente 8 dígitos”. Não tente emitir repetidamente sem corrigir o dado indicado. Se a mensagem mencionar credencial, certificado, CSC ou homologação, procure o administrador; não altere dados tributários apenas para contornar a validação.