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


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.

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

Abra um bloco de notas para facilitar a edição do comando.
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
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.

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.


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


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}}'
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.

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.

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.
No sic, acesse o cadastro de bancos/Caixas e entre alterando a conta que será alterada para boleto online.
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”.

Ainda nesta tela, acesse a aba “Definições da API”
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.

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

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

Essa configuração vai permitir o cliente de enviar os pedidos de baixa, alteração de vencimento e Abatimento de valor.
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>