Novidades do Sistema
  1. 22.0
Novidades do Sistema
  • Bem-vindo(a) as Novidades do Sistema
  • 23.0
    • Protesto para cobrança própria
  • 22.0
    • Cofres SSG Bank
  • 21.0
    • Tarifas DDA
    • Notificação na aprovação de limites
    • Atualização do flutter para o aplicativo
    • Cobrança própria - Tarifas agrupadas na Emissão via Cnab
    • Cobrança própria - Não validação de CEP para emissão de boletos
    • Cosif 1.5
    • Adequação Credito Resolução Bacen 352 e CMN 4966
    • Cadoc 4111
    • Cadoc 4010
  • 20.0
    • Melhorias no Módulo de Cobrança Própria
    • Pré-validação do Convênio no pagamento de boletos
    • Pix Agendado e Recorrente
    • Dimp
  1. 22.0

Cofres SSG Bank

image.png
Cofres Inteligentes (Imagem ilustrativa)
Um cofre para depósito de valores é um equipamento seguro utilizado para armazenar o dinheiro recebido de uma empresa de forma protegida, permitindo depósitos sem a necessidade de acesso direto ao conteúdo armazenado. Na prática, esses cofres são amplamente utilizados em estabelecimentos comerciais e empresas que lidam com grandes volumes de dinheiro, permitindo que funcionários depositem valores sem acesso ao conteúdo interno. Isso reduz riscos de roubos internos e externos, melhora a gestão financeira e possibilita conciliações automáticas dos valores depositados. Eles são conectados a sistemas de gestão, permitindo auditorias em tempo real e facilitando o transporte seguro dos valores para instituições bancárias.
Logo, um módulo de controle de cofres e depósitos é essencial para garantir a segurança e a gestão eficiente dos valores mantidos pela empresa. Ele permite o acompanhamento detalhado da utilização dos saldos, registrando entradas e saídas de forma precisa, reduzindo riscos operacionais e fraudes. Além disso, a conciliação dos valores melhora a transparência financeira, facilitando auditorias e garantindo conformidade com normas regulatórias. Com esse controle, a instituição ganha mais eficiência e confiabilidade na administração de seus recursos. Neste sentido, disponibilizamos uma personalização para o cliente SSG Bank com as seguintes informações:

1. Exibição dos Saldos dos Cofres#

Os cofres estarão vinculado a uma conta específica, e respectivamente, a um cadastro de cliente. Criamos novas tabelas para exibir as informações de saldos dos cofres e podem ser divididos em:
1
Saldo em envelope:
Todos os valores são depositados a partir de um envelope específico, no qual serão registrados o valor e a data durante a ação de depósito.
2
Saldo em moeda:
O equipamento conta com um leitor de cédulas e moedas, permitindo que o usuário, se preferir, deposite os valores individualmente em vez de utilizar um envelope, garantindo que os depósitos sejam processados normalmente, prevenindo inclusive contra possíveis falsificações.
3
Saldo utilizado:
Os valores depositados em moeda, podem ser utilizados antes da conciliação dos valores realizados pela transportadora. A medida que o usuário vai utilizando este valor na conta (ver Tela de Utilização de Saldos dos cofres), este campo vai sendo preenchido até o limite do Saldo em moeda.
4
Saldo disponível:
Consiste na diferença entre o Saldo em moeda do Saldo utilizado. Tecnicamente ele é um saldo virtualizado, ou seja, não existe no banco de dados, apenas em tela.
5
Tarifas
Uma vez que se utiliza os saldos cofres, se devidamente configurado, o sistema pode realizar o desconto de tarifas. Estas tarifas podem acumulado dia-a-dia de acordo com o um percentual específico (ver subitem Tarifas) que será descontado na conciliação dos saldos dos cofres. Assim como ocorre na abertura e fechamento dos saldos das contas, a cada abertura e fechamento do dia, o sistema registra uma nova linha com os saldos das tarifas e acrescenta o valor acumulado, conforme regra de cálculo das tarifas. Se o saldo utilizado for zero, o campo permanecerá inalterado; caso contrário, será incrementado.
6
Dias utilizados
Os dias utilizados referem-se ao período no qual o saldo utilizado tenha sido consumido. Assim como ocorre na abertura e fechamento dos saldos das contas, a cada abertura e fechamento do dia, o sistema registra uma nova linha com os saldos dos cofres e acrescenta um dia caso o saldo não esteja zerado. Se o saldo utilizado for zero, o campo de dias utilizados permanecerá inalterado; caso contrário, será incrementado em 1 para o dia seguinte.
IMPORTANTE
O vínculo entre Cofre e Conta se dará através dos CNPJ da empresa, não guardaremos nenhum id específico da relação de cofres e clientes.
A SSG Bank manterá apenas uma conta ativa por cliente, garantindo que cada cliente possua uma única conta vinculada aos cofres.
Veja abaixo onde é possível visualizar as informações dos Saldos dos Cofres nas nossas aplicações:
image.png
Internet Payment > Página Inicial > Área de Saldos
image.png
Internet Payment > Extrato > Área de Saldos
image.png
Mobile Payment > Área de Saldos
IMPORTANTE
Para visualizar estas informações é necessário que o módulo "Cofre SSG Bank" esteja ativo.

