Ajuda › Telas de Lista

Telas de Lista — Contas, Estoque, Notas Fiscais, Pedidos, Orçamentos

O programa tem cinco listas grandes e todas funcionam da mesma maneira. Se aprender uma, conhece as cinco. Esta página trata a lista não como uma "tabela", mas como uma ferramenta feita para encontrar o que você procura: escopo de busca, filtro, ordenação, largura de coluna e abertura do cadastro.

1. Cinco listas, uma só lógica

As cinco janelas abaixo usam o mesmo motor de tabela. A única diferença real entre elas é como os dados chegam — falaremos disso na seção 6.

2. As três zonas da tela

Qualquer lista que você abra, a tela sempre tem três partes. Fixe este mapa na cabeça de uma vez:

3. Busca: primeiro diga "onde procurar"

Ao lado da caixa de busca existe um seletor de escopo. É o botão que os iniciantes mais deixam passar: a maioria das queixas do tipo "não consigo achar" nasce de procurar no escopo errado. Na lista de Contas os escopos são estes:

4. Filtros: o trabalho que a busca não faz

A busca serve para "encontre o registro cujo nome eu sei". O filtro serve para "traga os registros cujo nome eu não sei, mas cuja característica eu conheço" — por exemplo "mostre todos que me devem". O filtro Situação da lista de Contas oferece:

4.1 A coluna Entrega e a data vermelha

A coluna Entrega mostra a data de entrega que você digitou ao lançar o pedido — não é um campo novo, é uma informação que o pedido sempre carregou; agora ela ficou visível na lista. Tem três estados:

4.2 Os quatro filtros — o que exatamente cada um traz?

Os quatro são aplicados no servidor: quem é filtrado é o conjunto inteiro, não a página que você vê, e a quantidade e o total na faixa acima pertencem a esse conjunto filtrado. Os limites do dia são montados pelo calendário local do servidor — se apertar às 21:00, "hoje" ainda é hoje.

4.3 O selo "Faturado Parcialmente"

A coluna Situação é a gêmea da coluna Entrega: a entrega responde quando, a situação responde quanto dele. Você verá três valores:

4.4 A rotina matinal do responsável pela expedição

1. Abra a lista de pedidos e aperte Pronto para expedir na faixa de entrega. A faixa de informações no topo da tela lhe dá dois números: quantos pedidos e quanto dinheiro no total. É o resumo em uma linha da carga de trabalho daquela manhã.
2. Clique no cabeçalho Entrega — para a entrega mais antiga subir ao topo. Assim a lista fica na ordem de urgência: a linha vermelha do alto é o cliente que mais esperou.
3. Olhe a coluna Situação. Nas linhas em que aparece "Faturado Parcialmente" você carregará o restante, não o pedido inteiro — dê duplo clique na linha, abra o Cadastro do Pedido e veja a quantidade que falta.
4. Exporte a lista (o botão CSV da barra de ferramentas — veja a seção CSV) e entregue-a ao depósito. A exportação leva também a coluna Entrega; assim ninguém pergunta de novo, no papel, "qual pedido é para hoje".
5. Salve este arranjo. Clique com o botão direito num ponto vazio da página e salve a predefinição da página: o filtro de entrega escolhido, a ordenação e o período ficam guardados juntos. Na manhã seguinte, ao abrir a janela, a lista já está em "Pronto para expedir" — sem apertar nada.

5. Ordenação e colunas

• Clique no cabeçalho para ordenar

  Um clique ordena em ordem crescente, o segundo passa para a decrescente; uma pequena seta aparece no cabeçalho. A resposta para "quem é o maior devedor?" é: clique duas vezes no cabeçalho Saldo.

• Ajuste a largura da coluna arrastando

  Na borda direita da célula de cabeçalho há uma alça fina. Arraste-a com o mouse (ou com o dedo, numa tela sensível ao toque). Seu ajuste é gravado no servidor por usuário: se amanhã você entrar de outro computador, vem igual, e o arranjo do seu colega continua intacto.

• Abrir o cadastro: um clique ou dois?

  O comportamento muda conforme a lista: nas listas de contas e de estoque, um clique na linha abre o cadastro; nas listas de notas fiscais, pedidos e orçamentos, um clique seleciona a linha e o duplo clique (ou Enter) abre o cadastro. Nas listas de documentos a seleção é proposital — você pode marcar a linha e usar as ações do menu do botão direito. O botão direito abre o menu de contexto em todas as listas (atalhos como copiar ou abrir a janela relacionada).

• Escolha suas colunas — a engrenagem no cabeçalho

  A engrenagem na faixa de cabeçalho (⚙, "Kolonları seç") define quais colunas ficam visíveis: desligue as desnecessárias e reordene as listadas arrastando. A preferência é gravada por janela (por tela) e por usuário — se amanhã você entrar de outro computador, vem igual, e o arranjo do seu colega continua intacto.

Ordenar pela data de entrega

Clique no cabeçalho Entrega: a lista é ordenada pela data de entrega e o segundo clique inverte o sentido. A ordenação também é feita no servidor, ou seja, quem é ordenado é o conjunto inteiro e não a página que você vê — um pedido na página 3 é realmente o de entrega mais tardia. As linhas sem data de entrega são sempre jogadas para o fim; em qualquer sentido que você ordene, nunca verá um bloco de vazios no topo. Essa opção de ordenação só existe nos pedidos — as listas de notas fiscais e de orçamentos não têm o cabeçalho Entrega.

