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

1. Acesse o Bradesco Developers e crie uma conta.

   <aside> 💡

   O Bradesco não deixa criar várias aplicações com a mesma API em uma só conta, então caso seja multiempresa, é necessário criar uma conta para cada empresa.

   </aside>

2. Feito o cadastro, vá na aba “Aplicativos” e crie uma aplicação. Neste primeiro momento, só deixe ela criada.

   

   

3. Após isso, acesse a aba produtos e encontre a API cobrança com QR code.

   

   

4. Ao clicar na API, vai abrir uma nova tela para realizar a inscrição para uso do serviço. Após enviar a solicitação a inscrição ficará como pendente, o banco tem até 48 horas para ativar ou rejeitar.

   

5. Você pode acompanhar o status na aba “Assinaturas”, localizado no menu lateral.

   

6. Ainda nesta tela, clique em cima do nome do produto e, na nova tela que irá abrir, clique em “Registrar aplicação”.

   

   

7. Na tela de cadastro, você deve selecionar a assinatura (só existe uma opção) e a aplicação que criamos anteriormente.

   

8. Após isso, selecione todos os recursos que aperecer, todos são referentes ao boleto online.

   

9. Por fim, registre a aplicação.

   

10. Após isso, volte na tela dos aplicativos criados e entre na aplicação que fez o cadastro.

    

11. Ao entrar, clique em “Solicitar credencial”

    

12. Após isso, preencha as informações:

    

    <aside> 💡

    Se já tiver credencial criada e apenas for renovar o certificado, selecione a opção “Renovação certificado”

    </aside>

    

    <aside> 💡

    Antes de selecionar o certificado, é necessário limpar algumas informações que ficam gravadas dentro do certificado, deixe somente o conteúdo gravado dentro do - - - - Begin Certificate:

    </aside>

13. Após finalizar a solicitação da credencial, ficará novamente como pendente. O banco tem até 48 horas para gerar as credenciais.

14. Após ser ativada, irá aparecer um novo botão para visualizar credencial. Ao visualizar, guarde as credenciais em um bloco de notas, pois a client Secret só fica visível por 3 dias.

3. 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 “Bradesco” 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”; → Informar os caminhos com os certificados .key e .crt; → Tipo de Juros: Valor dia; → Tipo de Multa: Valor Fixo; → 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