# Central de Ajuda — Configurações
## O que é
O módulo de Configurações é o painel central do Calcme onde você define como o sistema vai se comportar no dia a dia. É aqui que ficam os parâmetros que afetam todos os outros módulos: prazos padrão de produção, margens de lucro, regras fiscais, modelos de e-mail e WhatsApp, certificado digital, condições de pagamento, contratos, notificações e muito mais.
Diferente de outros módulos (como Vendas ou Financeiro, onde você opera), em Configurações você parametriza o sistema — define as regras que serão aplicadas automaticamente em todo o restante. Por isso, erros de configuração costumam ter impacto silencioso: tudo parece funcionar, mas os valores, textos ou documentos saem errados.
## Para que serve
- Padronizar prazos, margens e textos usados em orçamentos, pedidos e notas.
- Habilitar a emissão de NF-e, NFC-e e NFS-e com os parâmetros fiscais corretos da sua empresa.
- Gerenciar o certificado digital (validade, upload, renovação).
- Configurar as formas de pagamento e condições de parcelamento aceitas pela empresa.
- Integrar e-mail e WhatsApp ao sistema para envio automático de documentos.
- Definir regras de comissões, compras e contratos.
- Atualizar em massa métodos de custo, processos e plano de contas de produtos.
## Fluxo completo
1. O gestor acessa o menu Configurações e preenche as seções em ordem: Geral, Certificado Digital, NF-e/NFS-e/NFC-e, Condições de Pagamento, Notificações, e depois as configurações específicas de cada área (Offset, Visual, Compra, Comissão, Contratos).
2. As configurações são salvas por empresa (isolamento por idGraf) — cada cliente Calcme tem seu conjunto independente.
3. Todas as alterações são auditadas (histórico de quem alterou, quando e o quê).
4. Ao salvar, o sistema valida dados críticos: se o SMTP estiver ativo, testa a conexão antes de salvar; se o certificado digital for inválido, rejeita o upload.
5. As demais áreas (Vendas, Financeiro, Estoque, NF-e) leem essas configurações em tempo real — não é necessário reiniciar nada após salvar.
## Como usar
1. Acesse o menu Configurações (ícone de engrenagem no menu lateral).
2. Escolha o submódulo desejado no painel de abas ou lista lateral.
3. Preencha os campos e clique em Salvar.
4. Onde houver Cancelar, qualquer alteração não salva será descartada.
5. Campos obrigatórios são marcados com asterisco; campos condicionais aparecem e somem conforme outras seleções.
6. Alguns submódulos têm botões extras: Testar Conexão (SMTP), Validar Token (Gabster), Gerar QR Code (WhatsApp).
---
## Submódulos
### 1. Configuração Geral ⚙
A configuração geral é o coração das Configurações. É aqui que você define os padrões que valem para toda a operação da empresa: prazos, margens, regras de cálculo e os textos que aparecem em orçamentos, pedidos e notificações por e-mail e WhatsApp.
Prazos e valores padrão: informe o Prazo de Produção (em dias, para calcular data de entrega automática nos orçamentos), o Prazo de Fornecedores (para pedidos de compra) e a Validade da Proposta (quantos dias o orçamento fica válido). Defina também a Margem de Lucro padrão (%), o Juros de Financiamento (%) e a Alíquota de ICMS (%). Esses valores são usados como base de cálculo em toda a precificação.
Regras de cálculo: o campo Seleção de Preço em Orçamento determina qual preço de fornecedor será usado quando houver mais de um cadastrado — Menor Preço, Último Preço ou Maior Preço. A Provisão de Estoque e a Baixa de Estoque definem se o sistema pergunta, sempre faz ou nunca faz essas operações ao confirmar pedidos. A Regra de Total controla se os totais somam as maiores quantidades, menores ou todas.
Templates de comunicação: configure os textos padrão das mensagens de WhatsApp (proposta, pedido, cupom, PIX, cartão) e os títulos/conteúdos dos e-mails enviados automaticamente. Sem esses textos configurados, as mensagens automáticas saem em branco ou com placeholders visíveis para o cliente.
Campos obrigatórios: Prazo Produção, Prazo Fornecedor, Validade Proposta, Margem de Lucro, Juros, Impostos, Casas Decimais, Seleção de Preço.
Permissão: permissão para alterar configurações gerais.
Exemplo gráfica: a gráfica define Prazo de Produção = 3 dias e Validade da Proposta = 15 dias. Todo novo orçamento já vem com a data de entrega e validade preenchidas automaticamente.
Exemplo marcenaria: a marcenaria define Provisão de Estoque = "Sempre" para que, ao confirmar qualquer pedido de móvel sob medida, o sistema reserve o MDF e as ferragens do estoque sem perguntar.
---
### 2. Configuração Offset 🖨
A configuração de Offset define os parâmetros de custo para o setor de impressão offset — o tipo de impressão em que chapas de alumínio transferem tinta para o papel via cilindros. Essa tela é exclusiva de gráficas que operam máquinas offset.
Custos de produção: informe o valor da Hora de Pré-Impressão, o Tempo de Gravação de chapa (formato hh:mm), e os valores mínimos de Fotolito, Papel e Tinta. Esses mínimos garantem que nenhum orçamento de offset fique abaixo do custo real de setup. A Margem de Lucro aqui pode ser diferente da Configuração Geral — permite que o offset tenha sua própria margem.
Controles de impressão: o campo Cobertura (máx 100%) define o percentual de cobertura de tinta considerado nos cálculos. A opção Ignorar Formatos Que Não Cabem na Máquina evita que o sistema ofereça tamanhos impossíveis para as dimensões das máquinas cadastradas.
Campos obrigatórios: Margem, Hora Pré-Impressão, Tempo de Gravação, Fotolito Mínimo, Papel Mínimo, Tinta Mínimo, Unidade de Medida, Cobertura.
Impacto se incorreto: margens ou tempos errados fazem os orçamentos de offset saírem com custo subestimado, gerando trabalho no prejuízo.
Permissão: permissão para alterar configurações gerais.
Exemplo gráfica: a gráfica calibra o Tempo de Gravação = 00:20 (20 minutos) e Fotolito Mínimo = R$ 35,00. Qualquer orçamento offset que passe por cálculo de chapa já inclui esses custos automaticamente.
Exemplo marcenaria: este submódulo não se aplica a marcenarias.
---
### 3. Configuração Visual (Comunicação Visual) 🖼
A configuração Visual parametriza o cálculo de serviços de Comunicação Visual — banners, fachadas, adesivos, placas, lonas e similares. Enquanto o Offset é específico para impressão em papel com máquinas offset, o Visual cobre toda a impressão em grandes formatos e aplicações.
Taxa de lucro e markup: escolha entre trabalhar com Lucro (percentual sobre o custo) ou Markup (fator multiplicador sobre o custo). Os dois campos coexistem; a opção Preferência Taxa define qual o sistema usa por padrão nos cálculos. Configure o percentual ou fator de cada um.
Custos mínimos: defina valores mínimos para Papel (ou mídia/substrato) e Tinta nos serviços de Comunicação Visual. Esses mínimos funcionam como piso de custo — mesmo um trabalho pequeníssimo vai no mínimo cobrir esses valores. A opção Descontar Apara desconta automaticamente a sobra de material não utilizada no cálculo de custo.
Campos obrigatórios: Preferência Taxa, Lucro, Markup, Papel Mínimo, Tinta Mínimo, Alterar Todas as Tiragens, Alterar Todas as Unidades, Cobertura.
Exemplo gráfica: a gráfica define Markup = 2,5 como padrão para CV. Um banner com custo de R$ 40,00 sai no orçamento a R$ 100,00 automaticamente.
Exemplo marcenaria: não se aplica diretamente; marcenarias não usam esse módulo de cálculo.
---
### 4. Condições de Pagamento 💳
As condições de pagamento são os "planos de pagamento" que aparecem nos orçamentos e pedidos. Cada condição define a forma de pagamento (dinheiro, cartão, boleto, PIX etc.), o número de parcelas, a frequência e os eventuais juros aplicados.
Como criar: vá em Configurações → Condições de Pagamento → Nova. Escolha um Título (ex.: "30/60/90 Boleto"), o Modo (Detalhado ou Simples) e a Forma de Pagamento. No Modo Detalhado, informe a condição no formato numérico separado por barras (ex.: "30/60/90"). No Modo Simples, informe a Quantidade de Parcelas e a Frequência (mensal, semanal etc.). Se houver juros, ative o toggle Adicionar Juros e informe a taxa e o formato de cobrança. Vincule uma Conta Bancária para que as parcelas geradas já tenham destino correto.
Como editar ou excluir: localize a condição na lista, clique no ícone de lápis para editar ou na lixeira para excluir. O sistema confirma a exclusão antes de executar. É possível duplicar uma condição existente para criar variações rapidamente. A lista pode ser exportada em XLSX para controle externo. Exclusão em massa está disponível selecionando múltiplas linhas.
Impacto se mal configurado: condições sem banco vinculado geram parcelas sem conta destino, quebrando a conciliação financeira. Condições com juros errados alteram o valor final cobrado do cliente.
Permissões: permissão para visualizar condições de pagamento, permissão para criar condições de pagamento, permissão para editar condições de pagamento, permissão para excluir condições de pagamento, permissão para duplicar condições de pagamento.
Exemplo gráfica: a gráfica cria "À Vista no PIX (5% desc)", "30 dias no boleto" e "3x no cartão sem juros". Essas três opções aparecem no seletor de pagamento de todos os orçamentos.
Exemplo marcenaria: a marcenaria cria "50% na aprovação + 50% na entrega". Ao confirmar o pedido do cliente, o sistema gera duas parcelas automaticamente nas datas certas.
---
### 5. Certificado Digital 🔐
O certificado digital é o "RG eletrônico" da empresa para assinar documentos fiscais. Sem ele, a emissão de NF-e, NFC-e e NFS-e é completamente bloqueada pelo sistema e pela Receita Federal.
Como fazer o upload: vá à tela de configuração de NF-e (ou NFS-e/NFC-e) e localize a seção do certificado. Selecione o arquivo .pfx ou .p12 (fornecido pela sua certificadora — Certisign, Serasa, Soluti etc.) e informe a senha do certificado. O Calcme envia o certificado para a integração fiscal (parceiro de integração fiscal) e registra a data de vencimento automaticamente. Se o certificado for do tipo A3 (token USB), ative o toggle correspondente.
Renovação e vencimento: o sistema monitora o vencimento e exibe alertas quando a data está próxima. Ao receber o novo certificado da certificadora, basta fazer o upload novamente com o novo arquivo e a nova senha — o anterior é substituído. Para empresas com múltiplos CNPJs (Multi Faturamento), cada CNPJ tem seu próprio certificado.
Campos obrigatórios: arquivo (.pfx/.p12) + senha. Permissões: permissão para criar este recurso (upload), permissão para excluir este recurso (remoção).
Impacto se expirado ou ausente: todas as emissões de NF-e, NFC-e e NFS-e são rejeitadas. O sistema exibe mensagem de erro fiscal até que o certificado válido seja carregado.
Exemplo gráfica: a gráfica recebe o certificado renovado da Certisign. Vai em Configurações → NF-e → Certificado, faz o upload do novo.pfx com a senha nova, e a emissão volta ao normal imediatamente.
Exemplo marcenaria: a marcenaria emite NFS-e (nota de serviço de marcenaria). Sem o certificado válido, nenhuma nota pode ser gerada e o cliente não recebe comprovante fiscal.
---
### 6. Configuração NF-e 📋
A configuração de NF-e define todos os parâmetros fiscais usados na emissão de Nota Fiscal Eletrônica (mercadorias). É a configuração mais complexa do módulo — envolve tributos, CFOP, DIFAL, ambiente de teste/produção, logo e integrações com a Sefaz via integração fiscal.
Tributação: configure o ICMS conforme o regime da empresa — Simples Nacional (códigos 101 a 900) ou Regime Normal (00 a 90). Informe as alíquotas de IPI, PIS e COFINS com suas situações tributárias. Para substituição tributária, informe modalidade, margem e alíquota do ICMS ST. A aba DIFAL mostra uma tabela 27×27 com os estados de origem e destino para configurar o diferencial de alíquota interestadual.
CFOP: defina os códigos para cada situação de venda: dentro do estado, fora do estado, importação, exportação, remessa. O CFOP correto é crítico — NF-e com CFOP errado pode ser rejeitada ou gerar autuação.
Ambiente e logo: escolha Produção ou Homologação (teste). Em Homologação, as notas são geradas mas são inválidas legalmente — use apenas para testes. Em Produção, as notas têm validade jurídica. Faça upload da logo da empresa (aparece na DANFE impressa). Configure também o template de e-mail enviado ao destinatário.
Multi-empresa: empresas com múltiplos CNPJs (filiais, holding) podem ter uma configuração de NF-e por CNPJ via Multi Faturamento.
Permissão: permissão para editar este recurso.
Exemplo gráfica: a gráfica é Simples Nacional. Configura ICMS 400 (isento), PIS 07 (isento), COFINS 07, e o CFOP 5102 para vendas dentro do estado. Ao emitir NF-e de uma venda de panfletos, esses parâmetros são aplicados automaticamente.
Exemplo marcenaria: a marcenaria é Regime Normal com substituição tributária em alguns estados. Configura o ICMS ST com margem de 30% e alíquota de 12%, e preenche a tabela DIFAL para os estados onde vende.
---
### 7. Configuração NFC-e 🧾
A configuração de NFC-e parametriza a emissão de Nota Fiscal de Consumidor Eletrônica, usada no PDV (caixa) para vendas diretas ao consumidor. É semelhante à NF-e, porém com simplificações para o varejo.
Diferenças-chave em relação à NF-e: o CFOP é específico para venda ao consumidor final (ex.: 5405 para venda de mercadoria com ST). O campo mais crítico é o CSC (Código de Segurança do Contribuinte) — cada empresa recebe dois tokens da Sefaz (um para Produção, um para Homologação) que devem ser cadastrados aqui. Sem o CSC correto, a NFC-e não é autorizada.
Configuração do CSC: informe o Token de Produção, o ID do Token de Produção, o Token de Homologação e o ID do Token de Homologação. Esses dados são obtidos diretamente no portal da Sefaz do estado. O Calcme armazena e sincroniza com a integração fiscal.
Permissão: permissão para configurar NFC-e.
Impacto se incorreto: vendas no PDV geram erro na emissão da NFC-e, o que bloqueia o fechamento de caixa ou obriga a emitir cupom não fiscal como alternativa.
Exemplo gráfica: a gráfica tem uma loja de insumos no balcão com PDV. Configura o CSC da SEFAZ-SP e o CFOP 5102. As vendas no caixa emitem NFC-e automaticamente para o consumidor.
Exemplo marcenaria: a marcenaria vende alguns itens avulsos (puxadores, dobradiças) no balcão. Com o PDV configurado e NFC-e parametrizada, o vendedor emite a nota diretamente na tela do caixa.
---
### 8. Configuração NFS-e 📄
A configuração de NFS-e parametriza a emissão de Nota Fiscal de Serviço Eletrônica, usada quando a empresa presta serviços. Gráficas que emitem nota de serviço (acabamento, arte, criação) e marcenarias (instalação, projeto) usam este submódulo.
Tributação de serviços: configure a Natureza da Operação (tributação no município, fora do município, imune etc.), o Regime Especial de Tributação e as alíquotas de ISS, COFINS, PIS, CSLL, IR e INSS. Para cada imposto há um toggle de Retenção — ative os que a empresa é obrigada a reter na fonte.
Atividades da empresa: cadastre as atividades de serviço prestadas, com Código de Serviço Nacional, Código Municipal, Descrição, Imposto Federal e Imposto Municipal. Marque a atividade Principal. Cada tipo de serviço pode ter uma atividade diferente. Sem atividade cadastrada, a NFS-e não pode ser emitida.
Autenticação com a prefeitura: informe o Usuário e a Senha do portal da prefeitura. Se a senha aparecer como "0000" ao abrir a tela, é a máscara de segurança — o sistema mantém a senha real. Só altere se precisar trocar a senha. A integração integração de NFS-e pode ser ativada para backup e auditoria das notas emitidas. O campo ativação da integração de NFS-e registra a empresa no integração de NFS-e ao ser ativado.
Campos obrigatórios: Natureza da Operação, Regime Especial, alíquotas de ISS/COFINS/PIS/CSLL/IR/INSS, Título e Conteúdo do E-mail, pelo menos uma Atividade.
Permissão: permissão para editar este recurso.
Exemplo gráfica: a gráfica presta serviços de design e criação de arte. Configura ISS = 5%, atividade "Serviços de Publicidade e Propaganda" com código municipal 7319-0/02, e o login da prefeitura da cidade.
Exemplo marcenaria: a marcenaria cobra separado o serviço de instalação dos móveis. Configura ISS = 3% (alíquota do município), atividade "Instalação de Móveis" e senha do portal da prefeitura para emitir NFS-e de cada instalação.
---
### 9. Configuração de Boleto 🏦
Define os parâmetros específicos para o envio de boletos bancários gerados no módulo Financeiro. São basicamente dois conjuntos de configurações: o template do e-mail enviado ao cliente junto com o boleto e a política de formas de pagamento.
Template de e-mail: configure o Título do E-mail e o Conteúdo do E-mail que acompanham o boleto enviado ao cliente. Textos claros e profissionais aumentam a taxa de pagamento. Se esses campos ficarem em branco, o e-mail sai sem assunto ou sem corpo — o cliente pode classificar como spam.
Múltiplas formas de pagamento: o campo allowPaymentsType define se, ao enviar o link do boleto, o sistema também oferece outras opções de pagamento (PIX, cartão etc.) na mesma tela. Ative para flexibilizar as formas de recebimento. A configuração do Testar Conexão valida a integração com o atualização automática da integração fiscal para confirmar que as notificações de pagamento de boleto chegam corretamente.
Permissão: permissão para configurar boletos.
Impacto se incorreto: e-mail de boleto enviado sem assunto ou sem corpo reduz a taxa de pagamento. atualização automática não validado pode fazer o sistema não reconhecer automaticamente quando o boleto foi pago.
Exemplo gráfica: a gráfica configura o e-mail: Título = "Seu boleto está disponível – Gráfica Estrela" e conteúdo com instruções de pagamento. Ao emitir um boleto de R$ 850,00 para um cliente, esse e-mail é enviado automaticamente com o arquivo PDF em anexo.
Exemplo marcenaria: a marcenaria ativa "Múltiplas Formas de Pagamento" e o cliente que recebe o link do boleto pode escolher pagar por PIX em vez do boleto bancário.
---
### 10. Configuração de Comissões 👔
Define as regras gerais de como as comissões de vendedores e agências serão calculadas e lançadas automaticamente no módulo Financeiro.
Automação de comissões: o campo comissaoAutomatico define se a comissão é gerada automaticamente ao confirmar uma venda ou se precisa ser criada manualmente. O campo diasAposPagamentoCliente define quantos dias após o cliente pagar o sistema pode lançar a comissão (útil para garantir que só se paga comissão de vendas que efetivamente entraram no caixa). O campo travaContaPagar impede que a conta a pagar gerada pela comissão seja alterada depois de lançada.
Categoria financeira: vincule uma Categoria Financeira do tipo Despesa (cadastrada no módulo Financeiro → Categorias) para que todas as comissões sejam classificadas corretamente no DRE e nos relatórios. Sem essa vinculação, a comissão é lançada sem categoria e "suja" os relatórios.
Forma de pagamento: defina a forma de pagamento padrão das comissões (dinheiro, transferência, PIX etc.) para que a conta a pagar seja gerada já com o método correto.
Permissão: permissão para editar este recurso.
Impacto se incorreto: sem categoria definida, as comissões aparecem como despesas sem classificação no DRE, distorcendo a análise de lucratividade. Se a automação estiver desligada e ninguém gerar manualmente, vendedores ficam sem comissão registrada.
Exemplo gráfica: a gráfica define que comissão é gerada automaticamente, 5 dias após o cliente pagar, e vincula à categoria "Comissões Comerciais". Ao confirmar um pedido de R$ 2.000,00, o sistema aguarda o pagamento e, no quinto dia útil depois, cria automaticamente a conta a pagar da comissão do vendedor.
Exemplo marcenaria: a marcenaria paga comissão de 3% ao arquiteto que indicou o cliente. Configura o gerador automático com a categoria "Comissões de Parceiros" e, ao faturar o projeto, a conta a pagar já aparece no Financeiro.
---
### 11. Configuração de Compra 🛒
Define os textos e templates de comunicação usados nos pedidos de compra enviados a fornecedores. Serve para padronizar a aparência dos documentos de compra (PDF) e as mensagens enviadas por e-mail e WhatsApp.
Textos do documento: configure o Texto do Topo (aparece no cabeçalho do pedido de compra) e o Texto do Rodapé (aparece no rodapé). Use esses espaços para incluir condições gerais de compra, dados do responsável pelo setor de compras, prazo de validade do pedido etc.
Comunicação com fornecedor: configure o Texto de WhatsApp (enviado ao fornecedor quando o pedido é compartilhado pelo app) e os campos de Título e Conteúdo do E-mail do pedido de compra. Se esses textos não estiverem configurados, os documentos e mensagens saem sem informação.
Campos obrigatórios: Texto Topo, Texto Rodapé, Texto WhatsApp, Título E-mail, Conteúdo E-mail.
Permissão: permissão para editar este recurso.
Exemplo gráfica: a gráfica configura o Rodapé do pedido de compra com "Pedido sujeito a confirmação. Para dúvidas, fale com Maria – Compras: (11) 99999-0000". Todo pedido de papel e tinta enviado ao fornecedor já sai com esse rodapé.
Exemplo marcenaria: a marcenaria configura o texto de WhatsApp como "Olá, seguem as especificações do pedido de MDF e ferragens para análise. Favor confirmar disponibilidade e prazo". Ao compartilhar o pedido pelo WhatsApp, essa mensagem acompanha o PDF automaticamente.
---
### 12. Contratos 📝
O submódulo de Contratos permite gerenciar modelos de documentos (propostas comerciais, contratos, ordens de serviço) e os assinantes responsáveis por assinar esses documentos. Os arquivos são armazenados na nuvem e podem ser associados a orçamentos, pedidos e incidentes.
Upload de documentos: envie arquivos nos formatos .docx ou .pdf para cada tipo de documento — Orçamento, Pedido ou Incidente. O sistema aceita múltiplos arquivos por tipo. É possível visualizar o arquivo diretamente na tela (prévia) e baixar quando necessário.
Assinantes: cadastre as pessoas que devem assinar os contratos. Para cada assinante, informe Nome, E-mail e Telefone. A ordem dos assinantes pode ser reorganizada por arrastar e soltar — a ordem define a sequência de assinatura. Adicione, edite ou remova assinantes conforme o fluxo jurídico da empresa.
Variáveis dinâmicas no template: os documentos.docx podem conter variáveis que o sistema substitui automaticamente pelo dado real do pedido. Exemplos: {{ped_numero}} (número do pedido), {{ped_data}} (data), {{ped_data_por_extenso}} (data por extenso), {{ped_data_entrega}} (data entrega), {{ped_contato}} (nome do cliente), {{ped_produtos}} (lista de produtos), {{ped_pagamentos}} (condições de pagamento). Também existem variáveis de Empresa, Cliente, Orçamento e Incidente.
Permissões: libere este recurso apenas para usuários administradores ou responsáveis pela configuração da empresa.
Exemplo gráfica: a gráfica sobe um contrato de serviços gráficos em.docx com a variável {{ped_numero}} no título. Ao fechar um pedido de impressão, o contrato é gerado com o número real do pedido já preenchido.
Exemplo marcenaria: a marcenaria usa um contrato padrão para projetos acima de R$ 5.000,00 com variáveis de data de entrega e itens. Os assinantes cadastrados são o responsável comercial e o gerente de produção. Ao confirmar o projeto, o contrato vai para assinatura automaticamente na sequência correta.
---
### 13. Ações em Massa 🆕 🔄
O submódulo de Ações em Massa permite atualizar em lote propriedades de produtos e materiais cadastrados, sem precisar editar item por item. São três tipos de alteração suportados: Método de Custo, Processo e Plano de Contas.
Como usar: acesse Configurações → Ações em Massa e escolha a ação desejada no menu: Método de Custo (altera como o custo do produto é calculado em orçamentos), Processo (vincula ou troca o processo produtivo de múltiplos itens) ou Plano de Contas (redefine a conta contábil de itens em lote). Use os filtros para selecionar os itens desejados, marque individualmente ou use o botão "Selecionar Todos" e aplique a alteração.
Quando usar: útil quando há uma mudança estratégica no negócio — por exemplo, a marcenaria muda de "Custo Médio" para "Último Preço de Compra" como método de custo para todos os insumos, ou a gráfica precisa reclassificar todos os papéis couché para uma nova conta contábil após mudança no plano de contas da empresa.
Permissões separadas por ação: permissão para visualizar este recurso (listar e selecionar), permissão de acesso ao recurso (alterar método de custo), permissão de acesso ao recurso (alterar plano de contas).
Atenção: alterações em massa são irreversíveis em lote — não há "desfazer". Revise bem os filtros antes de aplicar.
Exemplo gráfica: a gráfica tem 300 tipos de papel cadastrados com método de custo "Preço Manual". Decide migrar todos para "Último Preço de Compra". Em vez de editar um por um, usa Ações em Massa, filtra por categoria "Papel" e aplica em segundos.
Exemplo marcenaria: a marcenaria reorganiza o plano de contas e precisa mover todos os acessórios (puxadores, dobradiças, trilhos) de uma conta para outra. Filtra por tipo "Acessório" e aplica o novo plano de contas em lote.
---
### 14. Notificações (E-mail e WhatsApp) 🔔
O submódulo de Notificações centraliza a configuração dos canais de comunicação automática do sistema: servidor de e-mail SMTP e integração com WhatsApp Business.
Configuração SMTP: ative o toggle Usar SMTP Próprio para usar o servidor de e-mail da sua empresa em vez do servidor padrão do Calcme. Preencha o Host SMTP (ex.: smtp.gmail.com, smtp.seuprovedor.com.br), a Porta, o Protocolo (SSL ou TLS), o Usuário (endereço de e-mail remetente) e a Senha. Clique em Testar Conexão antes de salvar — o sistema envia um e-mail de teste e confirma se a configuração está correta. Se a conexão falhar, o sistema não salva e exibe a causa do erro. Se o SMTP não for configurado, os e-mails saem com remetente do Calcme (sem personalização).
Integração WhatsApp: para conectar o WhatsApp Business ao Calcme, clique em Gerar QR Code. Abra o WhatsApp no celular, vá em Aparelhos Conectados e escaneie o código. O status muda para "Conectado" e o sistema passa a enviar mensagens automáticas (orçamentos, pedidos, avisos) via este número. Para desconectar, use o botão Desconectar. ⚠ Alertas personalizados por evento: identificados no frontend, mas os detalhes completos de configuração de backend não foram totalmente mapeados.
Permissão: sem permissão específica mapeada no frontend (acesso geral às Configurações).
Exemplo gráfica: a gráfica usa o e-mail [email protected] para enviar orçamentos. Configura o SMTP do provedor, testa e salva. Os clientes passam a receber os e-mails com o remetente da gráfica, não do Calcme.
Exemplo marcenaria: a marcenaria conecta o WhatsApp da empresa. Ao aprovar um orçamento, o sistema envia automaticamente a mensagem configurada na Config Geral para o WhatsApp do cliente — sem o dono precisar digitar nada.
---
## Integração com outros módulos
- Config Geral → Vendas: prazos alimentam a data de entrega dos orçamentos; templates alimentam e-mails e mensagens automáticas.
- Config Geral → Estoque: provisaoEstoque e baixaEstoque controlam o comportamento ao confirmar pedidos.
- Config Offset → Módulo Offset: todos os cálculos de custo de impressão offset leem os parâmetros aqui definidos.
- Config Visual → Módulo Comunicação Visual: idem para grandes formatos.
- Condições de Pagamento → Financeiro: ao gerar parcelas de um pedido, o sistema usa a condição escolhida para criar os lançamentos de conta a receber.
- Certificado Digital → NF-e / NFC-e / NFS-e: sem certificado válido, nenhuma nota é emitida.
- Config NF-e → Fiscal: alíquotas, CFOP e ambiente definem como cada NF-e é montada e enviada à Sefaz.
- Config NFS-e → Fiscal: atividades e alíquotas definem a NFS-e enviada à prefeitura.
- Config NFC-e → PDV: CSC token é obrigatório para NFC-e no caixa.
- Config Boleto → Financeiro/Boleto: template e-mail usado no envio do boleto; atualização automática valida recebimento.
- Config Comissão → Financeiro/Comissões: regras definem quando e como as comissões são lançadas.
- Config Compra → Compras/Estoque: textos e templates alimentam os documentos de pedido de compra.
- Contratos → Vendas: modelos e variáveis são usados na geração de contratos vinculados a pedidos.
- Notificações (SMTP) → Todos os módulos com e-mail: servidor SMTP define o remetente de todos os e-mails automáticos do sistema.
- Notificações (WhatsApp) → Todos os módulos com WhatsApp: número conectado é usado em todos os envios automáticos.
---
## Cancelamentos e estornos
As configurações não são "documentos" com ciclo de vida (criar, aprovar, cancelar). São parâmetros — você pode editá-los quantas vezes quiser, e o sistema passa a usar o novo valor imediatamente na próxima operação. Não existe "cancelar uma configuração".
Porém, há dois pontos de atenção:
- Mudança de Ambiente NF-e (Homologação → Produção ou vice-versa): esta troca é crítica. Ao mudar para Homologação, as notas emitidas são inválidas. Ao voltar para Produção, as notas voltam a ter validade jurídica — mas as notas emitidas em Homologação não são estornadas automaticamente.
- Ações em Massa: alterações em lote não têm desfazer automático. Se precisar reverter, terá que rodar outra ação em massa com os valores anteriores.
- Exclusão de Condição de Pagamento: se uma condição for excluída e ainda estiver vinculada a pedidos ou parcelas em aberto, esses registros históricos mantêm o texto da condição, mas não poderão mais ser reaplicados.
---
## Erros e validações comuns
- "Campo obrigatório" — algum campo essencial foi deixado em branco. Verifique os marcados com asterisco.
- "Erro ao testar conexão SMTP" — host, porta, protocolo, usuário ou senha incorretos; verifique com seu provedor de e-mail.
- "Certificado inválido ou senha incorreta" — o arquivo.pfx está corrompido ou a senha digitada não corresponde. Solicite novo arquivo à certificadora.
- "Atividade obrigatória — NFS-e não configurada" — nenhuma atividade foi cadastrada em Config NFS-e; adicione pelo menos uma.
- "Ambiente em homologação" — as NF-es emitidas não têm validade legal. Mude para Produção antes de emitir notas reais.
- "Certificado expirado" — o certificado venceu. Renove junto à certificadora e faça novo upload.
- "Token CSC inválido" — o código CSC da NFC-e está errado ou não foi inserido; obtenha no portal da Sefaz do estado.
- "Cobertura deve ser no máximo 100" — percentual de cobertura de tinta acima do limite.
- "Formato de tempo inválido" — campo de Tempo de Gravação (hh:mm) com formato errado.
---
## Perguntas frequentes
1. Preciso mexer nas Configurações toda vez que fizer um pedido?
Não. As configurações são feitas uma única vez (ou quando algo mudar no negócio) e o sistema usa automaticamente. Você só volta aqui para ajustar prazos, margens, textos ou parâmetros fiscais quando necessário.
2. O que acontece se eu mudar a margem de lucro na Config Geral?
A nova margem passa a valer para todos os orçamentos gerados a partir daquele momento. Orçamentos já criados não são alterados retroativamente.
3. Meu certificado digital expirou. O que fazer?
Contate sua certificadora (Certisign, Serasa, Soluti etc.) para renovar. Após receber o novo arquivo.pfx e a nova senha, acesse Configurações → NF-e (ou NFS-e/NFC-e) → seção Certificado, faça o upload e salve. A emissão de notas volta ao normal imediatamente.
4. Posso ter condições de pagamento diferentes para cada tipo de cliente?
As condições cadastradas aqui ficam disponíveis como opção para qualquer venda. A escolha de qual aplicar é feita pedido a pedido, ou pode ser vinculada ao cadastro do cliente. Não existe restrição automática por tipo de cliente diretamente nesta configuração.
5. Configurei o SMTP mas os e-mails ainda saem com o remetente do Calcme. O que está errado?
Verifique se o toggle Usar SMTP Próprio está ativado. Se estiver ativo, confirme que o botão Testar Conexão passou com sucesso e que o formulário foi salvo após o teste. Sem salvar, a configuração não persiste.
6. O que é o campo "Seleção de Preço em Orçamento"?
Quando um produto tem mais de um fornecedor cadastrado com preços diferentes, esse campo decide qual preço o sistema usa no cálculo do orçamento: o Menor Preço (mais competitivo), o Último Preço (mais recente) ou o Maior Preço (mais conservador). Afeta diretamente a margem calculada.
7. Preciso emitir NF-e e NFS-e ao mesmo tempo. Preciso configurar as duas?
Sim. Se sua empresa emite nota de mercadoria (NF-e) e nota de serviço (NFS-e), cada uma tem sua configuração independente — tributações diferentes, integrações diferentes (Sefaz para NF-e, prefeitura para NFS-e) e certificados que podem ser compartilhados ou separados.
---
## Problemas comuns
- Orçamento com data de entrega errada: verifique o Prazo de Produção na Config Geral.
- E-mail de orçamento chega sem texto no corpo: os campos Título do E-mail e Conteúdo do E-mail da Config Geral (aba Orçamento) estão em branco.
- WhatsApp não envia: número desconectado — acesse Notificações, gere novo QR Code e reconecte.
- NF-e rejeitada com "ambiente": Config NF-e está em Homologação. Mude para Produção.
- Comissão não gerada automaticamente: verifique se comissaoAutomatico está ativado na Config Comissão e se a categoria financeira está vinculada.
- Parcelas geradas sem conta bancária: a Condição de Pagamento usada não tem banco vinculado — edite a condição e vincule a conta correta.
- Boleto não muda status para "Pago" automaticamente: o atualização automática da integração fiscal não está validado — use o botão Testar Conexão na Config Boleto.
- NFS-e com "atividade não cadastrada": acesse Config NFS-e → aba Atividades e cadastre pelo menos uma atividade com todos os campos obrigatórios.
- Contrato não preenche variáveis: o arquivo.docx não usa o formato {{variavel}} ou a variável tem erro de digitação.
---
## Quando algo parece errado
1. Verifique o submódulo específico: cada problema costuma ter origem em uma configuração específica. Mapeie o sintoma → identifique qual Config está envolvida.
2. Confira se foi salvo: é comum editar e fechar sem clicar em Salvar. Reabra o submódulo e verifique se os valores persistiram.
3. Cheque o ambiente da NF-e: se notas estão sendo geradas mas o cliente não recebe DANFE válida, provavelmente está em Homologação.
4. Tente Testar Conexão no SMTP ou WhatsApp para diagnóstico rápido.
5. Verifique permissões do usuário: se o botão Salvar não aparece ou está desabilitado, o usuário pode não ter a permissão correta (ex.: permissão para alterar configurações gerais, permissão para editar este recurso).
6. Verifique o histórico de auditoria (Relatórios → Histórico) para ver quem alterou a configuração e quando — útil quando algo mudou sem aviso.
7. Persistindo, acione o suporte com: nome do submódulo, campo afetado, o valor que estava antes e o que era esperado.
---
## Orientações para o cliente
- Faça uma revisão completa das Configurações antes de começar a operar — principalmente Config Geral, Certificado Digital, NF-e/NFS-e/NFC-e e Condições de Pagamento. Uma configuração errada no início pode afetar centenas de documentos depois.
- Documente suas configurações fiscais (alíquotas, CFOPs, regime) com seu contador antes de preencher. Erros fiscais podem gerar autuações.
- Nunca deixe o ambiente NF-e em Homologação após testes. Sempre volte para Produção.
- Renove o certificado digital com antecedência (pelo menos 30 dias antes do vencimento). O processo de renovação leva tempo e, durante ele, você não consegue emitir notas.
- Teste o SMTP logo após configurar. Envie um e-mail de teste para você mesmo e confirme o recebimento antes de depender do canal para comunicação com clientes.
- Mantenha o WhatsApp conectado: o pareamento do WhatsApp pode cair se o celular ficar sem internet por muito tempo. Reconecte quando necessário.
- Revise as Condições de Pagamento periodicamente — se mudou de banco, as condições vinculadas ao banco antigo precisam ser atualizadas.
- Use Ações em Massa com cuidado: teste em um subconjunto pequeno de itens antes de aplicar em todos.
---
## Resumo
O módulo de Configurações é a base de toda a operação no Calcme. Sem ele bem preenchido, os demais módulos funcionam com dados incompletos ou incorretos.
Os 14 submódulos cobrem:
1. Geral — prazos, margens, textos, regras de cálculo e integrações de marketing.
2. Offset — custos de produção offset (gráficas).
3. Visual — custos e taxas de Comunicação Visual (gráficas).
4. Condições de Pagamento — formas e planos de pagamento.
5. Certificado Digital — upload, vencimento, A3, multi-empresa.
6. NF-e — ICMS, IPI, PIS, COFINS, CFOP, DIFAL, ambiente.
7. NFC-e — similar NF-e + CSC token para PDV.
8. NFS-e — ISS, prefeitura, atividades, integração de NFS-e.
9. Boleto — template e-mail, múltiplas formas, atualização automática.
10. Comissões — automação, dias após pagamento, categoria financeira.
11. Compra — textos de pedido de compra (e-mail/WhatsApp).
12. Contratos — documentos, assinantes, variáveis dinâmicas.
13. Ações em Massa 🆕 — atualização em lote de método de custo, processo e plano de contas.
14. Notificações — SMTP e WhatsApp Business.
Regras de ouro:
- Configure uma vez, use para sempre — mas revise periodicamente.
- Ambiente NF-e: PRODUÇÃO para notas reais, HOMOLOGAÇÃO só para testes.
- Certificado digital vencido = emissão bloqueada. Renove com antecedência.
- Ações em Massa são irreversíveis em lote — revise os filtros antes de aplicar.
- Cada submódulo tem suas permissões — libere com critério por perfil de usuário.
Configurações corretas = sistema funcionando certo = menos dor de cabeça no dia a dia da gráfica ou marcenaria.