6. Lista completa ou lista paginada?

Há dois tipos de lista e o comportamento deles é um pouco diferente. Saber a diferença é a resposta para "por que a busca aqui é instantânea e ali não":

7. Criar um registro novo a partir da lista

Toda lista tem um botão + Novo … na barra de ferramentas. Na lista de Contas, + Nova Conta abre um pequeno formulário; ao salvar, o cadastro é gravado no HNR e começa com saldo 0. Já nas listas de notas fiscais/pedidos/orçamentos, o botão de novo abre a janela de lançamento de documento correspondente — que tem o seu próprio guia.

8. Três erros frequentes

9. Perguntas frequentes

A lista veio vazia, os dados foram apagados?

Quase nunca. Verifique em ordem: (1) pode ter sobrado um texto antigo na caixa de busca, (2) pode haver um filtro ligado, (3) numa lista paginada você pode estar na última página. Limpe os três; se a lista encher, seus dados estão no lugar.

Bagunçei o arranjo das minhas colunas, dá para desfazer?

As larguras são pessoais e você pode corrigi-las a qualquer momento arrastando de novo; isso não afeta ninguém. Não há dano permanente — o arranjo faz parte da sua visão, não dos dados.

Posso apagar um registro pela lista?

A exclusão exige permissão de administrador e já fica bloqueada nos registros que têm movimento (quando uma conta não pode ser excluída, o programa lhe diz o motivo). O reflexo certo não é apagar, mas inativar o registro ou mudar a situação dele: o histórico não se estraga.

Quantas listas posso manter abertas ao mesmo tempo?

Quantas quiser — cada uma fica como uma janela própria e ganha um ponto embaixo do ícone no dock. Deixar a lista de contas aberta enquanto abre também a lista de notas fiscais e ir e vir entre as duas é uma forma normal de trabalhar.

"Hoje" veio vazio, mas estamos carregando mercadoria hoje.

Quase sempre o motivo é o mesmo: naqueles pedidos não foi escrita data de entrega. Aperte Todos, veja a lista, encontre as linhas com — na coluna Entrega e preencha as datas. O segundo motivo é a entrega não ser hoje, e sim ontem — nesse caso a linha não está em "Hoje", mas em "Atrasados"; para ver as duas de uma vez, use Pronto para expedir.

Por que "Esta semana" não é a semana do calendário?

Porque a expedição é planejada pelos dias que vêm pela frente, não pelo calendário. Se na sexta-feira você olhasse a semana do calendário, sobrariam dois dias de trabalho na sua mão; o problema de verdade, porém, é a carga que não ficará pronta na próxima terça. Por isso "Esta semana" são sete dias a partir de hoje — em qualquer dia da semana que você aperte, ela mostra a semana à sua frente.

Quero o filtro de entrega nas notas fiscais também.

A nota fiscal é um documento já emitido; a promessa de entrega ficou no passado e filtrar não teria sentido. No orçamento também não existe: o orçamento nem pedido é ainda. A faixa foi colocada de propósito só no pedido — é a única lista onde vive o trabalho prometido, mas ainda não feito.

10. Exportação CSV: levar a lista para o Excel

As listas mostram tudo, mas não calculam nada. No momento em que você diz "vou somar o IVA destas 340 notas fiscais e mandar para o diretor", a tela não basta; você precisa levar os dados para o Excel. O caminho para isso é o pequeno botão CSV que fica em toda lista — com uma seta e uma só palavra.

Onde fica o botão

Pode estar em dois lugares; os dois produzem o mesmo arquivo e os dois funcionam pela mesma regra:

O que há no arquivo — e o que não há

Regra em uma frase: o que estiver na tela naquele momento é o que desce. Isso tem três consequências práticas:

1. Se você estreitar o filtro, o arquivo estreita junto

   A caixa de busca, o intervalo de datas, o filtro de situação — tudo se reflete igualzinho no arquivo. Isso não é uma limitação, é uma ferramenta: se você quer a lista "só as notas fiscais canceladas deste mês", monte primeiro essa visão na tela e depois aperte CSV. Não precisa procurar uma tela de relatório separada.

2. Numa lista paginada só descem as linhas carregadas

   A distinção que explicamos na seção 6 serve aqui. Nas telas do tipo lista completa (Contas, Estoque) os dados já estão inteiros no cliente; o CSV entrega a lista toda. Já nas telas paginadas (Notas Fiscais, Pedidos, Orçamentos) eles chegam do servidor aos pedaços, e o CSV exporta só a página carregada naquele instante. Se quiser tudo, primeiro role para baixo e carregue as páginas, ou estreite o filtro para caber numa página só — a faixa de rodapé já informa quantos registros estão carregados.

3. As colunas de selo e de botão vêm vazias

   Se uma coluna mostra um selo colorido ou um botão de ação (🖨, "Abrir", uma luz de situação), não há equivalente no Excel e a célula desce vazia. Isso não é uma falha, é uma decisão consciente: no arquivo entram apenas números e texto. A informação de situação em geral também aparece por extenso em outra coluna; use essa.

