API Cobrança Santander
8 min
Criado por Letície Montenegro em 04/12/2023 18:12
Atualizado por Letície Montenegro em 28/03/2025 14:28


Com o objetivo de automatizar o processo, estamos disponibilizando a integração através da API de emissão de boletos do banco Santander. Para uma compreensão mais aprofundada, essa API consiste em uma interface de programação fornecida pelo banco, permitindo a integração do sistema Fortes Financeiro com o Sistema Bancário. A emissão e baixa de boleto é feita de forma automatizada através dessa comunicação e com um grande diferencial, esses boletos serão disponibilizados em modelo híbrido, forma de boleto que possibilita ao cliente realizar o pagamento por QR-code ou por código de barras.

Pré requisitos para utilizar API de Recebimento Santander

1º - Entrar em contato com o Gerente da sua Empresa e contratar o serviço junto ao banco;

2º - Utilizar Certificado A1 para realizar transações via API (arquivo em formato .crt)

3º-Gerar credenciais no Portal Developers Santander - Acessar o gerente que atende à Empresa para auxiliar no caso de dúvidas neste ponto.

4º - Após cadastro efetuado e certificado validado pelo Banco Santander, realizar as configurações no Fortes Financeiro.

Configurações

1º - Em Utilitários>>Configuração - Marcar a opção:


2º - No Cadastro de Agente Cobrador Pagador, realizar as parametrizações para emissão de boleto:

Obs.: É necessário informar o tipo e a chave pix.

3º - Na aba Integração de Recebimentos, informar no campo Tipo de integração de boletos a opção Banco Santander - Integração cobrança.


4º - No caminho Cadastros/Empresas - seleciona o Estabelecimento e no botão "Integração" marcar a opção Integração API Santander Bolecode:



Deve ser vinculado o agente cobrador cadastrado no sistema com todos os dados bancários corretamente aplicados. As informações de “Client ID”, “Client Secret” e “Private key” serão repassadas e validadas pelo próprio banco, o certificado A1 deve ser apontado no campo Certificado (utilizar formato .crt). Após adicionar as informações citadas, criar a chave “Workspace” no botão “Gerar”. Para finalizar, escolher o ambiente de emissão.


Obs.: Para conversão do certificado, ver o manual -  Converter certificado


Para emissão do boleto:

Após a criação da conta a receber, adicionando o agente cobrador parametrizado com os dados da API, na tela de Vencimentos temos as opções de  Emissão, Consulta, reenvio de e-mail e cancelamento.

Obs. 1: Essas opções estão disponíveis para ser utilizadas por mais de um boleto por vez.

Obs. 2: Os boletos gerados via API são disparados por e-mail automaticamente para os clientes.

Disponibilizamos a opção de pagamento via PIX COPIA E COLA. Essa modalidade consiste em um link de pagamento gerado a partir do QR Code do Pix.


Para realizar a baixa é necessário realizar a seguinte configuração:


A baixa é realizada apenas utilizando a função “Consulta”, onde é verificado no sistema bancário o vencimento que foi quitado, assim é realizado a baixa no Fortes Financeiro. (É uma sugestão momentânea até liberarmos a consulta automática)

Obs.: A data da baixa será a mesma data do crédito. (D1)

Alterar data de vencimento de boleto (sem juros e multa):

Seleciona o vencimento desejado, botão Opções>> Alterar Vencimentos Marcados. 

Após a alteração será exibido uma mensagem: “Deseja alterar o vencimento do boleto da integração on-line do vencimento selecionado?”

Obs.: Se deseja receber o valor com juros e multa configurado, o cliente pode pagar o boleto (1ª via ) que o novo valor será recalculado no ato do pagamento.


Envio de boleto e nota fiscal

Para os usuários que desejam enviar boletos e nota fiscal no mesmo e-mail devem realizar a seguinte configuração em Cadastro>>Notas Fiscais>> Configuração de Emissão de Nota Fiscal




Passo- a passo para boletos emitidos via API:

1º Emitir o boleto na tela de vencimentos do contas a receber
2º Autorizar a nota fiscal

Ao finalizar o processo, o e-mail será disparado com PDF da nota e o boleto.


 API QR-Code Santander

Ainda no contexto da API de recebimento, o Banco Santander oferece a API de geração de QR Code dinâmico. Essa funcionalidade cria um QR Code e o envia por e-mail para o cliente, possibilitando que ele realize o pagamento do título a receber via Pix.

Para a utilização desta API, devem ser observados os mesmos pré-requisitos mencionados anteriormente:

1.Certificado Digital Válido:  Utilizar Certificado A1 para realizar transações via API (arquivo em formato .crt)

2.Gerar credenciais no Portal Developers Santander - Acessar o gerente que atende à Empresa para auxiliar no caso de dúvidas neste ponto.

Importante! Caso o usuário já tenha integrado outras APIs do Santander, será necessário adicionar a nova API de QR Code Dinâmico às credenciais já existentes, garantindo que todas as integrações sejam devidamente configuradas e autorizadas.

3.Para utilizar a API Pix, é necessário que a chave Pix esteja ativa na conta do Santander do cliente. As credenciais de produção e a chave Pix devem estar vinculadas ao mesmo CNPJ. Isso é fundamental para garantir que as transações sejam processadas corretamente pela API e que o cliente receba os pagamentos nas contas corretas.

4.Após cadastro efetuado e certificado validado pelo Banco Santander, realizar as configurações no Fortes Financeiro.

Configurações

Deve-se realizar as mesmas configurações da API de Recebimento mencionadas anteriormente, com a única diferença de que, no agente cobrador, na aba Integração de Recebimentos, é necessário parametrizar o campo 'Tipo de Integração de PIX', conforme ilustrado na imagem a seguir:

Para geração e envio de QR-Code

Inicie criando o título de Contas a Receber no sistema.
Após a criação do título, acesse a tela de Vencimentos Diversos.
Escolha o vencimento correspondente ao título que deseja gerar para pagamento via Pix.No menu de Opções do vencimento selecionado, clique na opção Pix.Por fim, clique em Enviar para gerar o QR Code e iniciar o processo de envio para o cliente realizar o pagamento via Pix.





Espero ter ajudado, até a próxima!

 
Este artigo foi útil para você?
Últimos artigos visitados