Ir para o conteúdo
clabor Manual do ERPia

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ábricaPor loja?Quando mudar
Atalhos de teclado do PDV
pdv.atalhos
lista=[]simQuando o mapeamento de teclas do caixa precisa mudar (ex.: novo atalho, tecla remapeada).
CNPJ da automação (TEF)
pdv.tef_cnpj_automacao
50480988000101nãoCNPJ da empresa que desenvolveu a automacao comercial, exigido pela certificadora do TEF em toda transacao.
Exigir lacre do malote
pdv.exigir_lacre_malote
habilitado=falsesimQuando a loja passa a usar malote físico lacrado no fechamento do turno.
Limites de desconto e ajuste no caixa
pdv.limites_operacionais
desconto_valor=5.0 · desconto_percentual=5.0nãoDefine limites gerais do PDV antes de exigir autorizacao superior.
Máscara do código de barras da balança
pdv.mascara_balanca_ean
ativa=true · prefixo=2 · digitos_codigo=6.0 · digitos_valor=5.0 · casas_decimais_peso=3.0 · casas_decimais_preco=2.0simQuando a loja troca de modelo de balança ou o padrão de código de barras dela muda.
Mídia da tela do cliente
pdv.midia_cliente
ativa=false · titulo=(vazio) · mensagem=(vazio) · imagem_url=(vazio) · cor_fundo=(vazio)simAo publicar ou encerrar uma campanha na tela voltada pro cliente do checkout.
Pagamento v2 no PDV
pdv.pagamento_v2
habilitado=falsesimPublica o snapshot operacional de pagamentos v2 para o PDV.
Pele padrão do PDV (mercado/touch)
pdv.perfil
(vazio)simPele 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=falsesimVende 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ábricaPor loja?Quando mudar
Limite para sangria
limite_sangria
valor=500.0simValor de numerario no caixa a partir do qual o sistema recomenda sangria.
Tolerância na conferência do caixa
caixa.tolerancia_conferencia
valor=1.0 reaissimAceita 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ábricaPor loja?Quando mudar
Conferência cega no recebimento
entrada.conferencia_cega
habilitado=truenãoOculta a quantidade esperada da NF-e enquanto o recebimento fisico ainda nao foi contado.
Conferência física em 2 passos
entrada.exige_conferencia_fisica
habilitado=falsenãoEntrada 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ábricaPor loja?Quando mudar
NFC-e consolidada no SPED Fiscal
sped.nfce_consolidada
falsenãoSó por decisão do contador, avaliando UF e regime tributário da empresa.
Versão do leiaute do SPED Contribuições
sped.versao_leiaute_contribuicoes
006nãoVersao 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
020nãoVersao do leiaute (COD_VER, registro 0000) do SPED Fiscal EFD-ICMS/IPI.

Fidelidade#

Parâmetro (nome na tela)Padrão de fábricaPor loja?Quando mudar
Regra de cashback/pontos
fidelidade.cashback
modo=cashback · percentual=0.0 · pontos_por_real=0.0 · teto_dia_cpf=20.0 · validade_dias=0.0 · valor_ponto=0.05nãoRegra 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ábricaPor loja?Quando mudar
Exigir verificação em duas etapas
seguranca.exigir_2fa
habilitado=falsenãoExige 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ábricaPor loja?Quando mudar
Conta obrigatória a partir de
financeiro.conta_obrigatoria_a_partir_de
(vazio)nãoAo definir a partir de quando toda baixa financeira passa a exigir conta declarada.
Lançamento automático por origem
financeiro.lancamento_por_origem
habilitado=falsenãoQuando 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 candidata
financeiro.recusar_resolucao_com_transferencia_candidata
habilitado=truenãoQuando 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ábricaPor loja?Quando mudar
IA por padrão nas telas
ia.ai_first_telas
modo_padrao=ativo · telas={}nãoAo começar ou encerrar um rollout da experiência AI First numa tela ou loja específica.
Varredura em segundo plano
erpia.varredura_sob_demanda
habilitado=truenãoA 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#

  1. Abra Administração › Parâmetros — a tela agrupa por módulo e mostra o valor vigente.
  2. Cada parâmetro traz o nível de risco (baixo, médio, alto) e o escopo (retaguarda, PDV).
  3. Alterar exige motivo, e a tela guarda o histórico de alterações — a auditoria fica na aba de histórico, na mesma tela.
  4. 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.