"Seç modu" e "CSV (seçili)" na lista de notas fiscais

Às vezes o que você quer não se descreve com um filtro: "estas três notas fiscais mais aquelas duas de baixo". Na lista de notas fiscais existe o Seç modu para isso. Ao ligá-lo, você clica nas linhas e faz uma seleção múltipla; o botão CSV (seçili) que aparece ao lado baixa apenas o que você selecionou, com o nome faturalar-secili.csv. O botão CSV normal ignora a seleção — ele sempre exporta a página visível.

Abrir o arquivo no Excel

O arquivo é gerado num formato que o Excel com configuração regional turca consegue abrir com duplo clique. Para isso, foram feitas três escolhas pequenas, mas críticas:

As datas descem sempre no formato DD.MM.AAAA. Os valores sentinela que, nos registros antigos do HNR, significam "sem data" (como 1900 ou 31.12.1999) passam ao arquivo como célula vazia — assim, ao ordenar no Excel, uma data inventada não se instala no topo da lista.

11. Glossário de termos

11. Botão direito › "Copiar diretamente (novo documento)" — a diferença para "Abrir uma cópia"

Nas listas de Orçamento, Pedido e Nota Fiscal, ao clicar com o botão direito numa linha, há dois itens vizinhos no menu. Abrir uma cópia abre a janela de edição, como antes: você troca os itens, corrige a data e depois manda Salvar. Já Copiar diretamente (novo documento) não abre janela: depois de uma pergunta de confirmação, grava um documento novo com a data de hoje numa única requisição e mostra o aviso "Origem #x → novo #y · n itens". É ideal para pedidos que se repetem, a mesma nota fiscal todo mês, o "igual ao da semana passada".

Permissão: o direito de gravar aquele tipo de documento — a cópia passa pelas mesmas travas de um documento digitado à mão. O documento de origem nunca muda. Se você der duplo clique, a segunda requisição responde "já existe" e mostra o mesmo documento novo. Erros: 404 se a origem foi apagada, 422 se a origem não tem itens, e a pergunta de estoque negativo do lançamento de documentos se o estoque for ficar negativo.

12. A linha "Máximo sugerido" ao Faturar

Ao faturar o pedido, se o estoque não for suficiente ou o saldo do pedido for ultrapassado, o programa para (422). Antes a mensagem só dizia "insuficiente"; agora, abaixo da faixa de erro, há a linha Máximo sugerido: "item 1 STK-01: no máximo 0 (solicitado 4)". Na ultrapassagem, o máximo é o saldo do pedido; no estoque negativo, é o disponível no depósito (não desce abaixo de zero). Reduza a quantidade para esse valor e tente de novo ou, se tiver permissão, marque a caixa de aprovação de estoque negativo / remessa excedente.

13. Pedidos › "Faturar os prontos para expedir"

O filtro "Pronto para expedir" da seção 4 mostra os pedidos; o botão Faturar os prontos para expedir, no alto da janela de Pedidos, seleciona e fatura em lote: escolha a data, olhe o selo de estoque (suficiente / insuficiente / indefinido), por padrão só os que têm estoque suficiente vêm marcados, mande Faturar e leia o resultado pedido a pedido. Explicação passo a passo e tabela de erros: Guia de vendas, seção 18.

14. A lista de estoque dividiu-se em três famílias: Estoque · Despesa · Peças de Reposição / Equipamentos

Todo cadastro de estoque agora tem um Tipo, e o tipo coloca o cadastro em uma de três famílias. Cada família é listada na sua própria janela; as três usam o mesmo motor de lista (busca, filtro de grupo, ordenação, seletor de colunas, CSV) — o que muda é apenas quais cadastros aparecem e quais colunas/campos fazem sentido.

14.1 Um único bloco no dock, três ícones

Clique no bloco Estoque / Depósito do dock; na faixa inferior aparecem os ícones Estoque, Despesa e Peças de Reposição / Equipamentos (junto com Depósitos). As três janelas são a mesma tela — ela lista os cadastros da família cujo ícone você usou. A permissão é comum: o usuário que consegue ver a lista de Estoque também vê as outras duas; não é preciso liberar uma permissão à parte.

14.2 Chips de tipo e os cadastros antigos "Sem classificação"

Logo abaixo da barra de ferramentas há uma faixa de chips: à esquerda o nome da família, depois Todos e cada tipo da família — ao lado de cada chip está o número de cadastros daquele tipo. Ao clicar num chip a lista se estreita naquele tipo; clicando no mesmo chip de novo, o estreitamento é desfeito. Os números são independentes do filtro de grupos; são contados a partir da lista completa, de modo que a pergunta "quantos produtos acabados há nesta família" sempre dá a mesma resposta.

Os cadastros antigos, aos quais ainda não se deu um tipo, têm o tipo vazio. Eles contam na família estoque (ou seja, o comportamento antigo é preservado: mantêm estoque) e, na janela de Estoque, aparecem também sob um chip Sem classificação. Esse chip só é desenhado na janela de Estoque e só quando existem cadastros assim. Para atribuir um tipo, abra o cadastro › Editar › Tipo. Esquecer de atribuir o tipo não estraga os dados — o cadastro apenas continua aparecendo na lista errada.

