Remessa e Retorno (via Arquivo)
Este manual visa instruir a respeito da configuração da conta no webPosto para a emissão de boletos pelo Banco Santander CNAB 400.
Para que a emissão seja bem sucedida, aconselha-se que se use o padrão de preenchimento sugerido nos respectivos campos, respeitando a quantidade de caracteres separação do dígito por traço (-).
Cedente: Preencher com 7 caracteres, inserindo o traço (-) antes do último carácter (Ex:123456-7).
Cobrança Registrada: Indica se a conta trabalha com a transmissão remessa e retorno.
Não utilizar.
Baixa Automática: Determina se as duplicatas serão quitadas automaticamente através do arquivo de retorno quando o boleto vinculado for identificado como ‘Pago’.
Convênio: Preencher de 7 caracteres, inserindo traço (-) antes do último caractere. (Ex: 123456-7). *Preencher com a mesma numeração do Cedente.
Variação Carteira: Preencher com 1 dígito. (Ex: 0, 1, 4).
Código Carteira: Preencher com 3 dígitos. (Ex: 101, 157)
Código de Transmissão: Informado pelo banco.
Conta Principal: Define como a conta principal no sistema;
Agência: Preencher de 4 a 5 caracteres.inserindo o traço (-) antes do último carácter (Ex: 0123-5, 123-4)
Número de Conta: Preencher de 9 caracteres, inserindo o traço (-) antes do último caractere (Ex: 12345678-9, 01234567-8).
Banco: 033 - Banco Santander (Brasil) S.A.;
Protesto:
a. Protestar dia corridos: Protesta o boleto com x dias corridos;
b. Protestar dias úteis: Protesta o boleto com x dias, considerando apenas dias úteis;
c. Não protestar: Não protesta o boleto.
Informações Complementares: Instruções impressas no cabeçalho do boleto;
Informações Serviços: Instruções impressas no corpo do boleto;
Juros Dia(%): Define a % em juros aplicada por dia após o vencimento;
Multa(%): Define a % da multa aplicada após o vencimento;
Arquivo de Remessa: Caminho do diretório onde o sistema salvará o arquivo de remessa gerado pelo sistema;
Arquivo de Retorno: Caminho do diretório onde o sistema salvará o arquivo de remessa gerado pelo sistema;
Cobrança Bancária(R$): Valor cobrado pelo banco por boleto emitido. Este valor é acrescentado ao valor a pagar do boleto.
Possui Banco Correspondente: Opção utilizada quando a remessa é processada por outra conta.
Desconto ao pagar antes do vencimento: Define a % do desconto ao pagar o boleto x dias antes do vencimento.
Layout de Remessa: Define o layout CNAB utilizado para gerar o boleto.
Nosso Número: Define o nosso número utilizado no último documento;
Número sequencial remessa: Define o valor que dará sequência ao número da remessa;
Informações para Remessa CNAB 240: Define os dados cadastrais utilizados para a emissão de boletos no layout CNAB 240.
Usar Remessa de Pagamento: Define o convênio e ‘Seu número’ para realizar pagamentos.
Remessa e Retorno de Cobrança (via API)
Configuração da conta Santander para utilização de API na geração de arquivo de Remessa e/ou Retorno.
Acesse a conta Santander.
Verifique se a flag Conta Bancária e Gera Boleto estão marcadas, e acesse a aba integração.
Cobrança
Para geração de remessa e retorno de cobrança preencha os campos Client id e envie o certificado, deverão ser informados dois arquivos com o conteúdo específico e extensão específica, que referem-se ao certificado utilizado pelo cliente e citado na documentação do Santander.
Para o Santander, utilizar somente o certificado tipo PFX.
O certificado deve ser exportado com a senha “quality”.
Pagfor Santander via API
Foi implementado PagFor Santander via API para:
Pagamentos de boletos;
Pagamento de guias não compensáveis com código de barras (água, luz, telefone, tributos, etc.).
webPosto > Cadastros > Contas
Configurações Pagamento via API Santander
Para o usuário utilizar o pagamento, ele precisa ter as configurações de Senha, Expira Senha, Logoff Automático habilitados.
Senha, validar se a senha do usuário é forte, seguindo a orientação para senha forte:
Forte, deve conter mais de 8 caracteres, letras, números, letras maiúsculas e caracteres especiais.
Media, deve conter mais de 8 caracteres, letras e números.
Fraca, contém menos de 8 caracteres ou apenas números ou apenas letras.
O usuário só poderá utilizar o envio do pagamento da remessa se ele possuir a senha forte, expira senha configurado, Logoff Automático devidamente configurado.
webPosto > Administração > Usuário
O Cadastro da conta bancaria tem que ter uma opção para gerar MFA.
webPosto > Administração > Permissão
Configuração do MFA na conta bancária:
webPosto > Cadastros > Conta
Ao clicar na Flag “Usaf MFA por usuário”, é necessário ir em Administração > Permissões, e ativar as permissões Cadastrar MFA]
Quando o usuário clicar em (Configurar MFA para pagamentos), abrirá uma tela com o QRCode para leitura e vinculo com o aplicativo.
Leitura do QRCode no app autenticador:
Ao gerar remessa de pagamento, deve verificar se o usuário possui permissão para pagamento.
webPosto > Administração > Permissão > Financeiro > Título a Pagar >
Verificar se as configurações do cadastro de usuário estão habilitadas "Senha, Expira Senha, Logoff Automático"
Se não estiver habilitado as configurações do cadastro de usuário, então deve abrir uma tela para informar ao usuário, com a mensagem “Usuário não possui configuração para envio de pagamentos de remessa “.
Validar se a senha do usuário é forte. Se o usuário possuir todas as configurações, mas a senha não é forte, então deve apresentar uma mensagem na tela “A senha do usuário não é forte para fazer transações de pagamento.“
Após as validações de configurações, deve chamar uma tela para solicitar o código MFA do aplicativo (Google, Microsoft).
Só irá enviar a remessa, apresentar a tela do código do MFA, se a conta bancaria possui MFA configurado.
Gravar o MFA no banco de dados, criptografado.
Se tiver 3 tentativas de digitar o MFA, e todas as 3 não conseguir validar o código. Deve resetar o MFA no cadastro da conta.
Cada tentativa invalida o sistema tem que apresentar uma mensagem para o usuário “Em caso de 3 tentativas negadas, o MFA será removido da conta bancaria.“
Após a validação positiva do código do MFA, o sistema precisa enviar os registros via API para o banco.
Se o retorno do banco for positivo para os registros enviados, o sistema tem que efetuar a baixa(quitar) dos mesmos.
webPosto > Financeiro > Título a Pagar > Remessa - Retorno
Notificações em caso de falhas:
Em caso de falha enviar e-mail de notificação de tentativas. Enviar para o e-mail cadastrado em Administração >Filial > Configuração de Email.
Quando remover o MFA da conta, deve disparar um e-mail. Enviar para o e-mail cadastrado em Administração >Filial > Configuração de Email.
Quando cadastrar o MFA da conta, deve disparar um e-mail. Enviar para o e-mail cadastrado em Administração >Filial > Configuração de Email.
LOG das transações feitas do PagFor via API - pagamentos
webPosto > Administração > Auditoria