Devolução de Cheque Próprio 1ª Vez
Devolução de Cheque Próprio 1ª Vez — Financeiro (ERPV1)
A tela Devolução de Cheque Próprio 1ª Vez, do módulo Financeiro (menu Caixa), registra a primeira devolução de um cheque próprio emitido pela empresa.
Visão Geral
A tela Devolução de Cheque Próprio 1ª Vez, do módulo Financeiro (menu Caixa), registra a primeira devolução de um cheque próprio emitido pela empresa. O usuário informa a data, o documento e o valor, e o sistema lança a devolução entre a carteira logada e a carteira de cheques devolvidos da filial, gerando os lançamentos financeiros e contábeis e um comprovante.
A tela funciona como um assistente de dois passos: Informações e Comprovante. Depois de gravar, o usuário consulta os lançamentos gerados, imprime o comprovante em PDF, Excel ou Word ou inicia uma nova devolução.
Pré-requisitos
- Acesso à tela no menu: a tela aparece em Financeiro > Caixa > Devolução cheque próprio 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 na filial: a filial da carteira logada precisa ter a carteira de cheques devolvidos configurada.
- Fato contábil: a operação Devolução cheque próprio 1ª vez, sem variação, precisa ter fato contábil com ao menos um lançamento configurado.
Fluxo Operacional
Fluxo de devolução
- O usuário abre Financeiro > Caixa > Devolução cheque próprio 1ª vez com uma carteira logada. A tela exibe o passo Informações, com a Data preenchida pela data de movimentação do usuário.
- O usuário informa o Documento e o Valor e, se necessário, altera a Data.
- O usuário aciona Concluir. A tela exibe a espera “O sistema está trabalhando, por favor aguarde…”.
- O sistema grava a devolução e exibe “Operação concluída com sucesso.”.
- A tela passa ao passo Comprovante, com os dados da operação e as grades de operações financeiras e contábeis.
- O usuário pode imprimir o comprovante ou acionar Nova devolução para iniciar outro lançamento.
Fluxo de impressão do comprovante
- No passo 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 | Data, Documento e Valor |
| 2 | Comprovante | Dados da operação e grades de lançamentos |
O assistente se chama “Devolução de Cheque Próprio – 1ª vez”. A janela do passo 1 tem o título “Devolução de cheque próprio – 1ª vez” e a do passo 2, “Comprovante de devolução de cheque próprio – 1ª vez”. Os passos não são clicáveis. No passo 1, os botões Anterior, Próximo e Cancelar ficam ocultos; a gravação é feita por Concluir (Ctrl + S).
Passo 1 — Informações
| Campo | Comportamento |
|---|---|
| Data | Campo de data (dia/mês/ano). Começa com a data de movimentação do usuário e recebe o foco ao abrir |
| Documento | Texto de até 25 caracteres |
| Valor | Campo monetário com duas casas decimais |
Passo 2 — Comprovante
O comprovante mostra os campos Data (data de lançamento da primeira operação financeira), Código da operação, Documento, Conta movimentada, Conta origem e Valor, além de duas grades: operações financeiras e operações contábeis. A busca das grades fica bloqueada e as grades se ajustam à altura da janela.
| Campo | Conteúdo |
|---|---|
| Conta origem | Código do cadastro da primeira operação financeira |
| Conta movimentada | Código do cadastro da segunda operação financeira |
A barra do passo tem os botões Fechar, Imprimir (Ctrl + P) e Nova devolução (Ctrl + R). Concluída a gravação, Concluir, Anterior, Cancelar e fechar aba ficam desabilitados no passo 1, que é fechado ao entrar no comprovante.
Impressão
Imprimir abre uma sobreposição com três botões: Gerar PDF, Exportar Excel e Exportar Word. Clicar fora dos botões fecha a sobreposição. 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 ao concluir | Aviso “Status” | “Por favor, preencha todos os campos corretamente.” |
| Valor vazio ou zero | Aviso “Atenção” | “No campo “Valor”, informe um valor maior que zero.” |
| Durante a gravação | Espera “Caixa – Devolução de cheque próprio – 1ª vez” | “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 |
|---|---|---|---|
| Pedido sem título a processar | Não foi possível Salvar | Os dados informados podem estar incorretos | Verifique se os dados informados estão corretos. |
| Carteira logada não encontrada | Não foi possível devolver cheques próprios | Carteira não encontrada | Configure uma carteira para operação |
| Filial sem carteira de cheques devolvidos | Não foi possível devolver cheques próprios | Carteira não encontrada | Por favor configure a carteira de cheques devolvidos na filial : {0} |
| Operação sem fato contábil | 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 PRÓPRIO, Variação: {0} | DEVOLUÇÃO CHEQUE PRÓPRIO, Informe um fato contábil para a operação |
| 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 |
|---|---|
| DevolucaoDeChequeProprioPrimeiraVez/Salvar | Grava a devolução e devolve os lançamentos financeiros e contábeis |
| DevolucaoDeChequeProprioPrimeiraVez/Imprimir | Prepara o modelo do relatório de comprovante |
Sequência da gravação
- A tela envia o documento, a data de lançamento, a carteira logada, um título a processar com o valor digitado (valor e valor na moeda iguais, data de emissão igual à data) e um cheque de terceiros de número 0.
- Sem título a processar, o sistema recusa a operação com “Não foi possível Salvar”.
- O sistema localiza o fato contábil da operação, a carteira logada e a filial dela, a moeda padrão e o cadastro do usuário logado.
- Em transação, valida o fato contábil, a carteira e a carteira de cheques devolvidos da filial, gera uma nova chave de fato e cria os dois lançamentos financeiros (ver “Lançamentos gerados”).
- Usa o código de integração do primeiro lançamento como código da operação.
- Se todos os lançamentos criados tiverem operação financeira, integra a contabilidade; caso contrário, apenas registra em log que não há fato contábil configurado.
- Confirma a transação. Qualquer exceção desfaz a operação e chega à tela como falha geral, com o texto original no início da mensagem.
- A resposta traz o código de sucesso e as listas de lançamentos financeiros (lidos pelo código da operação) e contábeis (lidos pela chave de fato).
Sequência da impressão
O sistema verifica se o modelo do relatório de comprovante já existe na pasta do cliente. Se não existir, copia o modelo padrão, criando a pasta do cliente quando necessário, e devolve sucesso.
Lançamentos gerados
| Lançamento | Partida | Conta de origem | Contrapartida | Conciliação |
|---|---|---|---|---|
| 1 (sequência 1) | Débito | Carteira de cheques devolvidos da filial | Carteira logada | Conciliado na data de lançamento |
| 2 (sequência 2) | Crédito | Carteira logada | Carteira de cheques devolvidos da filial | Não conciliado |
Os dois lançamentos têm o mesmo código de integração, data de lançamento, valor, valor na moeda, documento, parcela 1 de 1, histórico do primeiro lançamento do fato contábil, atualização do módulo Banco, usuário logado e moeda padrão. Só o lançamento 1 segue para a integração contábil.
Fato contábil padrão
Na configuração padrão, o fato contábil da operação, sem variação, debita a conta do cadastro da carteira do movimento financeiro e credita a conta de cheques devolvidos da filial, com o histórico “Devolução de cheque próprio ref @DOCUMENTO_OPERACAO”.
Regras de Negócio
Carteira logada obrigatória
A tela só abre com uma carteira logada.
Valor maior que zero
O Valor precisa ser informado e maior que zero. A tela não envia a gravação sem isso.
Datas da operação
A data digitada é a data de lançamento. A data de movimentação dos lançamentos é a data de movimentação do usuário.
Carteira de cheques devolvidos
A devolução move o valor entre a carteira logada e a carteira de cheques devolvidos da filial da carteira logada. Sem essa carteira configurada, a operação é recusada.
Fato contábil obrigatório
A operação exige fato contábil com ao menos um lançamento. O histórico dos lançamentos financeiros vem do primeiro lançamento do fato.
Dois lançamentos por devolução
Cada devolução gera um débito conciliado na carteira de cheques devolvidos e um crédito não conciliado na carteira logada, ambos com o mesmo código de operação.
Operação única
Qualquer erro durante a gravação desfaz a operação inteira.
Integração contábil condicionada
A integração contábil só ocorre se todos os lançamentos criados tiverem operação financeira.
Troubleshooting
A tela não abre
Cenário: o usuário abre Devolução cheque próprio 1ª 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 concluir
Cenário: o usuário aciona Concluir com campo obrigatório vazio.
Mensagem exibida: “Por favor, preencha todos os campos corretamente.”
O que fazer: preencher os campos do formulário e concluir de novo.
Valor não aceito
Cenário: o usuário aciona Concluir com Valor vazio ou zero.
Mensagem exibida: “No campo “Valor”, informe um valor maior que zero.”
O que fazer: informar um valor maior que zero.
Carteira de cheques devolvidos não configurada
Cenário: a gravação falha porque a filial da carteira logada não tem carteira de cheques devolvidos.
Mensagem exibida: “Por favor configure a carteira de cheques devolvidos na filial : {0}”, com o título “Não foi possível devolver cheques próprios” ou o texto no início da falha geral.
O que fazer: configurar a carteira de cheques devolvidos na filial e repetir a operação.
Fato contábil não configurado
Cenário: a gravação falha porque a operação não tem fato contábil.
Mensagem exibida: “É obrigatório informar um fato contábil para a seguinte configuração: Operação: DEVOLUÇÃO CHEQUE PRÓPRIO, Variação: {0}”
O que fazer: configurar o fato contábil da operação e repetir a gravação.
Carteira não encontrada
Cenário: a gravação falha porque a carteira logada não foi localizada.
Mensagem exibida: “Carteira não encontrada”, com a orientação “Configure uma carteira para operação”.
O que fazer: entrar em uma carteira válida e repetir a operação.
Falha geral na gravação
Cenário: a gravação é interrompida por um erro, por exemplo a falta de configuração contábil.
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 — Registrar a devolução de um cheque próprio
Uma analista de caixa logada na carteira Matriz abre Devolução cheque próprio 1ª vez, informa o número do documento e o valor do cheque devolvido pelo banco e aciona Concluir. A tela exibe o comprovante com os lançamentos financeiros e contábeis.
Caso 2 — Lançar com data diferente da data de movimentação
A analista altera a Data do passo 1 para a data em que o banco devolveu o cheque. O sistema usa essa data como data de lançamento da devolução.
Caso 3 — Imprimir o comprovante em PDF
No comprovante, a analista aciona Imprimir e Gerar PDF. A tela abre o relatório com os dados da operação.
Caso 4 — Lançar outra devolução em seguida
No comprovante, a analista aciona Nova devolução. A tela reinicia o assistente no passo Informações.