14.3 "+ Nova Despesa" e "+ Novo Cadastro" — o diálogo se ajusta à família

O nome do botão de novo cadastro muda conforme a janela: no Estoque, + Novo Estoque; na Despesa, + Nova Despesa; em Peças de Reposição / Equipamentos, + Novo Cadastro. O diálogo que abre oferece apenas os tipos daquela família (a lista suspensa Tipo) e simplesmente não desenha os campos sem sentido para a família:

• No cadastro de Despesa não há Preço 1 nem Código de barras (despesa não se vende nem se lê na prateleira); a Retenção permanece — é necessária nas compras de sucata e de serviços. O texto de dica da caixa Unidade muda para despesa: "kWh, m³, MÊS, HORA".
• No cadastro de Peça de Reposição / Equipamento não há Preço 1 nem Retenção (máquina não se vende e na compra dela não há retenção); o código de barras permanece.
• Um campo oculto nunca é escrito no corpo da requisição; o servidor usa o padrão de fábrica dele. Os demais campos são iguais em todas as famílias: Código de Estoque (no máximo 30 caracteres, único), Descrição (obrigatória), Unidade, IVA % (0–100), Retenção (0–10, sistema x/10).
• Ao salvar, o diálogo se fecha e a janela do cadastro criado se abre; a lista também é atualizada. Se o código já existir, o servidor diz isso claramente e o cadastro não é criado.

14.4 O painel Acompanhamento de Despesas — despesa a partir das compras

Como os cadastros de despesa não mantêm estoque, a resposta para "quanto pagamos de energia elétrica" não está no disponível, e sim nas compras. O botão Acompanhamento de Despesas, que só existe na barra de ferramentas da janela de Despesa, traz um painel que abre dentro da janela (não abre outra janela; ao mandar Fechar, a lista fica exatamente onde estava).

• Intervalo de datas — as caixas Início e Fim; ao abrir, vem do começo deste ano até hoje. Os números se renovam no instante em que você muda.
• Sem IVA / Com IVA — é um botão único; ao clicar, alterna entre os dois modos e a tabela e as barras mudam juntas. O número que vai para a contabilidade é o sem IVA.
• Total do período — na ponta direita da faixa; a resposta em um único número para o intervalo escolhido.
• Despesa mensal — barras horizontais, mês a mês. Se num mês as devoluções superarem as compras, a barra daquele mês é desenhada em vermelho.
• Extrato do mês — se você clicar na barra de um mês, os itens daquele mês se abrem logo abaixo: Data · Código · Conta · Documento · Quantidade · Preço · Valor. A lista é limitada aos cadastros selecionados e ao intervalo de datas do painel; ao clicar numa linha que tem vínculo de documento, a nota fiscal ou a nota de remessa se abre, e as devoluções de compra são escritas em negativo (em vermelho). O total no alto à direita acompanha o botão de IVA. Clicar de novo no mesmo mês ou mandar Fechar fecha o extrato; mudar o intervalo de datas também fecha. O limite do extrato é de 5.000 linhas.
• A tabela por cadastro — Código · Descrição · Tipo · Quantidade · Devolução · Valor líquido. Ao clicar numa linha, a janela daquele cadastro se abre na aba Movimentos; ali você vê, documento a documento, de onde veio o total.
• Seleção de cadastros — ao marcar a caixa no início de cada linha, as barras mensais, o extrato do mês e o total no alto à direita passam a ser calculados apenas com os cadastros selecionados; o título deixa de ser "Total do período" e vira "Total selecionado · 3/12", e as linhas não selecionadas ficam esmaecidas. Todos remove a seleção e volta a contar tudo, Nenhum esvazia a seleção; dar duplo clique numa linha seleciona apenas aquele cadastro. Clicar na caixa não abre o cadastro — para abrir o cadastro, clique na própria linha.

Enquanto nenhum cadastro estiver selecionado, o extrato do mês não traz números e diz "Nenhum cadastro selecionado — selecione cadastros abaixo."; e, se naquele mês não houver nenhum item, escreve "Não há itens neste mês." A seleção fica no painel: mesmo que você mude as datas, os cadastros marcados são preservados, apenas o extrato do mês aberto é fechado.

Os cabeçalhos das colunas do extrato do mês — Data · Código · Conta · Documento · Quantidade · Preço · Valor — são clicáveis. Clicar num cabeçalho ordena o extrato por aquela coluna: as colunas numéricas (Quantidade, Preço, Valor) vêm do maior para o menor no primeiro clique — quem olha o valor procura o item grande —, enquanto as colunas de texto seguem a ordem alfabética A→Z das letras turcas. Clicar uma segunda vez no mesmo cabeçalho inverte o sentido; no cabeçalho da coluna ativa fica a marca ▲ ou ▼. A ordenação é feita inteiramente na tela: nenhuma requisição nova vai ao servidor, o limite de linhas não muda e as linhas de valores iguais preservam a ordem em que o servidor as trouxe. A ordenação escolhida por você continua valendo quando passa para outro mês.

