1.1. Visão Geral
O Relatório de Carteira de Cobrança é um extrato analítico, apresentado linha a linha por título, da carteira do beneficiário. Permite consultar os títulos sob diferentes recortes de status e período, combinando o tipo de situação (Em Aberto, Liquidados, Baixados etc.) com o tipo de intervalo de data (vencimento ou pagamento/baixa).
1.2. Localização no Sistema
Relatórios → aba Carteira de Cobrança
O menu Relatórios é exibido apenas para usuários com a permissão correspondente.
1.3. Filtros
Filtro
- Tipo: Dropdown
- Obrigatoriedade: Obrigatório
- Comportamento: Apresenta 14 combinações de status × tipo de intervalo.
Mensagem (filtro não selecionado): “Campo obrigatório”
Opções disponíveis no dropdown Filtro:
|
Opção |
|
Todos (por intervalo de vencimento) |
|
Em Aberto (por intervalo de vencimento) |
|
Liquidados (por intervalo de vencimento) |
|
Liquidados (por intervalo de pagamento) |
|
Baixados por Decurso de Prazo (por intervalo de vencimento) |
|
Baixados por Decurso de Prazo (por intervalo de decurso de prazo) |
|
Baixado Banco (por intervalo de vencimento) |
|
Baixado Banco (por intervalo de baixa) |
|
Baixado Protestado (por intervalo de vencimento) |
|
Baixado Protestado (por intervalo de baixa) |
|
Baixado Manualmente (por intervalo de vencimento) |
|
Baixado Manualmente (por intervalo de baixa) |
|
Títulos Descontados (por intervalo de vencimento) |
|
Protesto Cancelado (por intervalo de vencimento) |
Pagador
- Tipo: Dropdown com busca (rolagem infinita)
- Obrigatoriedade: Opcional
- Comportamento: Permite localizar o pagador digitando nome, CPF ou CNPJ.
-
- Obrigatoriedade: Opcional
- Comportamento: Permite localizar o pagador digitando nome, CPF ou CNPJ.
Intervalo
- Tipo: Seletor de intervalo de datas
- Obrigatoriedade: Obrigatório
Mensagem (intervalo não preenchido): “Informe o período”
Mensagem (intervalo excedido): “O intervalo de datas não pode ser superior a 365 dias.”
1.4. Colunas do Relatório
Colunas padrão, exibidas na maioria dos filtros:
|
Coluna |
|
Pagador (documento + nome) |
|
Conta |
|
Nosso Número |
|
Número Documento |
|
Data Vencimento |
|
Valor Nominal |
|
Data Pagamento/Baixa |
|
Valor Recebido |
|
Dias em Atraso |
|
Protestado/Negativado (Sim / Sim (Serasa) / Não) |
|
Juros/Multa |
|
Status |
|
Status TD |
1.5. Exportação
O relatório pode ser exportado em PDF ou Excel, com geração síncrona e download direto pelo navegador.
Nome do arquivo gerado:
- pdf (formato PDF)
- xlsx (formato Excel)
1.6. Regras Condicionais e Erros
|
Cenário |
Mensagem exibida |
|
Data final anterior à data inicial |
A data final deve ser igual ou posterior à data inicial. |
|
Período acima do limite permitido |
O período máximo permitido é de 365 dias. [Acceptance Criteria original citava 365 dias como limite de mensagem — confirmado em código] |
|
Filtro sem nenhum resultado |
Nenhum registro, por favor refaça o filtro. |
|
Acesso sem permissão / token inválido |
Acesso negado (403) ou não autorizado (401), conforme o caso |
|
Erro interno inesperado |
Erro interno – contate o suporte |