Fale conosco
WhatsApp

Antecipação de boletos

Este manual descreve o módulo de Desconto / Antecipação de Duplicatas — a operação em que a empresa leva ao banco boletos/duplicatas a receber e o banco adianta o caixa hoje, cobrando encargos (juros, IOF e tarifas).

1 - Visão geral e conceito contábil

Este manual descreve o módulo de Desconto / Antecipação de Duplicatas — a operação em que a empresa leva ao banco boletos/duplicatas a receber e o banco adianta o caixa hoje, cobrando encargos (juros, IOF e tarifas). Cada capítulo aborda uma área:

O que é: no desconto / antecipação de duplicatas, a empresa entrega ao banco boletos a receber e recebe o dinheiro adiantado. O banco credita o valor líquido (o valor de face menos os juros, IOF e tarifas) e, no vencimento, é o próprio cliente quem paga o banco. A empresa continua responsável se o cliente não pagar — é a chamada coobrigação: se o boleto não for quitado, a empresa "recompra" a duplicata, devolvendo o dinheiro ao banco.

O problema

A empresa antecipa boletos no banco para ter caixa hoje. Sem um tratamento adequado no ERP, surgem problemas:

Como o sistema trata

O ciclo tem três momentos: o desconto (geração do borderô), a liquidação (cliente paga) e a recompra (cliente não paga).

No desconto (geração do borderô)

Ao gerar o borderô na tela de geração (ver capítulo Gerar o desconto), o sistema faz, em uma única operação:

Exemplo numérico (operação real): um borderô de R$ 11.928,37 de valor bruto, com R$ 167,15 de juros, resulta em R$ 11.761,22 creditados no banco. Vale a identidade líquido + encargos = bruto (11.761,22 + 167,15 = 11.928,37). Quando houver IOF e tarifas, eles entram do mesmo lado dos juros, reduzindo ainda mais o líquido.

Na liquidação (o cliente paga o boleto)

Quando o cliente paga o boleto descontado, não há movimento novo no extrato — o dinheiro já entrou no dia do desconto. É um encontro de contas: o recebível original é liquidado e o passivo "Duplicatas Descontadas" é baixado por contrapartida, sem gerar caixa novo (um anula o outro).

Essa liquidação ocorre exclusivamente pelo retorno bancário — pelo arquivo de retorno (CNAB) ou pela consulta de liquidados por API. A baixa manual de um título descontado fica bloqueada nas telas de recebimento; detalhes no capítulo Liquidação pelo retorno bancário.

Na recompra (o cliente não paga)

Se o cliente não paga (protesto, devolução, inadimplência), a operação é manual: o estorno do desconto devolve o valor bruto ao banco, baixa o passivo e reabre o recebível original para cobrança direta ao cliente. Pode ser feito para o borderô inteiro ou para um único título. Detalhes no capítulo Recompra e estorno.

Conceito contábil

O ponto central é que o principal antecipado não reduz o contas a receber nem entra no resultado: ele é um passivo (um empréstimo lastreado nos recebíveis), que fica fora do DRE. Já os encargos financeiros entram no DRE como despesa.

Os lançamentos, resumidos:

Momento Débito Crédito
No desconto Banco (líquido) + Despesas Financeiras — juros/IOF/tarifa Duplicatas Descontadas (bruto)
Na liquidação (cliente paga) Duplicatas Descontadas Contas a Receber
Na recompra (cliente não paga) Duplicatas Descontadas Banco

No desconto, o débito no Banco (líquido) mais os encargos igualam o crédito em "Duplicatas Descontadas" (bruto) — o lançamento fecha. Na liquidação não há trânsito de caixa na empresa, porque foi o banco quem recebeu do cliente. Um eventual juro extra cobrado do cliente na recompra é lançado à parte, manualmente, como receita.

Melhoria sobre sistemas concorrentes

Diferente de sistemas que lançam as tarifas soltas ou usam uma conta de controle apenas para conciliar por OFX, o TryERP lança o crédito real na conta bancária e cada encargo (juros, IOF, tarifa) vira uma linha conciliável vinculada ao borderô. O resultado é conciliação automática: o líquido do borderô bate exatamente com o depósito do banco, e cada taxa fica rastreável.

Situações de um borderô

Na Consulta de Descontos, a coluna Situação mostra em que estado está cada borderô. Ela é derivada dos títulos que o compõem:

Situação Significado
Aberto Nenhum título do borderô foi liquidado nem estornado ainda — a operação está em andamento
Parcial Pelo menos um título já foi resolvido (liquidado ou estornado), mas ainda há títulos em aberto
Liquidado Todos os títulos foram resolvidos e nenhum foi estornado — todos os clientes pagaram
Estornado O borderô inteiro foi estornado (recompra total), ou todos os títulos foram resolvidos sem nenhuma liquidação
Encerrado Todos os títulos foram resolvidos, com uma mistura de liquidados e estornados

Essas mesmas situações aparecem na consulta e podem ser usadas como filtro na impressão do relatório (ver capítulo Consulta e relatório).

2 - Configuração inicial

Antes de usar o Desconto de Duplicatas no dia a dia, alguns itens precisam estar em ordem. A base do módulo — tabelas, as classificações contábeis de apoio e as telas no menu — já vem pronta com a atualização do sistema: você não precisa instalar nem executar nada. O que resta é uma configuração rápida, feita uma única vez, normalmente pelo administrador ou supervisor: definir quem pode usar o recurso (permissões) e conferir alguns pré-requisitos de operação.

As três Receitas/Despesas de apoio e as telas "Desconto de Duplicatas" e "Consulta de Descontos" (no menu Financeiro) são criadas automaticamente na atualização do sistema. Este capítulo é para quem administra o sistema; o uso do recurso em si está nos capítulos seguintes.

1. Permissões

Quem pode gerar o desconto, estornar/recomprar e imprimir o relatório é controlado por quatro ações de permissão. Elas podem ser ajustadas por perfil ou por operador na tela de administração de permissões. Os códigos e a postura padrão recomendada são:

Código Controla Postura padrão
DESCONTO_DUPLICATA.GERAR Gerar o desconto/antecipação (borderô) Permitido
DESCONTO_DUPLICATA.ESTORNAR Estornar o borderô e recomprar títulos Solicitar autorização (de supervisor)
DESCONTO_DUPLICATA.LIQUIDAR_MANUAL Baixar manualmente um título descontado (exceção ao bloqueio) Bloqueado
RELATORIO.IMPRIMIR.DescontosECompensacoes Imprimir o relatório "Descontos e Compensações" Permitido

Mantenha DESCONTO_DUPLICATA.LIQUIDAR_MANUAL como Bloqueado na maioria dos casos. A liquidação de um título descontado deve ocorrer pelo retorno bancário (ver capítulo Liquidação pelo retorno bancário); a baixa manual é uma exceção reservada a poucos operadores. O fluxo de estorno/recompra e a exigência de autorização estão no capítulo Recompra e estorno.

O acesso às telas de geração e de consulta é liberado automaticamente junto com o cadastro das telas na atualização — não é preciso configurar nada além do que está na tabela acima.

%%INSIRA PRINT DE tela de administração de permissões com as ações DESCONTO_DUPLICATA.* AQUI%%

2. Receitas/Despesas do módulo

A operação usa três Receitas/Despesas (RD), criadas automaticamente pela atualização do sistema. Você não precisa cadastrá-las — basta conhecê-las para entender os lançamentos e para a conversa com a contabilidade. O sistema as localiza pela descrição; por isso não devem ser renomeadas nem ter a natureza (+/−) alterada.

Receita/Despesa Natureza No DRE? Para que serve
Duplicatas Descontadas Despesa () Fora do DRE O passivo gerado por título: para cada recebível descontado nasce uma "Duplicata Descontada" em aberto, pelo valor bruto e no mesmo vencimento. Representa o empréstimo que o banco adiantou, por isso não é resultado — aparece só no balancete.
Antecipacao Bancaria Receita (+) Fora do DRE A RD "neutra" usada para creditar o valor bruto na conta bancária no dia do desconto. O dinheiro entra no banco, mas não vira receita de resultado.
Juros Pagos (Desconto Duplicatas) Despesa () Dentro do DRE Recebe os encargos da operação (juros + IOF + tarifa), lançados como saída na conta. Diferentemente das duas acima, é despesa financeira real e entra no DRE — é o custo da antecipação.

Não renomeie estas RD nem altere a natureza (+/−) delas. Se a descrição mudar, o sistema deixa de encontrá-las e a geração do desconto passa a falhar; se a natureza mudar, o lançamento no banco sai invertido. As mensagens exatas e o que fazer estão no capítulo Troubleshooting e glossário.

A classificação no plano de contas (o grupo de cada RD) já vem definida pela atualização. Se a contabilidade precisar reclassificá-las — normalmente "Duplicatas Descontadas" e "Antecipacao Bancaria" em um grupo de passivo / empréstimos e "Juros Pagos (Desconto Duplicatas)" em despesas financeiras — isso é ajustado no cadastro de Receitas/Despesas, junto com a contabilidade, sem afetar o funcionamento do módulo. O conceito contábil está detalhado no capítulo Visão geral e conceito contábil.