2. Depósitos dos Cofres#

Com estrutura de Saldos dos Cofres já pronta, agora já podemos partir para os depósitos realizados. Toda vez que o cliente realizar um depósito em envelope e em moeda, deve ser chamado uma API Openbanking (v1/deposito-cofre) para atualização do Saldo do Cofre do dia com as seguintes informações:
Na requisição deve ser passado o Valor, Tipo do saldo (Moeda ou Envelope), NSU (id para controle único da lista de depósitos), Data e hora do depósito e o CNPJ.
Uma vez acionado, o sistema atualizará o valor do Saldo em envelope e moeda, conforme solicitação.
Guardaremos as informações de depósitos em uma tabela específica para eventuais conciliações.
O campo NSU validará requisições repetidas, caso o usuário passe na requisição, um depósito já enviado com um NSU repetido, o sistema não aceitará esta requisição.
Acesse nosso Swagger a e veja a documentação completa da requisição e do response da Api de Depósitos de Cofres.

3. Utilização dos Saldos#

Uma vez que o módulo “Cofres SSG Bank” esteja contratado, deve existir também uma nova tela no Internet Payment (IP) e no Mobile Payment (MP) denominada “Utilização dos Saldos do Cofre” que será utilizada para realizar o lançamento de transferência do saldo da conta cofre para a conta bancária. Ela será uma tela de lançamento e terá as seguintes informações:
image.png
Internet Payment > Cofres
Veja abaixo a relação de campos da tela:
Saldo da Conta: Valor do Saldo em Conta.
Saldo do Cofre: Total em papel moeda do Cofre.
Saldo a disponibilizar: É a diferença entre o Saldo em moeda e o Saldo utilizado
Limite máximo para transferência: É diferença entre o Saldo a disponibilizar e a Prévia das tarifas caso o usuário utilize o respectivo saldo.
Ao confirmar a ação em tela, o sistema realizará o crédito em conta de acordo com o valor informado, validando as seguintes informações:
1.
Se "Valor solicitado" acrescido do "Saldo Utilizado" e da "Prévia da tarifa" for maior que "Saldo do cofre", o sistema deve exibir a seguinte mensagem: "Não existe Saldo disponível para realizar esta ação. Verifique a informação e tente novamente."
2.
Se "Valor solicitado" acrescido do "Saldo Utilizado" e da "Prévia da tarifa" for menor ou igual que "Saldo do cofre", o sistema realizará:
O crédito em conta com o "Valor solicitado" e do "Valor da prévia da tarifa" em um lançamento único.
Adicionar o "Valor solicitado" acrescido da "Prévia da tarifa" no "Saldo utilizado" do dia aberto.
Débito em conta da Tarifa configurada no tipo de lançamento da Utilização do Saldo do cofre.
EXEMPLO
Dados iniciais:
Saldo em Conta = $1000
Saldo do cofre (moeda) = $100
Saldo utilizado = $10
Tarifa a ser cobrada na utilização = $5
Ao acessar a tela de Utilização dos saldo do cofre, teremos então:
Saldo em Conta = $1000
Saldo do cofre = $100
Saldo à disponibilizar = 100 - 10 = $90
Limite máximo para transferência = 90 - 5 = $85
Ao utilizar $70 e confirmar operação, teremos as seguintes informações:
Lançamento de Crédito em Conta = $75
Lançamento de Dédito em Conta = $5
Saldo da Conta = 1000 + 75 - 5 = $1070
Saldo utilizado = 10 + 75 = $85
Saldo do cofre (moeda) = $100 (permanece igual)
Saldo disponível = 100 - 85 = $15
ATENÇÃO
Caso o usuário informe um valor a maior do que o disponível ou não informe valor nenhum ou informe zero, o botão de Confirmar ficará inabilitado.
Aprovação múltipla: Caso o cliente final possua uma configuração de aprovação múltipla de lançamentos, o crédito em conta só será realizado após a aprovação completa de todos os usuários. Ao realizar a aprovação deste lançamento, o sistema lançará o crédito do valor solicitado e realizará o desconto da tarifa de utilização do saldo do cofre, caso esteja configurado.
Para visualizar estas informações é necessário que o módulo "Cofre SSG Bank" esteja ativo.
Foi criado o parâmetro "Tipo de lançamento para utilização do saldo do cofre (cd_tp_lcto_utiliza_saldo_cofre)" para realizar o lançamento em conta da utilização dos saldo do cofre.

