Configurar parâmetros do sistema

Use este guia para consultar e ajustar parâmetros globais do Syrion ERP.

Parâmetros do sistema afetam regras de estoque, financeiro, fiscal, contábilidade e integrações. Altere apenas quando souber o impacto ou quando houver orientação do responsável interno ou do suporte.

Parâmetros criados pelo sistema

Os parâmetros base não são cadastrados manualmente por está tela. Eles são criados pela carga inicial do sistema, via seeder ParametroDoSistemaSeeder. A tela de parâmetros serve para consultar, buscar e ajustar valores existentes, como ativar/desativar regras ou definir contas contábeis padrão.

Entenda antes de usar

Parâmetros são regras globais que o Syrion ERP consulta quando uma rotina precisa tomar uma decisão ou preencher um valor padrão. Eles não pertencem a um documento específico; podem afetar vários usuários e várias operações futuras.

Exemplo simples

Se uma retirada de estoque não encontrar conta de consumo no item ou no grupo do produto, o sistema pode buscar o parâmetro conta_consumo_debito_id. Se esse parâmetro também estiver vazio, a retirada pode ser bloqueada.

Impacto no Syrion ERP

Podem alterar comportamento de estoque, financeiro, faturamento, fiscal e contábilidade.
Normalmente afetam novas operações, não corrigem documentos antigos automáticamente.
Devem ser testádos em ambiente controlado quando envolverem conta contábil, estoque ou NF-e.

Antes de começar

Confirme:

Qual regra precisa ser alterada.
Qual módulo será afetado.
Se a mudança vale para todos os usuários.
Se a alteração deve ser feita antes de uma nova operação ou se afeta documentos futuros.
Se há necessidade de comunicar operadores depois da mudança.

Para dados fiscais da empresa e certificado, veja Cadastrar empresa e Importação XML e certificado digital.

Se um parâmetro esperado não aparecer na lista, acione o suporte ou a equipe técnica para conferir se os seeders da base foram executados corretamente.

Abrir parâmetros

Parâmetros de sistema

Acesse Configurações > Parâmetros de Sistema.
Use a busca para localizar por chave, grupo ou descrição.
Leia o grupo, parâmetro, descrição e valor atual.
Ajuste somente o parâmetro necessário.
Aguarde a confirmação de parâmetro atualizado.

Use Atualizar para recarregar a lista depois de uma alteração ou se outro administrador mudou parâmetros ao mesmo tempo.

Entender os grupos

Os parâmetros podem aparecer agrupados por área, como:

Contábilidade.
Estoque.
Financeiro.
Faturamento.
Outros grupos configurados no ambiente.

O grupo ajuda a entender o impacto principal da regra, mas uma alteração pode afetar mais de um módulo. Por exemplo, uma conta contábil padrão pode impactar estoque, financeiro e relatórios contábeis.

Origem dos parâmetros

Os parâmetros padrão são criados automáticamente pelo seeder do sistema. Exemplos criados pela carga inicial:

permitir_estoque_negativo.
conta_estoque_credito_id.
conta_consumo_debito_id.
conta_ajuste_estoque_id.
conta_cmv_id.
conta_receita_vendas_id.
conta_juros_pagar_id.
conta_multa_pagar_id.
conta_desconto_obtido_id.

Usuários administradores não devem criar novas chaves pela interface. Quando uma nova regra global for necessária, ela deve ser adicionada pela equipe técnica e entregue junto com a carga/seeder correspondente.

Funcao de cada parâmetro

Use a tabela abaixo para entender o efeito de cada parâmetro criado pela carga inicial e onde ele pode ser exigido pelo Syrion ERP.