3. Pré-requisitos de operação

Além das permissões, o operador precisa garantir a cada operação:

Checklist

Para deixar o módulo pronto para uso, confirme:

3 - Gerar o desconto (borderô)

Este capítulo mostra o passo a passo para levar os recebíveis ao banco e registrar o desconto no ERP: você seleciona os títulos em aberto que possuem boleto, informa os encargos cobrados pelo banco (juros, IOF e tarifa) e o sistema gera um borderô e lança o financeiro — o valor líquido resulta na conta bancária. Tudo isso pela tela Desconto de Duplicatas 

Pré-requisitos: as três Receitas/Despesas de apoio já cadastradas e as permissões atribuídas (ver capítulo Configuração inicial). Além disso é obrigatório haver um caixa aberto — o crédito do valor no banco exige caixa aberto e a operação só roda pela interface (nunca em job automático).

1. Abrir a tela e escolher empresa e conta

  1. Acesse o menu Banco→ Antecipação de Boletos.
  2. Confira o campo "Empresa" (emitente). Ao abrir, a tela já preenche o emitente logado, se houver — este campo é obrigatório.
  3. Selecione a "Conta (banco)" — a conta bancária do banco que adiantou o dinheiro. É nela que o líquido será creditado; sem ela não há como lançar o financeiro.

Ao abrir, a tela também já traz valores padrão que você pode ajustar:

2. Consultar os recebíveis candidatos (F3)

Pressione a tecla F3 ou clique no botão "Consultar (F3)" para popular a grade. Aparecem os recebíveis em aberto que possuem boleto e que ainda NÃO foram descontados. Especificamente, um título entra na lista quando:

Se você preencher o campo "Cliente (opcional)", a consulta restringe àquele cliente; senão, traz todos. O resultado vem com uma linha por parcela, ordenado por data de vencimento. Após "Gerar", a consulta é recarregada e os títulos já descontados somem da lista.

Colunas da grade (todas somente leitura):

Coluna O que mostra
(seleção) Checkbox de multi-seleção; há um checkbox no cabeçalho para marcar/desmarcar todos.
Nº Docto Número do documento da fatura.
Cliente Razão social do parceiro.
Vencimento Data de vencimento da parcela.
Valor Saldo da parcela.
Nosso Nº Nosso número do boleto.
Cód. Cliente Código do parceiro.
CPF/CNPJ CPF/CNPJ do parceiro.
Linha Digitável Linha digitável do boleto.

3. Marcar os títulos do borderô

  1. Marque o checkbox de cada título que fará parte deste borderô.
  2. Para incluir todos os candidatos de uma vez, use o checkbox no cabeçalho da coluna de seleção.

Sempre é gerado um único borderô agrupado com todos os títulos marcados. A opção "por documento" (um processo por documento) não está disponível nesta tela — o comportamento é sempre borderô agrupado.

4. Informar os encargos

Preencha os campos do painel de operação do desconto conforme o que o banco cobrou:

Os juros são informados como total (em R$ ou %) e o sistema faz o rateio proporcional por título (peso = valor do documento ÷ valor bruto); o último título absorve a diferença de arredondamento. Você não precisa distribuir os juros manualmente. IOF e tarifa entram do mesmo lado dos juros, reduzindo o líquido.

Esta tela não possui campo de observação. O borderô é gravado sem observação preenchida pela tela de geração.

5. Gerar

  1. Clique no botão "Gerar" (verde).
  2. O sistema valida a seleção, a empresa, a conta e os encargos e verifica a permissão DESCONTO_DUPLICATA.GERAR. Sem a permissão concedida, a operação é cancelada.
  3. Aparece a confirmação (título "Confirmar geração", botões Sim/Não) com os totais:
    • "Confirma o desconto de [quantidade] título(s)?"
    • "Bruto: [total bruto]"
    • "Encargos: [encargos]"
    • "Líquido a creditar no banco: [bruto − encargos]"
  4. Confirme com Sim. O sistema cria o passivo por título (a "Duplicata Descontada", em aberto, com o mesmo vencimento e valor do recebível) e lança o financeiro na conta escolhida.

No financeiro, o borderô produz duas pernas na conta bancária:

O recebível original do cliente não é alterado: ele passa a ser considerado "descontado" apenas por existir o vínculo, e a baixa manual dele fica bloqueada (ver capítulo Liquidação pelo retorno bancário).