4. Conciliação dos Saldos#

Uma vez depositado os valores, em determinados períodos, uma empresa transportadora realizará a coleta nos cofres. Depois de coletado e conciliado, a transportadora informará os valores apurados. Pensando neste fluxo, criamos uma API no qual a SSG enviará as informações de coletas através de .csv. Nesta planilha deve conter os seguintes campos:
1
CNPJ do titular da Conta
O sistema utilizará esta informação para chegar ao ID da Conta. Segundo a SSG Bank, eles não trabalham com clientes multicontas e caso exista algum cliente neste cenário, os lançamentos não serão processados e existirá uma mensagem de erro específico por linha para este cenário (mensagem a ser definida).
2
Valor informado (envelope)
Corresponde ao valor total informado em depósito em envelope pelos cofres, que quando o sistema processar esta planilha, o respectivo valor será debitado do “Saldo do cofre (envelope)”.
3
Valor apurado (envelope)
Corresponde ao valor total apurado na contagem dos envelopes, que quando o sistema processar esta planilha, o respectivo valor será creditado do Saldo em conta.
4
Valor informado (moeda)
Corresponde ao valor total informado em depósito em papel/moeda pelos cofres, que quando o sistema processar esta planilha, será debitado o respectivo valor do campo “Saldo do cofre (moeda)”.
5
Valor apurado (moeda)
Corresponde ao valor total apurado na contagem do total de depósitos em papel/moeda.
O processo de conciliação dos valores se dará da seguinte maneira, caso a diferença entre “Valor apurado (moeda)” e o “Saldo do cofre utilizado” seja:
Maior ou igual a zero
Menor que zero
EXEMPLO
Dados iniciais:
Saldo em Conta = $1000
Saldo do cofre (moeda) = $100
Saldo do cofre (envelope) $70
Saldo utilizado = $10
Tarifa a ser cobrada na compensação = $5
Dias de utilização do saldo do cofre = 2
Na planilha de Conciliação temos os seguintes valores:
Saldo informado (moeda) = $100
Saldo apurado (moeda) = $90
Saldo informado (envelope) = $70
Saldo apurado (envelope) = $80
Ao realizar a conciliação, teremos as seguintes informações:
Saldo do cofre (envelope) = 70 - 70 = 0
Lançamento de crédito em conta referente ao saldo em envelope = $80
Saldo do cofre (moeda) = 100 - 100 = 0
Saldo utilizado = 10 - 10 = 0
Dias de utilização do saldo do cofre = 0
Tarifas = 5 - 5 = 0
Lançamento de crédito em conta referente ao saldo em moeda = 90 - 10 - 5 = $75
Saldo da conta = 1000 + 80 + 75 = $1155
Assim que processado e realizado todas as compensações, o sistema encaminhará um email com as linhas de sucesso ou erro e o respectivo motivo.
OBSERVAÇÕES
Foram criados os seguintes parâmetro:
Tipo de lançamento para lançamento da conciliação do cofre (cd_tp_lcto_concilia_saldo_cofre) que será utilizado para realizar o crédito em conta do respectivo lançamento.
Destinatário de email de conciliação do saldo do cofre (ds_destinatario_email_cofre) utilizado para encaminhar o email das conciliações realizadas.
O sistema validará no campo Valor a quantidade de decimais da planilha (aceito apenas duas), além da formatação do campo (não pode ser vazio, nem conter letras).
Caso o sistema não encontre nenhuma conta ativa para aquele CNPJ, o sistema exibirá uma mensagem de validação.
Nem sempre ao final o Saldo em moeda ou envelope ficará zerado, pois, durante o intervalo de coleta e contagem da transportadora novos depósitos podem ser realizados.

5. Tarifas#

A SSG Bank trabalha com duas tarifas, são elas:
Tarifa na Utilização dos Saldos dos Cofres
Tarifa de juros diária sobre o Saldo Utilizado (per noite)
Modificado em 2025-03-20 17:46:48
Página anterior
22.0
Próxima página
21.0
Built with