Parâmetro	Funcao	Onde e exigido
`permitir_estoque_negativo`	Define se o sistema permite movimentos que deixam o saldo de estoque negativo.	Retirada de requisição, ajuste manual de saída de estoque e validações de baixa ou remoção de movimentos quando a operação reduzir saldo.
`conta_estoque_credito_id`	Conta contábil padrão do estoque. É usada como conta de estoque quando o item ou grupo não tiver conta própria.	Retirada e devolução de requisição, ajustes de estoque, baixas que precisam contábilizar estoque e NF-e/NF de saída com baixa de estoque.
`conta_consumo_debito_id`	Conta contábil padrão de consumo ou despesa de materiais.	Retirada de requisição, devolução ou reversão relacionada e consumo direto quando o item ou grupo não informar conta de débito.
`conta_ajuste_estoque_id`	Conta contábil de contrapartida para sobras, faltas e ajustes de estoque.	Ajustes de estoque com contábilização. Também pode exigir centro de custo quando a conta configurada estiver marcada para trabalhar com centro de custo.
`conta_cmv_id`	Conta de CMV, usada para reconhecer o custo da mercadoria vendida.	NF-e/NF de saída que movimenta estoque e possui custo de baixa. Quando há custo de estoque, a conta é obrigatória para gerar a partida contábil de custo.
`conta_receita_vendas_id`	Conta contábil padrão de receita de vendas.	NF-e/NF de saída e faturamento quando a natureza de operação exige contábilização e os itens não informam conta de receita.
`conta_juros_pagar_id`	Conta contábil para juros pagos em contas a pagar.	Baixa de conta a pagar com juros quando a conta de juros não foi informada diretamente na baixa.
`conta_multa_pagar_id`	Conta contábil para multa paga em contas a pagar.	Baixa de conta a pagar com multa quando a conta de multa não foi informada diretamente na baixa.
`conta_desconto_obtido_id`	Conta contábil para desconto obtido em contas a pagar.	Baixa de conta a pagar com desconto quando a conta de desconto não foi informada diretamente na baixa.

Em rotinas que permitem informar uma conta diretamente no item, grupo, documento ou baixa financeira, essa conta específica normalmente tem prioridade. O parâmetro funciona como padrão global para evitar bloqueios quando a conta não foi definida em um cadastro mais específico.

Se nem a conta específica nem o parâmetro estiverem configurados, a rotina pode bloquear a operação e solicitar o ajuste contábil. As contas usadas nesses parâmetros devem ser analíticas, ativas e revisadas no plano de contas.

Erros quando parâmetros faltam

Quando uma rotina precisa de contábilização automática, o Syrion ERP tenta usar primeiro a conta específica do item, grupo, documento ou baixa. Se essa conta não existir, ele consulta o parâmetro global. Se o parâmetro também estiver vazio ou inválido, a operação pode ser bloqueada.

Parâmetro	Erro ou bloqueio possível	Como corrigir
`permitir_estoque_negativo`	Se estiver vazio ou desativado, o sistema trata como não permitir estoque negativo. Em retiradas pode aparecer Saldo insuficiente para retirada. Em ajuste manual de saída pode aparecer Saldo insuficiente para ajuste de saída.	Confirme se a empresa realmente permite saldo negativo. Se sim, ative o parâmetro. Se não, registre entrada de estoque, corrija saldos ou reduza a quantidade da saída.
`conta_estoque_credito_id`	Em retirada, devolução, ajuste ou baixa de estoque, pode aparecer Item sem conta contábil de estoque no grupo do produto e sem parâmetro global "conta_estoque_credito_id". Em ajuste contábil, pode aparecer Parâmetro "conta_estoque_credito_id" não configurado.	Configure a conta de estoque no grupo do produto ou selecione uma conta de estoque neste parâmetro.
`conta_consumo_debito_id`	Em retirada ou devolução de requisição, pode aparecer conta de débito não informada no item e parâmetro global 'conta_consumo_debito_id' não configurado. Em consumo direto, pode aparecer Item com destino Consumo sem conta contábil no item, sem conta no grupo do produto e sem parâmetro global "conta_consumo_debito_id".	Informe a conta de débito no item/grupo quando a regra for específica ou configure a conta padrão de consumo neste parâmetro.
`conta_ajuste_estoque_id`	Ao contábilizar ajustes de estoque, pode aparecer Parâmetro "conta_ajuste_estoque_id" não configurado. Se a conta configurada exigir centro de custo, pode aparecer Ajuste de estoque exige centro de custo porque a conta contábil ... exige centro de custo.	Configure a conta de ajuste de estoque e informe centro de custo no ajuste quando a conta exigir.
`conta_cmv_id`	Em NF-e/NF de saída com baixa de estoque e custo, pode aparecer Parâmetro "conta_cmv_id" não configurado. Configure a conta contábil em Configurações > Parâmetros do Sistema para baixa de estoque da NF de saída.	Configure uma conta de CMV analítica para permitir a partida contábil de custo da venda.
`conta_receita_vendas_id`	Em NF-e/NF de saída ou faturamento com natureza que exige contábilização, pode aparecer Informe a conta contábil de receita nos itens da nota ou configure o parâmetro "conta_receita_vendas_id". Em faturamento, a mensagem pode citar a NF de saída específica.	Informe a conta de receita nos itens da nota ou configure a conta padrão de receita de vendas neste parâmetro.
`conta_juros_pagar_id`	Na baixa de conta a pagar com juros, pode aparecer Conta contábil de juros não informada. Selecione no lançamento ou configure o parâmetro "conta_juros_pagar_id".	Informe a conta de juros na baixa ou configure a conta padrão neste parâmetro.
`conta_multa_pagar_id`	Na baixa de conta a pagar com multa, pode aparecer Conta contábil de multa não informada. Selecione no lançamento ou configure o parâmetro "conta_multa_pagar_id".	Informe a conta de multa na baixa ou configure a conta padrão neste parâmetro.
`conta_desconto_obtido_id`	Na baixa de conta a pagar com desconto, pode aparecer Conta contábil de desconto não informada. Selecione no lançamento ou configure o parâmetro "conta_desconto_obtido_id".	Informe a conta de desconto na baixa ou configure a conta padrão neste parâmetro.

