Parâmetros: o nome na tela, o padrão de fábrica e quando mudar#
O que o ERPia assume quando ninguém configurou nada — e quando faz sentido mexer. O nome de cada parâmetro é o que você lê em Administração › Parâmetros.
PDV — o caixa#
| Parâmetro (nome na tela) | Padrão de fábrica | Por loja? | Quando mudar |
|---|---|---|---|
Atalhos de teclado do PDVpdv.atalhos | lista=[] | sim | Quando o mapeamento de teclas do caixa precisa mudar (ex.: novo atalho, tecla remapeada). |
CNPJ da automação (TEF)pdv.tef_cnpj_automacao | 50480988000101 | não | CNPJ da empresa que desenvolveu a automacao comercial, exigido pela certificadora do TEF em toda transacao. |
Exigir lacre do malotepdv.exigir_lacre_malote | habilitado=false | sim | Quando a loja passa a usar malote físico lacrado no fechamento do turno. |
Limites de desconto e ajuste no caixapdv.limites_operacionais | desconto_valor=5.0 · desconto_percentual=5.0 | não | Define limites gerais do PDV antes de exigir autorizacao superior. |
Máscara do código de barras da balançapdv.mascara_balanca_ean | ativa=true · prefixo=2 · digitos_codigo=6.0 · digitos_valor=5.0 · casas_decimais_peso=3.0 · casas_decimais_preco=2.0 | sim | Quando a loja troca de modelo de balança ou o padrão de código de barras dela muda. |
Mídia da tela do clientepdv.midia_cliente | ativa=false · titulo=(vazio) · mensagem=(vazio) · imagem_url=(vazio) · cor_fundo=(vazio) | sim | Ao publicar ou encerrar uma campanha na tela voltada pro cliente do checkout. |
Pagamento v2 no PDVpdv.pagamento_v2 | habilitado=false | sim | Publica o snapshot operacional de pagamentos v2 para o PDV. |
Pele padrão do PDV (mercado/touch)pdv.perfil | (vazio) | sim | Pele padrao do PDV: 'mercado' (teclado, denso) ou 'touch' (alvos grandes). Vazio = cada terminal usa o padrao da plataforma (Android=touch). |
Venda sem NFC-e (não fiscal)pdv.venda_sem_nfce | habilitado=false | sim | Vende SEM emitir NFC-e: a venda entra no faturamento e no caixa, mas nao gera documento fiscal. |
Caixa e sangria#
| Parâmetro (nome na tela) | Padrão de fábrica | Por loja? | Quando mudar |
|---|---|---|---|
Limite para sangrialimite_sangria | valor=500.0 | sim | Valor de numerario no caixa a partir do qual o sistema recomenda sangria. |
Tolerância na conferência do caixacaixa.tolerancia_conferencia | valor=1.0 reais | sim | Aceita de R$ 0,00 a R$ 100,00. A diferença continua registrada. Dentro da tolerância, registra o motivo tolerância de caixa. Acima dela, pede motivo e registra divergência. Zero exige motivo para qualquer diferença. |
Esse parâmetro tem risco médio. A pessoa que altera confirma a revisão do impacto. O padrão de fábrica não comprova o valor configurado para a sua loja.
Entrada e recebimento de mercadoria#
| Parâmetro (nome na tela) | Padrão de fábrica | Por loja? | Quando mudar |
|---|---|---|---|
Conferência cega no recebimentoentrada.conferencia_cega | habilitado=true | não | Oculta a quantidade esperada da NF-e enquanto o recebimento fisico ainda nao foi contado. |
Conferência física em 2 passosentrada.exige_conferencia_fisica | habilitado=false | não | Entrada de NF-e em 2 passos: dar entrada (lanca estoque/custo/contas pela nota) e depois conferir o fisico, ajustando a diferenca. |
Fiscal e SPED#
| Parâmetro (nome na tela) | Padrão de fábrica | Por loja? | Quando mudar |
|---|---|---|---|
NFC-e consolidada no SPED Fiscalsped.nfce_consolidada | false | não | Só por decisão do contador, avaliando UF e regime tributário da empresa. |
Versão do leiaute do SPED Contribuiçõessped.versao_leiaute_contribuicoes | 006 | não | Versao do leiaute (COD_VER, registro 0000) do SPED Contribuicoes EFD-Contribuicoes. |
Versão do leiaute do SPED Fiscal (ICMS/IPI)sped.versao_leiaute_icms_ipi | 020 | não | Versao do leiaute (COD_VER, registro 0000) do SPED Fiscal EFD-ICMS/IPI. |
Fidelidade#
| Parâmetro (nome na tela) | Padrão de fábrica | Por loja? | Quando mudar |
|---|---|---|---|
Regra de cashback/pontosfidelidade.cashback | modo=cashback · percentual=0.0 · pontos_por_real=0.0 · teto_dia_cpf=20.0 · validade_dias=0.0 · valor_ponto=0.05 | não | Regra do clube de fidelidade. Programa desligado quando percentual ou pontos por real sao zero. |
Segurança e acesso#
| Parâmetro (nome na tela) | Padrão de fábrica | Por loja? | Quando mudar |
|---|---|---|---|
Exigir verificação em duas etapasseguranca.exigir_2fa | habilitado=false | não | Exige verificacao em duas etapas de quem acessa a RETAGUARDA. Quem so opera o caixa (PIN/QR) nao e afetado. |
Financeiro#
| Parâmetro (nome na tela) | Padrão de fábrica | Por loja? | Quando mudar |
|---|---|---|---|
Conta obrigatória a partir definanceiro.conta_obrigatoria_a_partir_de | (vazio) | não | Ao definir a partir de quando toda baixa financeira passa a exigir conta declarada. |
Lançamento automático por origemfinanceiro.lancamento_por_origem | habilitado=false | não | Quando ligado, cada baixa de titulo e cada transferencia de caixa (sangria/suprimento) grava tambem um lancamento no ledger financeiro pela conta declarada na operacao; quando desligado, a baixa/transferencia ocorre normalmente e nenhum lancamento de ledger e criado. Vale para toda a empresa (parametro sem override por loja). |
Recusar conciliação com transferência candidatafinanceiro.recusar_resolucao_com_transferencia_candidata | habilitado=true | não | Quando ligado, a conciliacao bancaria recusa resolver manualmente um item de extrato que ja tem uma transferencia de caixa candidata vinculada (a sangria ja creditou aquele item); quando desligado, a resolucao manual e permitida mesmo havendo transferencia candidata. Vale para toda a empresa. |
Inteligência (ERPia)#
| Parâmetro (nome na tela) | Padrão de fábrica | Por loja? | Quando mudar |
|---|---|---|---|
IA por padrão nas telasia.ai_first_telas | modo_padrao=ativo · telas={} | não | Ao começar ou encerrar um rollout da experiência AI First numa tela ou loja específica. |
Varredura em segundo planoerpia.varredura_sob_demanda | habilitado=true | não | A deteccao de trabalho da ERPia roda somente em segundo plano; abrir a tela apenas le o que ja foi detectado. |
Como conferir e mudar na sua loja#
- Abra Administração › Parâmetros — a tela agrupa por módulo e mostra o valor vigente.
- Cada parâmetro traz o nível de risco (baixo, médio, alto) e o escopo (retaguarda, PDV).
- Alterar exige motivo, e a tela guarda o histórico de alterações — a auditoria fica na aba de histórico, na mesma tela.
- Parâmetro de risco alto muda comportamento sensível (emissão fiscal, desconto, malote). Não altere para testar: o efeito é imediato na operação.