Resultado esperado no extrato da conta: entra o valor bruto (crédito) e saem os encargos (débito), de modo que o saldo líquido = bruto − encargos — exatamente o depósito que o banco entrega. Ao final, aparece a mensagem "Borderô de desconto #[id] gerado e financeiro lançado com sucesso." e a consulta é recarregada.

Para acompanhar o borderô, ver o capítulo Consulta e relatório. Para desfazer um desconto ou tratar inadimplência, ver Recompra e estorno.


Mensagens que podem aparecer

Ao consultar (F3)

Quando Mensagem (verbatim)
Empresa não selecionada "Selecione a empresa (emitente)."
Empresa inválida "Empresa inválida."
Nenhum candidato para o filtro "Nenhum recebível em aberto (com boleto) encontrado para o filtro."
Falha na consulta "Erro ao consultar candidatos: " + [mensagem do erro]

Ao gerar

Quando Mensagem (verbatim)
Nenhum título marcado "Selecione ao menos um título (marque o checkbox)."
Empresa não selecionada "Selecione a empresa (emitente)."
Conta não selecionada "Selecione a conta (banco que adiantou)."
Empresa inválida "Empresa inválida."
Conta inválida "Conta inválida."
Encargos ≥ bruto "Os encargos (juros/IOF/tarifa = [valor]) não podem ser maiores ou iguais ao valor bruto ([valor bruto])."
Sem caixa aberto "Abra um caixa antes de gerar o desconto (o crédito do valor no banco exige caixa aberto)."
Conta bancária não informada "Informe a conta bancária que adiantou o desconto."
RD do passivo ausente Receita/Despesa não cadastrada, verifique a etapa de configurações neste manual
RD do crédito ausente Receita/Despesa não cadastrada, verifique a etapa de configurações neste manual
RD dos juros ausente Receita/Despesa não cadastrada, verifique a etapa de configurações neste manual
Falha na geração "Erro ao gerar o desconto: " + [mensagem do erro]

Se os títulos já foram gravados mas o lançamento financeiro falhar, o sistema avisa: "O borderô #[id] foi criado, mas o lançamento financeiro no banco falhou: [mensagem do erro] — estorne o borderô e tente novamente após corrigir." Nesse caso, corrija o problema apontado (por exemplo, uma RD renomeada ou faltando) e estorne o borderô antes de refazer o desconto. O tratamento das RDs e das demais mensagens está detalhado no capítulo Troubleshooting e glossário.

4 - Liquidação pelo retorno bancário

Quando o boleto descontado vence e o próprio cliente paga o banco, o ciclo do desconto se fecha. A boa notícia: você não precisa fazer nada manualmente — a baixa acontece sozinha quando o retorno bancário é processado.

Pré-requisito: o borderô já gerado e com o financeiro lançado (ver capítulo "Gerar o desconto (borderô)").

1. A baixa acontece sozinha

A liquidação de um título descontado ocorre exclusivamente pelo retorno bancário. Quando o banco confirma que aquele boleto foi pago, o sistema identifica que o título estava descontado e faz a baixa automaticamente, sem intervenção do operador.

Existem dois caminhos, e ambos disparam a mesma baixa de bastidor:

É um comportamento silencioso: não aparece nenhuma mensagem de confirmação específica do desconto durante o processamento do retorno. O sistema detecta o título descontado, faz a baixa por contrapartida e segue o processamento normal dos demais boletos. A tarifa bancária do retorno, quando houver, continua sendo lançada normalmente mesmo para o boleto descontado.

2. Não há movimento no extrato — é um encontro de contas

Importante: nesse momento NÃO há entrada de dinheiro no banco. O dinheiro já entrou no dia do desconto, quando o banco adiantou o caixa. Se o sistema creditasse a conta agora, o valor entraria em dobro.

A liquidação do título descontado é um encontro de contas, não uma nova entrada de caixa. O sistema simplesmente anula duas contas que ficaram vivas desde o desconto:

Como os dois têm o mesmo valor e vencimento, eles se anulam por contrapartida — sem gerar crédito na conta bancária. O resultado bate com a realidade: o dinheiro entrou lá atrás (no desconto), e agora quem recebeu do cliente foi o banco.

Etapa Banco (caixa) Recebível do cliente Passivo "Duplicatas Descontadas"
No desconto + líquido (bruto − encargos) Aberto (descontado) + bruto (aberto)
Cliente paga o banco (retorno) — (sem movimento) Liquidado Baixado