Também podem ocorrer erros quando o parâmetro aponta para uma conta apagada ou inadequada:

Conta contábil configurada em parâmetro não foi encontrada: revise se a conta ainda existe no plano de contas.
A conta contábil configurada em parâmetro precisa ser uma conta analítica de grau 5: selecione uma conta de último nível.
Conta inativa ou incorreta: troque por uma conta ativa e compativel com a rotina.

Prioridade das contas

Quando uma rotina precisa de conta contábil, o Syrion ERP segue a conta mais específica disponível antes de usar o parâmetro global.

Rotina	Ordem comum de prioridade
Retirada de requisição	Conta informada no item da requisição para consumo; conta de estoque do grupo do produto; parâmetro global de estoque quando o grupo não informar.
Consumo direto de estoque	Conta do item; conta do grupo do produto; parâmetro global de consumo.
Ajuste de estoque	Parâmetro de ajuste de estoque e parâmetro de estoque. Se a conta de ajuste exigir centro de custo, o ajuste também deve informar centro de custo.
NF-e/NF de saída	Conta de receita informada no item da nota; parâmetro global de receita de vendas quando os itens não informarem. Para baixa de estoque com custo, usa também CMV e estoque.
Baixa de conta a pagar	Conta informada na baixa para juros, multa ou desconto; parâmetro global correspondente quando a baixa não informar.

Por isso, alterar um parâmetro nem sempre muda uma operação específica se aquela operação já possui conta definida em outro ponto. Revise primeiro o item, grupo, nota, baixa ou cadastro relacionado.

Impacto por módulo

Módulo	Parâmetros mais sensíveis	Impacto principal
Estoque	`permitir_estoque_negativo`, `conta_estoque_credito_id`, `conta_consumo_debito_id`, `conta_ajuste_estoque_id`	Retiradas, devolucoes, ajustes, saldo negativo, custo médio e contábilização de estoque.
Fiscal e faturamento	`conta_receita_vendas_id`, `conta_cmv_id`, `conta_estoque_credito_id`	Faturamento, NF-e/NF de saída, receita de venda, CMV e baixa contábil do estoque.
Financeiro	`conta_juros_pagar_id`, `conta_multa_pagar_id`, `conta_desconto_obtido_id`	Baixa de contas a pagar com acréscimos ou descontos.
Contábilidade	Todos os parâmetros de conta contábil	Lançamentos contábeis automaticos, partidas de débito e crédito, relatórios e fechamento.

Quando a alteração passa a valer

Parâmetros normalmente afetam operações criadas ou processadas depois da alteração. Eles não refazem automáticamente lançamentos contábeis, notas faturadas, baixas financeiras ou movimentos de estoque antigos.

Se um documento antigo foi gerado com parâmetro incorreto, avalie o procedimento correto com o responsável contábil ou suporte. Dependendo do caso, pode ser necessário estornar a origem, cancelar/refazer a operação ou realizar ajuste contábil manual.

Exemplos práticos

