Conteúdo
0. Caminho de abertura e o mapa real das seções9. Usuários › "Modelo de papel": criar um usuário sem clonarControle de segregação de funções: os modelos seguem as regras da Central de auditoria10. Tela de login › ⚙ Assistente "Primeira instalação / Nova empresa"O passo 2 tem duas camadas: a visão Simples e "Configurações avançadas"Avançado › "Banco de dados neste computador": a senha do administrador já não é pedidaAvançado › ⤓ "Importar banco de dados": trazer dados de uma empresa antigaSe o Oracle for escolhido: os privilégios da conta de instalação11. Configurações › HNR › "Backup do banco de dados da empresa" e restauração a partir do backup12. Configurações › Perfil da empresa e requisitos corporativos13. Configurações › Política de estoque: proibir estoque negativo14. Configurações › Dados da empresa › Comunicação: Endereço público (acesso externo)15. Configurações › SistemaRegra de senhaBloqueio de acesso e sessãoQuem pode alterar as configurações de toda a empresaEncerrar um usuário sem excluí-lo: DesativarPolítica financeira: se o caixa e o banco ficarem negativosConfigurações e Log — Deixar o programa do seu jeito
A janela Configurações mantém dois tipos de ajuste lado a lado: os que são só seus (tema, disposição das janelas, atalhos) e os que afetam o funcionamento da empresa (preferências HNR, usuários, conexões, dados da empresa, formulários de impressão). Brinque à vontade com o primeiro grupo; no segundo, mude apenas o campo de que o seu trabalho precisa. As quatro seções exclusivas do administrador estão claramente marcadas abaixo. Já a janela Log é a resposta para "o que acabou de acontecer".
0. Caminho de abertura e o mapa real das seções
Caminho de abertura: Dock inferior › Configurações. O usuário comum vê as seções Aparência, Janelas, Conta, Preferências HNR, Conexões, Atalhos e Sistema. O administrador vê, além dessas, as seções Usuários, Status, Usuários Ativos e Formulários de Impressão. Na visão móvel, Janelas e Atalhos, próprias do desktop, ficam ocultas. Não ver uma seção de administrador não é defeito, é consequência de permissão.
Seções recolhíveis: Quando Configurações abre pela primeira vez, todos os títulos principais e os grupos internos de ajustes estão fechados. Clique no título; pelo teclado, você pode chegar até ele com Tab e pressionar Enter ou Espaço. Dá para manter várias seções principais abertas ao mesmo tempo. Fechar e reabrir uma seção preserva o rascunho não salvo; isso não substitui a gravação. Se fechar a janela Configurações por completo e abri-la de novo, os títulos começam fechados outra vez. Preferências HNR › Dados da Empresa › Preferências de Produção só aparece para o administrador do sistema; ao usuário sem permissão não são mostrados nem o título de configurações da empresa nem um resumo somente leitura.
| Seção | Abrangência e uso seguro |
|---|---|
| Görünüm · Pencereler · Kısayollar | Aparência pessoal, posicionamento das janelas e teclas; não mudam dados da empresa. |
| Hesap | Sua própria senha e a segurança da sua sessão; não grave sem saber a senha antiga. |
| HNR Tercihleri · Bağlantılar | Hábito de depósito/lista padrão e as conexões de e-mail/WhatsApp da empresa; depois de alterar, faça um pequeno teste na tela correspondente. |
| Sistem | Informação de versão e exportação do log; não grava nenhum registro contábil nem de estoque. |
| Kullanıcılar · Statüs · Aktif Kullanıcılar · Baskı Formları YÖNETİCİ | Gestão de contas/permissões, situação do servidor, sessões conectadas e modelos de documento. Para o desenho de impressão, siga o guia detalhado; antes de alterar, faça um backup/pré-visualização. |
Figura 1 — Dois tipos de ajuste
1. Aparência e Janelas
Aqui é pura questão de gosto; nenhuma escolha afeta os seus dados. As três mais úteis:
| Ajuste | Opções | Quando alterar |
|---|---|---|
| Tema | Claro · Escuro · Sistema (segue o seu sistema operacional) | Escuro se você trabalha à noite, claro num escritório iluminado durante o dia |
| Movimento | Calmo (animação reduzida) · Completo | "Calmo" num computador antigo, ou se o movimento cansa você |
| Botões da janela | macOS (esquerda) · Windows esquerda · Windows direita | Conforme o seu hábito — para nunca procurar o botão de fechar no lugar errado |
| Disposição das janelas | Lado a lado (organizadas juntas) · Flutuante (livre) | "Lado a lado" se você trabalha com muitas janelas numa só tela |
Na linha de título da janela Configurações há sempre, à direita, um seletor de Idioma; ele fica visível mesmo com a seção Aparência fechada. O idioma que você escolhe é gravado na sua conta de usuário, de modo que, ao entrar com o mesmo usuário em outro computador ou em um telefone, a interface abre no mesmo idioma. Quando o idioma muda, as janelas abertas (inclusive a lista de Aplicativos abertos no telefone) aparecem com o nome do aplicativo no novo idioma; o título detalhado vem quando a janela é aberta. Um ?dil= acrescentado ao endereço muda o idioma apenas dessa aba do navegador; ele não mexe na sua preferência salva.
2. Conta — onde fica a sua senha
É aqui que você troca a sua senha. Três regras:
- Não compartilhe a sua senha com ninguém — nem com o administrador, se ele pedir; o administrador não precisa da sua senha.
- Encerre a sessão ao sair de um computador compartilhado; senão, o que for feito ali fica registrado em seu nome.
- Se você esquecer a senha, o administrador emite uma nova, não consegue ler a antiga — e esse é o projeto correto.
3. Atalhos
Os atalhos de teclado são listados e podem ser alterados. Para quem está começando, poucos valem a pena aprender:
| Tecla | O que faz |
|---|---|
| F5 | Atualiza a janela aberta — busca os dados de novo no servidor |
| Esc | Fecha um menu aberto, o submenu do dock ou um diálogo |
| Ctrl+Enter | "Enviar" nos campos de mensagem e de observação |
4. Preferências HNR
Estes não são ajustes de aparência, mas de hábito de trabalho: qual depósito vem como padrão, como as listas abrem e assim por diante. Com o tempo, aquilo que você percebe estar mudando toda vez, configure aqui de uma vez por todas.
5. As seções do administrador
As seções abaixo só aparecem para o usuário com a permissão de administrador do sistema. Se você não as vê, não há defeito nenhum — você simplesmente não tem a permissão. Esconder a seção é apenas enfeite; a porta de verdade está no servidor: uma requisição sem permissão também é recusada lá.
Usuários
Criação de usuários, definição de senhas e as permissões que determinam quem pode ver qual janela.
Conexões
A conta de e-mail (SMTP) e a linha de WhatsApp usadas para enviar documentos. Se um orçamento não está saindo, é aqui que se olha.
Dados da empresa
Razão social, endereço, dados fiscais — daqui eles passam ao cabeçalho das impressões de orçamento e de nota fiscal.
Séries de documentos
Em detalhes da Companhia: o formato de fatura, nota de entrega, encomenda, citação, receita e cheque batch números (art00001, e-Fatura ABC2026000000001), Filtros e correção de controlo. detalhes: Número de Documentos Série.
Monitor do servidor
A situação do servidor e os usuários conectados naquele momento. A resposta para "o sistema está lento ou sou só eu?".
Não abra as permissões para todo mundo "para facilitar". Direitos como apagar registros, cancelar apontamentos e ver preços são portas; ao abrir uma, você não facilita só o trabalho, facilita também o erro. Comece um novo usuário com o mínimo de permissão e acrescente conforme a necessidade aparecer.
6. Log — "o que acabou de acontecer?"
A janela Log é o diário de operações que o programa mantém sobre si mesmo. Você olha aqui quando uma operação não sai como esperava ou quando vê uma mensagem de erro. Não é um registro contábil — é um registro técnico.
| Recurso | Para que serve |
|---|---|
| Filtro de nível | debug · info · warn · error. Ao caçar um problema, deixe ligados no início apenas error e warn. |
| Filtro de escopo | Seleciona de que parte do programa veio o registro — por exemplo, só as linhas relacionadas ao estoque. |
| Busca | Procura texto na mensagem, no escopo e nos dados. Digitar um número de documento costuma bastar. |
| Expandir a linha | As linhas que trazem dados detalhados abrem ao clique e mostram o detalhe técnico. |
| Exportar | Baixa o diário como arquivo. É a primeira coisa a fazer ao pedir suporte. |
| Limpar | Esvazia a lista. Exporte antes — o registro limpo não volta. |
(1) O que você estava tentando fazer (uma frase), (2) uma captura de tela da mensagem que você viu, (3) o arquivo baixado da janela Log com Exportar. Esses três dão resultado mais rápido do que dez mensagens tentando descrever o problema.
O log é um registro técnico e pode ser limpo. Perguntas contábeis como "quem alterou esta nota fiscal" são respondidas não no log, mas na trilha de auditoria do Cockpit e no próprio histórico dos registros. Esses registros não são apagados.
7. Perguntas frequentes
Mudei um ajuste; mudou também para o meu colega?
Aparência, janelas, atalhos e preferências HNR são só seus: ninguém é afetado. Usuários, conexões e dados da empresa afetam todo mundo. Na dúvida, olhe as duas colunas da Figura 1.
Não consigo ver uma seção de jeito nenhum
Você não tem a permissão. Isto não é defeito; as seções de administrador só aparecem para o administrador. Se realmente precisar de uma, peça ao seu administrador de sistema e diga por que precisa — as permissões são concedidas com uma justificativa.
O programa ficou lento; devo olhar o log?
Olhe primeiro a seção Monitor do servidor (ou peça ao seu administrador que olhe): fica claro se o problema é do seu lado ou do servidor. Já o log é o lugar da pergunta "qual operação deu erro". Os dois respondem perguntas diferentes.
8. Glossário
| Turco | Descrição breve |
|---|---|
| Tema | O esquema de cores claro/escuro do programa |
| Yetki (izin) | O que um usuário pode ver e fazer |
| Kapsam (scope) | De que parte do programa veio a linha de log |
| Seviye | A importância da linha de log: debug, info, warn, error |
| Denetim izi | O histórico de alterações, não apagável, dos registros contábeis |
| Dışa aktarma | Baixar como arquivo o que está na tela |
O botão Imprimir no canto superior direito gera a página em formato adequado para A4. Guias relacionados: Primeiro Dia, Comunicação, Cockpit.
9. Usuários › "Modelo de papel": criar um usuário sem clonar
O jeito antigo de dar permissões a um novo funcionário era "copie alguém parecido e depois corrija uma a uma as cem e tantas caixas de permissão"; o resultado, na maioria das vezes, era todo mundo circulando com permissão de almoxarife — o vendedor podia abrir ordem de produção, o pessoal da qualidade enxergava o banco. O grupo Modelo de papel na seção Usuários acaba com isso: escolha, aplique, grave.
| Modelo | Para quem, o que libera (resumo) |
|---|---|
| satis | Cotações, pedidos, notas e devoluções de venda, cadastro e extrato de conta, CRM. Sem recibos de cobrança (financeiro, segregação de funções). Banco, produção e compras desativados. |
| satinalma | Notas e devoluções de compra, cadastro de fornecedor, solicitações de compra e avaliação, Abaixo do nível mínimo. As guias de recebimento ficam no modelo de depósito (segregação de funções). |
| depo | Depósitos, inventário, transferência, nota de remessa, ficha de estoque. |
| uretim · planlama | Ordem de produção, lista de materiais, apontamento, MRP; planejamento também com requisições e programação. |
| kalite | Janela de qualidade, depósitos do tipo quarentena, estoque/série, IQC-NCR do departamento, aprovações corporativas (família qualidade). |
| finans · muhasebe | Financeiro: caixa, banco, cheques, lançar e excluir recibos de cobrança e pagamento, extratos, limites de crédito; não emite notas nem edita cadastros de conta (segregação de funções). Contabilidade: consulta as áreas financeiras, lança notas de compra/venda e relatórios. |
| ik · yonetim | RH: pessoal, portal, férias e licenças. Diretoria: união dos demais modelos + relatórios, sem movimentação financeira (cobranças, pagamentos, caixa, banco), recebimento de mercadorias nem emissão de documentos de venda (segregação de funções), e sem bit de administrador do sistema. |
- Configurações › Usuários › selecione o usuário (ou crie um novo) › escolha o papel no seletor "Modelo de papel". Abaixo do seletor são listados a descrição do modelo e os módulos que ele libera.
- Aplicar (adicionar): os bits do modelo são somados por cima das permissões existentes (para combinar dois modelos). Somente o modelo: os bits fora do modelo são desligados; o bit de administrador do sistema é preservado.
- Se precisar, ajuste as caixas uma a uma (o modelo é só o começo); Gravar. Até você clicar em Gravar, nada é escrito no servidor.
O seletor Ficha de funcionário de RH em Usuários › ficha do usuário vincula o usuário a um funcionário. Um usuário fica vinculado a um único funcionário e o vínculo nunca é movido em silêncio: se o usuário já está vinculado, não é possível escolher outro; primeiro remova o vínculo com (não selecionado). Um funcionário vinculado a outro usuário aparece desativado na lista com a nota (vinculado: nome do usuário). Quando um vínculo muda, todos os seletores se atualizam sozinhos; em um usuário novo, o vínculo é criado depois de salvar o usuário.
Controle de segregação de funções: os modelos seguem as regras da Central de auditoria
Cada modelo de perfil cumpre sozinho as oito regras de segregação de funções da Central de auditoria; as regras são lidas de um único lugar e os modelos são verificados a cada inicialização. Combinar dois modelos ou marcar caixas manualmente pode gerar conflito: o formulário mostra na hora, em um quadro vermelho, qual regra foi violada e quais permissões conflitam, e o botão "Desativar …" de cada permissão corrige com um toque.
Ao salvar, o servidor interrompe o conflito que esse salvamento criaria e indica a regra violada. Saídas: em uma empresa com perfil Individual ou PME sem outros usuários além do administrador, só é exibido um aviso e o registro é salvo; nos demais casos escreva uma justificativa de pelo menos 10 caracteres e escolha "Salvar mesmo assim com justificativa" — a justificativa vai para a trilha de gestão de usuários. Um conflito que já existia antes não bloqueia; usuários existentes são corrigidos com a sugestão "Corrigir conforme a regra" em Central de auditoria › Segregação de funções. A etapa Usuários do assistente de configuração inicial usa o mesmo formulário.
Se o usuário tem filial/depósito atribuído mas as três permissões depo, deposayim e depotransfer estão desligadas, aparece um aviso vermelho — para aquele usuário a janela Depósitos devolve 403 por completo. O botão ao lado do aviso, "Aplicar o modelo 'Depo'" (em depósito do tipo quarentena, "Aplicar o modelo 'Kalite'"), corrige com um clique. O mesmo aviso aparece também ao fazer a atribuição em Depósitos › Responsáveis.
Efeito imediato: no momento em que você clica em Gravar, as sessões abertas do usuário são atualizadas; ele não precisa sair e entrar de novo. Se você trocar a senha dele, as sessões abertas caem e ele entra com a nova senha. Na resposta aparecem os números "oturumYenileme: renovadas / derrubadas". Regra: guia de Segurança, seção 8.
Preferências de Produção: Level 1 e modelos setoriais — guia do administrador
10. Tela de login › ⚙ Assistente "Primeira instalação / Nova empresa"
O assistente abre pelo ícone de engrenagem na tela de login e instala uma nova empresa em sete passos: idioma e país, banco de dados, administrador principal, verificação e criação, usuários, nível de produção, resumo da instalação. Não é preciso chave de instalação; as empresas existentes não são tocadas e o processo não avança se já existir, sob o mesmo código, um banco de dados principal, um EK1 ou uma definição de empresa.
O passo 2 tem duas camadas: a visão Simples e "Configurações avançadas"
A visão simples (padrão) faz uma única pergunta: o código da nova empresa. O motor de banco de dados, o endereço do servidor e a senha do administrador não aparecem na tela; tudo isso vem da configuração do servidor de aplicação. A linha da conta de administrador é somente leitura e mostra hnr_kurulum · senha guardada no servidor ✓: essa senha nunca é enviada ao navegador, quem a coloca na requisição de instalação é o servidor. Para que essa linha apareça, o operador precisa ter definido kurulum.basitKimlik=<usuário>:<senha> no arquivo server.properties (a senha também pode vir de uma variável de ambiente com ${env:NAME}; para mudar o motor, kurulum.basitMotor=firebird5). Sem essa linha, o assistente abre direto na visão avançada. Esta conta não é um superusuário — ela só cria bancos de dados de empresa; troque a senha dela ao entrar em produção.
O botão "Configurações avançadas" pergunta onde o banco de dados vai ficar, com um cartão de três opções; ao marcar uma, apenas os campos dela se abrem: (1) Banco de dados neste computador — o software servidor está na mesma máquina em que a aplicação roda; aparecem o motor, a conta de administrador e a linha somente leitura do servidor. (2) Servidor SQL remoto na mesma rede — o banco está em outra máquina; abrem-se os campos de nome do servidor, endereço, porta, modo TLS, certificado CA, diretório de dados para o Firebird e papel de execução. (3) Cluster SQL / servidores de cluster — são listados os perfis definidos na configuração do servidor; a opção "Definir cluster em nuvem…" no final abre o mesmo formulário para Neon e CockroachDB Cloud já com verify-full preenchido. As novas definições de (2) e (3) só podem ser escolhidas com kurulum.uzakSunucuIzin=true; quando isso está desligado, os cartões aparecem mas não podem ser clicados e a justificativa vem escrita. Ao lado do nome técnico de cada campo há uma explicação em linguagem simples e um balão ? (passe o mouse, toque ou foque pelo teclado).
O botão “Importar banco de dados (transferir dados de uma empresa antiga)”, abaixo da visão avançada, não transfere mais dados; ele só mostra uma nota informativa: crie a empresa primeiro e, depois de entrar, faça a migração em Configurações › Migração de dados (do programa anterior) (detalhes). O aviso “Início: Level 1…” não fica mais na etapa 1, mas logo abaixo do título da etapa 6 (Nível de produção), onde a escolha é feita.
Avançado › "Banco de dados neste computador": a senha do administrador já não é pedida
Se o servidor de banco de dados foi instalado pelo HNR (ou se o operador registrou uma vez as credenciais no arquivo de configuração), nenhum motor pede nome de usuário e senha de administrador. Ao selecionar o cartão "Banco de dados neste computador" na visão avançada, o campo de usuário mostra a conta registrada (por exemplo postgres, sa, SYSTEM, root, SYSDBA), o campo de senha mostra •••••••• e abaixo aparece a nota "Senha de administrador registrada pronta.". A senha nunca é enviada ao navegador: o cliente manda apenas a marca "usar a credencial registrada", e quem coloca a senha na requisição de instalação é o próprio servidor de aplicação. Se quiser mudar, basta digitar em um dos campos — o modo registrado cai e você segue com a sua própria conta; para voltar, clique no botão "Usar a credencial registrada".
Quando você escolhe um local de dados (pasta) diferente, é preciso uma conta mais privilegiada: o PostgreSQL cria um novo tablespace e só um superusuário pode fazer isso; no Oracle o mesmo trabalho exige o privilégio CREATE TABLESPACE. Se essa conta também estiver registrada no arquivo de configuração, o campo de usuário muda sozinho para ela (hnr_kurulum → postgres) e aparece "Para a pasta selecionada será usada a conta de administrador de banco de dados registrada."; nada continua sendo perguntado a você. Se não houver conta privilegiada registrada, surge uma caixa âmbar com o botão "Informar a conta de administrador do banco de dados", que abre os campos. A mesma caixa também abre sozinha se o servidor devolver PG_DIRECTORY_PRIVILEGE_REQUIRED, ORACLE_TABLESPACE_PRIVILEGE_REQUIRED ou ORACLE_PRIVILEGE_REQUIRED.
Para o operador: a linha tem o formato kurulum.yerelKimlik.<motor>=<usuário>:<senha> e é escrita no arquivo server.properties; os códigos de motor são firebird5, postgresql, cockroach, mssql, oracle. A senha também pode vir de uma variável de ambiente com ${env:NAME}. A credencial é usada apenas para o banco de dados deste computador: se for escolhido um servidor remoto ou um cluster, o servidor recusa com SAVED_CREDENTIAL_TARGET_INVALID, e quando não há credencial registrada devolve SAVED_CREDENTIAL_UNAVAILABLE (nunca tenta em silêncio com senha vazia). Senha vazia não é aceita; para um CockroachDB insecure, que não pede senha, escreva root:root. No Firebird não é preciso linha extra: usam-se os já existentes firebird.user/firebird.password. Apagar a linha volta ao comportamento antigo — o usuário digita as credenciais de novo.
Avançado › ⤓ "Importar banco de dados": trazer dados de uma empresa antiga
O que ele faz: lê, do seu antigo banco Firebird, as fichas de conta e de estoque, notas fiscais, notas de remessa, pedidos, orçamentos, recibos, cheques, fichas de armazém, listas de materiais e ordens de produção, registros de pessoal e as imagens/documentos do banco EK1; gera um objeto de cada um deles e grava pelo próprio caminho de gravação da empresa. O que ele não faz: NÃO CRIA UMA EMPRESA NOVA. A empresa de destino precisa ter sido instalada antes com este assistente. O banco de origem é somente leitura: nem uma linha dele muda durante a importação.
Etapa 1 — Verificação do FirebirdSQL (agora em Configurações › Migração de dados). Como a migração não é mais feita neste assistente, não há etapa de código da empresa nem de entrada do administrador: como administrador conectado, você abre a seção Configurações › Migração de dados, e ela verifica se o FirebirdSQL está instalado e em execução neste computador. Um usuário que não é administrador não pode fazer nada nesta seção. Se o servidor estiver em modo somente leitura (HNR_WRITE desligado), a migração é recusada. Detalhes: Guia de migração de dados.
Etapa 2 — Arquivo de origem. O endereço do servidor, a porta, o caminho do banco de dados e o usuário não são mais perguntados: o servidor é este computador (localhost), a porta é a do Firebird instalado e o usuário é SYSDBA. Na janela de abertura de arquivos do Windows, você seleciona o backup (.FBK) ou o banco de dados (.FDB) do programa anterior; o EK1 é encontrado automaticamente na mesma pasta; só a senha do SYSDBA é informada. O botão “Testar a conexão” (FDB) ou “Preparar o backup como UTF-8 e conectar” (FBK) verifica a origem e informa a versão, o número de tabelas e se o EK1 foi encontrado; sem o EK1, imagens e documentos não são importados, e esta tela diz isso claramente. Detalhes: Guia de migração de dados.
Passo 3 — inventário de tabelas. Todas as tabelas da origem são listadas com uma de quatro decisões; nenhuma cai em silêncio. Objeto: da tabela são geradas fichas/documentos, gravados pelo próprio caminho de gravação da empresa (ex.: MUSTERI → ficha de conta, FATURA + IRSALIYEITEM → nota fiscal e seus itens). Cópia: se o destino tem uma tabela de mesmo nome, as colunas comuns são copiadas linha a linha. Derivada: não é copiada — valores como o saldo da conta (CARIDURUM) e o disponível em estoque (STOKDURUM) são refeitos pelo caminho de gravação; no fim da importação eles ficam alinhados exatamente com a origem. Pular: tabela de sistema ou de log.
A decisão "pular" agora vale apenas para caches que podem ser regerados. Na versão anterior, 53.662 linhas — histórico de câmbio (KUR), situação de transferência Logo (FATURA_LOGO), definições de impressora (SISTEMDOSYA), dicionários de interface e de rótulos de campo (METIN_SOZLUK, ALAN_SOZLUK), logs de RH e de produção — eram consideradas "tabelas de sistema" e não eram importadas; agora todas são copiadas. A única coisa realmente pulada é o cache de pré-visualização de arquivos, e o motivo está escrito na lista. As tabelas do banco EK1 que não são conteúdo de arquivo (por exemplo, a trilha de acesso) também passam a ser levadas e aparecem na lista com o prefixo EK1..
Os números dos documentos são preservados. Os números de nota fiscal, nota de remessa, pedido, orçamento, recibo, borderô de cheques e ficha de armazém da origem ficam exatamente iguais no destino — num arquivo de 20 anos, a resposta para "qual nota fiscal de número tal" não muda. No fim da importação, os contadores de numeração avançam além do maior valor, para que o primeiro documento emitido depois não colida.
Fidelidade à origem — alinhamentos automáticos. Um banco de dados de vinte anos nem sempre é coerente consigo mesmo; a importação não corrige a origem, ela se parece com a origem. Por isso, no fim da importação, rodam quatro alinhamentos: (1) código do livro da conta — quando uma ficha de conta era renomeada, as versões antigas do HNR não atualizavam os cabeçalhos dos recibos, e a linha do livro e o cabeçalho do documento ficavam com códigos diferentes; no destino, a linha do livro toma o código da linha de livro da origem, (2) linha de saldo residual — as linhas de saldo que não existem na origem e não têm nem ficha nem conta de caixa/banco são apagadas, (3) linha de estoque sem ficha — as linhas de situação de estoque nunca vistas na origem e sem ficha são apagadas, (4) linha de consumo de produção — a divisão por lote do consumo de produção é trazida à lista de linhas da origem. Todo alinhamento é fail-closed: se os totais dos dois lados não forem iguais, nada é tocado; a quantidade aparece na linha "Correções automáticas" da tela de resultado e no log da importação.
A configuração da própria empresa SOBRESCREVE os padrões do destino. A instalação de uma empresa nova grava suas próprias linhas-semente em tabelas como preferências de produção, regras de aprovação, turnos, depósito e caixa. Essas linhas colidem com as linhas de mesma chave da origem, e antes a origem era pulada EM SILÊNCIO — a empresa importada abria com o perfil "Level 1" e com as regras de APQP/terceirização desligadas. Agora, nas pequenas tabelas de configuração, a origem vence: a linha do destino é atualizada a partir da origem. Há duas exceções, deixadas de propósito: as fichas de usuário (para você não perder a senha do administrador criada na instalação) e a identidade de instalação da empresa. Toda chave pulada aparece na lista "Resultado tabela a tabela" do passo 5.
Proteção do número de documento deslocado. Quando se importa uma segunda vez para a mesma empresa (concluir uma execução interrompida, o restante de uma importação seletiva), o número de um documento pode deslocar. Antes, aquele lançamento no livro da conta era tido como "não existe na origem" e APAGADO, tirando dinheiro do extrato; como CARIDURUM é gravado a partir da origem, o saldo parecia certo e contradizia o extrato. Agora duas coisas acontecem: (1) no modo de importação, o livro de numeração definitiva não faz o número contar como "ocupado", ou seja, o número é preservado; (2) mesmo assim, se um grupo deslocado for encontrado, ele não é apagado — é registrado na conciliação como Desvio e escrito no log. Nas linhas de consumo de produção, o preço também passa a ser trazido da origem; o novo critério de valor do item verifica isso por tipo de documento.
Avaliação de contas (KALAN) e a seção de manutenção
Os balanços de fatura aberta são derivados. O antigo programa de desktop nunca preenchia uma fatura permanecer quantidade (FATURA.KALAN), Enquanto em HNR envelhecimento, os “recipitáveis excessivos” do coquete, o fluxo de caixa e as contas fechadas Todos os registros leram este campo. Assim, na fase de reconciliação derivada, os processos de importação movem cada conta em ordem data: pagamentos, retornos e cheques fecham o mais velho A primeira conta (FIFO) e o balanço aberto da conta é escrito para as últimas contas. As faturas de vendas e compra seguem a mesma regra; as faturas canceladas permanecem fechadas; contas cujo saldo líquido está abaixo 1 TL (antigo resíduo de rodas) não receberá uma fatura aberta. Uma conta que já tem um montante restante em qualquer fatura é deixada intacta. O que fatura.kalanTop A linha da tabela de reconciliação compara o objetivo com o total a mesma regra que se dá na base de dados fonte. Parte de um balanço aberto pode estar em um cheque/nota emitido, uma nota de débito ou um movimento bancário/cash em vez de numa fatura; essa parte não é mostrada nas contas mas é visível no relatório da conta.
Secção de Manutenção (em passo) 2, Depois de assinar). Reparação de balanças abertas A mesma regra é aplicável a uma empresa que foi importada anteriormente. A Previsão A primeira (faturas para mudar, total anterior e seguinte, contas perdidas, balanço aberto fora das contas) é mostrada e nada é escrito; Aplique reparação escreve apenas o campo restante-alvo, re-check o valor antigo em cada linha (uma fatura alterada por um recebimento enquanto não é sobreescrito) e é registado em A trajetória da atividade. A reabertura não produz mudanças. Revisando o dicionário Apresentação de linhas de interface e traduções de campo (24 linguagens); traduções editadas manualmente não são tocadas e leva alguns minutos. Quando uma nova empresa é configurada, esta sementeira corre automaticamente no fundo uma vez que a empresa é aberta; se falhar a configuração não falha, ela é escrita no log de configuração e pode ser concluída com este botão. Se a página for re-carregada ou o servidor retomar, um Importes ainda estão em curso Abertura em passo 4 por si mesmo quando você se inscrever; o resultado da última importação acabada está disponível através Mostrar o resultado da última importação. O inventário em passo 3 Também inclui as tabelas do EK1 Base de dados com a sua linha de contas.
Opções de importação. Execução seca: tudo é lido e contado, mas nada é gravado — rode primeiro assim para ver o inventário e a duração estimada. Importar também o arquivo de documentos excluídos e Importar também os movimentos históricos: as tabelas de arquivo da empresa antiga (importadas na última fase; se forem interrompidas, a importação não é considerada falha). Importar imagens e documentos (EK1): os arquivos do banco EK1. Continuar mesmo que o destino já tenha dados: por padrão a importação para quando a empresa de destino já tem registros; esta caixa é o seu consentimento. Tamanho do lote: quantos registros são gravados por transação (200 por padrão).
Passo 4 — importação e progresso. Aparecem a fase (preparação → fichas → documentos → produção → imagens e documentos → cópia geral de tabelas → arquivo → conciliação de derivados → medição da conciliação), o percentual, os contadores de gravados/pulados/com erro e as últimas linhas do log da importação. O log é mascarado: senhas, tokens e credenciais dentro de strings de conexão nunca são escritos. O botão Parar encerra o trabalho no próximo ponto seguro; o lote pela metade é revertido. O trabalho roda no servidor: mesmo que você feche a janela ele não para, e ao voltar você vê a situação do mesmo trabalho.
Passo 5 — como ler a tabela de conciliação. Cada linha é um item medido: Origem é o valor lido do banco antigo, Destino o valor lido da nova empresa, Diferença a diferença entre os dois. Se a situação for Confere, o item veio exatamente igual. Desvio é escrito em vermelho e precisa ser examinado à mão. Desvio conhecido é uma diferença esperada, vinda da própria origem (por exemplo, uma conta duplicada na origem, cheques sem borderô). Os itens medidos são: saldos de contas, disponíveis em estoque (geral e por depósito), quantidade/valor/situação dos cheques, quantidade e valor de recibos e notas fiscais, número de listas de materiais e de ordens de produção, número de arquivos do EK1 e cobertura de tabelas.
Se a conciliação apresentar desvio, o trabalho não diz "concluído". Quando um critério desvia, o título do resultado diz "Importação terminada — MAS há desvio na conciliação" e os nomes dos critérios que desviaram são listados numa faixa amarela acima da tabela. A lista suspensa "Resultado tabela a tabela" mostra, para cada tabela da origem, a decisão, o número de linhas da origem, quantas foram gravadas, puladas, com erro e o motivo; as tabelas com linhas com erro ficam no topo e em vermelho. Olhe estas duas listas antes de começar a usar a empresa importada.
Você pode importar a mesma origem uma segunda vez. A importação é baseada em identidade: uma ficha, documento, cheque ou arquivo que já existe no destino não é gravado de novo, entra no contador de pulados. Recomeçar do zero uma importação interrompida é seguro; não se formam registros duplicados.
Numa importação seletiva (com filtro de tabelas) o alinhamento de derivados não roda. Quando você importa apenas certas tabelas, gravar da origem as tabelas derivadas, como saldo de conta e disponível em estoque, é pulado — porque parte dos documentos ainda não foi importada e um alinhamento parcial enganaria. Isso é registrado na conciliação como Desvio conhecido. Quando você importar também as tabelas restantes (execução sem filtro), o alinhamento roda normalmente.
Códigos de erro. AKTARIM_OTURUM_GEREKLI não há sessão ou ela caiu · AKTARIM_YONETICI_GEREKLI / AKTARIM_YETKI_YOK o usuário não é administrador do sistema · AKTARIM_YAZMA_KAPALI o servidor está em modo somente leitura · AKTARIM_HEDEF_UYUSMAZ a empresa escolhida não é a empresa da sessão · KAYNAK_GECERSIZ o formato do formulário de origem está errado · KAYNAK_ERISILEMEDI não foi possível conectar à origem · KAYNAK_KIMLIK o usuário/senha da origem foi recusado · KAYNAK_UZAK_YASAK a lista de permissões na configuração do servidor bloqueia esse endereço · KAYNAK_EK1_YOK não foi possível abrir o EK1 (a importação continua, os arquivos são pulados) · HEDEF_DOLU o destino tem registros, a caixa de consentimento é necessária · HEDEF_SEMA_EKSIK o destino não tem a tabela correspondente (ela é pulada) · AKTARIM_SURUYOR já há um trabalho nesta empresa · AKTARIM_IS_BULUNAMADI não há registro do trabalho ou ele expirou · AKTARIM_IPTAL_EDILDI o usuário parou · AKTARIM_FAZ_HATASI uma fase parou (veja o log).
Faça backup da empresa de destino antes de importar. A importação grava no destino; não toca na origem. Se o resultado no destino não for o que você queria, o caminho de volta é o backup — por isso recomenda-se fazer a primeira execução como execução seca, revisar o inventário, depois tirar o backup e iniciar a importação de verdade.
Depois da importação: abra o plano de 30 dias em Configurações › Entrada em produção. A etapa de migração do plano é fechada com a evidência desta importação; detalhes na seção 13.
Motor de banco de dados: Firebird SQL 5 e PostgreSQL 17 — os dois com suporte total
Você escolhe o motor no passo 2. Firebird SQL 5: a conta SYSDBA e a senha definida na instalação do Firebird; o servidor precisa ser local. PostgreSQL 17: os dados da empresa ficam no banco hnr_<código da empresa> e os anexos de arquivo em hnr_<código da empresa>_ek1; a conta informada precisa ser um superusuário com privilégio CREATEDB, e os bancos criados são transferidos ao papel de execução do servidor (postgresql.user). Lançamento de documentos, relatórios, fichas de estoque/conta e anexos de arquivo (enviar / listar / baixar / pré-visualizar / cancelar) se comportam igual nos dois motores.
A linha "Servidor": host:port · TLS — somente leitura
Depois de escolhido o motor, aparece abaixo da senha do administrador a linha Servidor · <motor>: algo como localhost:5432 · TLS: disable. Esses valores são lidos da configuração do servidor de aplicação (server.properties) e não podem ser alterados pelo assistente: nenhum endereço, porta ou caminho vindo do navegador é repassado ao servidor; assim, a identidade de administrador não pode ser apontada para um destino arbitrário. Na linha do Firebird consta ainda "servidor local obrigatório". Se for usar outro servidor de banco de dados, procure o operador do servidor.
A linha "Idioma de ordenação/maiúsculas": o idioma do banco da empresa vem do país
Abaixo da linha do Servidor aparece Idioma de ordenação/maiúsculas: o idioma oficial do país de legislação escolhido no passo 1 (ex.: Turquia → turco (tr), Suécia → sueco (sv), Indonésia → indonésio (id)); a mesma linha também consta no resumo da instalação. Esse idioma define as regras de letras do banco da empresa: as buscas por igualdade são independentes do idioma (comparação de raiz sem distinção de maiúsculas e de acentos — "ali" combina com "ALİ", "sema" com "ŞEMA" em todos os países), enquanto a ordenação e a conversão entre maiúsculas e minúsculas seguem o idioma oficial do país (em turco, a ordem de ç/ş/ı e ı↔I, i↔İ; em sueco, ä/ö no fim do alfabeto). O valor é lido da tabela país→idioma do servidor, não pode ser alterado na tela e fica fixo depois da instalação. No motor CockroachDB, a ordenação por idioma só é aplicada ao ORDER BY de consultas simples de uma única tabela; em consultas complexas pode aparecer a ordem por ponto de código.
Banco de dados em outro servidor: a escolha do "Servidor"
O banco de dados da empresa também pode ser criado em um servidor de banco de dados que esteja em outra máquina, e não naquela em que roda o servidor de aplicação. Você instala por conta própria o servidor de banco (Firebird 5, PostgreSQL ou CockroachDB) naquela máquina, torna-o acessível pela rede e define a senha do administrador; o assistente não instala nada, apenas conecta e cria ali o banco da empresa. Para isso, o arquivo server.properties do operador do servidor precisa ter a linha kurulum.uzakSunucuIzin=true; se o endereço estiver fora das faixas de rede privada (10.x, 172.16-31.x, 192.168.x, 127.x), ele precisa constar ainda na linha kurulum.sunucuIzinListesi=host1,host2. Com a permissão desligada, a linha Servidor do passo 2 continua somente leitura como antes.
Com a permissão ligada, a linha Servidor do passo 2 vira um seletor: são listados os servidores definidos na configuração do servidor (kume.<ad>.*) e a opção "Este servidor (configurado)", e no final fica "Definir outro servidor…". Na nova definição são pedidos: nome do servidor (no máximo 30 letras/números/sublinhados/hífens, começando por letra minúscula; os nomes firebird, postgresql e cockroach são reservados), endereço e porta, para PostgreSQL/CockroachDB um modo TLS e, opcionalmente, um certificado CA (arquivo PEM, no máximo 16 KB), para o Firebird o diretório de dados (o diretório raiz na máquina remota; o arquivo da empresa é criado ali) e, opcionalmente, usuário/senha do papel de execução. Se o papel de execução já existir naquele servidor, a senha dele é verificada; se não existir, o papel de instalação o cria e gera a sua senha. Ao terminar a instalação, a definição do servidor e a linha da empresa (firma.<firma>=kume:<ad>) são escritas no arquivo server.properties; a senha e o certificado também ficam guardados ali, e não é preciso reiniciar a aplicação.
Códigos de erro que a verificação prévia pode devolver
| Código | Significado e solução |
|---|---|
DB_SUPERUSER_REQUIRED | No PostgreSQL, os objetos de conversão implícita só podem ser instalados por um superusuário; informe uma conta de superusuário para a instalação. |
DB_OWNER_GRANT_REQUIRED | A conta informada não consegue transferir a propriedade ao papel de execução (hnr_uygulama); é preciso grant hnr_uygulama to <hesap> ou um superusuário. |
RUNTIME_DB_USER_MISMATCH | O usuário informado não é compatível com o usuário de conexão de execução do servidor, ou o papel de execução não está definido no cluster; procure o operador do servidor. |
DB_CREATE_PRIVILEGE_REQUIRED | A conta não tem o privilégio CREATEDB. |
LOCAL_FIREBIRD_REQUIRED | Para o Firebird, o servidor precisa ser local (host remoto é recusado). |
REMOTE_SERVER_DISABLED | A definição de outro servidor está desligada; o operador precisa colocar kurulum.uzakSunucuIzin=true. |
REMOTE_HOST_NOT_ALLOWED | O endereço não está numa faixa de rede privada e não consta em kurulum.sunucuIzinListesi. |
CLUSTER_NAME_INVALID / CLUSTER_EXISTS | O formato do nome do servidor está errado, ou já existe uma definição com o mesmo nome. |
RUNTIME_ROLE_PASSWORD_REQUIRED / RUNTIME_ROLE_PASSWORD_INVALID | O papel de execução existe no servidor; a senha dele está faltando ou errada. |
FB_DATA_DIR_REQUIRED / FB_DATABASE_ACCESS_RESTRICTED | O diretório de dados do Firebird não foi informado, ou a configuração DatabaseAccess do servidor remoto recusou aquele diretório. |
CONFIG_WRITE_FAILED | A empresa foi criada, mas não foi possível gravar o server.properties; o operador precisa acrescentar a definição da empresa à mão. |
COMPANY_EXISTS | O código da empresa está em uso; entre na empresa existente ou escolha outro código. |
PRECHECK_TIMEOUT | O servidor de banco de dados não respondeu a tempo à verificação prévia. Servidores remotos e em nuvem (Neon, CockroachDB Cloud) podem demorar ao acordar do modo de suspensão; o assistente tenta de novo uma vez sozinho — se ainda assim falhar, clique outra vez em Continuar depois de alguns segundos. |
SETUP_IN_PROGRESS | Já há outra instalação em andamento para este código de empresa. O código da empresa é único em todo o servidor: o mesmo código não pode ser instalado ao mesmo tempo em outro servidor de banco de dados. Espere a instalação em andamento terminar ou escolha outro código de empresa. |
SETUP_BUSY | O número de instalações que podem rodar ao mesmo tempo no servidor está esgotado (3 por padrão; o operador muda isso com HNR_KURULUM_PARALEL). Tente de novo quando uma das instalações em andamento terminar. |
Várias instalações de empresa ao mesmo tempo, e o log da instalação
Códigos de empresa diferentes podem ser instalados ao mesmo tempo; empresas que vão para servidores de banco diferentes já não esperam umas pelas outras. O bloqueio é por código de empresa: uma segunda instalação para o mesmo código é recusada com SETUP_IN_PROGRESS (o código da empresa é único em todo o servidor). Por padrão, no máximo 3 instalações rodam ao mesmo tempo. Quando a janela de instalação informa uma falha, aparece abaixo da linha de erro a caixa expansível "Log da instalação (últimas linhas)": essas linhas são a saída de diagnóstico do próprio servidor de banco e do procedimento de instalação (tempos das fases, avisos do motor, mensagens de erro do banco). Senhas e dados de conexão não são mostrados nesse log; você pode encaminhar o conteúdo como está ao operador do servidor.
Se não há PostgreSQL neste computador: o HNR o instala
Se o PostgreSQL não for encontrado no passo do banco de dados, o assistente mostra o botão "Instalar o PostgreSQL". Um clique roda o instalador embutido: leva cerca de um minuto, ocupa cerca de 200 MB e o servidor instalado aceita conexões somente deste computador (listen_addresses=localhost, verificação de senha scram-sha-256). O progresso aparece na tela fase a fase: diretório de dados, arquivos de configuração, início do servidor, papéis de usuário, banco de modelo, ajustes do servidor, verificação. Ao terminar, você continua de onde parou; nenhum nome de usuário ou senha de banco de dados é pedido.
O que o instalador grava? O cluster é instalado sob data/pg (diretório de dados data/pg/veri, log data/pg/pg.log). O modelo de papéis é o mesmo de data/pg-calisma-rolu.sql: papel de execução hnr_uygulama (não é superusuário, não cria bancos), papel de instalação sem superusuário hnr_kurulum (CREATEDB) e o banco de modelo hnr_sablon conforme o idioma da empresa (com a camada de conversão implícita dentro). No arquivo server.properties são acrescentadas apenas as linhas postgresql.host/port/user/password/sslmode e kurulum.basitKimlik; nenhuma linha existente é alterada e, antes de gravar, é feito o backup server.properties.bak-…. A senha do superusuário (postgres) não é escrita no arquivo de configuração: ela fica apenas no arquivo data/pg/HNR-PG-SIRLAR.txt — faça backup desse arquivo e mantenha-o fora do alcance de acessos não autorizados.
Limites e solução de problemas. O instalador só pode ser iniciado a partir do computador em que a aplicação roda (um navegador remoto recebe 403) e, por enquanto, funciona somente no Windows. Se os arquivos de programa do PostgreSQL não estiverem no servidor, em vez do botão aparece o aviso de que "o operador precisa extrair o zip de binários Windows x64 na pasta tools/postgresql" — o instalador não baixa nada da internet. Se o PostgreSQL já estiver configurado, o instalador não faz nada. A instalação também registra uma tarefa que inicia o PostgreSQL sozinho quando o computador liga; se a tarefa não puder ser registrada (restrição de permissão), o PostgreSQL ainda funciona, mas aparece na tela o aviso de que "precisa ser iniciado à mão após reiniciar". Só pode ser removido o cluster que o próprio HNR instalou; a remoção limpa junto a tarefa, o diretório de dados e as linhas do server.properties, e todos os dados de empresa daquele cluster são apagados.
Se o Oracle for escolhido: os privilégios da conta de instalação
Privilégios indispensáveis para a instalação. No Oracle, a empresa é criada como dois donos de esquema (principal + EK1). A conta de banco de dados que você digita no assistente precisa obrigatoriamente ter estes privilégios de sistema: CREATE USER, ALTER USER, GRANT ANY PRIVILEGE. Se, nas configurações avançadas, você escolheu um local de dados personalizado (seu próprio caminho de tablespace/DBF), é preciso ainda CREATE TABLESPACE. Se faltar algum, o assistente para antes de iniciar a instalação e diz o nome dos privilégios que faltam (ORACLE_PRIVILEGE_REQUIRED) — ele não deixa uma empresa pela metade.
Privilégios extras recomendados. DROP USER (e, em local personalizado, também DROP TABLESPACE) não é indispensável para a instalação, mas, se algo falhar no meio dela, o HNR usa esse privilégio para remover sozinho os donos de esquema que ficaram pela metade. Sem ele a instalação é tentada assim mesmo; a mensagem de erro então informa, com ORACLE_YARIM_KURULUM_KALDIRILAMADI, qual dono de esquema você precisa apagar à mão. Por isso é boa prática conceder DROP USER só durante a instalação e revogá-lo depois.
A conta de execução é separada. O assistente cria dois donos de esquema por empresa e concede a eles apenas CREATE SESSION, CREATE TABLE, CREATE VIEW, CREATE SEQUENCE, CREATE PROCEDURE, CREATE TRIGGER; a cota é definida como QUOTA UNLIMITED sobre o tablespace escolhido. Ou seja, a conta usada no trabalho diário não consegue ver outra empresa nem criar usuários/esquemas.
Informação da empresa › Conectividades bancárias (Só administrador): estabelecer conexões para receber transações de conta ao vivo dos seus bancos, credenciais criptografadas, teste de conexão, mapeamento da conta e intervalo de feto. Guia de conexão ao banco.
Senha do administrador (rodada 14): na etapa do administrador do assistente, a senha deve ter pelo menos 12 caracteres, conter pelo menos uma letra e um dígito e não conter o nome de usuário; as condições são contadas em tempo real abaixo do campo e Avançar não prossegue enquanto a regra não for atendida. Para a regra de senha dos usuários comuns, veja Regra de senha.
11. Configurações › HNR › "Backup do banco de dados da empresa" e restauração a partir do backup
Finalidade. O cartão Backup do banco de dados da empresa em Configurações › HNR grava os bancos principal e EK1 da empresa atual em uma única pasta de pacote criptografado. O pacote aparece como uma nova pasta dentro do diretório escolhido no computador que executa o servidor HNR: main.enc, ek1.enc e o marcador de conclusão hnr-yedek.json, gravado por último. Você deve ser administrador do sistema e informar novamente sua senha atual de administrador do HNR; a mesma senha abre o pacote. Nenhuma credencial do servidor ou do banco é armazenada nele.
Restauração. A tela “Criar uma nova empresa a partir de um backup do HNR”, aberta pelo menu ⋮ da tela de login, sempre restaura com um NOVO código de empresa; uma empresa existente nunca é sobrescrita. São solicitados a senha de administrador do HNR usada ao criar o backup e um administrador do banco de destino: Firebird, SYSDBA; PostgreSQL, um superusuário; CockroachDB, root/admin; SQL Server, sysadmin; Oracle, um administrador com CREATE USER. A empresa só é disponibilizada depois que ambos os conteúdos são abertos e verificados. Com senha incorreta ou segunda parte corrompida, nada é criado no destino.
Motores compatíveis. Firebird, PostgreSQL, um nó local de CockroachDB instalado pelo próprio HNR, Microsoft SQL Server e Oracle. Para Firebird/PostgreSQL/CockroachDB, usa-se a ferramenta de backup do próprio motor. Para SQL Server e Oracle, o pacote é lógico: a definição do esquema e as linhas de todas as tabelas são lidas pela conexão com o banco. Assim, o backup pode ser feito mesmo com o servidor remoto ou em um contêiner, sem acesso ao sistema de arquivos do servidor. A restauração cria um novo banco/esquema e um novo usuário de execução para a nova empresa. Em um pacote Oracle, informe o nome do cluster de destino e, se necessário, o nome do serviço; o padrão é FREEPDB1.
O que você precisa saber. Os bancos principal e EK1 são copiados separadamente; não há um instante atômico único para ambos. Escolha um intervalo curto sem atividade na empresa. Apenas um backup ou restauração pode executar por vez. A pasta fica no sistema de arquivos do servidor, não no navegador; pastas ligadas por symlink/junction são rejeitadas. Copie o pacote para um lugar seguro: sem ele não há recuperação, e sem a senha ele não pode ser aberto.
12. Configurações › Perfil da empresa e requisitos corporativos
O perfil desliga aprovações desnecessárias e o excesso de menus conforme quantas pessoas usam o programa: Sozinho (padrão em novas instalações), Em equipe, Corporativo. Empresas antigas sem perfil contam como corporativas; o comportamento não muda.
As quatro chaves podem ser alteradas uma a uma: menu simples, ficha simples, ocultar contas com saldo pequeno, segunda confirmação ao vender com estoque negativo. Ao mudar o perfil, elas voltam ao padrão do novo perfil; cada alteração vai para o registro de configurações. As obrigações legais (impostos, numeração de documentos, dados da fatura, documentos eletrônicos, dados pessoais) não estão nesta tela. Passo a passo: Primeiros passos sozinho.
Quinta chave, Recebimentos quitam as faturas em aberto mais antigas: um recebimento sem fatura quita em ordem as faturas de venda em aberto mais antigas do cliente (ligada em individual e equipe, desligada em corporativo). Ocultar contas com saldo pequeno vem desligado em todos os perfis, inclusive empresas antigas sem perfil; só funciona se você ligar aqui.
Controles corporativos › Aprovação por segundo usuário: não pode ser escolhida enquanto a empresa tiver um único usuário (ninguém mais aprovaria); fica disponível ao criar um segundo usuário. A aba Backup reúne o backup do banco de dados em um só lugar.
Nos perfis individual e PME, a aba Backup também traz Corrigir saldos das notas fiscais sob o backup: recalcula o valor em aberto das notas a partir das movimentações do cliente (a mais antiga primeiro); mostra antes um resultado de teste, cada execução vai para a trilha de auditoria e o saldo do cliente não muda. No perfil corporativo esta ferramenta fica na manutenção de importação da instalação avançada. O aviso 'limite de e-Fatura / e-Arquivo não informado' só aparece nos perfis individual e PME.
13. Configurações › Política de estoque: proibir estoque negativo
Você também pode gerenciar a mesma trava em Configurações › Política de estoque › Proibir estoque negativo (por armazém): há uma caixa para cada armazém ativo (é a mesma configuração da caixa do cartão do armazém; quando uma muda, a outra também muda). Somente o administrador ativa ou desativa a trava; para os demais usuários a caixa fica desativada e mostra “Para alterar é necessária a permissão de Administrador (Configurações › Usuários).” Por padrão ela fica desativada.
14. Configurações › Dados da empresa › Comunicação: Endereço público (acesso externo)
O Endereço público (acesso externo) é o endereço que o cliente consegue abrir pela internet (p. ex. https://erp.firmaniz.com). O link de resposta da carta de conciliação de saldo é impresso com este endereço. O endereço deve começar com http:// ou https://; endereços que só abrem a partir deste computador, como localhost ou 127.0.0.1, não são aceitos: abaixo do campo é informado o motivo e Salvar fica desativado; o servidor também recusa esse valor com 422 GENEL_ADRES_GECERSIZ.
Se o campo estiver vazio, o programa consulta o endereço de resposta do ambiente do servidor (MUTABAKAT_YANIT_TABAN ou PORTAL_ADRES); se este também não existir, nenhum link é impresso na carta (antes, o endereço local deste computador podia ser impresso por engano), e apenas o código de resposta é escrito. Depois de alterar o endereço, as cartas enviadas a partir de então são impressas com o novo endereço. Detalhes: Conciliação de contas › Código de resposta, hora do saldo e endereço público.
15. Configurações › Sistema
A seção Sistema está aberta a todos os usuários e contém três pequenos grupos: Sobre (informações de versão; a linha «Idioma» mostra o nome visível do idioma da interface, p. ex. «Idioma Português»; a linha de acesso a arquivos se lê em linguagem simples «Completo (pode abrir e salvar arquivos diretamente)», «Limitado (OPFS)» ou «Download»), Registro (exporta o registro de operações do sistema para um arquivo) e Redefinir (volta ao padrão o tema, o destaque, o papel de parede e a escala; afeta apenas a sua visualização e não toca nos dados da empresa). A seção Sistema não grava nenhum lançamento contábil nem de estoque. O botão «? Ajuda» no título da seção abre esta seção.
Regra de senha
Ao criar um usuário, ao redefinir a senha de um usuário (Configurações › Usuários) e ao alterar a sua própria senha (Configurações › Conta › Senha), a senha deve seguir esta regra: deve conter pelo menos 8 caracteres, pelo menos uma letra e pelo menos um dígito, e não deve conter o nome de usuário. A linha de condições abaixo do campo mostra qual condição ainda falta; enquanto a regra não for atendida, Salvar permanece desativado e o motivo aparece abaixo do botão. O servidor aplica a mesma regra: uma senha que não a cumpre é recusada com a frase “A nova senha não atende à regra (faltam n condições)” e a lista das condições que faltam. As senhas existentes não são forçadas: o usuário que não altera a senha continua entrando com a antiga; a regra só é verificada em uma senha nova ou alterada.
A senha do administrador criada no assistente de primeira configuração é mais rigorosa: pelo menos 12 caracteres, pelo menos uma letra e um dígito, e não contém o nome de usuário. Esse usuário tem todos os direitos, portanto guarde a senha em local seguro. O assistente mostra as condições em tempo real abaixo do campo e exibe a mesma frase ao clicar em Avançar (veja Assistente de primeira configuração).
Bloqueio de acesso e sessão
Se, com o mesmo nome de usuário, forem digitadas 10 senhas incorretas em 15 minutos, o acesso desse usuário é suspenso por 15 minutos. Enquanto estiver bloqueado, até a senha correta é recusada; a tela mostra a frase “Acesso suspenso temporariamente; tente novamente em 15 minutos ou peça ao seu administrador que o desbloqueie em Configurações › Usuários.” A frase não revela se o nome de usuário existe (é a mesma para um nome inexistente). O freio de acesso por computador (IP) funciona separadamente e é independente do bloqueio da conta: após muitas tentativas falhas, retorna 429 com a frase “Muitas tentativas de acesso falhas — este endereço foi bloqueado temporariamente; tente novamente em alguns minutos.”; o cabeçalho Retry-After informa, em segundos, o tempo restante real do bloqueio (no máximo 5 minutos). Em Configurações › Conta › Senha, o bloqueio da conta também conta a senha atual digitada errada. O evento de bloqueio é gravado no registro de sessões.
O usuário bloqueado aparece na lista Configurações › Usuários com um ícone 🔒 e o selo “Acesso bloqueado (n min)”. O botão Desbloquear da linha só é usado por um usuário com a permissão de Administrador e só desbloqueia usuários da própria empresa; aparece “Bloqueio de acesso removido.” e o evento é registrado. Esperar também basta: após 15 minutos o bloqueio é removido sozinho. Se o usuário for excluído, o registro de bloqueio também é apagado.
Uma sessão dura no máximo 24 horas a partir do momento em que foi aberta. Bloquear sessão agora não bloqueia apenas a tela, mas também a sessão no servidor: enquanto está bloqueada, o token da sessão não funciona em nenhum ponto de acesso; desbloquear significa entrar novamente digitando a sua senha, e se você atualizar a página enquanto estiver bloqueada, é exigido um login completo. Quando você altera a sua senha (Configurações › Conta › Senha), as suas sessões em outros dispositivos são encerradas; a sessão em que você fez a alteração permanece aberta. Se um administrador redefinir a senha de um usuário, renomeá-lo ou excluí-lo, as sessões abertas desse usuário são encerradas imediatamente (somente na empresa do próprio administrador). Sair também encerra o cookie de sessão.
Quem pode alterar as configurações de toda a empresa
As configurações de política que afetam toda a empresa não podem ser alteradas com um direito de trabalho comum: as configurações de dia de pagamento e de ordem de pagamento, a regra de desconto de preços, a distribuição do custo de importação, as operações de depósito (programa de contagem), a qualidade (inclusive desativar um critério IQC), as configurações de chamados de serviço e outras políticas semelhantes da empresa só são salvas com o direito de Administrador. A tentativa de salvar por um usuário sem o direito é recusada com 403 e a frase “Somente um Administrador pode alterar esta configuração de toda a empresa — Configurações › Usuários.” As configurações do serviço de mensagens e da conexão bancária seguem a mesma regra. O direito é concedido no cartão do usuário, em Configurações › Usuários.
A mesma regra vale nas telas de configurações de Mercadoria Recebida, Logística de Devoluções, Conciliação em Lote, Empréstimo, Inspeção de tecido e da porta de documentos de fornecedor do QMS: um funcionário sem a permissão vê a configuração, mas Salvar fica desativado e o motivo aparece abaixo (“Somente um Administrador pode alterar esta configuração de toda a empresa — Configurações › Usuários.”). A regra se estende às páginas de configurações próprias dos módulos: as configurações de período e contabilidade do Custo padrão e as taxas de custos indiretos de produção (GÜG) (somente o Administrador grava e exclui as taxas), as taxas de decisão de cheques/notas promissórias, os limites de posição cambial, as configurações de financiamento, as configurações de manutenção e MES, as definições de expedição (previsão de chegada, exportação, cobrança na entrega, GS1), as configurações do portal de clientes e o usuário de serviço, as configurações de ativo imobilizado, o item da fatura de juros de mora, a configuração da porta do ponto e das horas extras, e as configurações de orçamento, operações de depósito, inspeção final, planejamento de pagamentos, importação, preço, risco, trabalho parado e conciliação de contas, além das regras de anomalia de notificações, que são salvas somente pelo Administrador. Uma requisição de salvamento não autorizada retorna 403 com um único código (YONETICI) e a mesma frase. Uma requisição de configuração vazia não zera a configuração: retorna 422 (“Nenhuma configuração foi enviada para salvar — altere pelo menos uma configuração e salve novamente.”); uma requisição parcial altera apenas o campo enviado, e devolver uma configuração ao padrão só acontece por meio de uma ação explícita. Os registros de regras (regras contábeis, de vencimento, de comissão e de calendário) e as configurações do gerente de RH continuam sendo gravados com a permissão do próprio módulo ou papel.
Encerrar um usuário sem excluí-lo: Desativar
Na lista Configurações › Usuários, cada linha tem um botão Desativar (pede confirmação; no telefone, em Jardim + Etapas, existe o mesmo botão). Um usuário desativado não consegue entrar e suas sessões abertas são encerradas; seus registros e o rastro de suas operações são mantidos (“O usuário não pode entrar; as sessões abertas são encerradas. Os registros e a trilha de auditoria são mantidos.”). O usuário desativado recebe o mesmo erro de uma senha incorreta (401, KIMLIK_HATALI), de modo que a existência da conta não é revelada. Os acessos da mesma pessoa ao portal do funcionário e ao terminal MES também deixam de funcionar. Ativar reabre a conta. Você não pode desativar a própria conta nem o último Administrador (“Você não pode desativar a própria conta.”). O acesso encerrado por um desligamento no RH também aparece como “Inativo” na lista.
Desativar não é excluir. Excluir é uma ação separada e não pode ser desfeita; a desativação pode ser revertida a qualquer momento com Ativar. Somente o Administrador desativa; o acesso de uma conta encerrada em Configurações também só pode ser reaberto pelo Administrador, na tela de acesso do RH. No campo Nível de permissão (0–15) da ficha do usuário, 0 significa “sem nível”.
O novo acesso ao portal do funcionário e ao terminal MES do funcionário vinculado a um usuário desativado também é bloqueado: a tela mostra a mesma frase de PIN errado (“Nome de usuário ou PIN incorreto”), assim não se revela se a conta existe. A conta do portal não é excluída; com Ativar, o mesmo PIN volta a valer.
Política financeira: se o caixa e o banco ficarem negativos
O grupo Se o caixa ou o banco ficar negativo em Configurações › Política financeira é uma única configuração da empresa, com duas opções. Avisar (padrão): se o pagamento for deixar a conta negativa, o recibo para; se o usuário der a aprovação de saldo negativo e escrever uma justificativa de pelo menos 5 caracteres, ele é lançado e a aprovação fica no registro de operações como “Exceção aprovada”. Bloquear: a conta de caixa ou de banco não pode ficar negativa, nem mesmo com aprovação; primeiro é preciso obter saldo por meio de um recebimento ou de uma transferência.
Abrangência: todo recibo que retira dinheiro de uma conta de caixa ou de banco — Entrada de recibo (caixa/banco, lançamento em lote), a transferência caixa ↔ banco, o lançamento de recibo a partir de Movimentações bancárias e o pagamento de ordem de pagamento. Contas de cartão de crédito ficam de fora. Para alterar, é necessária a permissão Administrador (Configurações › Usuários); um usuário sem ela vê a opção, mas não pode alterá-la. A seção mostra o nome de quem alterou a política por último e a data (“Última alteração”). No celular (Jardim + Etapas) existe a mesma seção.
Guias relacionados
- Formulários de Impressão — você desenha o que sai no papelAntigamente os layouts de orçamento, nota fiscal e recibo ficavam enterrados dentro do programa; para mudar um deles era preciso um programador.
- Document Number Series – Um Guia de ScratchCada documento final – fatura, nota de entrega, encomenda, citação, receita, cheque batch – tem um número que é mostrado ao cliente.
- Cockpit — Um guia do zero para gestoresEste guia foi escrito para quem precisa olhar os números e decidir. O objetivo dele não é te ensinar a ler um relatório, e sim mostrar de onde vem cada número.
- Calendário e tarefas de contrato — Renda, Seguro, Licença e Experiências de Inspecção e Trabalho DocumentadoO que Calendário de Contrato coleta as obrigações de tempo da empresa em um lugar: aluguer, seguro, licença de software, contrato de manutenção/serviço.
- Webhooks e OpenAPI: notificação de eventos para outros sistemasQuando um evento ocorre no HNR (nota lançada, pedido excluído, remessa em trânsito…), o webhook envia uma notificação HTTP assinada para o endereço definido.
- Centro de auditoria: matriz de permissões e bloqueios de períodoQuem pode fazer o quê, que período financeiro está bloqueado e quem abriu um bloqueio, quando e porquê: as primeiras perguntas da auditoria interna e do.