Reapresentação de Cheque Próprio
Criado por Igor Ribeiro em 25 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
ReapresentacaoDeChequeProprio
Esta rotina do módulo Financeiro (submenu “Caixa”) permite reapresentar cheques próprios que foram devolvidos pelo banco.
Visão Geral
Esta rotina do módulo Financeiro (submenu “Caixa”) permite reapresentar cheques próprios que foram devolvidos pelo banco. O usuário localiza os lançamentos financeiros de devolução de cheque próprio ainda não conciliados e gera uma nova movimentação de reapresentação, vinculada ao lançamento original de devolução.
Endpoints
[GET] /ReapresentacaoDeChequeProprio/Listar
Lista as movimentações financeiras de devolução de cheque próprio da filial logada, elegíveis para reapresentação (partida Crédito, operação financeira “BCODEV1CHP”, ainda não conciliadas).
Permissão: coberta pela permissão de acesso à rotina “EditViewDeReapresentacaoDeChequeProprio” (ID 1597)
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| extGrid | ConfiguracaoDeGrid | Sim | Configuração de paginação/ordenação da grid |
| valorDeConsulta | string | Não | Filtro textual de busca (padrão: vazio) |
“` GET /ReapresentacaoDeChequeProprio/Listar?valorDeConsulta=123 “`
“`json { “total”: 0, “rows”: [] } “`
[POST] /ReapresentacaoDeChequeProprio/Salvar
Recebe a lista de movimentações financeiras de devolução de cheque próprio selecionadas pelo usuário e efetiva a reapresentação: para cada movimentação, valida o lançamento de devolução original, marca esse lançamento como conciliado e gera duas novas movimentações financeiras (débito e crédito) vinculadas à operação de reapresentação (“BCOREAPCHP”). Ao final, dispara a integração contábil correspondente, quando aplicável.
Permissão: “ReapresentacaoDeChequeProprio/Salvar” (ID 3037)
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| dto | DTOCabecalhoDeOperacoes | Sim | Cabeçalho da operação; o campo relevante para esta rotina é “MovimentacoesFinanceiras” |
| dto.MovimentacoesFinanceiras | IList[DTODeMovimentacaoFinanceira] | Sim (não pode ser vazia) | Lista das movimentações financeiras de devolução de cheque próprio selecionadas para reapresentação |
“` POST /ReapresentacaoDeChequeProprio/Salvar { “MovimentacoesFinanceiras”: [ { “IdDaFilial”: “001”, “ChaveDeFato”: “000000001”, “NumeroDoLancamento”: 1 } ] } “`
“`json { “success”: true, “CodigoDaOperacao”: 0, “listaDeMovimentacaoFinanceira”: [], “listaDeOperacoesContabeis”: [] } “`
[POST] /ReapresentacaoDeChequeProprio/Imprimir
Prepara o relatório de comprovante (“ComprovanteCaixa.rpt”) para impressão, copiando o modelo padrão do relatório para a pasta específica do cliente caso ainda não exista.
Permissão: “ReapresentacaoDeChequeProprio/Imprimir” (ID 3038)
Nenhum parâmetro de entrada.
“` POST /ReapresentacaoDeChequeProprio/Imprimir “`
“`json { “success”: true } “`
Modelos de Dados
DTOCabecalhoDeOperacoes (campos relevantes para esta rotina)
| Campo | Tipo | Descrição |
|---|---|---|
| MovimentacoesFinanceiras | IList[DTODeMovimentacaoFinanceira] | Lista das movimentações de devolução de cheque próprio a reapresentar |
DTODeMovimentacaoFinanceira (campos relevantes para esta rotina)
| Campo | Coluna (BD) | Tipo | Descrição |
|---|---|---|---|
| IdDaFilial | Cod_filial | string (char 3) | Filial da movimentação financeira |
| ChaveDeFato | Chave_fato | string (char 9) | Chave do fato contábil/financeiro da movimentação de devolução |
| NumeroDoLancamento | Num_lancto | short | Número do lançamento dentro do fato |
| AtualizarModulo | Atualizar_modulo | string (char 1) | Módulo de origem da movimentação — deve ser o módulo bancário |
| IDDoTipoPartida | Tipo_partida | string (char 1) | Tipo de partida do lançamento — deve ser “Crédito” |
| StatusConciliado | Status_conciliado | string (char 1) | Indica se a movimentação de devolução já está conciliada — deve estar não conciliada para permitir reapresentação |
| OperacaoFinanceira | operfin | string | Código da operação financeira — deve ser “BCODEV1CHP” (devolução de cheque próprio) |
Regras de Negócio
Regra 1 — Lista de reapresentação restrita a devoluções não conciliadas. A ação “Listar” traz apenas movimentações da filial logada com operação financeira “BCODEV1CHP”, partida Crédito e ainda não conciliadas — movimentações já conciliadas ou de outra operação não aparecem para reapresentação.
Regra 2 — Lista de movimentações não pode ser vazia ao salvar. Se o usuário tentar salvar sem selecionar nenhuma movimentação financeira, o sistema bloqueia a operação.
Regra 3 — Fato contábil obrigatório para a configuração de operação. Ao processar a reapresentação, o sistema exige que exista um fato contábil configurado para a operação e variação utilizadas.
Regra 4 — Movimentação de devolução deve existir. O sistema busca a movimentação financeira de devolução original vinculada à movimentação selecionada; se não encontrar, bloqueia a operação.
Regra 5 — Movimentação de devolução deve pertencer ao módulo bancário. Se a movimentação de devolução encontrada não pertencer ao módulo bancário, o sistema bloqueia a operação.
Regra 6 — Movimentação de devolução deve ser de partida Crédito. Se a movimentação de devolução não for de partida Crédito, o sistema bloqueia a operação.
Regra 7 — Movimentação de devolução não pode já estar conciliada. Se a movimentação de devolução já estiver conciliada, o sistema bloqueia a operação.
Regra 8 — Movimentação de devolução deve ser da operação correta. Se a movimentação de devolução não for da operação “BCODEV1CHP” (devolução de cheque próprio), o sistema bloqueia a operação.
Regra 9 — Falha inesperada na reapresentação. Se ocorrer qualquer erro não previsto durante o processamento da reapresentação (dentro da transação de banco de dados), a operação é revertida e o erro é reportado ao usuário.
Regra 10 — Persistência e integração contábil. Ao concluir com sucesso, o sistema conclui a transação de banco de dados (Unit of Work) marcando o lançamento de devolução original como conciliado e criando as novas movimentações de débito e crédito da reapresentação. Em seguida, dispara a integração contábil correspondente para gerar os lançamentos contábeis vinculados à operação.
Permissões
Acesso à rotina: “EditViewDeReapresentacaoDeChequeProprio” (ID 1597)
| Ação | Permissão | ID |
|---|---|---|
| Listar | coberta por “EditViewDeReapresentacaoDeChequeProprio” | — |
| Salvar | “ReapresentacaoDeChequeProprio/Salvar” | 3037 |
| Imprimir | “ReapresentacaoDeChequeProprio/Imprimir” | 3038 |