O painel Acompanhamento de Despesas segue o filtro de grupos da janela. Se você abrir o painel com um grupo principal ou um subgrupo selecionado no painel Grupos à esquerda, os números são calculados apenas com os cadastros visíveis na lista naquele momento — é assim que se faz «o acompanhamento das despesas daquele grupo». Na faixa de parâmetros aparece um chip azul dizendo isso: «Grupo principal: operação · todos os seus subgrupos · 12», «Grupo: energia elétrica, água · 5» ou, no modo Fora dos grupos, «Fora do grupo: … · 9»; o número ao final é a quantidade de cadastros daquele escopo que tiveram compra neste período. O título no alto à direita também passa de Total do período para Total do grupo, para você não confundir de onde veio o número.

O botão Todos os cadastros, ao lado do chip, remove o filtro temporariamente: o painel volta a todos os cadastros de despesa, o chip aparece riscado e o nome do botão vira Somente os do grupo — ao apertá-lo, você retorna ao filtro da janela. Cada vez que você vira essa chave, a seleção de cadastros é zerada e o extrato do mês aberto se fecha, porque o conjunto de cadastros é montado do zero. Se os cadastros do grupo selecionado não tiverem nenhuma compra naquele período, o painel diz «Os cadastros do grupo selecionado não têm compra neste período — você pode remover o filtro com "Todos os cadastros".» Enquanto não houver nenhuma seleção no painel Grupos, o chip também não aparece: o painel conta todos os cadastros de despesa, como antes.

À direita das barras mensais fica um gráfico de anel (pizza): a distribuição das despesas do mês selecionado por cadastro. O título dele diz quais dados estão sendo desenhados — com um mês selecionado, Distribuição do mês · 2026-03; com o intervalo inteiro desenhado, Distribuição do período. Quando o painel abre pela primeira vez, nenhum mês está selecionado; nesse estado a pizza mostra o último mês. Se você clicar na barra de um mês, abre-se o extrato de itens daquele mês e a pizza passa para aquele mês; qual mês está sendo desenhado você percebe pela pequena marca ◉ no fim da linha do mês. O botão Todo o período no título abandona a seleção de mês e reúne todo o intervalo de datas escolhido numa única pizza.

Na pizza, os oito cadastros maiores viram fatias separadas, e os demais são reunidos na fatia Outros. Na legenda à direita estão a cor de cada fatia, o código do cadastro, o valor e a porcentagem; no centro do anel fica o total do mês selecionado — ou, quando todo o período está desenhado, o total do intervalo inteiro, com a palavra PERÍODO. A seleção de cadastros e a chave Sem IVA / Com IVA também valem para a pizza: só os cadastros marcados viram fatias e os valores são escritos no modo escolhido. A pizza não envia nenhuma requisição separada ao servidor; deriva os números da divisão mensal da tabela de cadastros, por isso trocar de mês não traz espera. Se no mês selecionado não houver nenhuma despesa, no lugar da pizza aparece "Não há despesa neste mês."; se o intervalo inteiro estiver vazio, "Não há despesa neste período."

Os números vêm dos itens das notas fiscais e das notas de remessa de compra: a compra é somada, a devolução de compra é subtraída; o valor líquido é a diferença entre as duas. A fórmula do valor é a mesma do lançamento de documentos — preço × câmbio × quantidade × (100 − desconto) ⁄ 100. Comprovantes de armazém, inventários e movimentos de produção não são contados; não são compras.

14.5 Quais colunas somem da lista?

As colunas básicas são as mesmas em todas as famílias — Código · Descrição · Unidade · Tipo — mas as que não fazem sentido simplesmente não são desenhadas: na janela de Despesa somem Preço 1 e Disponível, na janela de Peças de Reposição / Equipamentos some Preço 1. A sua escolha de colunas na engrenagem é guardada separadamente para cada janela e uma não sobrescreve a outra. O botão CSV também dá nomes de arquivo diferentes conforme a família: stok-listesi.csv, gider-kartlari.csv, ekipman-kartlari.csv.

Quais abas e seções ficam ocultas na tela do próprio cadastro é explicado na seção 12 do guia do Cadastro de Estoque.

15. Grupos de estoque: adicionar e excluir, vários grupos principais, arrastar e soltar

O painel Grupos, à esquerda da janela de Estoque, já não é apenas um filtro: é onde você administra os próprios grupos. Ali você cria e exclui grupos principais e subgrupos, vincula um subgrupo a vários grupos principais e arrasta cadastros de estoque para dentro de um grupo. O mesmo painel na janela de Contas continua somente leitura — os botões de administração só aparecem no Estoque.

15.1 Grupo principal e subgrupo — os nomes já não levam marcador

Os grupos têm duas camadas. Em cima ficam os grupos principais (por exemplo «tubos», «bombas») e, abaixo deles, os subgrupos vinculados àquele grupo principal. Um cadastro de estoque só é membro de um SUBGRUPO; o grupo principal não carrega associação, é um título que reúne os subgrupos abaixo dele.

No antigo programa de desktop, os nomes dos grupos principais eram guardados no banco de dados com um ponto de exclamação e apareciam assim também na tela: «!tubos». Agora o marcador fica apenas no formato de ARMAZENAMENTO; no painel, nas listas e nos relatórios você vê o grupo principal pelo nome: «tubos». A única regra que decorre disso é esta: um nome de grupo novo não pode COMEÇAR com ponto de exclamação — se tentar, a caixa diz «O nome do grupo não pode começar com '!'» e nada é gravado.

