Conteúdo
1. O que faz cada uma das três camadas?2. A história completa de um documento: o Dossiê do Documento3. Travas de segurança — seis barreiras3.5 A decisão sobre quem é administrador agora vem do servidor3.6 O que uma recusa de permissão te diz4. Como ligar uma trava5. Anomalias — não é acusação, é onde olhar6. Uma rotina semanal de dez minutos7. Quatro travas novas (2026-09): assinatura única, bloqueio automático de período, exigência de lote no CoC, padrão automático de lote8. Modelos de perfil e permissões que valem imediatamente nas sessões abertas9. Os erros de acesso vêm em três classes: identidade, freio, carga10. Portal do funcionário: freio de acesso e desbloqueio11. Onde olhar quando uma mensagem fala em «trava de segurança»Ciclo de vida da sessãoTipos de arquivo enviadosCódigos de erro de login e senha (integrações)O bloqueio de período é uma única travaGraus de sigilo e necessidade de conhecerTrilha de Auditoria, Travas de Segurança e Anomalias
Este guia trata de três camadas de defesa distintas. Em resumo: a primeira registra, a segunda impede, a terceira mostra. Cada uma é útil sozinha, mas a força de verdade aparece quando são usadas juntas.
As seções 1–2 são o que todo gestor deveria ler: dez minutos. Se você vai ligar travas, leia também as seções 3–4.
1. O que faz cada uma das três camadas?
O que separa um acidente de um abuso é a intenção, e nenhum software enxerga intenção. É por isso que o sistema responde a três perguntas diferentes, separadamente:
| Camada | A pergunta que ela responde | Onde |
|---|---|---|
| 1 · Trilha de auditoria | Quem fez isto, quando e de qual computador? | Gestão → Auditoria → Busca |
| 2 · Travas de segurança | Isto deveria sequer ter sido possível? | Gestão → Auditoria → Travas de segurança |
| 3 · Anomalias | O que parece normal sozinho mas não é? | Gestão → Auditoria → Anomalias |
2. A história completa de um documento: o Dossiê do Documento
Nas telas de nota fiscal, pedido, orçamento, nota de remessa, recibo e borderô de cheques — se você entrou como gestor — aparece um botão Dossiê do Documento. Um clique abre a história inteira daquele documento:
- Identity — who wrote the document, when, and who made the last change.
- Version history — how many times it was edited and how much the amount moved each time.
- Access trail — who touched this document, when, and from which IP address.
- Linked documents — which quote and order it came from; which collection it was tied to.
- Certainty — how sure the system is about the match: single match, single IP, multiple candidates or no trail.
O HNR pode entregar de novo o número de um documento excluído. Por isso o Dossiê do Documento cruza a trilha não só pelo número, mas pelo próprio carimbo de tempo do documento. Correspondências de datas distantes são mostradas em um bloco separado de histórico do número — não confunda os dois.
3. Travas de segurança — seis barreiras
Todas as travas vêm desligadas por padrão. Nada para sozinho numa empresa que migra para uma nova versão; ligar uma trava é uma decisão consciente. Toda trava tem uma saída, e ela está sempre escrita na tela — uma trava cuja saída não se vê acaba sendo desligada em bloco na primeira reclamação.
| Trava | O que faz / por que existe | Saída |
|---|---|---|
| Bloqueio de período | Impede acrescentar documentos a um mês cuja declaração fiscal já foi entregue. | O gestor passa (esse comportamento também pode ser desligado). |
| Limite para exclusão | Que os erros pequenos possam ser corrigidos, e que os documentos grandes passem por um segundo par de olhos. | O gestor pode excluir qualquer valor. |
| Teto do recibo | Saídas grandes de dinheiro do caixa não devem acontecer com uma assinatura só. | O gestor lança sem limite. |
| Tolerância de perda | A perda é o lugar mais fácil para esconder mercadoria que sumiu. | Acrescenta-se uma aprovação explícita ao apontamento; quem aprova fica registrado. |
| Bloqueio de custo | Digitar um custo à mão é o caminho mais curto para fazer o relatório de lucro dizer o que você quer. | Pode ser restrito ao gestor; no modo fechado, só o custo calculado vale. |
| Aprovação de nova conta | Uma nota fiscal emitida para um cliente inventado é um valor a receber que nunca será cobrado. | Editar cartões já existentes é sempre livre. |
Numa empresa de uma pessoa só, não ligue nenhuma trava; "nenhuma trava está ligada" na tela não é uma falha. Quando o segundo funcionário entrar, ligue primeiro o bloqueio de período e depois o limite para exclusão. As outras só entram se aquele ramo de trabalho realmente precisar.
3.5 A decisão sobre quem é administrador agora vem do servidor
A pergunta se um usuário é administrador do sistema podia ter duas respostas: a resposta do servidor e a interpretação da própria tela. Como os dois lados liam os mesmos bits de permissão separadamente, eles podiam — raramente — divergir: o botão aparecia, a ação era recusada. Agora há uma única resposta: enquanto você entra, o servidor decide ele mesmo "este usuário é administrador?" e informa o veredicto ao programa de forma explícita. A tela lê esse veredicto e não interpreta nada por conta própria.
- Consistency: What you see and what you can do no longer diverge. If you can see a button, the server also counts you as entitled to that job.
- Immediate effect: When your administrator changes your rights, signing out and in once is enough; the program refreshes the verdict from the server at startup.
- What has not changed: Visibility is still only decoration. The real gate is on the server — hiding a button is not a permission; removing a permission is.
3.6 O que uma recusa de permissão te diz
Quando uma ação é recusada, o programa não diz mais apenas "você não tem permissão"; ele informa o nome da permissão necessária. Isso permite ir ao seu administrador com "você pode liberar esta permissão?" em vez de "alguma coisa não está funcionando" — e a solução leva minutos. A mensagem segue sempre o mesmo formato:
| A mensagem que você vê | O que de fato aconteceu | O que fazer |
|---|---|---|
| "Esta ação exige a permissão '…' ou direitos de administrador do sistema." | A sua sessão é válida, mas o bit de permissão para aquele serviço está desligado | Diga ao seu administrador o nome que está entre aspas — ele é liberado em Ayarlar › Usuários |
| "Esta ação exige direitos de administrador do sistema." | Este serviço não é controlado por um bit, mas reservado a administradores (gestão de usuários, RH, qualidade, cadastro de depósitos…) | Passe o serviço a um administrador; nenhuma permissão parcial o libera |
| "Sessão necessária: … é preciso estar conectado ao WebOS." | Não é um problema de permissão: a sua sessão caiu ou nunca foi aberta | Entre de novo; nada se perde, refaça a ação |
Em vez de atualizar a tela, leia a mensagem e a repasse do jeito que está. O nome da permissão dentro dela é a única pista que o seu administrador encontra sem ter que procurar. Se você está numa sessão antiga (o programa está aberto há dias), pode ser preciso sair e entrar uma vez — ao entrar, o programa busca de novo o veredicto de administrador no servidor.
4. Como ligar uma trava
- Open the Management window → Audit tab → Security gates.
- Read the gate's description and its Escape line. If you cannot explain the escape to your team, do not open that gate.
- Enter the value (a date, a number or a choice) and press Apply. An open gate turns amber and the header says "1 gate open".
- If you change your mind, Close returns the setting to its default; no record changes, only the gate closes.
O sistema só aceita nomes de configuração que ele conhece. Uma configuração com o nome errado não faria nada em silêncio enquanto a empresa acreditaria que a trava está ligada — por isso um nome desconhecido é recusado e os nomes válidos são listados.
5. Anomalias — não é acusação, é onde olhar
Excluir uma nota fiscal é normal. Emitir no mesmo dia, para a mesma conta, uma nova nota de valor parecido também é normal. As duas coisas acontecerem em seguida não é. Esta tela mostra exatamente essa classe de evento — quatro visões:
- Ageing receivable / stalled collection — accounts whose balance grows while collection has stopped. A customer about to default slows down first.
- Same-day delete-and-rewrite — a new document for the same account on the same day for a similar amount. If the deleter and the writer are the same person, that is flagged too.
- Duplicate purchase invoice — same supplier, same amount, close dates. An invoice paid twice is the quietest loss there is.
- Return-heavy account — accounts whose returns are high relative to their sales.
Os números desta tela contam linhas para olhar. Um número diferente de zero não significa que existe um problema, e um zero não prova que está tudo bem. Cada linha pode ter uma explicação perfeitamente razoável — uma nota emitida errada foi corrigida, duas filiais compraram o mesmo item, uma assinatura custa o mesmo todo mês.
6. Uma rotina semanal de dez minutos
- Open the Anomalies tab and look at the four badge counts. Any jump compared with last week?
- In same-day delete-and-rewrite, open the rows where "same person = yes" and the difference is negative. Read the story with the Document File button.
- In duplicate purchases, look only at rows where "document no is the same"; the rest is usually regular buying.
- If you find something, ask the person involved — the system does not judge, you do.
- If you must send the list to your accountant, use the CSV button; the "this is not an accusation" note travels with the file.
7. Quatro travas novas (2026-09): assinatura única, bloqueio automático de período, exigência de lote no CoC, padrão automático de lote
Você verá quatro linhas novas na mesma tela (Gestão › Auditoria › Travas de segurança). A regra não mudou: todas desligadas por padrão, cada uma com saída e rastro, alteradas apenas pelo administrador do sistema.
| Trava | O que faz / por que existe | Valor, saída e rastro |
|---|---|---|
| Assinatura única (depo.dort_goz_tek_imza) | Quem abre uma instrução de transferência não pode aprová-la (quatro olhos). Com um único gestor na empresa, essa regra trava o trabalho. Com a trava ligada, esse gestor solitário pode aprovar a própria instrução. | kapali | acik. Se existir outro gestor, a configuração NÃO é aplicada (ele é a segunda assinatura). Quando aplicada, um rastro "TEK_IMZA" nas observações mais uma linha própria na trilha de Auditoria. |
| Bloqueio automático de período (mali.donem_kilidi_otomatik) | No dia N de cada mês o mês anterior se bloqueia sozinho; acabou o "esquecemos de colocar o bloqueio" depois da declaração. | 0 = desligado, 1–28 = dia do mês. A data de bloqueio gravada é o dia 1º do mês (aquele dia aberto, os anteriores fechados). Um bloqueio adiantado à mão nunca é puxado de volta. Cada execução publica um comunicado aos gestores + um registro de auditoria; desfazer manualmente: mali.donem_kilidi. |
| Exigência de lote no CoC (kalite.coc_lot_zorunlu) | Num cartão em que o certificado é obrigatório, uma conferência de CoC sem número de lote dá uma resposta "geral". Com a trava ligada, uma consulta sem lote é recusada. | kapali | acik. Desligada: a resposta traz o aviso "conferência geral — não por lote"; ligada: LOT_GEREKLI. Detalhes: guia de Qualidade. |
| Padrão automático de lote (depo.otomatik_lot_kalibi) | Quando um cartão com rastreamento de lote é recebido numa nota fiscal de compra sem número de lote, o programa abre um lote com este padrão. | Texto, no máximo 60 caracteres; marcadores {belgeNo} {sira} {kod} {tarih} {depo}; {belgeNo} é obrigatório. Padrão "{belgeNo}-{sira}". Detalhes: guia de Depósito. |
8. Modelos de perfil e permissões que valem imediatamente nas sessões abertas
Ao criar um usuário você agora escolhe um modelo de perfil (vendas, compras, depósito, produção, qualidade, finanças, contabilidade, RH, planejamento, gestão) — acabou a era do "clone o conferente do depósito e depois vá virando bit por bit". Como usar está no guia de Configurações. Do ponto de vista da segurança, duas regras importam:
- Nenhum modelo contém o bit de administrador do sistema. Direitos de administrador são sempre concedidos à mão e de propósito; nem o modelo de "gestão" abre o cockpit de Gestão.
- Uma mudança de permissão vale imediatamente nas sessões abertas. Antes, o usuário precisava sair e entrar de novo; agora, no instante em que o administrador salva, as sessões abertas daquele usuário são renovadas de forma transparente — a sessão não cai, basta atualizar a página. Se a senha de um usuário for alterada, as sessões abertas dele caem (ele entra com a senha nova) — comportamento esperado e seguro.
Permissão por tipo de nota fiscal: as notas de devolução são emitidas com o bit da própria área comercial — devolução de venda faturacikis, devolução de compra faturagiris. Uma recusa de permissão agora sempre chega como 403 e informa o direito exigido (alguns caminhos mostravam antes um "erro de servidor" 502). Detalhes: guia de Compras.
9. Os erros de acesso vêm em três classes: identidade, freio, carga
Nem toda recusa de acesso é "senha errada". Leia a mensagem:
| Código | Mensagem | O que fazer |
|---|---|---|
| 401 | Nome de usuário ou senha incorretos | Erro seu; a partir da terceira tentativa, cada acesso errado acrescenta um atraso crescente (até 2 s). |
| 429 | “Muitas tentativas de acesso erradas — este endereço foi bloqueado temporariamente; tente novamente em alguns minutos.” | Freio de acesso por computador (IP). Só tentativas erradas contam; colegas que entram corretamente pela mesma rede não acionam o freio. Enquanto o bloqueio durar, o cabeçalho Retry-After da resposta informa em segundos o tempo restante real (no máximo 5 minutos), que diminui a cada tentativa; não é preciso esperar um minuto fixo. Se o bloqueio foi ativado no terminal MES, o portal do funcionário informa o mesmo tempo restante. |
| 503 | Servidor sobrecarregado: o teto de sessões simultâneas foi atingido / não foi possível conectar ao servidor HNR | Não é culpa sua, e isso não conta para o bloqueio de tentativas. Quando o limite de sessões está cheio, as sessões ociosas são encerradas primeiro; se ainda não houver vaga, tente novamente em instantes. Se persistir, avise um usuário com a permissão Administrador (o Administrador na lista Configurações › Usuários). |
Envio de anexos: quando muitos arquivos estão sendo verificados ao mesmo tempo, você pode ver "Fila de verificação de arquivos cheia — tente de novo em instantes" (503); o seu arquivo não foi recusado, ele apenas não entrou na fila. Envie de novo alguns segundos depois.
10. Portal do funcionário: freio de acesso e desbloqueio
O portal tem duas proteções separadas. (1) Freio por computador (IP): se muitos PINs errados forem tentados do mesmo endereço em pouco tempo, a resposta é 429 com a frase “Muitas tentativas de acesso erradas — este endereço foi bloqueado temporariamente; tente novamente em alguns minutos.”; Retry-After informa o tempo restante real, que diminui. Acessos corretos não contam; na troca de turno, cinquenta pessoas entrando pela mesma rede da fábrica não acionam o freio. (2) Bloqueio de conta: 5 PINs errados para a mesma matrícula → bloqueio de 15 minutos; o terminal MES e o portal do funcionário usam o mesmo contador. Na lista Funcionários › Contas do portal, o gestor de RH desbloqueia sem esperar com o botão Desbloquear da linha; a ação é registrada. Já o “Desbloquear” de Configurações › Usuários é para a conta de usuário do WebOS e não desbloqueia o portal nem o MES. Detalhes: guia de RH.
O botão Imprimir no canto superior direito gera uma versão adequada ao papel A4. Guias relacionados: Cockpit, Configurações e Log, Registros Antigos.
Bloqueio de acesso por conta. O freio de acesso por computador (IP) continua; além disso, se forem digitadas 10 senhas incorretas em 15 minutos para o mesmo nome de usuário, o acesso desse usuário fica suspenso por 15 minutos. Enquanto está bloqueado, até a senha correta é recusada e a mensagem não informa se o nome de usuário existe. Você desfaz o bloqueio com o direito de Administrador em Configurações › Usuários; para mais detalhes, veja o guia de Configurações.
A mesma lógica nos portais. No portal do pessoal, 5 tentativas incorretas de PIN por nome de usuário o bloqueiam por 15 minutos; o PIN antigo digitado incorretamente ao alterar o PIN também é contado. A frase de bloqueio não revela se a conta existe. O PIN deve ter de 4 a 6 dígitos; dígitos repetidos (0000) e consecutivos (1234, 4321) são recusados. Quando o PIN ou o papel muda, ou a conta é encerrada ou bloqueada, as sessões abertas do portal são encerradas; uma sessão de portal dura no máximo 24 horas.
11. Onde olhar quando uma mensagem fala em «trava de segurança»
As travas de segurança ficam em Painel › Auditoria › Travas de segurança (no dock, a janela Painel, aba Auditoria; a «janela de Gestão» da seção 4 é hoje o nome desta janela). As mensagens sobre uma trava escrevem este caminho e o título da trava (p. ex. «Painel › Auditoria › Travas de segurança › Carga de capacidade da planta (capacidade aproximada)»); a chave interna da configuração não aparece em nenhuma mensagem, você procura a trava na lista pelo título.
As mensagens de permissão também dizem onde concedê-la: em uma frase como «Permissão do módulo Depósitos necessária — Configurações › Usuários.» o nome visível da janela está escrito e a permissão é concedida em Configurações › Usuários. Não procure uma pessoa chamada «administrador do sistema»: o nome da permissão e o lugar onde é concedida estão escritos na mensagem.
Ciclo de vida da sessão
Uma sessão é encerrada no máximo 24 horas depois de aberta. Bloquear sessão também bloqueia no servidor (desbloquear significa entrar novamente; se a página for atualizada enquanto estiver bloqueada, é exigido um login completo). Alterar a senha encerra as sessões nos outros dispositivos; se um administrador redefinir a senha de um usuário, renomeá-lo ou excluí-lo, as sessões desse usuário são encerradas imediatamente. As respostas que carregam informações de sessão não são armazenadas em cache pelo navegador e também é possível sair pelo cookie. Para mais detalhes, veja o guia de Configurações.
Tipos de arquivo enviados
Todo arquivo que você envia ao programa (anexos de documentos, imagens de produtos e cadastros, anexos de produção e de qualidade, documentos de expedição, imagens de OCR de notas fiscais, fotos de depósito e de campo) passa por uma lista de tipos permitidos. Tipos aceitos: pdf; imagens (jpg, jpeg, png, gif, webp, bmp, tif, tiff); texto (txt, csv); arquivos de escritório (docx, xlsx, pptx, odt, ods) e zip. Os anexos de engenharia e os arquivos de produção também aceitam tipos de desenho técnico (dwg, dxf, step/stp, iges/igs, stl). html, htm, svg, js, exe, bat, ps1, msi e todo tipo que não esteja na lista são recusados.
Não se confia apenas na extensão: o conteúdo do arquivo deve corresponder à extensão. Um arquivo chamado resim.jpg que na verdade contém uma página da web ou um script é recusado (“… o conteúdo do arquivo não corresponde ao tipo .jpg. Envie o arquivo no formato original; tipos permitidos: …”). Um nome sem extensão ou com extensão desconhecida retorna “não foi possível determinar o tipo do arquivo: o nome deve terminar com uma extensão permitida (por exemplo, documento.pdf)”; um arquivo grande demais retorna “Arquivo grande demais (tamanho; limite …)”. Um arquivo recusado não é salvo nem anexado ao documento.
Ao baixar, o arquivo sempre é baixado como arquivo; nunca é executado como página no navegador. Imagens e PDFs cujo conteúdo foi verificado podem ser abertos na tela como pré-visualização. Para um arquivo ou imagem que não existe, aparece uma frase de 404 como “Imagem não encontrada.” Se precisar compartilhar um documento em formato HTML ou SVG, converta-o para PDF e envie o PDF.
Alguns canais têm sua própria lista mais restrita: o envio de OCR de notas fiscais (PDF, JPG, PNG e XML de nota eletrônica; um XML que contenha script, html ou svg é recusado), os anexos de solicitações do portal do cliente (JPEG, PNG, WebP; em uma solicitação de pagamento também PDF; no máximo 2 MB), a foto de entrega e de devolução da expedição e a assinatura (PNG, JPEG, WebP, GIF; svg e html são recusados), a assinatura de cautela de ativos (PNG ou JPEG) e o envio de extrato bancário (PDF, XLS, XLSX, CSV, MT940; é apenas lido, não é armazenado).
Códigos de erro de login e senha (integrações)
Para integrações: um nome de usuário ou senha incorretos no acesso retornam 401 com o código KIMLIK_HATALI; uma senha atual incorreta ao alterar a senha retorna 401 e MEVCUT_PAROLA_HATALI (a sessão não é derrubada). O freio de acesso retorna 429 e o cabeçalho Retry-After informa, em segundos, o tempo de espera restante: no máximo 15 minutos para o bloqueio de conta e no máximo 5 minutos para o freio por computador (IP); enquanto o bloqueio durar, o tempo restante diminui a cada requisição. O bloqueio de PIN do portal do funcionário e do terminal MES usa o mesmo cabeçalho (5 PINs errados → bloqueio de 15 minutos); ao alterar o PIN no terminal MES, um PIN atual incorreto retorna 401 e MEVCUT_PIN_HATALI. As respostas 401/403 dos serviços de mensagens e de conexão bancária também trazem o mesmo corpo dos demais pontos: hata, kod, degerler.
O bloqueio de período é uma única trava
O bloqueio de data nas travas de segurança, o bloqueio de período na aba Contabilidade › Períodos e o bloqueio de período em Configurações › Controles corporativos são a mesma trava: documentos, recibos e movimentos de estoque com data em um mês bloqueado ou encerrado não podem ser lançados, editados, excluídos nem movidos para outra data (409). A frase de recusa diz “O/a {belgeTuru} datado(a) de {tarih} cai no período contábil bloqueado {donem}; primeiro desbloqueie o período informando um motivo.” Aplicar e remover a trava exige um motivo de pelo menos 5 caracteres; o motivo aparece em Painel › Auditoria, na linha “Trava de segurança — registro”. Detalhes: Contabilidade › Bloqueio de período.
A abrangência não se limita mais aos documentos contábeis: borderô/recebimento/endosso de cheques, movimentações de consignação, finalização no MES, produção direta, linhas de extrato bancário, saída da quarentena e lançamentos de recursos humanos (adiantamentos, ausências, faltas, horas extras, marcações de ponto, fechamento do dia) passam pelo mesmo controle. Detalhes: Contabilidade › Bloqueio de período.
Graus de sigilo e necessidade de conhecer
Em empresas que atuam em defesa, os anexos de arquivo e os projetos são filtrados por grau de sigilo: público < interno < reservado < secreto. Um usuário sem o grau necessário não vê o registro NEM NA LISTA, porque a existência de um documento já é informação. Esta trava não tem saída visível e todo acesso recusado é gravado na trilha de acesso. Detalhes: Rastreabilidade em Defesa → Necessidade de conhecer.
Guias relacionados
- Configurações e Log — Deixar o programa do seu jeitoA 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.
- Departamentos — Um guia do zero para o back officeEsta janela não faz um serviço só; ela mantém lado a lado os livros de dez departamentos diferentes. Não se assuste: ninguém usa os dez.
- 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.