Leia-me — como usar a ferramenta

O que é este sistema

O Gestão de Faturamento é um programa que roda no seu próprio computador e mostra, numa tela só, os pedidos de venda em aberto para faturamento, junto com o estoque, o cliente, o bloqueio e o pedido de compra de cada item. Ele substitui a planilha: os dados vêm do sistema da empresa (o ERP) e ficam guardados aqui para você filtrar, ordenar e exportar sem depender de internet o tempo todo.

As telas (menu no topo)

• Consulta de Dados: a lista completa dos pedidos, boa para procurar e exportar. É aqui que fica o botão Atualizar Dados (que busca no ERP).
• Operação: a mesma lista, com os recursos visuais para trabalhar o dia a dia (ícones de situação, cores, agrupamento por pedido, contadores).
• Pedidos Compras: os produtos que têm mais de um pedido de compra em aberto.
• IA – Análise: um chat para pedir análises sobre os dados baixados.
• Configuração (apenas administrador): Banco de Dados, Usuários, Logs e IA.
• Leia-me: esta página de instruções.

O menu mostra só as telas que o seu usuário pode acessar. Se você não vê algum item, é porque o administrador não liberou aquela tela para você.

Como usar no dia a dia

1. 1Na tela Consulta de Dados, clique em Atualizar Dados (canto superior direito) e escolha o período pela data do pedido. O sistema busca no ERP e guarda aqui. Esse é o único momento em que ele fala com o banco da empresa. Depois de atualizar, as outras telas já usam esses mesmos dados.
2. 2Use os filtros logo acima da tabela (empresa, número do pedido, código do produto, descrição e outros). A tabela atualiza sozinha conforme você digita ou marca. O botão Ocultar filtros recolhe essa área para sobrar mais espaço para a análise.
3. 3Clique no cabeçalho de uma coluna para ordenar. No menu de três pontos (à direita, acima da tabela) você esconde colunas e exporta em CSV (abre no Excel), sempre respeitando os filtros do momento.

Legenda dos ícones (BL, SEP, SI, PI)

Na Operação, as colunas BL, SEP, SI e PI aparecem como ícones, no mesmo padrão do ERP:

• BL bola vermelha: pedido bloqueado.
• BL bola verde: pedido liberado.
• Caixa verde marcada: Sim (em SEP quer dizer Separado; em SI, separação impressa; em PI, pedido impresso).
• Caixa laranja vazia: Não (não separado / não impresso).

BL, SEP, SI e PI são informações do pedido (aparecem só na linha do pedido). Já a coluna Bloq. Item é do item: ao expandir um pedido, cada item mostra a bolinha vermelha quando aquele item está bloqueado. Passe o mouse em cima do ícone para ver o texto por extenso (e o motivo do bloqueio, quando houver).

Cores que chamam a atenção (Operação)

• O número do pedido em vermelho quer dizer que o pedido está bloqueado (BL).
• O campo Lim. Exped. em vermelho quer dizer que a data limite de expedição está no futuro (depois de hoje).
• O Status Recebimento em verde quer dizer “Confirmado Recebimento na Empresa”.

Agrupar por pedido (abrir e fechar)

Na Operação e na Consulta os itens ficam agrupados por pedido. Cada pedido tem uma linha de cabeçalho com o botão + / -:

• Clique no - para retrair um pedido (esconde os itens) e no + para expandir.
• O botão Retrair todos / Expandir todos (acima da tabela) faz isso com a página inteira de uma vez. Do lado dele fica a legenda dos ícones.
• Mesmo retraído, o cabeçalho já mostra a situação do pedido: cliente, empresa, data e os ícones de BL, SEP, SI e PI. Assim você vê tudo sem precisar abrir.
• Cada página traz 30 pedidos, e um pedido nunca fica dividido entre duas páginas.

Estoque por empresa (Matriz e Filial)

A coluna Estoque acompanha o filtro de empresa:

• Com uma empresa selecionada (Matriz ou Filial), o Estoque, o Reservado e o Disponível mostram o valor daquela unidade.
• Com Todas as empresas, os números mostram a soma das duas unidades. Quando o produto tem estoque nos dois locais, a célula do Estoque fica azul e sublinhada: clique nela para abrir uma janela com a quantidade em cada unidade (Estoque, Reservado e Disponível por empresa, mais o total).

Outros cliques especiais na Operação

• Descrição em azul: quando a descrição de um produto aparece azul e sublinhada, é porque ele tem mais de um pedido de compra em aberto. Clique nela para abrir uma janela com os pedidos de compra desse produto, sem sair da tela.
• Reservado: clique no número da coluna Reservado para abrir uma janela mostrando quais pedidos de venda reservaram aquele estoque (com cliente, quantidade, limite de expedição e situação).

Tela Pedidos Compras

Mostra os produtos que têm mais de um pedido de compra em aberto ao mesmo tempo, para você identificar compras repetidas ou em duplicidade. Cada linha é um pedido de compra, e os produtos ficam separados por uma marca. Tem os mesmos filtros de empresa, código do produto, descrição e número do pedido de compra. Você chega nela pelo menu, ou clicando na descrição azul de um item na Operação.

Contadores no topo

Na Operação, ao lado de “Registros no cache”, aparecem Pedidos (quantos pedidos distintos) e Itens (quantas linhas). Eles acompanham os filtros: mudou o filtro, mudam os números.

IA – Análise (chat)

Na tela IA – Análise você escreve uma pergunta sobre os dados já baixados (por exemplo: “quais clientes tem mais pedidos?”, “quantos pedidos estão bloqueados?”, “resumo do estoque por empresa”) e recebe uma resposta em texto. Há sugestões de perguntas para começar.

• A IA analisa os dados que estão no cache (os do último Atualizar Dados). Se a base estiver vazia, atualize antes.
• Para funcionar, um administrador precisa configurar a chave e o modelo em Configuração > IA (só é feito uma vez).

Configuração (apenas administrador)

A tela Configuração só aparece para o administrador e tem quatro partes no submenu:

• Banco de Dados: host, porta, banco, usuário e senha do ERP, com Testar conexão antes de salvar.
• Usuários: criar, editar e excluir usuários. Cada usuário tem um papel (Administrador ou Comum) e, quando Comum, você marca quais telas ele acessa (Consulta, Operação, Pedidos Compras, IA – Análise, Atualizar Dados). O administrador tem acesso total. O administrador inicial (admin) não pode ser excluído.
• Logs: o registro do que cada usuário faz no sistema (entrar, atualizar dados, salvar configuração, mexer em usuário, consultar a IA), com filtros por usuário, ação e período.
• IA: a chave e o modelo da API de IA. A chave fica só neste computador e nunca aparece na tela depois de salva.

Atualizar e limpar a base

• Atualizar Dados (na tela Consulta de Dados): troca a base local pelo período que você escolher. Cada atualização já traz tudo do período (não acumula sujeira) e também recalcula o estoque por unidade.
• Limpar cache (dentro da janela de Atualizar Dados): esvazia a base local para você ter certeza de que o próximo Atualizar começa do zero. Pede uma confirmação antes.

Onde ficam os seus dados

Tudo fica na pasta dados/, dentro da pasta do programa, num arquivo chamado app.db. É só um arquivo: se ele for copiado, seus dados vão junto.

Como fazer backup

Feche o programa e copie a pasta dados/ para um pendrive ou outra pasta segura. Para restaurar, é só colocar a pasta dados/ de volta no lugar. Guarde também o arquivo config.txt (onde ficam os dados de acesso ao ERP), que não vem junto do programa por segurança.

Entrar no sistema

No primeiro uso, o login é usuário admin e senha admin. Troque a senha em Minha conta (ícone ao lado do seu nome, no topo da tela).

Tema claro ou escuro

Use o interruptor de sol/lua na barra do topo. Sua escolha fica salva neste computador.