Um subgrupo pode ser vinculado a mais de um grupo principal. O subgrupo «juntas» pode aparecer tanto em «tubos» quanto em «bombas»; o cadastro entra uma vez e é encontrado pelos dois ramos. Os subgrupos que não estão vinculados a nenhum grupo principal não se perdem: continuam visíveis na entrada Subgrupos sem vínculo, abaixo da lista de grupos principais.

15.2 Adicionar e excluir: «+», «×» e a faixa de confirmação

O botão «+» à direita dos títulos «Grupos Principais» e «Subgrupos» abre uma pequena caixa de nome na própria linha: digite, Enter grava, Esc desiste. A exclusão começa pelo «×» que aparece ao passar o cursor sobre a linha e não acontece de imediato — primeiro surge uma faixa de confirmação que escreve, com números, o que vai acontecer.

• Novo grupo principal — o «+» do título «Grupos Principais». Digite o nome e dê Enter; o grupo é criado e fica selecionado na hora, pronto para você acrescentar subgrupos embaixo dele.
• Novo subgrupo — selecione primeiro um grupo principal, depois o «+» do título «Subgrupos». A caixa sugere apenas os subgrupos DESTA LISTA (subgrupos de outra lista nunca aparecem aqui): se você digitar um nome novo, o subgrupo é criado e vinculado a este grupo principal; se escolher da lista um nome já existente, nenhuma definição nova é criada — aquele subgrupo apenas fica VINCULADO também a este grupo principal. O aviso diz qual dos dois aconteceu: «Subgrupo adicionado» ou «O subgrupo existente foi vinculado a este grupo principal».
• Eliminar um grupo principal — a faixa «×» pergunta «pipes — eliminar grupo principal?» e explica as perdas: «Serão removidas 3 ligações a subgrupos · ficará 1 subgrupo sem ligação». Só se eliminam a definição do grupo principal e as suas ligações; os subgrupos e as associações de artigos ficam intactos. Os subgrupos sem ligação a outro principal passam para «Subgrupos sem ligação».
• Excluir um subgrupo — a faixa oferece dois botões. Retirar apenas deste grupo principal desfaz somente o VÍNCULO: a definição do subgrupo e as associações dos cadastros permanecem, e o subgrupo continua aparecendo nos outros grupos principais em que estiver. Já Excluir por completo (N) remove de uma vez a definição, todos os vínculos com grupos principais e N associações de estoque. O título da faixa mostra os números antes de você decidir: «12 associação(ões) de estoque · 2 vínculo(s) de grupo principal (tubos, bombas)».
• Retirar os selecionados em lote — o botão −, ao lado do botão + no título de subgrupos, retira do GRUPO PRINCIPAL aberto no momento os subgrupos que você marcou nas caixas de seleção; é a forma em lote da operação × → «Retirar apenas deste grupo principal» da linha. Sem nenhum subgrupo selecionado o botão fica inativo, no modo «Subgrupos sem vínculo» ele não aparece de jeito nenhum e depende da permissão pode excluir grupos. Ao clicar, abre-se uma faixa de confirmação intitulada «tubos» — retirar os 3 subgrupos selecionados?: ela lista os nomes e diz «Apenas o vínculo é desfeito; a definição do subgrupo e suas associações permanecem.» O botão Retirar os selecionados executa e, ao terminar, diz «3 subgrupos foram retirados deste grupo principal». Se alguns falharem, aparece a linha «1/3 subgrupo não pôde ser retirado — nome: motivo» e a faixa continua aberta com os nomes restantes; você pode corrigir e tentar de novo.
• Subgrupos sem vínculo — a entrada abaixo da lista de grupos principais. Essa entrada também é específica da lista: reúne apenas os subgrupos sem vínculo que pertencem a esta lista. A partir daqui você exclui por completo um subgrupo que ficou sem vínculo ou seleciona um grupo principal e o vincula de novo digitando o nome dele no «+». Enquanto essa entrada estiver aberta, acrescentar subgrupo fica desativado (não há grupo principal a que vincular).
• Permissões — os botões «+» dependem da permissão operações de grupo e os botões «×» da permissão pode excluir grupos. Se você não tiver a permissão, o botão simplesmente não é desenhado; o painel continua funcionando como filtro, como antes. No administrador, as duas estão liberadas.

Os grupos agora são separados por lista. As janelas de Estoque, Despesa e Peças de Reposição/Equipamentos veem cada uma apenas os SEUS grupos principais, os SEUS subgrupos e a sua própria entrada Subgrupos sem vínculo: se «tubos» foi criado na lista de estoque, ele não aparece de jeito nenhum na janela de despesa. Um grupo principal novo é gravado na família da janela em que foi criado; todos os grupos que já existiam antes contam na família «estoque». A lista Associações de Grupo do cadastro de estoque também é filtrada pela família do cadastro.

