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.
    

• • 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

    
    
    

• 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
    
    
    
    

03. CORREÇÕES 

• TRANSFERÊNCIAS INTERNAS ENTRE CONTAS
  
  Ajuste realizado na movimentação entre contas internas, ao realizar a transação de transferências haverá apenas uma chamada no serviço, para realização das duas 
  movimentações "débito" e "crédito", melhorando a performance do serviço.
  
  Foi adicionado dois novos campos na tabela de movimentos indicando as contas de origem e destino da transação

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.