Itaú Unibanco (CNAB 400 e API)

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

Open

1. Cedente: Segue a sequência de número da agência e após número de conta sem o traço (-).

2. Cobrança Registrada: Indica se a conta trabalha com a transmissão remessa e retorno.

3. Não utilizar.

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

5. Convênio: Preencher de 6 caracteres, inserindo traço (-) antes do último caractere. (Ex: 12345-6).

6. Variação Carteira: Preencher com 1 dígito. (Ex: 0, 1, 4).

7. Código Carteira: Preencher com 3 dígitos. (Ex: 101, 157)

8. Código de Transmissão: Informado pelo banco.

9. Conta Principal: Define como a conta principal no sistema;

10. Agência: Preencher de 4 caracteres. (Ex: 0123)

11. Número de Conta: Preencher de 6 caracteres, inserindo o traço (-) antes do último caractere (Ex: 12345-6, 01234-5).

12. Banco: 341 - Itaú Unibanco S.A.;

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

14. Informações Complementares: Instruções impressas no cabeçalho do boleto;

15. Informações Serviços: Instruções impressas no corpo do boleto;

16. Juros Dia(%): Define a % em juros aplicada por dia após o vencimento;

17. Multa(%): Define a % da multa aplicada após o vencimento;

18. Arquivo de Remessa: Caminho do diretório onde o sistema salvará o arquivo de remessa gerado pelo sistema;

19. Arquivo de Retorno: Caminho do diretório onde o sistema salvará o arquivo de remessa gerado pelo sistema;

20. Cobrança Bancária(R$): Valor cobrado pelo banco por boleto emitido. Este valor é acrescentado ao valor a pagar do boleto.

21. Possui Banco Correspondente: Opção utilizada quando a remessa é processada por outra conta.

22. Desconto ao pagar antes do vencimento: define a % do desconto ao pagar o boleto x dias antes do vencimento.

23. Layout de Remessa: Define o layout CNAB utilizado para gerar o boleto.

24. Nosso Número: Define o nosso número utilizado no último documento;

25. Número sequencial remessa: Define o valor que dará sequência ao número da remessa;

26. Informações para Remessa CNAB 240: Define os dados cadastrais utilizados para a emissão de boletos no layout CNAB 240.

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

1 - O cliente recebe do banco Token e ClientId.

2 - Fazer o download e instalar o GitBash: https://git-scm.com/download/win

3 - Em uma pasta qualquer execute o Open Git Bash here com o botão direito do mouse:

Open

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, após 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 . Após 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:

Open