A separação é completa: as listas não veem os grupos umas das outras, e não existe uma operação para mover grupos entre listas. As sugestões do campo de subgrupo incluem apenas os desta lista. Se tentar usar um nome já definido noutra, o servidor recusa: «gaskets está definido noutra lista, Fichas de artigos — as listas não veem os grupos umas das outras; use outro nome nesta lista». O texto entre parênteses identifica a lista; escolha outro nome aqui. Um subgrupo sem ligação não se perde nem muda de lista: permanece na lista do último grupo principal a que esteve ligado, em Subgrupos sem ligação. Subgrupos muito antigos, sem registo de família, contam na lista Fichas de artigos.

15.3 Associação por arrastar e soltar e pelo botão direito

O caminho mais curto para colocar um cadastro de estoque num grupo: pegue a linha da lista e solte-a sobre uma linha de SUBGRUPO no painel da esquerda. A linha de destino é marcada com uma moldura azul; ao soltar, o sistema diz «Adicionado ao grupo» e a lista é atualizada. Você não pode soltar sobre a linha de um grupo principal — a associação só existe no subgrupo, e a linha do grupo principal não aceita o arraste.

O gêmeo da mesma operação, para teclado e toque, está no menu do botão direito. Com um ou vários subgrupos selecionados no painel da esquerda, clique com o botão direito numa linha da lista: aparecem os comandos Adicionar aos grupos selecionados (N) e Retirar dos grupos selecionados (N), em que N é o número de subgrupos selecionados. Se a gravação falhar, o sistema diz «Não foi possível gravar a associação de grupo» e o motivo vem escrito no corpo.

A mesma lógica de arraste funciona para os PRÓPRIOS subgrupos: pegue uma linha de subgrupo no painel da esquerda (ao passar o cursor, aparece uma alça ⋮⋮ à esquerda) e solte-a sobre outro grupo principal da lista Grupos Principais — o subgrupo passa a ser vinculado TAMBÉM àquele grupo principal. O grupo principal de destino é marcado com uma moldura azul e, ao soltar, o sistema diz «O subgrupo foi vinculado também ao grupo principal»; se já estiver vinculado, escreve «O subgrupo já está neste grupo principal». Só o vínculo é acrescentado, nada é copiado: a definição do subgrupo, as associações de estoque e o vínculo anterior com o grupo principal ficam como estavam — um único subgrupo aparece em vários grupos principais. Soltar sobre o próprio grupo principal em que você está é ignorado. As linhas da entrada «Subgrupos sem vínculo» também podem ser arrastadas; ao soltar uma delas num grupo principal, ela deixa de estar sem vínculo e sai daquela lista. O arraste depende da permissão operações de grupo. Para remover um vínculo, use o × da linha do subgrupo → «Retirar apenas deste grupo principal»; para retirar vários subgrupos de uma vez, selecione as linhas e use o botão − do título.

15.4 A chave «Os do grupo | Fora dos grupos | Todos» — encontrar e acomodar os cadastros sem grupo

Na barra de ferramentas há uma chave de TRÊS posições. Os do grupo é o comportamento de sempre: lista os membros dos subgrupos selecionados. Fora dos grupos traz o INVERSO da mesma seleção — os cadastros que NÃO são membros dos grupos selecionados. Todos mostra os dois de uma vez: a lista não é depurada, todos os cadastros continuam no lugar, e os que são membros ficam marcados com um pequeno selo na linha. A faixa de selo escreve o modo com todas as letras: «Fora do grupo: tubos, bombas».

A utilidade de verdade aparece quando NENHUM subgrupo está selecionado: então «Fora dos grupos» = os cadastros que não são membros de nenhum grupo, ou seja, os sem grupo; no selo está escrito «Cadastros sem grupo». O fluxo é este: coloque a chave em «Fora dos grupos», esvazie a seleção e arraste os cadastros que aparecerem para os subgrupos do painel da esquerda — a cada um que você soltar, o cadastro sai da lista e ela encurta. Quando, no fim, você vir a frase «Não há estoque sem grupo — todos os cadastros pertencem a um grupo», o trabalho acabou. Se a lista se esvaziar enquanto você trabalha com grupos selecionados, a mensagem é «Não há estoque fora dos grupos selecionados».

Escopo do grupo principal: se no painel da esquerda houver um GRUPO PRINCIPAL selecionado, mas você não tiver marcado nenhum subgrupo dele, a chave passa a atuar sobre TODOS os subgrupos daquele grupo principal: «Os do grupo» traz os cadastros que são membros de qualquer subgrupo do grupo principal, «Fora dos grupos» traz os que não são membros de nenhum deles, e «Todos» lista tudo e marca os membros com o selo Membro. A faixa escreve isso como «Grupo principal: tubos · todos os seus subgrupos» (ou, conforme o modo, «Fora do grupo principal: …» ou «Todos — membros do grupo principal marcados: …»). Assim que você marcar um dos subgrupos, o escopo se estreita e, como antes, vale apenas o conjunto de subgrupos marcados.

