Blog

341 – Itaú

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

  • BENEFICIARIO_DOCUMENTO: Informe o CPF ou CNPJ do beneficiário;
  • CERTIFICADO_ARQUIVO – Caminho absoluto do arquivo no formato PFX;
  • CERTIFICADO_SENHA – Senha do arquivo PFX;
  • 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).

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

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.

Leave a comment