Menu de Navegação

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. Credenciais

  1. Para iniciar, você deve pedir ao gerente da conta para que ele abra um chamado para ser enviado no seu e-mail o token temporário (utilizado para gerar a client secret) e a client ID.

    <aside> 💡

    O token temporário tem validade de 7 dias contado a partir do dia em que o e-mail foi enviado, então sempre se atentar a data de envio do e-mail. Caso tenha passado os sete dias, peça um novo token.

    </aside>

    image.png

    image.png

  2. Após isso, você deve baixar o software git bash, pois por ele faremos a conversão dos certificados e gerar a client secret. Você pode baixa-lo acessando aqui.

    image.png

  3. Após isso, crie uma pasta e execute o git bash dentro dela.

    image.png

  4. Abra um bloco de notas para facilitar a edição do comando.

  5. O primeiro comando que vamos executar é:

    openssl req -new -subj "//CN=**{{CLIENT_ID}}**\OU={**{SITE OU APP DOPARCEIRO}}**\L=**{{CIDADE}}**\ST=**{{ESTADO}}**\C=**{{PAIS}}**" -out ARQUIVO_REQUEST_CERTIFICADO.csr -nodes -sha512 -newkey rsa:2048 -keyout ARQUIVO_CHAVE_PRIVADA.key
    
  6. Explicação dos campos: → CN: É a credencial client ID que recebemos; → L: É a cidade que a empresa está localizada, caso a cidade seja muito pequena, sugerimos inserir a capital; → ST: É a capital da cidade; → C: O País em que a empresa está localizada. → OU: É um nome simples para identificar facilmente o serviço integrado ao Itaú, sugestão é utilizar o nome da empresa, não usar caracteres especiais, exemplo CESED como no exemplo abaixo.

    image.png

  7. No bloco de notas, copie o comando que você editou e cole no git bash que executamos dentro da pasta. Não de ctrl + c e ctrl + v, clique com o botão direito do mouse e copiei o texto e, no git bash clique novamente com o botão direito do mouse e cole o texto.

    image.png

    image.png

  8. Ao executar o comando, vai ser gerado o certificado .key e .csr.

    image.png

    image.png

  9. Após isso, vamos executar o segundo comando, neste comando será gerado o certificado .crt e a client secret.

    curl -i -k -X POST \
    --url [<https://sts.itau.com.br/seguranca/v1/certificado/solicitacao>](<https://sts.itau.com.br/seguranca/v1/certificado/solicitacao>) \
    -H "Content-Type: text/plain" \
    -H 'Authorization: Bearer {{access_token_temp}}' \
    -d '{{CSR - Certificate Sign Request}}'
    
  10. No comando acima, onde está {{access_token_temp}} você deve preencher com o token temporário que foi enviado no e-mail. Ademais, no item CSR - Certificate Sign Request você deve inserir o conteúdo que está dentro do arquivo .csr, deve ser copiado com os traços iniciais e finais.

    image.png

  11. Ao executar esse comando, será gerado o conteúdo do .crt e a client secret. Salve a client secret em um bloco de notas e o conteúdo do certificado em outro.

    image.png

  12. Ao salvar o conteúdo do crt em um bloco de notas, o arquivo não irá ficar salvo com a extensão .crt. A forma mais simples de resolver isso é alterando um arquivo.crt que já tenha existente.

2. 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 “Itaú” e, por fim, no canto inferior da tela selecione a opção “Ativa Boleto Online”.

    image.png

  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: boletoscash-boletos-consulta_titulo; → Versão: V2; → 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.

    image.png

  5. Depois, na aba “Credenciais Produção”, você deve informar as credencias geradas anteriormente.

    image.png

  6. Por fim, em “Ocorrência Remessa”, deixe da seguinte forma:

    image.png

  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>