Devolução de Cheque a Receber 1ª Vez
Devolução de Cheque a Receber 1ª Vez — Financeiro (ERPV1)
A tela Devolução de cheque a receber 1ª vez, do módulo Financeiro (menu Caixa), registra a primeira devolução de um cheque de cliente pelo banco.
Visão Geral
A tela Devolução de cheque a receber 1ª vez, do módulo Financeiro (menu Caixa), registra a primeira devolução de um cheque de cliente pelo banco. O usuário informa a data de lançamento, o documento e o valor. O sistema move o valor da carteira em que o usuário está logado para a carteira de cheques devolvidos de clientes da filial, gera a contrapartida bancária, faz a integração contábil e mostra um comprovante com os lançamentos financeiros e contábeis.
A tela funciona como um assistente de dois passos: informações e comprovante. No comprovante é possível imprimir em PDF, Excel ou Word e iniciar uma nova devolução.
Pré-requisitos
- Acesso à tela no menu: a tela aparece em Financeiro > Caixa > Devolução cheque a receber 1ª vez.
- 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.
- Carteira de cheques devolvidos de clientes: a filial da carteira logada precisa ter essa carteira configurada.
- Fato contábil: precisa existir o fato contábil de devolução de cheque de cliente 1ª vez, sem variação, com ao menos um lançamento. Sem ele, a operação é recusada.
Fluxo Operacional
Fluxo de devolução
- O usuário abre Financeiro > Caixa > Devolução cheque a receber 1ª vez com uma carteira logada. A tela exibe o passo 1, Informações, com a Data Lançamento preenchida com a data de movimentação do usuário.
- O usuário confere ou altera a data, informa o Documento e o Valor.
- O usuário aciona Concluir. A tela mostra “O sistema está trabalhando, por favor aguarde…”.
- O sistema grava a operação e a tela exibe “Operação concluída com sucesso.”.
- No passo 2, a tela mostra o comprovante com as operações financeiras e contábeis geradas e permite imprimir ou iniciar uma nova devolução.
Fluxo de impressão do comprovante
- No passo 2, o usuário aciona Imprimir e escolhe Gerar PDF, Exportar Excel ou Exportar Word.
- Para Excel, a tela pergunta a opção de exportação na janela “Opções de exportação para Excel”.
- O sistema prepara a pasta do comprovante e a tela abre o relatório com os dados da operação.
Interface e Comportamentos da Tela
Estrutura do assistente
| Passo | Nome | Conteúdo |
|---|---|---|
| 1 | Informações | Data Lançamento, Documento e Valor |
| 2 | Comprovante | Dados da operação e duas grades de lançamentos |
As janelas têm os títulos “Devolução de cheque a receber – 1ª vez” e “Comprovante de devolução de cheque a receber – 1ª vez”. A barra do passo 1 indica “Financeiro -> Caixa -> Devolução de cheque a receber – 1ª vez”. No passo 1, apenas o botão Concluir fica visível.
Passo 1 — Informações
| Campo | Comportamento |
|---|---|
| Data Lançamento | Data no formato d/m/Y, preenchida com a data de movimentação do usuário e com o foco ao abrir |
| Documento | Texto de até 25 caracteres; não aceita mais que isso |
| Valor | Numérico com duas casas decimais, obrigatório |
Passo 2 — Comprovante
| Elemento | Conteúdo |
|---|---|
| Data | Data do primeiro lançamento da operação |
| Código da operação | Código gerado para a operação |
| Documento | Documento informado |
| Conta movimentada | Conta do segundo lançamento |
| Conta origem | Conta do primeiro lançamento |
| Valor | Valor devolvido |
| Grade financeira | Lançamentos financeiros gerados, com pesquisa bloqueada |
| Grade contábil | Lançamentos contábeis gerados, com pesquisa bloqueada |
Os botões são Fechar, Imprimir e Novo (Nova devolução). A altura das grades acompanha o tamanho da janela. A impressão oferece Gerar PDF, Exportar Excel e Exportar Word; clicar fora do painel o fecha. 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
| 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.” |
| Formulário incompleto | Aviso “Status” | “Por favor, preencha todos os campos corretamente.” |
| Valor vazio ou zero | Aviso “Atenção” | “Não foi possível concluir Motivo : O campo ‘Valor’ está inválido Solução : Informe um valor maior que zero.” |
| Durante a gravação | Espera | “O sistema está trabalhando, por favor aguarde…” |
| Gravação concluída | Informação “Status” | “Operação concluída com sucesso.” |
Feedbacks do servidor
| Situação | Erro | Motivo | Solução |
|---|---|---|---|
| Requisição sem título | Não foi possível Salvar | Os dados informados podem estar incorretos | Verifique se os dados informados estão corretos. |
| Fato contábil não configurado | Não foi possível realizar operação | É obrigatório informar um fato contábil para a seguinte configuração: Operação: DEVOLUÇÃO CHEQUE CLIENTE, Variação: Sem variação | Informe um fato contábil para operação |
| Carteira não encontrada | Não foi possível realizar operação | Carteira não encontrada | Configure uma carteira para a operação |
| Filial sem carteira de cheques devolvidos | Não foi possível realizar operação | Carteira não encontrada ou inválida | Por favor configure a carteira de cheques devolvidos de clientes na filial : |
| Falha geral na gravação | Texto da própria exceção, seguido de ponto | Falha na operação. | Verifique os dados e tente novamente. |
Processamento pelo Backend
Operações expostas para a tela
| Operação | Função |
|---|---|
| Gravação | Grava a devolução e devolve os comprovantes financeiro e contábil |
| Impressão do comprovante | Prepara a pasta do relatório de comprovante de caixa |
Sequência da gravação
- A tela envia documento, data de lançamento, carteira logada, um título com o valor e um cheque com número fixo “0”. Sem nenhum título, o sistema recusa a operação.
- O sistema carrega a carteira informada e a filial dela, obtém a moeda padrão da configuração e o fato contábil de devolução de cheque de cliente 1ª vez, sem variação.
- Em transação, valida o fato contábil, a carteira e a carteira de cheques devolvidos de clientes da filial.
- Gera um novo código de operação e cria o primeiro lançamento, da carteira logada para a carteira de cheques devolvidos, como débito, com o valor e o documento informados e o histórico do primeiro lançamento do fato contábil. Grava e confirma.
- Cria o segundo lançamento, a contrapartida bancária, da carteira de cheques devolvidos para a carteira logada, como crédito, já conciliado na data de lançamento. Grava e confirma.
- Se houver fato contábil configurado, integra a contabilidade com o primeiro lançamento. Caso contrário, só registra em log que a integração não foi feita e conclui sem erro.
- Em qualquer exceção, devolve “Falha na operação.” e não conclui a operação.
- A resposta traz as movimentações financeiras e os lançamentos contábeis da operação, que a tela mostra no passo 2.
Comprovantes devolvidos
O comprovante financeiro reúne as movimentações da operação, com cadastro, contrapartida, documento, histórico, valor, tipo de partida, data e situação de conciliação, em ordem de chave e número do lançamento. O comprovante contábil reúne os lançamentos da operação, com contas de débito e crédito, cadastros, documento auxiliar, complemento de histórico, valor e data.
Regras de Negócio
Carteira logada obrigatória
A tela só abre com uma carteira logada. A carteira logada é a origem do valor devolvido.
Valor obrigatório
O valor é obrigatório e deve ser maior que zero; a conferência de zero ou vazio é feita só na tela.
Datas da operação
A data digitada é a data de lançamento. A data de movimento é a data de movimentação do usuário.
Dois lançamentos por operação
Cada devolução gera um lançamento de débito na carteira de cheques devolvidos e uma contrapartida de crédito na carteira logada, com o mesmo código de operação. A contrapartida já nasce conciliada.
Integração contábil
Apenas o primeiro lançamento entra na integração contábil. Sem fato contábil configurado, a operação conclui sem integração contábil e sem aviso ao usuário.
Histórico do lançamento
O histórico do lançamento vem do primeiro lançamento do fato contábil configurado (código e descrição).
Cheque e título enviados pela tela
A tela envia um único título e um cheque com número “0”; na primeira devolução, só o valor e o documento são usados.
Falha integral
A operação é atômica: qualquer erro desfaz tudo e nada é concluído.
Troubleshooting
A tela não abre
Cenário: ao abrir a tela aparece um aviso.
Mensagem exibida: “Atenção: Nenhuma carteira está selecionada. Para acessar esta rotina, é necessário estar logado em uma carteira.”
O que fazer: entrar em uma carteira e abrir a tela novamente.
Concluir não grava
Cenário: ao acionar Concluir, a tela pede o preenchimento.
Mensagem exibida: “Por favor, preencha todos os campos corretamente.”
O que fazer: informar o valor (e a data, quando vazia) e concluir novamente.
Valor inválido
Cenário: o valor está vazio ou zerado.
Mensagem exibida: “Não foi possível concluir Motivo : O campo ‘Valor’ está inválido Solução : Informe um valor maior que zero.”
O que fazer: informar um valor maior que zero.
Fato contábil não configurado
Cenário: a gravação é recusada.
Mensagem exibida: “Não foi possível realizar operação — É obrigatório informar um fato contábil para a seguinte configuração”.
O que fazer: configurar o fato contábil de devolução de cheque de cliente, sem variação, e repetir.
Filial sem carteira de cheques devolvidos
Cenário: a gravação é recusada.
Mensagem exibida: “Por favor configure a carteira de cheques devolvidos de clientes na filial :”.
O que fazer: configurar a carteira de cheques devolvidos de clientes na filial e repetir.
Falha geral na gravação
Cenário: a gravação é interrompida por um erro.
Mensagem exibida: o texto do erro, com o título “Falha na operação.”.
O que fazer: verificar os dados e a configuração e repetir a operação.
Casos de Uso
Caso 1 — Registrar a devolução de um cheque de cliente
O usuário logado na carteira Banco do Brasil abre a tela, confere a data, informa o documento do cheque e o valor, e conclui. O sistema gera os dois lançamentos e mostra o comprovante.
Caso 2 — Lançar com data diferente da movimentação
O usuário altera a Data Lançamento para a data em que o banco devolveu o cheque, informa documento e valor e conclui. A data digitada passa a ser a de lançamento.
Caso 3 — Imprimir o comprovante em Excel
No comprovante, o usuário aciona Imprimir e Exportar Excel, escolhe “Arquivo Excel – Somente dados” e confirma com OK.
Caso 4 — Devolver outro cheque
No comprovante, o usuário aciona Novo (Nova devolução) e repete o lançamento para o próximo cheque.