Este manual visa instruir a respeito da configuração da conta no webPosto para a emissão de boletos pelo Itaú Unibanco CNAB 400 e API.
Remessa / Retorno
Para que a emissão seja bem sucedida, aconselha-se que se use o padrão de preenchimento sugerido nos respectivos campos, respeitando a quantidade de caracteres separação do dígito por traço (-).
Cedente: Segue a sequência de número da agência e após número de conta sem o traço (-).
Cobrança Registrada: Indica se a conta trabalha com a transmissão remessa e retorno.
Não utilizar.
Baixa Automática: Determina se as duplicatas serão quitadas automaticamente através do arquivo de retorno quando o boleto vinculado for identificado como ‘Pago’.
Convênio: Preencher de 6 caracteres, inserindo traço (-) antes do último caractere. (Ex: 12345-6).
Variação Carteira: Preencher com 1 dígito. (Ex: 0, 1, 4).
Código Carteira: Preencher com 3 dígitos. (Ex: 101, 157)
Código de Transmissão: Informado pelo banco.
Conta Principal: Define como a conta principal no sistema;
Agência: Preencher de 4 caracteres. (Ex: 0123)
Número de Conta: Preencher de 6 caracteres, inserindo o traço (-) antes do último caractere (Ex: 12345-6, 01234-5).
Banco: 341 - Itaú Unibanco S.A.;
Protesto:
a. Protestar dia corridos: Protesta o boleto com x dias corridos;
b. Protestar dias úteis: Protesta o boleto com x dias, considerando apenas dias úteis;
c. Não protestar: Não protesta o boleto.Informações Complementares: Instruções impressas no cabeçalho do boleto;
Informações Serviços: Instruções impressas no corpo do boleto;
Juros Dia(%): Define a % em juros aplicada por dia após o vencimento;
Multa(%): Define a % da multa aplicada após o vencimento;
Arquivo de Remessa: Caminho do diretório onde o sistema salvará o arquivo de remessa gerado pelo sistema;
Arquivo de Retorno: Caminho do diretório onde o sistema salvará o arquivo de remessa gerado pelo sistema;
Cobrança Bancária(R$): Valor cobrado pelo banco por boleto emitido. Este valor é acrescentado ao valor a pagar do boleto.
Possui Banco Correspondente: Opção utilizada quando a remessa é processada por outra conta.
Desconto ao pagar antes do vencimento: Define a % do desconto ao pagar o boleto x dias antes do vencimento.
Layout de Remessa: Define o layout CNAB utilizado para gerar o boleto.
Nosso Número: Define o nosso número utilizado no último documento;
Número sequencial remessa: Define o valor que dará sequência ao número da remessa;
Informações para Remessa CNAB 240: Define os dados cadastrais utilizados para a emissão de boletos no layout CNAB 240.
Usar Remessa de Pagamento: Define o convênio e ‘Seu número’ para realizar pagamentos.
Como gerar o Certificado Digital e a Secret Key para o Banco Itaú
Obs.: O certificado gerado nesse processo, tem o prazo de validade de 12 meses. Para renovar precisa fazer esse passo a passo novamente.
1 - O cliente recebe do banco Token e ClientId.
2 - Fazer o download e instalar o GitBash: https://git-scm.com/download/win
3 - Dentro de uma pasta qualquer execute o Open Git Bash here com o botão direito do mouse:
4 - No Git Bash executar o comando:
4.1 - Campos para alterar no comando:
//CN=INSERIR CLIENTID AQUI (chave recebida pelo banco)
OU=INSERIR O NOME DO CLIENTE AQUI (Dados do cliente)
L=INSERIR CIDADE DO CLIENTE (Dados do cliente)
ST=INSERIR ESTADO DO CLIENTE (Dados do cliente)
Comando:
openssl req -new -subj "//CN=INSERIR CLIENTID AQUI\OU=INSERIR O NOME DO CLIENTE AQUI\L=INSERIR CIDADE DO CLIENTE\ST=INSERIR ESTADO DO CLIENTE\C=BR" -out ARQUIVO_REQUEST_CERTIFICADO.csr -nodes -sha512 -newkey rsa:2048 -keyout ARQUIVO_CHAVE_PRIVADA.key
5 - Após executar o comando acima, o Git Bash vai gerar dois arquivos .KEY e .CSR:
5.1 - O arquivo .key possui uma chave privada.
5.2 - O arquivo .csr possui o certificado digital
6 - Importar a collection do Postman abaixo, dentro do programa Postman. Para gerar o certificado digital e a secret key :
Download postman: Download Postman | Get Started for Free
6.1 - Fazer a configuração no endpoint::https://sts.itau.com.br/seguranca/v1/certificado/solicitacao
Inserir o Token que o banco enviou para o cliente, em Authorization com o type = Bearer Token.
6.2 - No Body do endpoint inserir o certificado gerado no arquivo .csr pelo Git Bash, depois de fazer esse processo basta pressionar send no postman.
6.3 - Após clicar em send o postman vai retornar SecretKey e o Certificado Digital.
6.4 - Esse foi o processo final para gerar SecretKey e o Certificado Digital.
Retorno do Postman:
7 - Após gerar SecretKey e o Certificado Digital:
7.1 - Copiar o texto Secret e guardar em um arquivo .txt para ser usado posteriormente no sistema webposto.
7.2 - Copiar o texto completo de (-----BEGIN CERTIFICATE-----) até (-----END CERTIFICATE-----), colar em um arquivo .txt . Depois de salvo esse arquivo, deve alterar a extensão do arquivo de .txt para .crt:
Collection do Postman para gerar o Certificado e a Secret Key: