Devolução de Cheque Próprio 2ª Vez
Devolução de Cheque Próprio 2ª Vez — Financeiro (ERPV1)
A tela Devolução cheque próprio 2ª vez, do módulo Financeiro (menu Caixa), trata cheques próprios que a empresa emitiu, que já foram liquidados e que precisam ser devolvidos pela segunda vez.
Visão Geral
A tela Devolução cheque próprio 2ª vez, do módulo Financeiro (menu Caixa), trata cheques próprios que a empresa emitiu, que já foram liquidados e que precisam ser devolvidos pela segunda vez. O usuário escolhe os cheques, confere o lote e grava. Para cada cheque, o sistema gera um novo título a pagar em aberto e os lançamentos financeiros e contábeis da devolução, e a tela mostra um comprovante.
A tela funciona como um assistente de três passos: informações (escolha dos cheques), conferência e comprovante. O comprovante pode ser impresso em PDF, Excel ou Word.
Pré-requisitos
- Acesso à tela no menu: a tela aparece em Financeiro > Caixa > Devolução cheque próprio 2ª 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.
- Cheques elegíveis: cheques próprios emitidos, com título a pagar liquidado do tipo cheque próprio, que ainda não tenham sido devolvidos pela segunda vez.
- Conta para cheques devolvidos na filial: a filial do cheque precisa ter a conta para cheques devolvidos configurada em Tabelas Auxiliares > Filial > Financeiro.
- Parâmetro financeiro de tipo de documento: o parâmetro de tipo de documento para cheques próprios devolvidos na 2ª vez precisa estar preenchido com um tipo de documento existente.
- Fato contábil: a operação de devolução de cheque próprio 2ª vez precisa ter fato contábil configurado para gerar os lançamentos contábeis.
Fluxo Operacional
Fluxo de devolução de cheques
- O usuário abre Financeiro > Caixa > Devolução cheque próprio 2ª vez com uma carteira logada. A tela exibe o passo 1, Informações.
- O usuário localiza o cheque pela consulta de cheques ou passando a banda magnética do cheque próprio. Os dados do cheque são preenchidos na tela.
- O usuário aciona a inclusão do cheque. A tela informa “Cheque adicionado.” e limpa o formulário para o próximo cheque. O processo se repete para cada cheque do lote.
- O usuário conclui o lote. O sistema grava a operação e exibe “Operação concluída com sucesso.”.
- A tela salta para o passo de comprovante, que mostra a data, o código da operação e as grades de títulos financeiros, cheques e lançamentos contábeis.
- O usuário pode imprimir o comprovante ou iniciar uma nova devolução.
Fluxo de impressão do comprovante
- No comprovante, 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 o modelo 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 | Dados do cheque, consulta de cheques e grade do lote |
| 2 | Conferência de Devolução | Grade com os cheques do lote, somente consulta |
| 3 | Comprovante de devolução de cheque próprio – 2ª vez | Data, código da operação e três grades |
A janela do assistente tem o título “Devolução de cheque próprio – 2ª vez”.
Passo 1 — Informações
Ao abrir, a data de validação recebe a data de hoje, o campo de banda magnética de cheque próprio é exibido e recebe o foco, e o campo de banda magnética de terceiro fica oculto.
| Campo | Comportamento |
|---|---|
| Banda magnética | Texto de até 30 caracteres para cheque próprio; ao sair do campo, o sistema valida e busca o cheque |
| Cheques | Consulta de cheques, obrigatória, em janela de 600 por 600; só traz cheques liquidados |
| Cheque Nº, Série, Banco, Agência, Conta, Compensação, Razão Conta | Somente leitura, preenchidos pelo cheque escolhido |
| Participante, CPF/CNPJ Emitente, Emitente, Observação | Somente leitura |
| Valor, Vencimento | Somente leitura; vencimento no formato d/m/Y |
| Data Devolução | Editável, formato d/m/Y; recebe o foco ao localizar o cheque |
A consulta de cheques busca pelo texto informado conforme o tipo: número inteiro procura por chave de fato, número do cheque ou banco; data procura por vencimento; valor decimal procura por valor; texto procura por série, banco, agência, conta, emitente ou CPF/CNPJ. Só a primeira coluna de ordenação é considerada.
Passo 2 — Conferência
A grade mostra os cheques do lote. A pesquisa fica bloqueada e os botões Próximo, Cancelar e Excluir ficam desabilitados.
Passo 3 — Comprovante
O comprovante mostra a data da operação, o código da operação e três grades.
| Grade | Conteúdo |
|---|---|
| Títulos financeiros | Lançamentos financeiros gerados |
| Cheques | Cheques devolvidos pela operação |
| Lançamentos contábeis | Lançamentos contábeis gerados |
Os botões são Fechar, Imprimir e Novo (Nova devolução). A impressão oferece Gerar PDF, Exportar Excel e Exportar Word em uma sobreposição que 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
| 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.” |
| Incluir sem cheque escolhido | Erro | “Nenhum cheque selecionado.” |
| Cheque já está no lote | Informação | “Cheque já adicionado. Verifique os dados informados.” |
| Cheque incluído no lote | Informação | “Cheque adicionado.” |
| Avançar com lote vazio | Informação | “Nenhum item incluído.” |
| Formulário incompleto ao gravar | Aviso | “Por favor, preencha todos os campos corretamente.” |
| Banda magnética incompleta | Erro | “Código inválido.” |
| Banco da banda magnética inválido | Erro | “Banda magnética inválida. Verifique o código informado .” |
| Durante a gravação | Espera | “O sistema está trabalhando, por favor aguarde…” |
| Gravação concluída | Informação | “Operação concluída com sucesso.” |
Feedbacks do servidor
| Situação | Erro | Motivo | Solução |
|---|---|---|---|
| Gravação sem cheques | Não foi possível Salvar | Os dados informados podem estar incorretos | Verifique se os dados informados estão corretos. |
| Cheque não localizado pela banda magnética | Erro ao realizar esta operação. | Banda magnética inválida ou cheque já devolvido. | Verifique o código informado. |
| Carteira não encontrada | Não foi possível devolver cheques próprios | Carteira não encontrada | Configure uma carteira para operação |
| 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: {0} Variação: {1} | DEVOLUÇÃO CHEQUE PRÓPRIO 2ª VEZ, Informe um fato contábil para a operação |
| Cheque não encontrado | Não foi possível realizar operação | Cheque não encontrado: {0} | Verifique e informe o cheque corretamente |
| Filial sem conta para cheques devolvidos | Não foi possível realizar a Devolução cheque a próprio 2ª vez. | Não existe configuração da carteira de cheque devolvido de cliente na filial {0} | Tabelas Auxiliares -> Filial -> Financeiro -> Conta p/ cheques devolvidos, informe uma carteira. |
| Parâmetro de tipo de documento vazio | Não foi possível realizar a operação. | O tipo do documento para cheque está inválido | Favor configurar o parâmetro {0} na lista de parâmetros do financeiro para a inclusão do novo cheque. |
| Tipo de documento não encontrado | Não foi possível realizar a operação.,Não foi encontrado nenhum tipo de documento para cheque cadastrado com o código {0}, Verifique a configuração do parâmetro {1} na lista de parâmetros do financeiro para a inclusão do novo cheque. | Mensagem única, sem separação entre erro, motivo e solução | Conferir o parâmetro de tipo de documento |
| 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 | Devolve os cheques do lote e retorna os comprovantes |
| Impressão do comprovante | Prepara o modelo de impressão do comprovante |
| Consulta de cheques | Lista os cheques elegíveis para a devolução |
| Busca por banda magnética | Localiza um cheque próprio pela tarja e/ou pelo código |
Sequência da gravação
- O sistema só processa se a lista de cheques recebida não estiver vazia; sem cheques, recusa a gravação.
- Localiza a carteira de pagamento informada e a filial dela. Em seguida, em transação, processa cada cheque do lote (ver “Lançamentos gerados”).
- O código da operação é o código de integração da primeira movimentação gerada.
- Se todas as movimentações têm operação financeira configurada, integra a contabilidade; caso contrário, apenas registra em log que não há fato contábil e segue.
- Confirma a transação.
- Em qualquer exceção, devolve a mensagem de falha e não conclui a operação.
- A resposta traz os lançamentos financeiros, os lançamentos contábeis e os cheques da operação, que a tela mostra no comprovante.
Sequência da impressão
- O sistema garante a pasta de comprovantes de caixa do cliente.
- Se o modelo do comprovante não existe nessa pasta, copia o modelo padrão.
- Devolve sucesso, e a tela abre o relatório de comprovante de caixa.
Lançamentos gerados
Para cada cheque do lote o sistema gera dois lançamentos com o mesmo código de operação:
| Lançamento | Características |
|---|---|
| Inclusão de título a pagar | Crédito na carteira de pagamento, vinculado ao novo título |
| Movimentação bancária de devolução | Débito, atualiza o módulo Banco, ligada ao cheque, ao título original e ao novo título |
O novo título a pagar nasce com situação Aberto e natureza Realizado, com valor, plano de contas, banco ou caixa, moeda, observação e participante copiados do título original.
Regras de Negócio
Carteira logada obrigatória
A tela só abre com uma carteira logada, e a carteira logada é a carteira de pagamento da operação.
Cheques elegíveis para a devolução
A consulta da tela traz cheques com título a pagar liquidado, de tipo de documento cheque próprio (e não cheque devolvido), com o cheque emitido, que ainda não tenham movimentação de devolução 2ª vez. A busca pela banda magnética exige título a pagar associado ao cheque e exclui cheques já devolvidos, sem filtrar situação do título nem tipo do cheque.
Validação da banda magnética
A banda magnética tem 30 caracteres. Com tamanho diferente de zero e menor que 30, o sistema recusa com “Código inválido.”. Com 30 caracteres, o banco é identificado pelos três primeiros caracteres; se o banco for inválido, a tela exibe “Banda magnética inválida. Verifique o código informado .”. Se nenhum cheque for encontrado, o servidor informa “Banda magnética inválida ou cheque já devolvido.”.
Datas da operação
O lançamento usa a data de movimentação do usuário, e o movimento usa a data corrente do sistema. A Data Devolução digitada na tela não é enviada nem usada pelo servidor.
Novo título a pagar
O cheque devolvido volta como um novo título a pagar em aberto, com vencimento e emissão iguais à data de lançamento e origem vinculada ao cheque original. O número do novo cheque usa a próxima sequência da série do cheque, e o controle de sequência é atualizado.
Conta para cheques devolvidos
A filial do cheque precisa ter a conta para cheques devolvidos configurada; sem ela, a operação é recusada.
Tipo de documento do novo título
O tipo de documento do novo título vem do parâmetro financeiro de cheques próprios devolvidos na 2ª vez. Parâmetro vazio ou apontando para tipo inexistente recusa a operação.
Fato contábil
A operação exige fato contábil de devolução de cheque próprio 2ª vez, sem variação cambial. Sem fato contábil ou sem lançamentos, a operação é recusada.
Operação atômica
Todo o lote é gravado em uma única transação: se qualquer cheque for recusado, nada é gravado.
Integração contábil condicionada
A integração contábil só é executada quando todas as movimentações geradas têm operação financeira; caso contrário, a operação é confirmada apenas com um registro em log.
Lote sem repetição
A tela não inclui o mesmo cheque duas vezes no lote e avisa quando isso é tentado.
Troubleshooting
A tela não abre
Cenário: o usuário abre Devolução cheque próprio 2ª vez e recebe 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.
Não é possível incluir o cheque
Cenário: o usuário aciona a inclusão sem ter escolhido um cheque, ou escolhe um cheque que já está no lote.
Mensagem exibida: “Nenhum cheque selecionado.” ou “Cheque já adicionado. Verifique os dados informados.”
O que fazer: escolher um cheque pela consulta ou pela banda magnética; se já está no lote, seguir para o próximo cheque.
Banda magnética recusada
Cenário: o usuário passa ou digita a banda magnética do cheque próprio.
Mensagem exibida: “Código inválido.”, “Banda magnética inválida. Verifique o código informado .” ou “Banda magnética inválida ou cheque já devolvido.”
O que fazer: conferir o código digitado (30 caracteres) e se o cheque já não foi devolvido pela 2ª vez; se necessário, escolher o cheque pela consulta.
Não é possível avançar sem cheques
Cenário: o usuário tenta avançar com o lote vazio.
Mensagem exibida: “Nenhum item incluído.”
O que fazer: incluir pelo menos um cheque no lote.
Cheque não aparece na consulta
Cenário: o usuário não encontra o cheque na consulta de cheques.
Mensagem exibida: nenhuma; a consulta vem sem o cheque.
O que fazer: conferir se o título do cheque está liquidado, se é do tipo cheque próprio, se o cheque foi emitido e se ele já não foi devolvido pela 2ª vez.
Filial sem conta para cheques devolvidos
Cenário: a gravação é recusada para um cheque.
Mensagem exibida: “Não foi possível realizar a Devolução cheque a próprio 2ª vez.” com o motivo “Não existe configuração da carteira de cheque devolvido de cliente na filial {0}”.
O que fazer: informar a conta para cheques devolvidos em Tabelas Auxiliares > Filial > Financeiro e repetir a operação.
Parâmetro de tipo de documento inválido
Cenário: a gravação é recusada na criação do novo título.
Mensagem exibida: “Não foi possível realizar a operação.” com o motivo “O tipo do documento para cheque está inválido”, ou a mensagem sobre tipo de documento não encontrado.
O que fazer: configurar o parâmetro financeiro de tipo de documento para cheques próprios devolvidos na 2ª vez com um tipo existente.
Fato contábil não configurado
Cenário: a gravação é recusada por falta de fato contábil.
Mensagem exibida: “Não foi possível realizar operação”, com a orientação “DEVOLUÇÃO CHEQUE PRÓPRIO 2ª VEZ, Informe um fato contábil para a operação”.
O que fazer: configurar o fato contábil da operação e repetir a gravação.
Falha geral na gravação
Cenário: a gravação é interrompida por um erro inesperado.
Mensagem exibida: o texto do erro, seguido de ponto, 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 — Devolver um cheque próprio pela consulta
Um analista financeiro logado na carteira Matriz abre a tela, escolhe um cheque próprio liquidado na consulta, confere os dados preenchidos e inclui o cheque. Conclui o lote, e a tela mostra o comprovante com o novo título a pagar e os lançamentos gerados.
Caso 2 — Devolver vários cheques de uma vez
O analista inclui um cheque após o outro, sempre pela consulta, e o sistema avisa se algum já estiver no lote. Ao concluir, todos os cheques são devolvidos na mesma operação, com um único código.
Caso 3 — Localizar o cheque pela banda magnética
O analista passa a banda magnética do cheque próprio no leitor. O sistema identifica o banco, localiza o cheque e preenche o formulário, deixando o foco na Data Devolução.
Caso 4 — Imprimir o comprovante em Excel
No comprovante, o analista aciona Imprimir e Exportar Excel, escolhe “Arquivo Excel – Somente dados” e confirma com OK.