O detalhe contábil (por que o passivo origem=9 fica fora do DRE e por que os encargos entram no DRE) está no capítulo "Visão geral e conceito contábil".

3. O que muda na consulta

Depois que o retorno é processado, a situação do título e do borderô se atualiza na Consulta de Descontos de Duplicatas:

Uma vez liquidado, o título deixa de ser tratado como descontado: não fica mais destacado nem bloqueia baixa manual (ele já está resolvido). Os detalhes da tela de consulta e do relatório estão no capítulo "Consulta e relatório".

Pagamento parcial: se o cliente pagar apenas parte do boleto no retorno, o sistema faz a baixa proporcional do recebível e do passivo, e o título permanece com o saldo restante em aberto.

4. Baixa manual — bloqueada por padrão

Como a liquidação correta é sempre pelo retorno, dar baixa manual num título descontado é bloqueado por padrão. Isso evita o erro mais grave da operação: creditar o caixa de novo por um dinheiro que já entrou no dia do desconto.

Na tela de liquidação de faturas, os títulos descontados são fáceis de identificar: aparecem com fundo amarelo suave na grade.

Ao tentar liquidar um desses títulos (pressionando ENTER na parcela ou confirmando a liquidação), o operador sem a permissão de exceção é impedido e vê a mensagem:

"Título descontado/antecipado — a baixa é feita somente pelo retorno bancário." (janela "Título Descontado")

O preenchimento do valor a liquidar é bloqueado e a operação não prossegue — as demais parcelas não descontadas continuam podendo ser liquidadas normalmente.

Não dê baixa manual num título descontado sem necessidade real. O caminho certo é sempre o retorno bancário. Fazer a baixa à mão pode duplicar a entrada de caixa (o dinheiro já entrou no desconto) e desalinhar a conciliação com o borderô que o banco entregou.

5. Quem pode liquidar manualmente (exceção)

Existe uma exceção controlada por permissão, para casos raros em que a baixa realmente precisa ser feita à mão. A baixa manual de título descontado só é liberada a quem tiver a permissão:

Código da permissão Descrição Postura padrão
DESCONTO_DUPLICATA.LIQUIDAR_MANUAL Liquidar manualmente titulo descontado (exceção ao bloqueio) Bloqueado

Quando o operador tenta liquidar um título descontado, o sistema solicita a permissão com o rótulo "Liquidar manualmente título(s) descontado(s)". Se a permissão não for concedida, a operação é abortada e nada é liquidado.

Mesmo quando a permissão é concedida, a baixa manual segue a mesma lógica do retorno: recebível e passivo se anulam por contrapartida, sem crédito na conta. A única diferença é que a baixa manual localiza o título pela parcela, e o retorno localiza pelo boleto. Ou seja: a permissão libera quem pode agir, mas não muda a natureza do encontro de contas.

No dia a dia, o cenário esperado é não mexer em nada: importe o retorno (ou consulte os liquidados pela API) e deixe o sistema fechar o ciclo. Recorra à baixa manual apenas em situações excepcionais, com a permissão adequada.


Quando o cliente não paga o boleto (inadimplência, protesto ou devolução), o caminho é outro: a recompra, que devolve o valor ao banco e reabre o recebível para cobrança direta. Isso é tratado no capítulo "Recompra e estorno".

5 - Recompra e estorno

Recompra (ou estorno) é a operação que desfaz um desconto já gerado. Ela devolve o valor antecipado ao banco e reabre o recebível original para cobrança direta ao cliente. É o passo oposto ao da geração do borderô (ver capítulo "Gerar o desconto (borderô)").

Toda recompra/estorno é feita pela tela Consulta de Antecipações(menu Banco → Consultar Antecipações). A situação e o detalhe dos borderôs são explicados no capítulo "Consulta e relatório".

1. Quando usar

Existem duas situações típicas:

Se o boleto foi pago, o caminho é a liquidação automática pelo retorno bancário, não a recompra (ver capítulo "Liquidação pelo retorno bancário"). Um título já liquidado não pode ser recomprado.

2. Os dois caminhos

A Consulta de Descontos oferece dois botões, para dois níveis de granularidade:

Botão Atua sobre Use quando
Estornar / Recompra O borderô inteiro selecionado no grid principal Quer desfazer o desconto de todos os títulos ainda em aberto do borderô
Recomprar título Um único título focado dentro do detalhe "+" Apenas um cliente ficou inadimplente e os demais títulos do borderô seguem normais

