Financeiro > Caixa > Consulta de cheques
Consulta de cheques — Financeiro (ERPV1)
A tela Consulta de cheques, do módulo Financeiro (menu Caixa), lista os cheques cadastrados no sistema, próprios e de terceiros, e permite consultar os dados de cada cheque e o histórico das movimentações financeiras ligadas a ele.
Visão Geral
A tela Consulta de cheques, do módulo Financeiro (menu Caixa), lista os cheques cadastrados no sistema, próprios e de terceiros, e permite consultar os dados de cada cheque e o histórico das movimentações financeiras ligadas a ele. A tela é somente de consulta: nenhum dado do cheque pode ser alterado.
O usuário filtra a lista, abre o cheque com duplo clique e, na janela aberta, vê a aba Dados do cheque e a aba Histórico. Para cheques próprios, a janela também permite imprimir o cheque em PDF, Excel ou Word.
Pré-requisitos
- Acesso à tela no menu: a tela aparece em Financeiro > Caixa > Consulta de cheques.
- Carteira logada: o usuário precisa estar logado em uma carteira. Sem carteira selecionada, a tela exibe “Atenção: Nenhuma carteira está selecionada. Para acessar esta rotina, é necessário estar logado em uma carteira.” e não abre.
- Impressão: só cheques próprios podem ser impressos, e o modelo de impressão do cheque precisa existir na instalação do cliente; se faltar, o sistema copia o modelo padrão.
Fluxo Operacional
Fluxo de consulta de cheques
- O usuário abre Financeiro > Caixa > Consulta de cheques com uma carteira logada. A lista abre com 30 cheques por página, ordenados pela emissão mais recente.
- Se precisar filtrar, expande o painel Filtros, preenche os campos desejados e aciona Buscar. A lista é recarregada a partir da primeira página.
- Para voltar à lista completa, aciona Limpar Filtros, que zera os campos e recarrega a lista.
- Para ver os detalhes, dá duplo clique no cheque. A janela “Cheque” abre em modo de visualização.
Fluxo de consulta do histórico do cheque
- Na janela do cheque aberta, o usuário muda para a aba Histórico.
- A grade mostra as movimentações financeiras ligadas ao cheque, carregadas ao abrir a janela.
- O usuário pode ordenar e filtrar a grade, e rolar para o lado para ver todas as colunas.
Fluxo de impressão do cheque
- Na janela do cheque, o usuário aciona Imprimir.
- Para cheque próprio, escolhe Gerar PDF, Exportar Excel ou Exportar Word. No Excel, escolhe também a opção de exportação na janela “Opções de exportação para Excel”.
- O sistema prepara o modelo do cheque e a tela abre o relatório com os dados do cheque.
Interface e Comportamentos da Tela
Lista da Consulta de cheques
A lista da Consulta de cheques mostra uma linha por cheque, com paginação de 30 registros e ordenação feita pelo servidor ao clicar no cabeçalho de uma coluna.
| Coluna | Conteúdo |
|---|---|
| Cheque | Número do cheque |
| Código | Código do participante |
| Participante | Nome do participante |
| Emitente | Nome do emitente do cheque |
| Carteira | Código da carteira (banco ou caixa) |
| Tipo | Tipo do cheque |
| Status | Situação do cheque |
| Emissão | Data de emissão (dd/mm/aaaa) |
| Vencimento | Data de vencimento (dd/mm/aaaa) |
| Valor | Valor do cheque; o rodapé mostra a soma |
Painel Filtros da Consulta de cheques
O painel Filtros da Consulta de cheques fica recolhido ao abrir a tela e pode ser expandido pelo usuário.
| Campo | Comportamento |
|---|---|
| Número do Cheque | Texto; filtra o número exato |
| Participante | Consulta de cadastros gerais |
| Carteira | Consulta de bancos e caixas |
| Tipo | P – Pagar, R – Receber ou T – Todos |
| Status do Cheque | A – Aberto, G – Gerado, C – Cancelado ou T – Todos |
| Data Emissão Inicial / Final | Período de emissão |
| Data Venc. Inicial / Final | Período de vencimento |
| Limpar Filtros | Zera os campos e recarrega a lista |
| Buscar | Aplica os filtros e volta à página 1 |
Os campos Tipo e Status aceitam seleção livre, sem obrigar a escolha de um item da lista.
Janela Cheque da Consulta de cheques
A janela Cheque da Consulta de cheques abre com duplo clique em uma linha. A ação de edição aparece como Visualizar e todos os campos ficam protegidos. A janela tem os botões Imprimir e Fechar.
A aba Dados do cheque reúne os blocos abaixo.
| Bloco | Campos |
|---|---|
| Tipo do cheque | Tipo exibido no topo |
| Dados do cheque | Banda magnética, Cheque Nº, Banco, Agência, Conta, Compensação, Razão Conta |
| Emitente | Nome, CPF/CNPJ |
| Datas | Entrada, Vencimento, Depósito |
| Status do cheque | Status, Emitido, Vínculo |
| Número do documento origem | Documento origem, Filial, Cód. documento, Tipo documento, Série, Número |
| Complementares | Valor, Filial, Participante, Carteira, Observação |
Aba Histórico da Consulta de cheques
A aba Histórico da Consulta de cheques mostra as movimentações financeiras do cheque em uma grade larga, com rolagem horizontal. Ordenação e filtro da grade são feitos na própria tela, sem nova consulta ao servidor. As colunas cobrem filial, número do lançamento, cadastro, datas de lançamento, movimento e conciliação, valores, módulo, série, documento, parcela, status, histórico padrão, rotina, funcionário, contrato, transmissão, recepção, valores anteriores, motivos, documento de conciliação, data e hora, operação financeira, integração e remessa.
Impressão do cheque na Consulta de cheques
O botão Imprimir da janela Cheque abre uma sobreposição com Gerar PDF, Exportar Excel e Exportar Word. A sobreposição se fecha ao clicar fora dos botões. A janela “Opções de exportação para Excel” oferece “Arquivo Excel” (padrão), “Arquivo Excel – Somente dados” e “Somente dados de pasta de trabalho(.xlsx)”, com os botões OK e Cancelar.
Feedbacks ao Usuário
Feedbacks da tela
A Consulta de cheques exibe as mensagens da tela abaixo.
| Situação | Feedback | Texto exato |
|---|---|---|
| Abrir sem carteira | Aviso “Atenção:” | “Atenção: Nenhuma carteira está selecionada. Para acessar esta rotina, é necessário estar logado em uma carteira.” |
| Imprimir cheque que não é próprio | Aviso “Atenção” | “Operação disponível somente para cheques próprios” |
Feedbacks do servidor
| Situação | Erro | Motivo | Solução |
|---|---|---|---|
| Histórico pedido sem identificador do cheque | Não possui histórico | Identificador do cheque em branco | Nenhuma — selecione um cheque da lista e abra-o novamente. |
Processamento pelo Backend
Operações expostas para a tela da Consulta de cheques
| Operação | Função |
|---|---|
| Listagem de cheques | Lista os cheques conforme filtros, ordenação e página, com o total |
| Histórico do cheque | Lista as movimentações financeiras ligadas a um cheque |
| Preparação da impressão | Garante o modelo de impressão do cheque na pasta do cliente |
Sequência da listagem de cheques
- O sistema recebe os filtros, a ordenação e a página pedida.
- Aplica os filtros informados (ver “Regras de Negócio”).
- Monta cada linha com o cheque, o participante, a carteira e os nomes do tipo e do status.
- Ordena em memória pela primeira coluna pedida; sem ordenação, usa a emissão mais recente primeiro.
- Calcula o total e devolve somente a página pedida; se não há registros, devolve a lista vazia.
Sequência do histórico do cheque
- O sistema recebe o identificador do cheque.
- Se estiver em branco, recusa com “Não possui histórico”.
- Caso contrário, busca as movimentações financeiras ligadas ao cheque, com os dados de filial, cadastro, documento, conciliação, motivos e integração.
- O total devolvido é a quantidade de movimentações encontradas.
Sequência da preparação da impressão
- O sistema garante a pasta de documentos do financeiro para o cheque na instalação do cliente.
- Se o modelo do cheque não existe nessa pasta, copia o modelo padrão.
- Devolve sucesso, e a tela abre o relatório do cheque.
Regras de Negócio
Carteira logada obrigatória
A Consulta de cheques só abre com uma carteira logada.
Filtros da Consulta de cheques
Os filtros da Consulta de cheques são combinados entre si: o cheque precisa atender a todos os preenchidos. Número do cheque, participante e carteira são comparados por igualdade. Tipo e Status são ignorados quando vazios ou com T – Todos. O período de emissão usa a data de entrada do cheque, e o período de vencimento usa a data de vencimento, ambos incluindo as datas inicial e final.
Busca por texto livre da Consulta de cheques
O servidor aceita um texto livre de busca, embora a tela não tenha campo para ele. Se o texto é uma data, procura cheques com vencimento ou entrada nessa data. Se contém vírgula e é um número decimal, procura pelo valor. Nos demais casos, procura o texto no número do cheque, no nome e código do participante, no emitente, na carteira e no valor.
Ordenação e paginação da Consulta de cheques
Só a primeira coluna de ordenação é considerada. Ordenação e paginação são aplicadas depois de carregar todos os cheques que atendem aos filtros, o que pode deixar a tela lenta com muitos registros.
Impressão restrita a cheque próprio
A impressão só está disponível para cheques do tipo “Cheque próprio”; para os demais, a tela recusa com aviso.
Cheque somente leitura
Todos os campos da janela Cheque ficam protegidos, e a ação de edição aparece como Visualizar.
Troubleshooting
A tela não abre ao acessar Consulta de cheques
Cenário: A Consulta de cheques não abre quando não há carteira logada.
Mensagem exibida: “Atenção: Nenhuma carteira está selecionada. Para acessar esta rotina, é necessário estar logado em uma carteira.”
O que fazer: faça login em uma carteira e abra a tela novamente.
Imprimir não funciona para o cheque escolhido
Cenário: A impressão da Consulta de cheques só atende cheques próprios.
Mensagem exibida: “Operação disponível somente para cheques próprios”
O que fazer: use a impressão apenas em cheques do tipo “Cheque próprio”.
A lista não mostra o cheque esperado
Cenário: A lista da Consulta de cheques mostra apenas os cheques que atendem a todos os filtros preenchidos.
Mensagem exibida: Nenhuma — a lista vem vazia ou sem o cheque.
O que fazer: acione Limpar Filtros e refaça a busca; confira Tipo, Status e os períodos de emissão e vencimento.
A aba Histórico fica vazia
Cenário: A aba Histórico da Consulta de cheques mostra apenas movimentações financeiras ligadas ao cheque.
Mensagem exibida: Nenhuma — a grade vem sem linhas.
O que fazer: confirme se o cheque já teve movimentação financeira; se não teve, a grade vazia é o comportamento esperado.
Casos de Uso
Caso 1 — Localizar cheques a vencer em um período
Para localizar na Consulta de cheques os cheques que vencem em um período, o usuário expande Filtros, preenche Data Venc. Inicial e Data Venc. Final, escolhe Status Aberto e aciona Buscar. A lista mostra os cheques do período, com a soma do valor no rodapé.
Caso 2 — Conferir o histórico de um cheque
Para conferir o que aconteceu com um cheque na Consulta de cheques, o usuário filtra pelo número do cheque, dá duplo clique na linha e abre a aba Histórico, onde vê as movimentações financeiras ligadas a ele.
Caso 3 — Reimprimir um cheque próprio
Para reimprimir um cheque próprio na Consulta de cheques, o usuário abre o cheque, aciona Imprimir e escolhe Gerar PDF, Exportar Excel ou Exportar Word.