Reapresentação de Cheque de Terceiro
Criado por Igor Ribeiro em 25 de setembro de 2026
Atualizado por Igor Ribeiro em 02 de outubro de 2026
ReapresentacaoDeChequeDeTerceiro
Rotina do módulo Financeiro > Caixa que permite reapresentar (levar novamente à cobrança/depósito) um cheque de terceiro que havia sido devolvido pelo banco.
Visão Geral
Rotina do módulo Financeiro > Caixa que permite reapresentar (levar novamente à cobrança/depósito) um cheque de terceiro que havia sido devolvido pelo banco. A operação reverte contabilmente a devolução registrada anteriormente, gerando uma nova movimentação financeira (débito e crédito) que representa o cheque voltando ao fluxo de caixa/banco.
Endpoints
GET /ReapresentacaoDeChequeDeTerceiro/Listar
Lista, em grid, as movimentações financeiras de cheques de terceiros devolvidos que estão disponíveis para reapresentação na filial logada do usuário.
Permissão: ação marcada como acesso anônimo no código ([PermiteAcessoAnonimo]) — não exige permissão granular própria; o acesso à tela como um todo é controlado pela permissão de acesso à rotina “EditViewDeReapresentacaoDeChequeDeTerceiro” (ID 1594).
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| extGrid | ConfiguracaoDeGrid | Sim | Configuração de paginação/ordenação do grid |
| valorDeConsulta | string | Não | Texto livre de filtro de busca (padrão vazio) |
“` GET /ReapresentacaoDeChequeDeTerceiro/Listar?valorDeConsulta=12345 “`
“`json { “total”: 2, “rows”: [ { “…”: “dados da movimentação financeira de devolução do cheque” } ] } “`
Internamente, a busca é restrita à filial logada do usuário (`FilialLogada`), à operação financeira “Devolução de Cheque de Terceiro” (código BCODEV1CHT) e à partida de Débito.
POST /ReapresentacaoDeChequeDeTerceiro/Salvar
Executa a reapresentação de um ou mais cheques de terceiros devolvidos selecionados pelo usuário, gerando uma nova movimentação financeira e, quando aplicável, o lançamento contábil correspondente.
Permissão: “ReapresentacaoDeChequeDeTerceiro/Salvar” (ID 3035)
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| dto | DTOCabecalhoDeOperacoes | Sim | Cabeçalho da operação; deve conter a lista `MovimentacoesFinanceiras` (uma ou mais movimentações de devolução de cheque a reapresentar) |
“` POST /ReapresentacaoDeChequeDeTerceiro/Salvar { “MovimentacoesFinanceiras”: [ { “IdDaFilial”: 1, “ChaveDeFato”: 12345, “NumeroDoLancamento”: 1, “DataDeLancamento”: “2026-09-10” } ] } “`
“`json { “success”: true, “CodigoDaOperacao”: 987654, “listaDeMovimentacaoFinanceira”: [ “…” ], “listaDeOperacoesContabeis”: [ “…” ] } “`
Se a lista `MovimentacoesFinanceiras` vier vazia ou nula, a operação é interrompida com a mensagem “Não foi possível Salvar” (ver Regras de Negócio).
POST /ReapresentacaoDeChequeDeTerceiro/Imprimir
Prepara o arquivo de modelo do comprovante de caixa (“ComprovanteCaixa.rpt”) para impressão, copiando-o do modelo padrão para a pasta do cliente caso ainda não exista. Não executa nenhuma regra de negócio sobre os dados da reapresentação — apenas garante que o arquivo de layout do relatório esteja disponível.
Permissão: “ReapresentacaoDeChequeDeTerceiro/Imprimir” (ID 3036)
Parâmetros: nenhum.
“` POST /ReapresentacaoDeChequeDeTerceiro/Imprimir “`
“`json { “success”: true } “`
Modelos de Dados
DTOCabecalhoDeOperacoes (ATAK.DTO.Financeiro.OperacoesFinanceiras)
| Campo | Tipo | Descrição |
|---|---|---|
| MovimentacoesFinanceiras | Lista de DTODeMovimentacaoFinanceira | Movimentações de devolução de cheque de terceiro selecionadas para reapresentação |
DTODeMovimentacaoFinanceira (ATAK.DTO.MovimentacaoDeEntradaESaida.MovimentacoesFinanceiras — reflete a tabela TBMOVTOFIN)
| Campo | Tipo | Descrição |
|---|---|---|
| IdDaFilial | Inteiro | Filial à qual pertence a movimentação financeira de devolução |
| ChaveDeFato | Inteiro | Chave do fato contábil/financeiro que identifica a movimentação de devolução original |
| NumeroDoLancamento | Inteiro | Número do lançamento financeiro da devolução |
| DataDeLancamento | Data | Data do lançamento financeiro |
(A movimentação financeira possui ainda dezenas de outros campos padrão do módulo financeiro — valor, cliente/cadastro, tipo de partida, operação financeira — não exclusivos desta rotina.)
Regras de Negócio
- Escopo da listagem restrito à filial e ao tipo de devolução. A ação Listar só traz movimentações da filial logada do usuário, da operação financeira “Devolução de Cheque de Terceiro” (BCODEV1CHT) e da partida Débito — ou seja, apenas cheques de terceiros que já foram devolvidos e ainda não foram reapresentados.
- A reapresentação só ocorre se houver movimentações selecionadas. Se o usuário tentar salvar sem selecionar nenhuma movimentação, a operação é bloqueada.Mensagem exibida: “Não foi possível Salvar. Os dados informados podem estar incorretos. Verifique se os dados informados estão corretos.”
- É necessário existir configuração de fato contábil para a operação de reapresentação. A reapresentação gera lançamentos sob a operação “Reapresentação de Cheque de Terceiro” (BCOREAPCHT); se não houver fato contábil configurado para essa operação/variação, a reapresentação é bloqueada.Mensagem exibida: “Não foi possível Reapresentar. É obrigatório informar um fato contábil para a seguinte configuração: Operação: {operação} Variação: {variação}. Informe um fato contábil para operação”
- A movimentação de devolução original precisa existir e ser válida. Para cada movimentação informada, o sistema localiza a movimentação de devolução original pela filial, chave de fato e número do lançamento. Se ela não for encontrada, o sistema impede a reapresentação:Mensagem exibida: “Não foi possível obter Movimentação de Devolução. Movimentação financeira de devolução do cheque de terceiros não encontrada. Filial: {filial} Chave de fato: {chave de fato} Num. Lançamento: {número do lançamento}. Informe Movimentação financeira de devolução do cheque de terceiros validos para operação”
- A movimentação de devolução precisa pertencer ao módulo bancário. Caso contrário:Mensagem exibida: “Não foi possível obter Movimentação de Devolução. Movimentação financeira de devolução do cheque de terceiros informada não faz parte do módulo bancário. Filial: {filial} Chave de fato: {chave de fato} Num. Lançamento: {número do lançamento}. Informe Movimentação Financeira que faça parte do módulo bancário”
- A movimentação de devolução precisa ser da partida Débito. Caso contrário:Mensagem exibida: “Não foi possível obter Movimentação de Devolução. Movimentação financeira de devolução do cheque de terceiros informada não é da partida Débito. Filial: {filial} Chave de fato: {chave de fato} Num. Lançamento: {número do lançamento}. Informe Movimentação de Devolução de partida de débito”
- A movimentação de devolução precisa ser da operação “Devolução de Cheque de Terceiro” (BCODEV1CHT). Caso contrário:Mensagem exibida: “Não foi possível obter Movimentação de Devolução. Movimentação financeira de devolução do cheque de terceiros informada não é uma operação BCODEV1CHT. Filial: {filial} Chave de fato: {chave de fato} Num. Lançamento: {número do lançamento}. Movimentação de devolução deve ser uma operação BCODEV1CHT”
- Efeito da reapresentação bem-sucedida. Para cada movimentação validada, o sistema marca a movimentação de devolução original como conciliada e cria uma nova movimentação de débito e outra de crédito sob a operação “Reapresentação de Cheque de Terceiro” (BCOREAPCHT), persistindo cada uma com confirmação de transação (commit) própria. Se todas as movimentações da operação tiverem uma operação financeira definida, o sistema aciona a integração contábil, gerando automaticamente os lançamentos contábeis correspondentes.
- Falha inesperada durante a gravação. Se ocorrer um erro não previsto durante a transação de reapresentação, toda a operação é revertida (rollback) e o sistema não retorna nenhum dado de operação criada.Mensagem exibida: mensagem genérica de erro de execução do sistema.
Permissões
Acesso à rotina: “EditViewDeReapresentacaoDeChequeDeTerceiro” (ID 1594)
| Ação | Permissão | ID |
|---|---|---|
| Listar | coberta por “EditViewDeReapresentacaoDeChequeDeTerceiro” | — |
| Salvar | “ReapresentacaoDeChequeDeTerceiro/Salvar” | 3035 |
| Imprimir | “ReapresentacaoDeChequeDeTerceiro/Imprimir” | 3036 |
