Menu de Navegação

• Sistemas
  • SIC
  • Supra Vendas App
  • Supra Help
  • Supra Coletor
  • SupraSys Estoque
  • RustDesk

O Boleto Online é a integração do sistema SIC com a API dos bancos para emissão do boleto de forma online, onde não é necessário mais o envio do arquivo de remessa e baixa do arquivo de retorno, tudo está centralizado no sistema SIC. O Boleto Híbrido é a emissão do boleto online, mas com QR Code do PIX, possibilitando tanto que o boleto seja pago como boleto ou como pix. Neste manual iremos ver como faz para realizar a configuração no sistema SIC para uso da API. O manual explicando como utilizar pode ser acessado clicando aqui.

1. Certificados

Para utilizar a API do boleto online/Hibrido é necessário ter o certificado da empresa nas extensões .key e .crt. Para realizar essa conversão utilizamos o OpenSSL. Segue passos para geração:

1.1 Baixar o Openssl

1. Para baixar o Openssl primeiro vamos acessar o seguinte site https://slproweb.com/products/Win32OpenSSL.html.

2. Após isso, clique na última versão disponível. Repare que tem duas versões disponíveis, sempre baixe a versão completa, nunca a light.

   

3. Clique no EXE e o download será iniciado.

4. Após baixado, iremos na pasta de downloads e executar o exe baixado.

   

5. Clique 2x no executável para iniciar a instalação

   

   

6. Após selecionar essas opções, só clicar em Next para finalizar a instalação.

7. Para finalizar, acesse as variáveis de ambiente do seu computador e clique em Variáveis de ambiente.

   

   

8. Nesta tela, adicione uma nova variável, no campo valor da variável coloque o caminho da pasta bin do Openssl.

   

1.2 Converter certificado

1. Para converter o certificado de .pfx para .crt, .key e .pem iremos usar 3 comandos:

   PEM: 
   openssl pkcs12 -in C:\SupraSys\Certificados\Certificado.pfx -nokeys -out C:\SupraSys\Certificados\certificado.pem
   

   CRT: 
   openssl pkcs12 -in C:\SupraSys\Certificados\Certificado.pfx -clcerts -nokeys -out C:\SupraSys\Certificados\certificado.crt
   

   KEY: 
   openssl pkcs12 -in C:\SupraSys\Certificados\Certificado.pfx -nocerts -nodes -out C:\SupraSys\Certificados\certificado.key
   

   <aside> 💡

   Os caminhos do comando devem ser atualizados para o caminho onde você salvou o certificado original.

   </aside>

2. Feito isso, na pasta bin do Openssl, abra o cmd.

3. Cole um comando por vez, assim que colar o comando e der Enter você deve informar a senha do certificado original e dar Enter novamente.

   

   

2. Credenciais

Para iniciar, vamos acessar o Santander Developers, neste portal iremos gerar a client ID e a Client Secret.

1. No developers, existe duas formas de fazer login, como desenvolvedor ou como administrador. Caso for o proprietário/responsável da conta, entre como administrador. Caso for suporte, entre como desenvolvedor.

2. Para entrar como administrador, irá precisar das seguintes informações: Obs.: O usuário e senha são os mesmos que utiliza para acessar o aplicativo do banco.

   

3. Para acessar como desenvolvedor, acesse com um e-mail e senha do cliente proprio para o acesso.

   

4. Após fazer o login, vamos criar a aplicação.

   

5. Para iniciar o cadastro da aplicação, selecione a empresa que irá utilizar o serviço.

   

6. Após isso, vamos selecionar os produtos que serão utilizado, no santander utilizamos a API Emissão de boleto.

   

7. Após isso, selecione o certificado digital com as extensões .pem ou .crt.

   

8. Feito isso, é só finalizar esse processo e, após o processamento, as credencias Client ID e Client Secret serão gerados e ficarão salvas em “Minhas Credenciais” dentro do portal, salve elas em um bloco de notas.

   

3. Postman

1. No postman é gerado a credencial key user. Para baixar a collection, acesse aqui

2. Para iniciar, iremos configurar o postman para poder criar a workspace. Clique na engrenagem na parte superior da tela.

   

3. Após isso, vá na opção “Certificates”

   

4. Nesta tela, no campo “Host” você deve informar: trust-open.api.santander.com.br e os certificados .crt e .key.

   

5. Após isso, vamos gerar a key user. No menu lateral da sua collection, vamos acessar a aba de Token. Nela, iremos na aba de “Body”, onde deve ser informado o client ID e Client Secret que foi gerado no developers.

   

6. Ainda na tela de geração do Token, na aba Headers vamos informar a client ID novamente.

   

7. Após isso, clique em “Send”, vai ser gerado o token de acesso, copie todo o conteúdo dentro das aspas, não deve ser copiado as aspas, somente o conteúdo dentro dela.

   

8. Após isso, no menu lateral vamos acessar a opção “Criar Workspace”, em seguida, na aba “Authorization” deve ser colado o token no campo disponível.

   

9. Após isso, na aba de “Headers” informe novamente a client ID.

10. Feito isso, vá na aba “Body” e informe o convênio da sua conta e a Url da aplicação. → Url: -> "webhookURL": "https://utils.suprasys.com.br/webhook/CNPJ/CONVENIO/boletos"

11. Clique em “Send”, no campo da Response irá aparecer a key user, guarde ela em um bloco de notas para não perder.

4. SIC

1. No sic, acesse o cadastro de bancos/Caixas e entre alterando a conta que será alterada para boleto online.
2. Na tela de alteração, vá em dados para cobrança e no campo “Tipo de geração” selecione a opção “1-Emissão Boleto Online”, altere o Tipo de cobrança para “Santander” e, por fim, no canto inferior da tela selecione a opção “Ativa Boleto Online”.
3. Ainda nesta tela, acesse a aba “Definições da API”
4. Na tela de definições API → Básico, você deve deixar com as seguintes configurações: → Ambiente: Produção; → Marque as opções “Usa certificado” e “Indicador Pix”; → Scope: cobrança; → Versão: V1; → Informar os caminhos com os certificados .key e .crt; → Tipo de Juros: Taxa Mensal; → Tipo de Multa: Percentual; → Informar o tipo de chave e a chave pix.
5. Depois, na aba “Credenciais Produção”, você deve informar as credencias geradas anteriormente.
6. Por fim, em “Ocorrência Remessa”, deixe da seguinte forma:
7. Essa configuração vai permitir o cliente de enviar os pedidos de baixa, alteração de vencimento e Abatimento de valor.
8. Após finalizar, as configurações estarão prontas. Realize testes para garantir o funcionamento correto