Multas

1) BNWEB – Integração de Multa

O BNWeb oferece mecanismos de integração de Multa. Esta integração permite que sistemas da instituição, possam efetivamente controlar as multas e seus pagamentos.

Ao utilizar este mecanismo, a biblioteca fica livre das rotinas de

  • Emissão de impresso para pagamento (boleto)
  • Recebimento do pagamento
  • Manuseio de dinheiro
  • Renegociação / Isenção / …

Todos as rotinas, emissão de boleto, relatórios, etc … ficam a cargo do sistema financeiro da própria instituição.

2) Mecanismos existentes

2.1) Funcionalidades a nível de banco de dados

O BNWeb disponibiliza dentro do Banco de dados as seguintes funcionalidades

  • View para identificar multas pendentes – vbibmul0
  • Procedure para pagamento de multa – cbibebd2

2.1.1) VIEW Relação de Multas – vbibmul0

Através da VIEW vbibmul0 pode ser verificado todas as multas pendentes

Esta view apresenta as seguintes informações:

cod_multa, matricula, data_multa, valor

Exemplo em SQL SERVER:     select * from vbibmul0

Exemplo em ORACLE:            select * from vbibmul0

2.1.2) Pagamento de Multas – cbibebd2

O BNWEB disponibiliza uma procedure chamada “cbibedb0” para realizar pagamento de multa.

Através da procedure “cbibebd2” pode ser realizado o pagamento de multa.

Exemplo em SQL SERVER:

exec bnweb.dbo.cbibebd2@kcod_emprestimo, @valor_pago, @dt_pagamento, @ret output;

Exemplo em ORACLE:

cbibebd2(kcod_emprestimo, valor_pago, dt_pagamento, ret);

Procedure com 3 parâmetros de entrada (obrigatórios):

cod_emprestimo        integer          código da Multa
valor_pago                      real                 valor pago pelo usuário.
dt_pagamento            data                data efetiva do pagamento.

ret output                   integer                        resultado / retorno

No parâmetro de retorno é retornado um inteiro indicando o resultado.

@ret = 1 correto, a multa foi paga corretamente
@ret = 0 // erro, cod de emp nao existe
@ret = -1 // erro, multa já estava paga

2.2) Funcionalidades por WEBSERVICE

O BNWeb disponibiliza um webservice específico para multas com as seguintes funcionalidades:

  • listarMulta retorna as multas não pagas ( similar a view vbibmul0 )
  • pagarMulta pagamento de multa ( similar a procedure cbibebd2)

2.2.1) Relação de Multas – listarMulta

Objetivo:         retorna a relacao de multas pendentes existentes

Parâmetros:    nenhum

Retorna os dados da VIEW vbibmul0

campos:  cod_emprestiomo as cod_multa, matricula, dt_prevista as data_multa, valor

*apenas* das multas pendentes // nao pagas

2.2.2) Pagamento de Multas – pagarMulta

Objetivo: pagar / informar ao BNWEB que a Multa está paga e/ou gerenciada pelo financeiro

Parâmetros:  3 parâmetros de entrada (obrigatórios):
cod_emprestimo         integer             código da Multa
valor_pago      real                  valor pago pelo usuário.
dt_pagamento data                 data efetiva do pagamento (formato dd/mm/yyyy)
Retorno: ret    integer             resultado / retorno
No parâmetro de retorno é retornado um inteiro indicando o resultado.

ret = 1  => correto, a multa foi paga corretamente
ret = 0 => erro, código de empréstimo não existe
ret = -1 => erro, multa já estava paga
ret= -2  => erro, Usuário negado ( acesso/alteração no BD )
ret= -3  => valor informado difere do original
ret= -9  => erro de conexão