{"id":88,"date":"2015-10-30T17:35:53","date_gmt":"2015-10-30T20:35:53","guid":{"rendered":"http:\/\/www.l2maker.com.br\/documentacao\/?p=88"},"modified":"2025-09-29T16:40:34","modified_gmt":"2025-09-29T19:40:34","slug":"341-itau","status":"publish","type":"post","link":"https:\/\/www.l2maker.com.br\/documentacao\/2015\/10\/341-itau\/","title":{"rendered":"341 &#8211; Ita\u00fa"},"content":{"rendered":"\n<p>Par\u00e2metro de identifica\u00e7\u00e3o do banco:<\/p>\n\n\n\n<p><strong>BANCO:<\/strong>&nbsp;&#8220;341&#8221;, &#8220;Ita\u00fa&#8221;, ou &#8220;Itau&#8221;.<\/p>\n\n\n\n<p>Par\u00e2metros principais:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>AGENCIA_NUMERO<\/strong> &#8211; 04 d\u00edgitos;<\/li>\n\n\n\n<li><strong>CONTA_CORRENTE_NUMERO<\/strong> &#8211; 05 d\u00edgitos;<\/li>\n\n\n\n<li><strong>CONTA_CORRENTE_DV<\/strong> &#8211; 01 digito;<\/li>\n\n\n\n<li><strong>CARTEIRA<\/strong> &#8211; 03 d\u00edgitos (EX: 109)<\/li>\n\n\n\n<li><strong>NOSSO_NUMERO<\/strong> &#8211; At\u00e9 08 d\u00edgitos.<\/li>\n<\/ul>\n\n\n\n<p>Informa os demais&nbsp;<a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2015\/10\/parametros-do-boleto-bancario\/\" target=\"_blank\" rel=\"noopener\">par\u00e2metros boletos<\/a>.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h1 class=\"wp-block-heading\">Boleto com PIX<\/h1>\n\n\n\n<p>Para emitir boleto com PIX no Ita\u00fa&nbsp; voc\u00ea deve usar a <a href=\"https:\/\/www.l2maker.com.br\/documentacao\/api-do-pix-para-maker\/\">API do PIX<\/a>, e ver a se\u00e7\u00e3o <a href=\"\/documentacao\/2022\/04\/trabalhando-com-o-pix-no-itau-341\/\">BOLECODE na documenta\u00e7\u00e3o do Ita\u00fa<\/a>.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\">WebService (V2)<\/h1>\n\n\n\n<p>Para se conectar via WebService atrav\u00e9s da API intitulada &#8220;API Emiss\u00e3o, Instru\u00e7\u00e3o e Consulta de boletos&#8221; utilize os dados abaixo.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Dados de conex\u00e3o<\/h3>\n\n\n\n<p>Para criar uma conex\u00e3o com o Ita\u00fa:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>BENEFICIARIO_DOCUMENTO<\/strong>: Informe o CPF ou CNPJ do benefici\u00e1rio;<\/li>\n\n\n\n<li><strong>CLIENT_ID<\/strong> &#8211; Fornecido pelo Ita\u00fa;<\/li>\n\n\n\n<li><strong>CLIENT_SECRET<\/strong> &#8211; Fornecido pelo Ita\u00fa;<\/li>\n\n\n\n<li><strong>CARTEIRA_CONVENIO<\/strong> &#8211; ID do Benefici\u00e1rio, Fornecido pelo Ita\u00fa &#8211; Ag\u00eancia (4 d\u00edgitos) + Conta (7 d\u00edgitos) + DAC (1 d\u00edgito);<\/li>\n<\/ul>\n\n\n\n<p>Certificado em formato PFX (PKCS12):<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>CERTIFICADO_ARQUIVO<\/strong> &#8211; Caminho absoluto do arquivo no formato PFX;<\/li>\n\n\n\n<li><strong>CERTIFICADO_SENHA<\/strong> &#8211; Senha do arquivo PFX;<\/li>\n<\/ul>\n\n\n\n<p>Certificado em arquivo key e cer:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><b><strong>CER <\/strong><\/b>&#8211; Caminho absoluto do arquivo CER (Certificado) no formato PEM;<\/li>\n\n\n\n<li><b><strong>KEY <\/strong><\/b>&#8211; Caminho absoluto do arquivo KEY (Chave privada) no formato PEM.<\/li>\n<\/ul>\n\n\n\n<p>OBS: Em ambos os casos o certificado a ser enviado \u00e9 o fornecido pelo banco. At\u00e9 o momento (SET\/2025) o banco n\u00e3o aceita e-CNPJ ou e-CPF usando uma cadeia pr\u00f3pria.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Dados para inclus\u00e3o do boleto<\/h3>\n\n\n\n<p>Utilize a fun\u00e7\u00e3o &#8220;<strong>Boleto &#8211; WebService &#8211; Incluir Boleto<\/strong>&#8220;, e no segundo par\u00e2metro, para gerar o JSON utilize os par\u00e2metros de boleto, com as seguintes observa\u00e7\u00f5es adicionais:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>CARTEIRA<\/strong> (<span style=\"color: #ff0000;\"><strong>Obrigat\u00f3rio<\/strong><\/span>): C\u00f3digo da carteira do t\u00edtulo;<\/li>\n\n\n\n<li><strong>DOCUMENTO_NUMERO<\/strong> (Letras) &#8211; Preenche o campo &#8220;<strong>dados_individuais_boleto<\/strong>&#8221; > &#8220;<strong>texto_uso_beneficiario<\/strong>&#8220;, conforme descri\u00e7\u00e3o do banco: &#8220;Campo de 25 caract\u00e9res, utilizado na API legado como &#8220;<strong>identificador_titulo_empresa<\/strong>&#8220;. Deve ser utilizado apenas letras e n\u00fameros.&#8221;;<\/li>\n\n\n\n<li><strong>INSTRUCOES<\/strong> (Letras)<strong> &#8211; <\/strong>Preenche o campo &#8220;<strong>lista_mensagens_cobranca<\/strong>&#8221; > &#8220;<strong>mensagem<\/strong>&#8220;, cada linha vira uma mensagem.<\/li>\n<\/ul>\n\n\n\n<p>Opcionalmente, voc\u00ea pode enviar o JSON completo, no lugar do mapeamento.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Dados para consulta do boleto<\/h2>\n\n\n\n<p>Usar a fun\u00e7\u00e3o &#8220;<strong>Boleto &#8211; WebService &#8211; Consultar Boleto<\/strong>&#8221; passando a conex\u00e3o no primeiro par\u00e2metro, e no segundo par\u00e2metro um mapa com os seguintes dados:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>CARTEIRA_CONVENIO<\/strong>: Opcional, quando j\u00e1 informada na inicializa\u00e7\u00e3o;<\/li>\n\n\n\n<li><strong>CARTEIRA<\/strong> (<span style=\"color: #ff0000;\"><strong>Obrigat\u00f3rio<\/strong><\/span>): C\u00f3digo da carteira do t\u00edtulo;<\/li>\n\n\n\n<li><strong>NOSSO_NUMERO<\/strong> (<span style=\"color: #ff0000;\"><strong>Obrigat\u00f3rio<\/strong><\/span>);<\/li>\n\n\n\n<li><strong>DATA_EMISSAO<\/strong> (Opcional).<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Dados para baixa \/ remo\u00e7\u00e3o \/cancelamento do boleto<\/h2>\n\n\n\n<p>Usar a fun\u00e7\u00e3o &#8220;<strong>Boleto &#8211; WebService &#8211; Baixar Boleto<\/strong>&#8221; para baixar\/remover\/cancelar uma cobran\u00e7a. Ela deve ser chamada passando a conex\u00e3o no primeiro par\u00e2metro, e no segundo par\u00e2metro um mapeamento com os seguintes dados:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>CARTEIRA_CONVENIO<\/strong>: Opcional, quando j\u00e1 informada na inicializa\u00e7\u00e3o;<\/li>\n\n\n\n<li><strong>CARTEIRA<\/strong> (<span style=\"color: #ff0000;\"><strong>Obrigat\u00f3rio<\/strong><\/span>): C\u00f3digo da carteira do t\u00edtulo;<\/li>\n\n\n\n<li><strong>NOSSO_NUMERO<\/strong> (<span style=\"color: #ff0000;\"><strong>Obrigat\u00f3rio<\/strong><\/span>): N\u00famero do boleto a ser baixado.<\/li>\n<\/ul>\n\n\n\n<h1 class=\"wp-block-heading\">Dados de homologa\u00e7\u00e3o<\/h1>\n\n\n\n<p>Paga obter os dados de teste, no portal do desenvolvedor ( <a href=\"https:\/\/devportal.itau.com.br\/\" target=\"_blank\" rel=\"noopener\">https:\/\/devportal.itau.com.br\/<\/a> ), localize a &#8220;<strong>API Emiss\u00e3o, Instru\u00e7\u00e3o e Consulta de boletos<\/strong>&#8220;, clique em documenta\u00e7\u00e3o, e depois em &#8220;API reference&#8221;, e gere os dados de uso no topo.<\/p>\n\n\n\n<p>N\u00e3o \u00e9 necess\u00e1rio certificado em homologa\u00e7\u00e3o.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\">Principais erros<\/h1>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Se o certificado ( <strong>CERTIFICADO_ARQUIVO )<\/strong> n\u00e3o for vinculado ao <strong>CLIENT_ID<\/strong>:\n<ul class=\"wp-block-list\">\n<li>&#8220;O Common Name (CN): <span style=\"color: #ff0000;\">xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx<\/span> do certificado \u00e9 inv\u00e1lido.&#8221;<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Se o <strong>CLIENT_SECRET <\/strong>ou <strong>CLIENT_ID <\/strong>estiver errado:\n<ul class=\"wp-block-list\">\n<li>&#8220;Falha ao Criar token local filter failed&#8221;.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Se o certificado n\u00e3o for permitido por qualquer motivo:\n<ul class=\"wp-block-list\">\n<li>&#8220;Erro na valida\u00e7\u00e3o do certificado filter failed&#8221;.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h1 class=\"wp-block-heading\">Gerando arquivo de remessa (CNAB)<\/h1>\n\n\n\n<p>Al\u00e9m dos valores informados no boleto se faz necess\u00e1rio informa os seguintes par\u00e2metros (mapeamento) da remessa:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>&#8220;<strong>PAGADOR_NOME<\/strong>&#8221; &#8211; Nome do sacado\/cliente;<\/li>\n\n\n\n<li>&#8220;<strong>INSTRUCAO_COBRANCA1<\/strong>&#8221; e &#8220;<strong>INSTRUCAO_COBRANCA2<\/strong>&#8221; &#8211; 2 n\u00fameros conforme manual do banco (Nota 11 p\u00e1gina 20 e 21).<\/li>\n\n\n\n<li><strong>&#8220;DATA_MORA&#8221;<\/strong> &#8211; Data de vencimento.<\/li>\n\n\n\n<li><strong>&#8220;DESCONTO_VALOR&#8221;<\/strong> &#8211; Define o valor do desconto;<\/li>\n\n\n\n<li><strong>&#8220;DIAS_PROTESTO&#8221;<\/strong> &#8211; Dias para protesto 00 a 99;<\/li>\n\n\n\n<li>&#8220;<strong>DOCUMENTO_DESCRICAO<\/strong>&#8221; &#8211; Deve ser informado, EX: &#8220;NF&#8221;, &#8220;DUP&#8221;;<\/li>\n\n\n\n<li>&#8220;<strong>DOCUMENTO_NUMERO<\/strong>&#8221; &#8211; Deve ser informado o n\u00famero do documento.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h1 class=\"wp-block-heading\"><\/h1>\n\n\n\n<h1 class=\"wp-block-heading\">WebService (V1) \/ Depreciada<\/h1>\n\n\n\n<p>Para se conectar via WebService utilize os dados abaixo.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Dados de conex\u00e3o<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>BENEFICIARIO_DOCUMENTO<\/strong>: Informe o CPF ou CNPJ do benefici\u00e1rio;<\/li>\n\n\n\n<li><strong>ITAU_CHAVE<\/strong> &#8211; Fornecido pelo Ita\u00fa;<\/li>\n\n\n\n<li><strong>CLIENT_ID<\/strong> &#8211; Fornecido pelo Ita\u00fa;<\/li>\n\n\n\n<li><strong>CLIENT_SECRET<\/strong> &#8211; Fornecido pelo Ita\u00fa;<\/li>\n\n\n\n<li><strong>VERSAO<\/strong> &#8211; Informar &#8220;<strong>V1<\/strong>&#8221; para for\u00e7ar a inicializa\u00e7\u00e3o com esta vers\u00e3o.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Par\u00e2metro de identifica\u00e7\u00e3o do banco: BANCO:&nbsp;&#8220;341&#8221;, &#8220;Ita\u00fa&#8221;, ou &#8220;Itau&#8221;. Par\u00e2metros principais: Informa os demais&nbsp;par\u00e2metros boletos. Boleto com PIX Para emitir boleto com PIX no Ita\u00fa&nbsp; voc\u00ea deve usar a API do PIX, e ver a se\u00e7\u00e3o BOLECODE na documenta\u00e7\u00e3o do Ita\u00fa. WebService (V2) Para se conectar via WebService atrav\u00e9s da API intitulada &#8220;API Emiss\u00e3o, Instru\u00e7\u00e3o [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[27],"tags":[],"class_list":["post-88","post","type-post","status-publish","format-standard","hentry","category-boleto-bancario-carteiras-suportadas"],"_links":{"self":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/88","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/comments?post=88"}],"version-history":[{"count":46,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/88\/revisions"}],"predecessor-version":[{"id":4095,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/88\/revisions\/4095"}],"wp:attachment":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/media?parent=88"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/categories?post=88"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/tags?post=88"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}