Devolução de cheque a receber 2ª vez
Devolução de Cheque a Receber 2ª Vez — Financeiro (ERPV1)
A tela Devolução cheque a receber 2ª vez, do módulo Financeiro (menu Caixa), registra a devolução de cheques de clientes que já foram recebidos e liquidados e voltaram a ser devolvidos.
Visão Geral
A tela Devolução cheque a receber 2ª vez, do módulo Financeiro (menu Caixa), registra a devolução de cheques de clientes que já foram recebidos e liquidados e voltaram a ser devolvidos. O usuário monta um lote de cheques, confere e conclui. Para cada cheque, o sistema gera um novo cheque e um novo título a receber em aberto, ligados à conta de cheques devolvidos de clientes da filial, e registra a movimentação bancária da devolução.
A tela funciona como um assistente de três passos: Informações, Conferência e Comprovante. No primeiro passo o cheque é localizado pela banda magnética ou pela pesquisa de cheques. No último passo a tela mostra o comprovante, com os lançamentos financeiros, os cheques e os lançamentos contábeis, e permite imprimir.
Pré-requisitos
- Acesso à tela no menu: a tela aparece em Financeiro > Caixa > Devolução cheque a receber 2ª vez.
- Carteira logada: o usuário precisa estar logado em uma carteira. Sem carteira selecionada, a tela exibe a mensagem “Atenção: Nenhuma carteira está selecionada. Para acessar esta rotina, é necessário estar logado em uma carteira.” e não abre.
- Cheque elegível: só podem ser devolvidos cheques de clientes cujo título a receber já esteja liquidado, que ainda não tenham passado pela devolução de 2ª vez.
- Parâmetro do financeiro: o parâmetro 5082, “Documento para cheques de terceiros devolvidos pela 2ª vez”, precisa estar configurado.
- Conta de cheques devolvidos: a filial do título precisa ter a conta para cheques devolvidos de clientes (Tabelas Auxiliares > Filial > Financeiro).
- Fato contábil: a operação “DEVOLUÇÃO CHEQUE CLIENTE 2ª VEZ” precisa ter fato contábil configurado.
Fluxo Operacional
Fluxo de devolução
- O usuário abre Financeiro > Caixa > Devolução cheque a receber 2ª vez com uma carteira logada. A tela exibe o passo 1, Informações.
- O usuário informa o cheque, digitando ou lendo a banda magnética, ou escolhendo-o no campo Cheques. Os dados do cheque preenchem o formulário.
- O usuário aciona Adicionar/Editar cheque. A tela exibe “Cheque adicionado.” e o formulário é limpo para o próximo cheque. O usuário repete até incluir todos os cheques.
- Ao acionar Próximo, a tela vai ao passo 2, Conferência, com a lista dos cheques do lote.
- No passo 2, o usuário confere e aciona Concluir. O sistema grava a devolução e exibe “Operação concluída com sucesso.”.
- No passo 3, a tela mostra o comprovante e permite imprimir ou iniciar uma nova devolução.
Fluxo de alteração de um cheque do lote
- No passo 1, o usuário clica em um cheque da lista do lote. O formulário é recarregado com os dados dele.
- O usuário altera os dados e aciona Adicionar/Editar cheque.
- A tela exibe “Cheque atualizado.” e substitui os dados daquele cheque no lote.
Fluxo de impressão do comprovante
- No passo 3, o usuário aciona Imprimir. A tela abre um painel com Gerar PDF, Exportar Excel e 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 comprovante e a tela abre o relatório da operação.
Interface e Comportamentos da Tela
Estrutura do assistente
| Passo | Nome | Conteúdo |
|---|---|---|
| 1 | Informações | Formulário do cheque e lista do lote |
| 2 | Conferência | Lista somente leitura dos cheques do lote |
| 3 | Comprovante | Data, código da operação e três listas de comprovantes |
As janelas do assistente têm os títulos “Devolução de cheque a receber – 2ª vez”, “Conferência de Devolução” e “Comprovante de devolução de cheque a receber – 2ª vez”. O título interno do assistente exibe “1ª vez”, embora a rotina seja da 2ª vez.
Passo 1 — Informações
O grupo Cheque reúne os campos a seguir. Ao abrir, o foco vai para Banda magnética e Data Devolução recebe a data de hoje.
| Campo | Comportamento |
|---|---|
| Banda magnética | Texto de até 30 caracteres. Ao sair do campo, lê o cheque pela banda |
| Cheques | Consulta obrigatória de cheques a receber liquidados e ainda não devolvidos |
| Número, Série, Banco, Agência, Conta, Compensação, Razão Conta | Preenchidos com os dados do cheque |
| Participante | Consulta de clientes. Preenche CPF/CNPJ Emitente e Emitente |
| CPF/CNPJ Emitente, Emitente, Observação | Preenchidos com os dados do cheque |
| Valor, Vencimento | Preenchidos com os dados do cheque |
| Data Devolução | Data, formato dd/mm/aaaa. Vem com a data de hoje |
| Vendedor | Consulta de vendedores. Ao escolher, preenche Perc. Comissão |
| Perc. Comissão | Percentual de comissão do vendedor |
Os campos de dados do cheque, o Vendedor e o Perc. Comissão são desbloqueados para edição na abertura da tela.
A lista do lote, abaixo do formulário, mostra os cheques incluídos e não tem pesquisa. Clicar em um cheque da lista recarrega o formulário.
Leitura da banda magnética
| Situação | Comportamento |
|---|---|
| Campo vazio | Nada acontece |
| Menos de 30 caracteres | Exibe “Código inválido.” |
| 30 caracteres | O banco é lido nas três primeiras posições. A máscara de tarja do banco separa agência, compensação, razão, número do cheque e conta. Em seguida o cheque é buscado pela tarja |
| Cheque não encontrado | O campo Cheques é limpo e o servidor informa que a banda é inválida ou o cheque já foi devolvido |
| Cheque encontrado | Os campos do formulário são preenchidos |
Passo 2 — Conferência
A lista exibe os cheques do lote, sem pesquisa. Os botões Próximo, Cancelar e Excluir ficam ocultos. Restam Anterior e Concluir.
Passo 3 — Comprovante
O passo mostra a data do lançamento, o código da operação e três listas somente leitura: lançamentos financeiros, cheques incluídos e lançamentos contábeis. Os botões são Fechar, Imprimir e Nova devolução.
Impressão
| Opção | Resultado |
|---|---|
| Gerar PDF | Abre o relatório do comprovante em PDF |
| Exportar Excel | Pergunta a opção: Arquivo Excel, Arquivo Excel – Somente dados ou Somente dados de pasta de trabalho (.xlsx) |
| Exportar Word | Abre o relatório do comprovante em Word |
Clicar fora do painel de impressão o fecha.
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.” |
| Banda magnética incompleta | Erro | “Código inválido.” |
| Adicionar sem cheque escolhido | Aviso | “Favor informar um cheque já cadastrado no sistema.” |
| Cheque novo no lote | Informação | “Cheque adicionado.” |
| Cheque já existente no lote | Informação | “Cheque atualizado.” |
| Próximo com lote vazio | Informação | “Nenhum item incluído.” |
| Concluir com formulário inválido | Aviso | “Por favor, preencha todos os campos corretamente.” |
| 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 |
|---|---|---|---|
| Banda inválida ou cheque já devolvido | Erro ao realizar esta operação. | Banda magnética inválida ou cheque já devolvido. | Verifique o código informado. |
| Gravação sem cheques ou com dados incorretos | 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: {0} Variação: {1} | Informe um fato contábil para a operação |
| Carteira não encontrada | Não foi possível realizar operação | Carteira não encontrada | Verifique e configure carteira de pagamento para o tipo de operação |
| Parâmetro de documento ausente | Não foi possível realizar operação | Documento para cheque inválido ou não configurado | Favor configurar o parâmetro {0} na lista de parâmetros do financeiro para a inclusão do novo cheque Devolvido |
| Filial sem conta de cheques devolvidos | Não foi possível realizar a Devolução cheque a receber 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 de clientes |
| 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 |
|---|---|
| Leitura do cheque por banda magnética ou identificador | Devolve os dados do cheque a receber ainda devolvível |
| Listagem de cheques | Alimenta o campo Cheques com cheques elegíveis, com pesquisa e paginação |
| Gravação | Registra a devolução do lote e devolve os comprovantes |
| Impressão do comprovante | Prepara a pasta e o modelo do relatório |
Sequência da leitura do cheque
- O servidor recebe a banda magnética e ou o identificador do cheque.
- Busca o cheque a receber com o título dele, excluindo os que já tiveram a devolução de 2ª vez.
- Devolve os dados do cheque, o número do título e o vendedor com seu percentual de comissão.
- Sem resultado, responde que a banda é inválida ou o cheque já foi devolvido.
Sequência da gravação
- O servidor exige ao menos um cheque no lote.
- Carrega a carteira de pagamento, a filial da carteira, a moeda padrão e o cadastro do usuário.
- Abre uma transação única para o lote.
- Para cada cheque, cria o novo cheque, o novo título a receber e as movimentações.
- Executa a integração contábil dos movimentos, quando cabível.
- Confirma a transação e devolve lançamentos financeiros, contábeis e cheques pelo código de integração.
Lançamentos gerados
| Item | Conteúdo |
|---|---|
| Novo cheque | Status Aberto, a receber, emitido, ligado ao banco/caixa da conta de cheques devolvidos da filial |
| Novo título a receber | Aberto, parcela 1, natureza Realizado, com o tipo de documento do parâmetro 5082 |
| Movimentação do título | Histórico do primeiro lançamento do fato contábil, não conciliada |
| Movimentação bancária de devolução 2ª vez | Crédito, ligada ao novo título, com o cheque original como documento, conciliada na data do lançamento |
Regras de Negócio
Carteira logada obrigatória
A tela só abre com uma carteira selecionada. A carteira logada é a carteira de pagamento da operação.
Cheques elegíveis
O campo Cheques lista apenas cheques de clientes do tipo cheque a receber (e não cheque devolvido) cujo título está liquidado, com situação de emitido, e sem nenhuma movimentação de devolução anterior. A pesquisa aceita data, valor, número inteiro (cheque, banco, agência, conta, série, participante) ou texto (banco, agência, conta, série, emitente, CPF/CNPJ).
Leitura por banda magnética
A banda magnética precisa ter 30 caracteres. O banco é lido nas três primeiras posições e a máscara de tarja do banco define onde estão agência, compensação, razão, número do cheque e conta. A busca por banda não filtra a situação do título, mas exclui cheques já devolvidos pela 2ª vez.
Lote de cheques
Cada cheque entra no lote uma única vez. Adicionar de novo um cheque já incluído atualiza os dados dele. O lote não pode ficar vazio para avançar ou concluir.
Vendedor e comissão
Ao escolher o vendedor, o percentual de comissão vem do cadastro dele. Esses dados seguem para a gravação junto com o cheque.
Data da devolução
A Data Devolução digitada na tela não é enviada na gravação. A data de lançamento é a data de movimentação do usuário e a data de movimento é a data do dia.
Novo cheque e novo título
Cada cheque devolvido gera um novo cheque e um novo título a receber em aberto. Com título original, o número do novo cheque vem da sequência do banco/caixa da conta de cheques devolvidos e a série é a informada ou a do banco/caixa. Sem título original, usa o número do cheque original. O novo cheque e o novo título herdam participante, valor, observação, moeda, cotação, vendedor, comissão, forma de cobrança e centro de custo do título original. Sem título original, usam-se os parâmetros 23 (forma de cobrança) e 29 (centro de custo).
Transação única
A devolução do lote é gravada em uma única transação. Se qualquer cheque falhar, nada é gravado.
Integração contábil
A integração contábil só é executada quando todos os movimentos têm fato contábil configurado. Caso contrário, a devolução é gravada sem lançamentos contábeis.
Cheque devolvido não volta a ser escolhido
Após a devolução, o cheque original passa a ter a movimentação de devolução 2ª vez e deixa de aparecer na pesquisa e na leitura por banda.
Comprovante
O código da operação é o código de integração do primeiro lançamento financeiro. O relatório do comprovante é gerado para a carteira, a filial logada e o código da operação.
Troubleshooting
A tela não abre
Cenário: o usuário abre Devolução cheque a receber 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.
Banda magnética recusada
Cenário: o usuário lê ou digita a banda magnética e o cheque não é carregado.
Mensagem exibida: “Código inválido.” ou “Banda magnética inválida ou cheque já devolvido.”
O que fazer: conferir os 30 caracteres da banda. Se estiverem corretos, verificar se o cheque já foi devolvido pela 2ª vez; nesse caso ele não pode ser devolvido de novo.
Adicionar cheque sem escolher o cheque
Cenário: o usuário aciona Adicionar/Editar cheque com o formulário vazio.
Mensagem exibida: “Favor informar um cheque já cadastrado no sistema.”
O que fazer: ler a banda magnética ou escolher o cheque no campo Cheques e acionar Adicionar/Editar cheque.
Não é possível avançar para a conferência
Cenário: o usuário aciona Próximo no passo 1 sem ter incluído cheques.
Mensagem exibida: “Nenhum item incluído.”
O que fazer: incluir ao menos um cheque no lote.
Cheque não aparece no campo Cheques
Cenário: o usuário procura um cheque e ele não é listado.
Mensagem exibida: nenhuma.
O que fazer: conferir se o título do cheque está liquidado, se é cheque de cliente e se ele ainda não foi devolvido pela 2ª vez.
Falta configuração da filial ou do financeiro
Cenário: ao concluir, o servidor recusa a operação por falta de configuração.
Mensagem exibida: “Não foi possível realizar a Devolução cheque a receber 2ª vez.” (filial sem conta de cheques devolvidos), “Documento para cheque inválido ou não configurado” (parâmetro 5082) ou “É obrigatório informar um fato contábil para a seguinte configuração” (fato contábil).
O que fazer: pedir ao responsável que complete a configuração indicada na própria mensagem e repetir a devolução.
Falha geral ao concluir
Cenário: a janela “O sistema está trabalhando, por favor aguarde…” permanece aberta ou o servidor responde com falha.
Mensagem exibida: “Não foi possível Salvar” ou “Falha na operação.”
O que fazer: verificar os dados informados e repetir. A gravação é única; se falhou, nada foi lançado. Persistindo, acionar o suporte com o texto da mensagem.
Casos de Uso
Caso 1 — Devolver um cheque lido pela banda magnética
Um operador de caixa logado na carteira Matriz abre a tela, passa o cheque no leitor, confere os dados carregados e aciona Adicionar/Editar cheque. Em seguida, aciona Próximo, confere o lote e conclui. A tela exibe o comprovante com os lançamentos financeiros e contábeis.
Caso 2 — Devolver vários cheques de uma vez
O operador escolhe cada cheque no campo Cheques, adicionando um a um ao lote. Na conferência, vê todos os cheques e conclui uma única vez. Todos são devolvidos na mesma operação.
Caso 3 — Corrigir um cheque do lote
O operador percebe um vendedor errado em um cheque já adicionado. Clica no cheque da lista, escolhe o vendedor correto e aciona Adicionar/Editar cheque. A tela exibe “Cheque atualizado.”.
Caso 4 — Imprimir o comprovante em Excel
No passo 3, o operador aciona Imprimir, escolhe Exportar Excel e seleciona “Arquivo Excel – Somente dados”. O relatório do comprovante é aberto no formato escolhido.