Os dois exigem a mesma permissão, DESCONTO_DUPLICATA.ESTORNAR, cuja postura padrão é Solicitar Autorização de um supervisor. Ao acionar o botão, o sistema pede essa autorização antes de prosseguir.

O Estornar / Recompra só processa os itens que ainda estão em aberto: ele ignora os títulos do borderô que já foram liquidados (pagos) e os que já foram recomprados anteriormente.

3. Estornar o borderô inteiro

  1. Na Consulta de Descontos, selecione o borderô na lista principal.
  2. Clique em Estornar / Recompra.
  3. Conceda a autorização exigida (permissão DESCONTO_DUPLICATA.ESTORNAR), se solicitada.
  4. No diálogo Estorno de Desconto de Duplicata, informe o motivo (obrigatório) e confirme. Se o motivo ficar em branco, a operação é cancelada.
  5. Confirme a caixa Confirmar estorno (Sim/Não).

4. Recomprar um título específico

  1. Na lista principal, expanda o borderô clicando no "+" para abrir o detalhe Títulos do Borderô.
  2. Clique (selecione) o título que deseja recomprar.
  3. Clique em Recomprar título.
  4. Conceda a autorização exigida, se solicitada.
  5. No diálogo Recompra de Título, informe o motivo (obrigatório) e confirme.
  6. Confirme a caixa Confirmar recompra (Sim/Não).

Somente aquele título é devolvido ao banco e marcado como estornado; o restante do borderô fica intacto.

5. O que acontece no financeiro

O efeito depende de o financeiro do borderô já ter sido lançado ou não. O sistema decide o caminho automaticamente:

Em ambos os caminhos, o recebível original volta a ficar em aberto, pronto para cobrança direta ao cliente, e o título deixa de bloquear a baixa manual.

Caixa aberto é obrigatório na recompra. Sempre que o financeiro já tiver sido lançado, o valor antecipado é debitado de volta no banco — e isso não roda sem caixa aberto nem sem conta bancária. Abra o caixa antes de iniciar a recompra.

6. Situação resultante

A situação exibida na consulta é derivada dos itens do borderô. Após um estorno/recompra, ela passa a ser:

Situação Quando ocorre
Estornado O borderô inteiro foi estornado, ou todos os itens acabaram estornados (nenhum foi liquidado).
Parcial Pelo menos um item já foi resolvido (liquidado ou estornado), mas ainda há títulos em aberto.
Encerrado Todos os itens já estão resolvidos, com mistura de títulos liquidados e estornados.

Assim, ao recomprar um único título de um borderô com vários, o borderô costuma ficar Parcial (ainda há títulos abertos) e, quando o último item se resolve, encerra como Encerrado (se houve mistura) ou Estornado (se todos foram recomprados).

Não é possível excluir um borderô diretamente — os botões de inclusão, edição e exclusão estão bloqueados na consulta. Para desfazer um desconto, use sempre o Estornar / Recompra.

7. Cobrança de encargos ao cliente

A recompra apenas devolve o valor bruto ao banco e reabre o recebível original. Os encargos extras (juros de mora, multa, tarifas de devolução) que você queira cobrar do cliente inadimplente não são lançados automaticamente. Se quiser cobrá-los, gere manualmente um título de receita separado (por exemplo, "Juros por recompra") — isso fica por sua conta e fora do escopo automático da recompra.

8. Mensagens que podem aparecer

Botão Estornar / Recompra

Título Mensagem (verbatim)
Atenção "Selecione um borderô na lista."
Estorno de Desconto de Duplicata "Informe o motivo do estorno/recompra (obrigatório):"
Confirmar estorno "Confirma o estorno do borderô #<id>? Se o financeiro já foi lançado, o valor antecipado será DEBITADO de volta no banco (recompra)."
Sucesso "Borderô estornado com sucesso."
Erro "Erro ao estornar o borderô: <mensagem>"

Botão Recomprar título

Título Mensagem (verbatim)
Atenção "Expanda um borderô no "+" e selecione (clique) o título a recomprar."
Recompra de Título "Informe o motivo da recompra do título (obrigatório):"
Confirmar recompra "Confirma a recompra do título Docto <numeroDocumento> (<nomeParceiro>)? Se o financeiro já foi lançado, o valor deste título será DEBITADO de volta no banco."
Sucesso "Título recomprado com sucesso."
Erro "Erro ao recomprar o título: <mensagem>"

Exclusão bloqueada

Se tentar excluir um borderô diretamente, aparece (título Ação não permitida): "A exclusão direta de borderôs não é permitida. Para desfazer um desconto, use o botão "Estornar / Recompra"."

