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