Relatório de Negativação SERASA
WRSER001 — Relatório de Negativação SERASA
“Negativação SERASA” é o processo pelo qual a empresa registra clientes inadimplentes (títulos vencidos e não pagos) no birô de crédito SERASA, como mecanismo de cobrança; a “exclusão” é a retirada desse registro, feita quando o título é quitado ou renegociado.
1. Visão Geral
“Negativação SERASA” é o processo pelo qual a empresa registra clientes inadimplentes (títulos vencidos e não pagos) no birô de crédito SERASA, como mecanismo de cobrança; a “exclusão” é a retirada desse registro, feita quando o título é quitado ou renegociado. Este relatório lista os títulos a receber que tiveram movimentação de inclusão e/ou exclusão no SERASA dentro de um período, mostrando cliente, vendedor, título, datas e valores — usado pela área de cobrança/crédito para acompanhar quais clientes foram negativados, quais tiveram a negativação retirada, e a situação atual de cada título envolvido.
2. Como Acessar
Menu Financeiro > Relatórios (rotina “WRSER001”).
3. Parâmetros de Filtro
| Parâmetro | Obrigatório | Tipo de controle | Operador | O que filtra |
|---|---|---|---|---|
| prmFilial | Sim | Lista de seleção (múltipla) | Contido em | Filiais dos títulos |
| prmDataEmissao | Sim | Intervalo de datas | Entre | Data de emissão do título |
| prmDataVencimento | Não | Intervalo de datas | Entre | Data de vencimento do título |
| prmCarteira | Não | Lista de seleção (múltipla) | Contido em | Carteira do título |
| prmVendedorInicial / prmVendedorFinal | Não | Lista de seleção | Contido em | Faixa de código de vendedor |
| prmParticipanteInicial / prmParticipanteFinal | Não | Lista de seleção | Contido em | Faixa de código de cliente/participante |
| prmStatusTitulo | Não | Lista de seleção | Igual | Status do título: Aberto ou Liquidado |
| prmStatusSerasa | Não | Lista de seleção | Igual | Tipo de movimento SERASA: Inclusão ou Exclusão |
4. Tabelas e Views Utilizadas
| Entidade/Classe C# | Tabela/View real no banco | O que representa |
|---|---|---|
| ViewDeTitulosAReceber | VWATAK4NET_TITULOS_A_RECEBER | View com os títulos a receber, já com saldo, status e datas calculadas |
| MovimentacaoFinanceira | TBMOVTOFIN | Lançamentos financeiros — usada para localizar os lançamentos de inclusão/exclusão no SERASA |
| BancoCaixa | TBBANCOCAIXA | Cadastro de carteiras — usada para restringir aos lançamentos feitos contra uma carteira do tipo “Serasa” |
5. Regras de Negócio e Cálculos
- Filtro dos títulos. O relatório parte dos títulos a receber filtrados por filial, data de emissão, data de vencimento, carteira, faixa de vendedor, faixa de cliente e status do título.
- Movimentos de inclusão e exclusão. São considerados apenas os lançamentos financeiros cuja operação seja especificamente de inclusão ou exclusão de negativação SERASA, e que tenham sido lançados contra uma carteira cadastrada como do tipo “Serasa” — a negativação sempre passa por uma carteira específica configurada para esse fim.
- Cruzamento título × movimento. O sistema cruza os títulos com os movimentos de inclusão (formando a lista de títulos incluídos no SERASA) e, separadamente, com os movimentos de exclusão (títulos excluídos).
- Montagem do resultado. Para um título que teve inclusão e depois exclusão, o relatório gera duas linhas: uma de “Inclusão” e uma de “Exclusão”, cada uma com a data e os dados do respectivo movimento. Títulos que só tiveram inclusão (sem exclusão) ainda geram uma segunda linha “Exclusão” reaproveitando os dados da inclusão — comportamento a validar com o time de negócio, pois pode não refletir a intenção original do relatório (títulos sem exclusão real aparecendo com uma linha de “Exclusão”). Títulos que só têm exclusão geram apenas essa linha.
- Remoção de duplicidade. Ao final, o resultado é agrupado e filtrado para eliminar linhas duplicadas que possam surgir do cruzamento entre títulos e movimentos.
6. Colunas Principais do Resultado
| Campo | Descrição de negócio |
|---|---|
| LetraSerasa / TipoDeOperacao | Indicador (I/E) e descrição textual do movimento — “Inclusão” ou “Exclusão” |
| Cod_cli_for / Nome_cli_for | Código e nome do cliente negativado |
| Cod_vendedor / Nome_vendedor | Vendedor responsável pela venda de origem |
| cod_filial, cod_docto, serie_docto, num_docto, num_parcela | Identificação do documento/parcela do título |
| Data_emissao / Data_vencto | Datas de emissão e vencimento do título |
| Valor_titulo / Valor_saldo | Valor original e saldo em aberto do título |
| DataDoLancamentoInclusao / DataDoLancamentoExclusao | Datas em que ocorreram os lançamentos de inclusão/exclusão no SERASA |
| Num_remessa_Inclusao / Num_remessa_Exclusao | Número da remessa enviada ao SERASA para inclusão/exclusão |
| Status_titulo | Situação atual do título (Aberto/Liquidado) |
| Cod_carteira / Nome_carteira | Carteira/agência SERASA usada no lançamento |
| ValorDoLancamentoDC | Valor do lançamento financeiro (débito/crédito) da movimentação SERASA |