CobrancaAlteracaoDeVencimento

Esta rotina permite alterar a data de vencimento de um ou mais títulos financeiros (a receber ou a pagar) já lançados no sistema, registrando a alteração como uma nova movimentação financeira vinculada ao título original.

Esta rotina permite alterar a data de vencimento de um ou mais títulos financeiros (a receber ou a pagar) já lançados no sistema, registrando a alteração como uma nova movimentação financeira vinculada ao título original. Pertence ao módulo Financeiro, dentro do submenu “Cobrança”.

DTOCabecalhoDeOperacoes (campos utilizados por esta rotina — classe compartilhada, ver observação acima):

DTODeTituloAProcessar (campo utilizado por esta rotina — classe compartilhada, ver observação acima):

Regra 1 — Título obrigatório para salvar a alteração. Se a lista de títulos a processar (`TitulosAProcessar`) de um item vier vazia ou nula, a operação para aquele item é rejeitada e nenhum título é alterado.

Regra 2 — Postecipação automática da data de vencimento. Se a nova data de vencimento informada (`DataDeVencimentoUtil`) for menor ou igual à data de lançamento (`DataDeLancamento`), o sistema recalcula automaticamente a data de vencimento para o próximo dia útil, aplicando a ação “postecipar” sobre sábados, domingos e feriados.

Regra 3 — Fato contábil obrigatório para a operação de alteração de vencimento. Antes de processar qualquer título, o sistema busca o fato contábil configurado para a operação “Alteração de vencimento” (tcTRECVCT), sem variação. Se não houver fato contábil configurado (ou ele estiver inativo) para essa operação, a alteração não é executada.

Regra 4 — Registro da movimentação financeira exige histórico configurado. Ao incluir a movimentação financeira decorrente da alteração de vencimento, o sistema exige que o fato contábil da operação tenha um histórico padrão configurado.

Regra 5 — Registro da movimentação financeira exige fato contábil (para operações que não são baixa). Se a operação de inclusão de movimentação não for do tipo “baixa” e não houver fato contábil associado, a movimentação não é registrada.

Regra 6 — Sincronização com bancos de boleto híbrido. Após alterar o vencimento e registrar a movimentação, o sistema busca as movimentações geradas pela operação e tenta sincronizar a nova data de vencimento com os bancos que oferecem boleto híbrido (ex: Itaú, Banco Inter, Bradesco, Sicoob, Banco do Brasil, Caixa Econômica Federal, Sicredi, Santander — a lista de bancos suportados varia conforme o tipo de operação). Se ocorrer falha na comunicação com o banco:

• Se o sistema determinar que a falha deve interromper a operação (com base na rotina de origem, `IdRotina`), toda a transação é desfeita (rollback) e a operação é cancelada com erro.
• Caso contrário, a alteração de vencimento é confirmada normalmente, mas um aviso informativo é retornado ao usuário, relatando quais títulos não puderam ser sincronizados com o banco ou que já haviam sido baixados anteriormente.

Regra 7 — Título a receber ou a pagar deve existir. Ao buscar um título a receber ou a pagar durante o processamento (em fluxos correlatos que envolvem este mesmo módulo de processamento de títulos), se o título informado não for encontrado, a operação correspondente falha.

Regra 8 — Falha inesperada durante o processamento. Qualquer exceção não tratada nas etapas anteriores é capturada e reexibida ao usuário com a mensagem original do erro ocorrido (mensagem dinâmica, definida no ponto onde a exceção realmente ocorreu — não há um texto fixo de Erro/Motivo/Solução para este caso, pois ele apenas encapsula e repassa a mensagem da exceção capturada).

Regra 9 — Preparação de relatório (Imprimir) é independente da alteração. A ação “Imprimir” apenas garante que a estrutura de pastas e o modelo do relatório de comprovante existam para a pasta do cliente; não valida nem depende de nenhum título específico ter sido alterado anteriormente na mesma requisição.

Acesso à rotina: “EditViewDeTitulosParaAlteracaoTRECVCT” (ID 1568) — tela “Alteração vencimento”, dentro do submenu “Cobrança” (ID 1562).