01. VISÃO GERAL
O serviço de bloqueio e desbloqueio foi desenvolvido com a finalidade de utilização em integrações, que necessitam da realização de bloqueios e desbloqueios de saldos, aplicado um conjunto de regras que detém características especificas para transações financeiras.
02. NOVAS FUNCIONALIDADES
- BLOQUEIO
- Realiza bloqueios no saldo disponível na conta corrente.
- Realiza bloqueios no saldo disponível na conta corrente.
- URI Bloqueio CCD: /saldo/{agencia}/{conta}
Exemplo de requisição para bloqueio:{
"codigoUnidade": 0,
"codigoContaCorrente": 0,
"codigoEmpresa": 0,
"prazoValidade": "string",
"dataValidade": "2023-03-09",
"numeroDocumento": 0,
"valorLancamento": 1,
"codigoHistorico": 0,
"sistemaOrigem": "str",
"tipoBloqueio": "string",
"lancamentoRetroativo": "str",
"motivoBloqueio": "string"
}
Tipos de Bloqueios:
CHEQUE, ADMINISTRATIVO, JUDICIAL
Prazo de Validade:
DETERMINADO, INDETERMINADO - para tipo bloqueio 'CHEQUE' esse campo não é obrigatório
Data de Validade:
Para bloqueio 'CHEQUE' esse campo é calculado conforme a parametrização do codigoHistorico e o valor do lancamentoRetroativo. Para bloqueio ADMINISTRATIVO ou JUDICIAL, quando prazoValidade DETERMINADO, validará este campo com o valor informado. Para prazoValidade INDETERMINADO, este campo será preenchido automaticamente no sistema com valor fixo '2099-01-01'. Formato 'AAAA-MM-DD';
Código de Histórico:Esse campo não deve ser informado para bloqueio ADMINISTRATIVO e JUDICIAL por ser parametrizado na tabela de Motivos de Bloqueio de Saldo. Para bloqueio CHEQUE, esse campo é obrigatório e deve conter tipo de lançamento "DP" e prazo de bloqueio maior que ZERO .
Lançamento Retroativo:É obrigatório apenas para bloqueio CHEQUE e os valores deverão ser SIM ou NAO. Usado para calcular a data validade em dia útil conforme prazo de bloqueio de dias úteis dentro do histórico informado. Quando SIM a dataValidade será o dia útil a partir da data ultimo processamento do sistema . Quando NAO a dataValidade será o dia útil a partir de data processamento atual do sistema.
Valor do Lançamento:
Campo obrigatório e deve ser maior que ZERO. Esse valor será subtraído do saldo disponível . Se o bloqueio for ADMINISTRATIVO ou JUDICIAL e este valor ser maior que o saldo disponível e o indicador do bloqueio de saldo for "N" na tabela Motivo de Bloqueio de Saldo , este valor de lançamento assumirá o saldo disponível. Se bloqueio ADMINISTRATIVO, este valor será adicionado ao campo saldo de bloqueio adminstrativo . Se bloqueio JUDICIAL, este valor será adicionado ao campo saldo de bloqueio judicial . Se bloqueio CHEQUE e prazo de bloqueio for igual a 1 este valor será adicionado ao campo saldo de bloqueio 24 . Se bloqueio CHEQUE e prazo de bloqueio for igual a 2 este valor será adicionado ao campo saldo de bloqueio 48. Se bloqueio CHEQUE, e prazo de bloqueio for maior que 2 este valor será adicionado ao campo saldo de bloqueio NC .
Sistema de Origem:Campo obrigatório informando o código da sigla do sistema de origem
Número do Documento:Campo obrigatório e importante para usar no desbloqueio, identificador da operação
Motivo do Bloqueio:Texto livre opcional
Código da Agencia ou Unidade:Código da agencia/unidade - obrigatório
Código da Conta Corrente:Código da conta - obrigatório
Código da empresa:
Código da empresa - obrigatório
- URI Bloqueio CCD: /saldo/{agencia}/{conta}
- DESBLOQUEIO
- Efetua o desbloqueio de saldo da conta corrente
Exemplo de requisição para desbloqueio:{
"codigoUnidade": 0,
"codigoContaCorrente": 0,
"numeroDocumento": 0,
"valorDesbloqueio": 1
}
URI Desbloqueio CCD: /saldo/desbloqueio
Código da Agencia ou Unidade:
Código da agencia/unidade - obrigatório
Código da Conta Corrente:
Código da conta - obrigatório
Número do Documento:
Número de documento gerado na operação de bloqueio
Valor do Desbloqueio:
Valor a ser desbloqueado, podendo ser total ou parcial
- Efetua o desbloqueio de saldo da conta corrente
03. CORREÇÕES
- N/a
04. BANCO DE DADOS
- Para esta nova versão do sistema, são necessárias implantações de atualizações de banco de dados. Os scripts correspondentes estão disponíveis no painel de expedição. Se houver a necessidade de pular versões durante a atualização, os pacotes de banco de dados intermediários precisam ser executados.