Retirar material de uma requisição: o sistema precisa da conta de consumo e da conta de estoque. Se o estoque negativo estiver bloqueado, também valida saldo disponível no local.
Registrar ajuste de estoque: o sistema precisa da conta de ajuste e da conta de estoque. Se a conta de ajuste exigir centro de custo, o centro deve ser informado.
Faturar NF-e/NF de saída com contábilização: o sistema precisa da conta de receita. Se houver baixa de estoque com custo, também precisa da conta de CMV e da conta de estoque.
Baixar conta a pagar com juros, multa ou desconto: o sistema usa as contas informadas na baixa ou os parâmetros globais de juros, multa e desconto.

Testes recomendados

Depois de configurar ou trocar parâmetros importantes, teste em ambiente controlado antes de liberar a rotina para todos os usuários:

Crié uma retirada pequena de requisição de materiais.
Registré um ajuste simples de entrada e outro de saída no estoque.
Emita ou faturé uma NF-e/NF de saída de homologação com item que movimente estoque.
Baixé uma conta a pagar com juros, multa e desconto em valores pequenos.
Confira se os lançamentos contábeis foram gerados nas contas esperadas.
Revise se algum erro de centro de custo, conta analítica ou saldo apareceu.

Antes de liberar para produção

Confirme com o responsável contábil, financeiro ou suporte:

Todos os parâmetros obrigatórios estão preenchidos.
Todas as contas selecionadas existem, estão ativas e são analíticas de grau 5.
As contas pertencem ao plano de contas correto da empresa.
Contas que exigem centro de custo possuem fluxo operacional para informar esse centro.
A empresa entende se permite ou não estoque negativo.
Os testes de estoque, faturamento e contas a pagar foram executados.
A mudança não está sendo feita durante fechamento contábil, fiscal ou financeiro sem aprovação.

Alterar parâmetros booleanos

Parâmetros do tipo verdadeiro/falso aparecem como um botão de ativar/desativar.

Exemplos de uso:

Permitir ou bloquear determinada regra operacional.
Habilitar comportamento automático.
Ativar validação específica.

Antes de mudar, confirme se a empresa deseja o comportamento para todos os usuários.

Selecionar contas contábeis padrão

Alguns parâmetros representam contas contábeis padrão. Nesses casos, a tela abré um seletor de conta contábil.

Exemplos de parâmetros de conta:

Conta de crédito de estoque.
Conta de débito de consumo.
Conta de ajuste de estoque.
Conta de CMV.
Conta de receita de vendas.
Conta de juros, multa ou desconto.

Ao selecionar uma conta:

Clique em Selecionar conta no parâmetro desejado.
Escolhá uma conta contábil de grau 5.
Confirme a seleção.
Confira se o valor passou a exibir classificação e nome da conta.

Use contas ativas e revisadas no plano de contas. Para revisar a estrutura, veja Consultar e manter plano de contas.

Limpar conta contábil

Quando o parâmetro possui conta selecionada, pode aparecer um botão para limpar o valor.

Use essa ação com cuidado. Remover uma conta padrão pode bloquear novas operações que dependem de contábilização automática.

Conferir impacto depois da mudança

Depois de ajustar um parâmetro:

Executé uma operação de teste, quando possível.
Confira se a rotina afetada passou a usar a nova regra.
Revise relatórios ou lançamentos gerados depois da alteração.
Avise usuários que operam a rotina afetada.

Cuidados importantes

Não altere parâmetros durante operações fiscais ou financeiras críticas sem alinhar com a equipe.
Evite trocar contas contábeis padrão no meio de um fechamento sem conferir impactos.
Registre internamente o motivo da alteração.
Use Consultar auditoria para investigar quem alterou configurações quando houver dúvida.
Se a alteração envolver NF-e, valide ambiente, certificado, empresa e natureza de operação.

Bloqueios comuns

Sem permissão para alterar: o usuário pode visualizar, mas não editar parâmetros.
Conta contábil obrigatória ausente: selecione uma conta ativa de grau 5.
Conta inativa ou incorreta: revise o plano de contas.
Parâmetro esperado não aparece: confirme com o suporte se o seeder ParametroDoSistemaSeeder foi executado na base.
Rotina não mudou como esperado: atualize a tela, confira se a operação foi criada depois da alteração e revise se há outro parâmetro envolvido.
Erro ao atualizar parâmetro: consulte a mensagem exibida e acione suporte se necessário.

Checklist

Antes de concluir:

Parâmetro correto localizado.
Descrição lida.
Impacto entendido.
Valor alterado com sucesso.
Operação afetada testáda.
Usuários avisados quando necessário.
Auditoria consultada se houver dúvida posterior.