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

O Sicoob é o único banco que necessita que o cliente acompanhe o processo de criação da credencial pois é necessário informar a senha da conta do banco e é enviado um código para finalizar o cadastro da aplicação.

1. Acesso o Sicoob developers e crie uma conta para a empresa, são necessárias as seguintes informações para o cadastro:

   

2. Feito o cadastro, vamos criar a aplicação para gerar a credencial. Clique em Meus Aplicativos → Cadastrar novo aplicativo

   

3. Após isso, peça ao cliente para preencher as seguintes informações:

   

4. Em seguida, peça ao cliente para acessar o aplicativo do banco para visualizar o código que foi enviado.

   

5. Será aberta uma nova tela para preencher as informações necessárias para criar a credencial.

6. A primeira tela é a de informações, você deve por o nome do cliente, número da conta, descrição do aplicativo e Nome do Cooperado.

   

7. Na aba de segurança, você deve informar o certificado com a extensão .pem

   

8. Na aba APIs, selecione a API cobrança bancária

   

9. Após isso confirme os dados e finalize a criação da aplicação.

10. Quando finalizar será mostrado na tela a client ID, salve ela em um bloco de notas para não perder.

11. Feito isso, pode ir para as configurações do Sic.

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 “Sicoob” 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. Nesta aba você vai informar o ambiente como o de Produção, selecione a opção ‘’Usa Certificado“ e “Indicador Pix”, informe o Scope, a versão da API e selecione os certificados. → Scope: boletos_inclusao boletos_consulta boletos_alteração

   

5. Na aba “Credenciais de Produção”, cole a credencial criada anteriormente nos campos cliente ID e cliente Secret. No Sicoob a mesma credencial é usada nos dois campos, porém é uma particularidade deste banco.

   

6. Acesse a aba “Ocorrência Remessa” e 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

<aside> 💡

Caso esteja em ambiente de produção, solicite ao cliente que realize o pagamento do boleto de teste e sempre alinhe isso previamente antes da emissão.

</aside>