Erros do motor (recompra/estorno)

Mensagens que podem vir dentro do "<mensagem>" do erro acima, com sua causa:

Mensagem (verbatim) Causa
"Este borderô já está estornado." O borderô inteiro já havia sido estornado antes.
"Este título já está estornado." O título selecionado já havia sido recomprado.
"Este título já foi liquidado (pago); não pode ser recomprado." O boleto foi pago; use a liquidação pelo retorno, não a recompra.
"É necessário um caixa aberto para a recompra (o valor antecipado é debitado de volta no banco)." Não há caixa aberto e a operação é uma recompra (financeiro já lançado). Abra o caixa.
"É necessário um caixa aberto para a recompra (o valor do título é debitado de volta no banco)." Mesma causa, na recompra de um único título.
"Conta bancária do desconto não informada; não é possível debitar a recompra." O borderô está sem a conta bancária que adiantou; sem ela não há como debitar a recompra.
"Borderô de desconto não encontrado (<id>)." Registro do borderô não localizado (situação anômala).
"Título do desconto não encontrado (<id>)." / "Borderô do título não encontrado." / "O borderô inteiro já está estornado." Inconsistências ao recomprar um título isolado (registro ausente ou borderô já estornado).

A lista completa de mensagens e o glossário estão no capítulo "Troubleshooting e glossário".

6 - Consulta e relatório

Este capítulo cobre as duas ferramentas de acompanhamento dos descontos gerados: a tela Consulta de Descontos de Duplicatas, onde você acompanha os borderôs e seus títulos e dispara estorno/recompra, e o relatório Descontos e Compensações, que lista os títulos descontados no período com totais.


Parte A — Consulta de Descontos de Duplicatas

A tela lista todos os borderôs de desconto gerados para o emitente logado, do mais recente para o mais antigo. Cada linha é um borderô; ao expandir o "+" você vê os títulos que o compõem.

Filtros e ordenação

A tela não possui filtros próprios: ela usa o mecanismo de pesquisa/filtro padrão da grade do sistema (o mesmo das demais consultas). A carga já vem restrita ao emitente logado e ordenada pela data do desconto (mais recente primeiro) e, em seguida, pelo código. A pesquisa rápida considera o código (Cód.) e a Observação do borderô.

Colunas do borderô (grade principal)

Coluna Descrição
Cód. Código interno do borderô de desconto
Data Data do desconto
Conta Conta bancária que adiantou o valor
Bruto Soma bruta dos títulos do borderô (N2)
Juros Juros totais da operação (N2)
IOF IOF total (N2)
Tarifa Tarifa total (N2)
Líquido Valor líquido creditado no banco = bruto − encargos (N2)
Situação Situação do borderô (ver abaixo)
Observação Texto de observação do borderô

A coluna Situação

A situação de cada borderô é derivada automaticamente a partir da condição dos seus títulos (itens) — você não a edita manualmente. Ela muda sozinha conforme os títulos são liquidados pelo retorno bancário (ver capítulo "Liquidação pelo retorno bancário") ou estornados/recomprados (ver capítulo "Recompra e estorno").

Situação O que significa
Aberto Nenhum título foi resolvido ainda — todos continuam descontados, aguardando o pagamento do cliente ao banco
Parcial Pelo menos um título já foi resolvido (liquidado ou estornado), mas ainda há títulos em aberto no borderô
Liquidado Todos os títulos foram resolvidos e todos por liquidação (cliente pagou) — nenhum título foi estornado
Estornado O borderô inteiro foi estornado; ou todos os títulos foram resolvidos sem que nenhum tenha sido liquidado
Encerrado Todos os títulos foram resolvidos, com mistura de liquidados e estornados no mesmo borderô

Como a situação é calculada a partir dos itens, ela evolui sozinha: um borderô nasce Aberto, passa a Parcial à medida que títulos são pagos ou recomprados e termina em Liquidado, Estornado ou Encerrado quando não resta nenhum título em aberto.

Master-detail: os "Itens" do borderô

Ao clicar no "+" na frente de uma linha, abre-se a relação de itens, rotulada "Títulos do Borderô". É a lista dos títulos que compõem aquele desconto, carregada somente ao expandir. Cada item traz o rateio proporcional de juros/IOF/tarifa e a sua própria situação.

