Parâmetro de identificação do banco:

BANCO: “341”, “Itaú”, ou “Itau”.

Parâmetros principais:

• AGENCIA_NUMERO – 04 dígitos;
• CONTA_CORRENTE_NUMERO – 05 dígitos;
• CONTA_CORRENTE_DV – 01 digito;
• CARTEIRA – 03 dígitos (EX: 109)
• NOSSO_NUMERO – Até 08 dígitos.

Informa os demais parâmetros boletos.

Boleto com PIX

Para emitir boleto com PIX no Itaú  você deve usar a API do PIX, e ver a seção BOLECODE na documentação do Itaú.

WebService (V2)

Para se conectar via WebService através da API intitulada “API Emissão, Instrução e Consulta de boletos” utilize os dados abaixo.

Dados de conexão

Para criar uma conexão com o Itaú:

• BENEFICIARIO_DOCUMENTO: Informe o CPF ou CNPJ do beneficiário;
• CLIENT_ID – Fornecido pelo Itaú;
• CLIENT_SECRET – Fornecido pelo Itaú;
• CARTEIRA_CONVENIO – ID do Beneficiário, Fornecido pelo Itaú – Agência (4 dígitos) + Conta (7 dígitos) + DAC (1 dígito);

Certificado em formato PFX (PKCS12):

• CERTIFICADO_ARQUIVO – Caminho absoluto do arquivo no formato PFX;
• CERTIFICADO_SENHA – Senha do arquivo PFX;

Certificado em arquivo key e cer:

• CER – Caminho absoluto do arquivo CER (Certificado) no formato PEM;
• KEY – Caminho absoluto do arquivo KEY (Chave privada) no formato PEM.

Dados para inclusão do boleto

Utilize a função “Boleto – WebService – Incluir Boleto“, e no segundo parâmetro, para gerar o JSON utilize os parâmetros de boleto, com as seguintes observações adicionais:

• CARTEIRA (Obrigatório): Código da carteira do título;
• DOCUMENTO_NUMERO (Letras) – Preenche o campo “dados_individuais_boleto” > “texto_uso_beneficiario“, conforme descrição do banco: “Campo de 25 caractéres, utilizado na API legado como “identificador_titulo_empresa“. Deve ser utilizado apenas letras e números.”;
• INSTRUCOES (Letras) – Preenche o campo “lista_mensagens_cobranca” > “mensagem“, cada linha vira uma mensagem.

Opcionalmente, você pode enviar o JSON completo, no lugar do mapeamento.

Dados para consulta do boleto

Usar a função “Boleto – WebService – Consultar Boleto” passando a conexão no primeiro parâmetro, e no segundo parâmetro um mapa com os seguintes dados:

• CARTEIRA_CONVENIO: Opcional, quando já informada na inicialização;
• CARTEIRA (Obrigatório): Código da carteira do título;
• NOSSO_NUMERO (Obrigatório);
• DATA_EMISSAO (Opcional).

Dados para baixa / remoção /cancelamento do boleto

Usar a função “Boleto – WebService – Baixar Boleto” para baixar/remover/cancelar uma cobrança. Ela deve ser chamada passando a conexão no primeiro parâmetro, e no segundo parâmetro um mapeamento com os seguintes dados:

• CARTEIRA_CONVENIO: Opcional, quando já informada na inicialização;
• CARTEIRA (Obrigatório): Código da carteira do título;
• NOSSO_NUMERO (Obrigatório): Número do boleto a ser baixado.

Dados de homologação

Paga obter os dados de teste, no portal do desenvolvedor ( https://devportal.itau.com.br/ ), localize a “API Emissão, Instrução e Consulta de boletos“, clique em documentação, e depois em “API reference”, e gere os dados de uso no topo.

Não é necessário certificado em homologação.

Principais erros

• Se o certificado ( CERTIFICADO_ARQUIVO ) não for vinculado ao CLIENT_ID:
  • “O Common Name (CN): xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx do certificado é inválido.”
• Se o CLIENT_SECRET ou CLIENT_ID estiver errado:
  • “Falha ao Criar token local filter failed”.
• Se o certificado não for permitido por qualquer motivo:
  • “Erro na validação do certificado filter failed”.

Gerando arquivo de remessa (CNAB)

Além dos valores informados no boleto se faz necessário informa os seguintes parâmetros (mapeamento) da remessa:

• “PAGADOR_NOME” – Nome do sacado/cliente;
• “INSTRUCAO_COBRANCA1” e “INSTRUCAO_COBRANCA2” – 2 números conforme manual do banco (Nota 11 página 20 e 21).
• “DATA_MORA” – Data de vencimento.
• “DESCONTO_VALOR” – Define o valor do desconto;
• “DIAS_PROTESTO” – Dias para protesto 00 a 99;
• “DOCUMENTO_DESCRICAO” – Deve ser informado, EX: “NF”, “DUP”;
• “DOCUMENTO_NUMERO” – Deve ser informado o número do documento.

WebService (V1) / Depreciada

Para se conectar via WebService utilize os dados abaixo.

Dados de conexão

• BENEFICIARIO_DOCUMENTO: Informe o CPF ou CNPJ do beneficiário;
• ITAU_CHAVE – Fornecido pelo Itaú;
• CLIENT_ID – Fornecido pelo Itaú;
• CLIENT_SECRET – Fornecido pelo Itaú;
• VERSAO – Informar “V1” para forçar a inicialização com esta versão.