DevolucaoDeChequeAReceberSegundaVez

Esta rotina registra, no módulo Financeiro (submenu Caixa), a devolução de um cheque de terceiros recebido de cliente que já havia sido devolvido uma primeira vez e voltou a ser devolvido pelo banco (“2ª vez”).

Esta rotina registra, no módulo Financeiro (submenu Caixa), a devolução de um cheque de terceiros recebido de cliente que já havia sido devolvido uma primeira vez e voltou a ser devolvido pelo banco (“2ª vez”). O sistema gera um novo cheque de substituição, um novo título a receber em aberto e a movimentação financeira/bancária correspondente, permitindo a impressão do comprovante de caixa da operação.

1. Fato contábil da operação: a rotina utiliza fixamente o fato contábil/operação financeira “BCODEV2CHT” (ID 42 — “DEVOLUÇÃO CHEQUE CLIENTE 2a VEZ”, módulo Banco) para classificar a movimentação bancária gerada. Se não houver fato contábil configurado com seus respectivos lançamentos, a operação é bloqueada.
   Mensagem exibida: “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 2ª VEZ / Variação: (sem variação). Informe um fato contábil para a operação.”
2. Carteira de pagamento obrigatória: a operação exige uma carteira de pagamento (conta bancária/caixa) válida e configurada para o tipo de operação.
   Mensagem exibida: “Não foi possível realizar operação. Carteira não encontrada. Verifique e configure carteira de pagamento para o tipo de operação.”
3. Tipo de documento para cheques devolvidos 2ª vez: o sistema exige que exista um parâmetro do financeiro configurado (“Tipo de documento para cheques de terceiros devolvidos 2ª vez”), usado para classificar o novo título a receber gerado.
   Mensagem exibida: “Não foi possível realizar operação. Documento para cheque inválido ou não configurado. Favor configurar o parâmetro [nome do parâmetro] na lista de parâmetros do financeiro para a inclusão do novo cheque Devolvido.” (o placeholder é substituído pela descrição do parâmetro de configuração exigido)
4. Carteira de cheque devolvido de cliente na filial: para cada cheque devolvido, a filial do título a receber original precisa ter configurada a “carteira de cheque devolvido de cliente” (Tabelas Auxiliares > Filial > Financeiro). Sem essa configuração, a devolução é bloqueada.
   Mensagem exibida: “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 [ID da filial]. Tabelas Auxiliares -> Filial -> Financeiro -> Conta p/ cheques devolvidos de clientes.” (o placeholder é o identificador da filial em que falta a configuração)
5. Geração do novo cheque e título a receber: para cada cheque da lista, o sistema cria um novo registro de cheque (status “Aberto”, tipo “Receber”) e um novo título a receber (partida Débito), reaproveitando os dados do título original quando este existir, ou os dados informados manualmente quando não existir título correspondente.
6. Geração da movimentação financeira e bancária: após persistir o novo título, o sistema gera a movimentação financeira vinculada (operação financeira “TRECINC”) e a movimentação bancária de devolução (operação “BCODEV2CHT”), marcando a movimentação do título como não conciliada e a movimentação bancária como conciliada.
7. Falha genérica de processamento: qualquer erro não tratado especificamente durante o processamento é capturado e reportado de forma genérica, sempre incluindo os dados originais do erro técnico.
   Mensagem exibida: “[detalhe técnico do erro]. Falha na operação. Verifique os dados e tente novamente.”
8. Lista de cheques obrigatória para salvar: a ação “Salvar” só executa a devolução se ao menos um cheque de terceiros for informado no DTO; caso contrário, a operação é interrompida antes de qualquer processamento.
   Mensagem exibida: “Não foi possível Salvar. Os dados informados podem estar incorretos. Verifique se os dados informados estão corretos.”
9. Impressão do comprovante: a ação “Imprimir” apenas garante que o arquivo de relatório “ComprovanteCaixa.rpt” exista na pasta do cliente (copiando o modelo padrão na primeira vez); não valida nem grava nenhum dado de negócio, servindo apenas de apoio para a geração visual do comprovante já processado pela ação “Salvar”.

Tabelas envolvidas: TBTITULOREC (novo título a receber gerado pela devolução), TBMOVTOFIN (movimentação financeira do título — operação “TRECINC”) e a movimentação bancária da devolução (operação “BCODEV2CHT”), também persistida como movimentação financeira vinculada à carteira.

Fato(s) contábil(is) utilizado(s): “DEVOLUÇÃO CHEQUE CLIENTE 2a VEZ” (código ListaDeOperFin “BCODEV2CHT”, ID 42, módulo Banco) — usado para classificar a movimentação bancária gerada pela devolução. A movimentação financeira do novo título a receber usa a operação “TRECINC” (inclusão de título a receber).

Lógica de gravação: para cada cheque de terceiros informado, o sistema primeiro cria e persiste (commit) o novo cheque e o novo título a receber (partida Débito). Em seguida, lança a movimentação financeira do título (operação “TRECINC”), marcando-a como não conciliada, e a movimentação bancária da devolução (operação “BCODEV2CHT”), marcando-a como conciliada, associando a esta última o fato contábil e a carteira de pagamento informados. Um segundo commit persiste essas movimentações. O método retorna a lista de todas as movimentações financeiras geradas na operação.

Compensação/baixa futura: o novo título a receber gerado fica em aberto e não é baixado automaticamente por esta rotina — sua liquidação (recebimento efetivo ou nova devolução) é tratada pelas rotinas normais de baixa/compensação de títulos a receber do módulo Financeiro, fora do escopo desta operação.

Acesso à rotina: “EditViewDeDevolucaoAReceberSegundaVez” (ID 1595) — recurso filho de “Caixa” (ID 1589), módulo Financeiro.

Não existem entradas de permissão granular próprias (ex: “DevolucaoAReceberSegundaVez/Salvar”) registradas em RecursosGeraisFinanceiro.cs para esta rotina — o acesso à tela já concede acesso às duas ações.