Coluna Descrição
Docto Número do documento do título
Cliente Razão social do parceiro
Nosso Nº Nosso número do boleto
Linha Digitável Linha digitável do boleto
Vencimento Data de vencimento do título
Bruto Valor do documento (N2)
Juros Juros rateados para este título (N2)
IOF IOF rateado para este título (N2)
Tarifa Tarifa rateada para este título (N2)
Líquido Líquido do título (N2)
Situação Situação do título individual: Aberto, Liquidado ou Estornado

Botões da tela

A ribbon da consulta oferece três ações:

Botão O que faz
Estornar / Recompra Estorna o borderô inteiro selecionado na grade principal (recompra de todos os títulos em aberto). Ver capítulo "Recompra e estorno".
Recomprar título Recompra apenas o título selecionado no detalhe "+" — também disponível pelo botão direito sobre o título. O caso de um único cliente inadimplente, mantendo o resto do borderô intacto. Ver capítulo "Recompra e estorno".
Relatório Imprime o relatório "Descontos e Compensações" (ver Parte B, abaixo).

Os passos, permissões e mensagens do Estornar / Recompra e do Recomprar título estão detalhados no capítulo "Recompra e estorno". Ambos exigem a permissão de estorno e pedem o motivo antes de confirmar.

Exclusão bloqueada

Nesta tela não é possível incluir, editar nem excluir borderôs diretamente — os botões de incluir e editar ficam ocultos e o botão de excluir fica desabilitado. Se a exclusão for acionada por atalho, o sistema exibe (título "Ação não permitida"):

"A exclusão direta de borderôs não é permitida. Para desfazer um desconto, use o botão "Estornar / Recompra"."

Isso é intencional: desfazer um desconto tem consequências financeiras (devolução do valor ao banco, reabertura do recebível). Por isso o único caminho para desfazer é o estorno/recompra, que segue o fluxo de autorização e registra o motivo.


Parte B — Relatório "Descontos e Compensações"

O relatório lista uma linha por título descontado (item de borderô) no período escolhido, com o rateio de juros/IOF/tarifa por título, o valor líquido e a situação, encerrando com os totais. É gerado em orientação paisagem (A4). O título impresso no cabeçalho é "Descontos e Compensações de Duplicatas", com subtítulo trazendo o nome fantasia do emitente logado e a data/hora de geração, além da linha "Período: [data inicial] a [data final] | Situação: [situação]".

Como abrir

  1. Abrir a tela Consulta de Descontos de Duplicatas
  2. Clicar no botão Relatório na ribbon
  3. Preencher os parâmetros solicitados (ver abaixo) e confirmar

Parâmetros solicitados ao abrir

Parâmetro Descrição Padrão
Data inicial Início do período (filtra pela data do desconto) 1º de janeiro do ano corrente
Data final Fim do período (filtra pela data do desconto) Data de hoje
Situação Lista suspensa para filtrar por situação Todos

A lista de Situação oferece os valores: Todos, Aberto, Parcial, Liquidado, Estornado, Encerrado. Quando diferente de "Todos", o relatório filtra também pela situação escolhida.

A geração atual do relatório classifica cada título apenas como Aberto, Liquidado ou Estornado. Por isso, embora a lista ofereça também "Parcial" e "Encerrado", filtrar por um desses dois valores não retorna nenhuma linha. Para uma visão consolidada, use o filtro "Todos".

Colunas do relatório

Coluna Descrição
Docto Número do documento do título
Cliente Razão social do parceiro
Vencimento Data de vencimento (dd/MM/yyyy)
Bruto Valor do documento (N2)
Juros Juros rateados para o título (N2)
IOF IOF rateado para o título (N2)
Tarifa Tarifa rateada para o título (N2)
Líquido Valor líquido do título (N2)
Situação Situação do título (Aberto / Liquidado / Estornado)

Totais

No rodapé, sob o rótulo "TOTAIS", o relatório soma (N2) as colunas Bruto, Juros, IOF, Tarifa e Líquido. Não há total para Docto, Cliente, Vencimento nem Situação.

Permissão

A impressão do relatório é controlada pela permissão RELATORIO.IMPRIMIR.DescontosECompensacoes (postura padrão: Permitido). A verificação é feita no momento da impressão. Se o relatório não gerar, confirme com o administrador se o operador tem acesso a essa permissão.

Se ao imprimir aparecer uma mensagem semelhante a "o caminho da rede não foi encontrado" (ou erro de acesso a caminho/pasta), o problema normalmente não é do relatório: trata-se de configuração de sessão — a pasta de impressão padrão está apontada para um local de rede que está fora do ar ou inacessível. Verifique a pasta de impressão configurada e a disponibilidade da rede antes de suspeitar dos dados do desconto.