No modo Todos, em vez de depurar, faz-se a MARCAÇÃO. Se houver ao menos um subgrupo selecionado, os membros desses grupos levam na linha o selo Membro (ao passar o cursor sobre o selo, lê-se «Membro dos grupos selecionados»); se não houver nenhum grupo selecionado, então são os cadastros que não pertencem a nenhum grupo que ficam marcados, com o selo Sem grupo. A faixa também dá os números: «Todos — membros marcados: tubos, bombas · 2908 estoque · 15 membros / 2893 não»; sem grupo selecionado, o título vira «Todos — cadastros sem grupo marcados». Esse modo responde à pergunta «em quais grupos este cadastro está?» sem estreitar a lista — ao procurar um código, você vê na mesma tela tanto o que é membro quanto o que não é.

Quando você seleciona um subgrupo, uma pequena cópia da mesma chave também aparece na faixa de grupo acima da lista; assim, para mudar de modo, não é preciso voltar à barra de ferramentas. À direita da faixa, se você tiver permissão de gravação de grupos, fica a dica «Arraste a linha e solte-a num grupo»; ao passar o cursor, ela explica «Solte a linha sobre o nome de um subgrupo no painel da esquerda». A dica fica oculta no modo «Os do grupo» — ali todas as linhas já são membros.

15.5 A barra divisória do painel — redimensionar as áreas de grupo principal / subgrupo

Quando você seleciona um grupo principal, aparece no painel uma barra horizontal fina e arrastável entre Grupos Principais e Subgrupos. Puxar a barra para cima diminui a área dos grupos principais e abre espaço para os subgrupos; puxar para baixo faz o contrário. O duplo clique iguala as duas áreas de novo (50% / 50%). Você pode focar a barra com Tab e movê-la de cinco em cinco pontos com as teclas ↑ e ↓. A proporção fica presa entre 12% e 88%, ou seja, nenhuma área se fecha por completo.

A proporção escolhida é lembrada no navegador: ela continua igual quando você fecha e reabre a janela, e também nas outras janelas de lista. Essa comodidade pertence apenas àquele navegador — não é gravada no servidor, então, ao abrir em outro computador, você começa com o arranjo padrão de meio a meio. A barra só aparece enquanto há um grupo principal selecionado; com a lista de subgrupos fechada, não há o que dividir.

15.6 Gráficos de Vendas — a curva de venda / compra do período para o grupo selecionado

O botão Gráficos de Vendas, na barra de ferramentas, fica ativo quando você seleciona um subgrupo ou um grupo principal no painel da esquerda; enquanto nenhum estiver selecionado, ele fica esmaecido e, ao passar o cursor, diz «Selecione antes um grupo ou um grupo principal no painel da esquerda». O painel abre como uma camada DENTRO da janela e, com Fechar, você volta à lista. O escopo vem do filtro de grupos da janela: qualquer que seja o modo em que você esteja (Os do grupo / Fora dos grupos), o gráfico descreve esse mesmo conjunto. Este painel é o gêmeo, no estoque, do Acompanhamento de Despesas do item 14.4 — a mesma lógica, rodando sobre os cadastros de estoque do escopo em vez dos cadastros de despesa.

Na linha de cima ficam as datas de Início e Fim, a chave Venda | Compra, o botão Sem IVA / Com IVA e o chip de escopo. «Venda» conta os itens das notas fiscais e das notas de remessa de venda (saída); «Compra», os das notas fiscais e notas de remessa de compra (entrada). O chip de escopo escreve claramente o que está sendo somado: «Grupo: tubos, bombas · 12»; com um grupo principal selecionado, «Grupo principal: tubos · todos os seus subgrupos · 522»; no modo inverso, «Fora do grupo: …»; o número ao final é a quantidade de cadastros no escopo. Na ponta direita lê-se Venda · total do período (na compra, Compra); quando você seleciona cadastros, o título passa a Total selecionado. Os critérios de valor são exatamente os mesmos dos Relatórios de Grupo — no mesmo intervalo, as duas telas dão o mesmo número.

No meio ficam as barras mensais e, à direita delas, a pizza. Cada linha de mês mostra o valor daquele mês pelo comprimento da barra; ao passar o cursor, aparecem a quantidade e o número de itens. Ao clicar num mês, a pizza da direita passa para aquele mês e seu título vira «Distribuição do mês · 2026-03»; clicar de novo no mesmo mês, ou o botão Todo o período, devolve a pizza ao intervalo inteiro («Distribuição do período»). A pizza desenha os oito itens de estoque maiores como fatias separadas e reúne o restante na fatia «Outros». Se não houver nenhum movimento no período, o painel diz «Não há venda dos estoques do escopo neste período.» (na compra, «Não há compra para os estoques do escopo neste período.»); se no mês selecionado não houver movimento, apenas no lugar da pizza aparece «Não há venda neste mês.».

Embaixo fica a tabela Por cadastro: cada linha traz o código, a descrição, o tipo, a quantidade, o número de itens e o valor. A caixa de seleção no início coloca o cadastro na seleção — as barras mensais, a pizza e o total passam a ser calculados apenas com os cadastros marcados; os botões Todos e Nenhum definem a seleção de uma só vez, e dar duplo clique numa linha deixa apenas aquele cadastro. Clicar nos cabeçalhos Código, Descrição, Quantidade e Valor ordena a tabela; o segundo clique inverte o sentido (a setinha mostra a direção). Clicar na linha abre o cadastro na aba Movimentos, ou seja, você desce com um único clique até os documentos que estão por trás do número que vê no gráfico.