GF - Como Fazer - Open Banking para Banco Itaú

2026-09-25T12:27:05Z

Felipe.silva:

[[categoria:Como_Fazer_Finanças]]

= Objetivo =

Este manual tem por objetivo instruir alguém que já tenha lido o manual geral do Open Banking CIGAM a realizar todo o processo de parametrização e início do uso das APIs '''bancárias do Itaú'''.


Aqui você será orientado desde a busca e obtenção das credenciais, assistente e parametrizações '''específicas do Itaú''' para o Open Banking. Para dúvidas gerais referentes a funcionalidades gerais do Open Banking consulte o Manual [http://ww2.cigam.com.br/mediawiki/index.php/GF_-_Como_Fazer_-_Open_Banking Open Banking - Geral].


= APIs disponíveis e serviços atendidos pelo CIGAM =
<center>

{| style="border-spacing:0;width:14.993cm;"
|- style="border:0.5pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.191cm;padding-right:0.191cm;"
|| '''Funcionalidade'''
|| '''Versão'''
|- style="border:0.5pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.191cm;padding-right:0.191cm;"
|| Registro de Cobrança Simples e vinculada
|| 220404 BETA
|- style="border:0.5pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.191cm;padding-right:0.191cm;"
|| Alteração de Vencimento
|| 220404 BETA
|- style="border:0.5pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.191cm;padding-right:0.191cm;"
|| Alteração de Juros e multa
|| 220404 BETA
|- style="border:0.5pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.191cm;padding-right:0.191cm;"
|| Baixa de título
|| 220404 BETA
|- style="border:0.5pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.191cm;padding-right:0.191cm;"
|| Protesto e Negativação
|| 220404 BETA
|- style="border:0.5pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.191cm;padding-right:0.191cm;"
|| Retorno de Cobrança
|| 221107.a BETA
|- style="border:0.5pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.191cm;padding-right:0.191cm;"
|| Demais alterações (endereço, desconto por antecipação, etc)
|| Não tratados no CIGAM
|- style="border:0.5pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.191cm;padding-right:0.191cm;"
|| QR CODE no Boleto (Bolecode)
|| 221107.a BETA
|- style="border:0.5pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.191cm;padding-right:0.191cm;"
|| API de PIX avulso (QR Code dinâmico ECF Lojas)
|| 231002 BETA
|- style="border:0.5pt solid #000000;padding-top:0cm;padding-bottom:0cm;padding-left:0.191cm;padding-right:0.191cm;"
|| Abatimentos
|| 251103.BETA
|-
|}

</center>

= Open Banking Itaú =

== Obtenção de credenciais - Itaú (versão atual V2 + BOLECODE) ==

As credenciais do Itaú são obtidas através de um processo realizado em conjunto com a equipe de implantação e acessos ao [https://devportal.itau.com.br/baas/#/ Portal Developers] desta instituição e seguir os passos do processo de credenciamento e geração do certificado digital.


'''IMPORTANTE: '''O Itaú utiliza credenciais e certificados digitais específicos para a API de cobrança, chamada CASH MANAGEMENT (registro sem QR Code e retorno de cobrança) e para a API BOLECODE (registro de cobrança com QR Code). Desta forma, um cliente que quiser possuir registro com QR Code e retorno via API, precisará das credenciais e certificados para as duas APIs. Tratam-se de certificados próprios, não sendo possível a utilização dos certificados da NFe.


O processo de obtenção de credenciais é totalmente de responsabilidade do cliente e sua equipe de TI juntamente com o Itaú. Para aqueles que desejarem auxílio, dispomos de um parceiro homologado na empresa [https://www.certidoc.com.br/ Certidoc] onde cabe ao cliente fazer este contato.



<ul>
<pre>
O Itaú a partir de setembro de 2024 possibilita que as credenciais geradas sejam 'unificadas', no sentido de que o scope de BOLECODE passa a poder ser adicionado a credencial de CASH_MANAGEMENT. Porém, para uso dessa modalidade de 'credenciais unificadas', é necessário que identifique a versão do Cigam para saber se a versão do Cigam em uso é a 241007 e posteriores ou 240506 patch 'c' ou posteriores, que são as versões que suportam esta modalidade. Caso sua versão de Cigam seja anterior as versões mencionadas e suas credenciais forem unificadas, apenas o registro de títulos irá funcionar, o retorno acusará o erro "Não encontrado".
</pre>
</ul>


== Responsabilidades na obtenção de credenciais, escopos e certificados ==

As integrações Open Banking dependem de credenciais, escopos de acesso (scopes), certificados digitais e demais permissões disponibilizadas pela instituição financeira.

É importante destacar que essas informações fazem parte do relacionamento entre o cliente e o banco, não sendo definições ou parametrizações do ERP. Portanto, a solicitação, geração, liberação e gerenciamento desses recursos são de responsabilidade do cliente junto à instituição financeira.

Para mais detalhes, consulte a FAQ:
*[[Credenciais Open Banking]]

== Instruções para troca/renovação do certificado digital - Itaú ==

As instruções para renovação do certificado digital utilizado nas credenciais do Itaú estão disponíveis no [https://devportal.itau.com.br/baas/#/ Portal Developers] e são compostas por ações semelhantes às do primeiro credenciamento. Contate o seu gerente de Cash (Itaú) para maiores informações e caso tenha dificuldade em realizar o processo, a CIGAM dispõe da [http://www.certidoc.com.br Certidoc] para prestar este auxílo.


Para a troca do certificado no CIGAM (seja Bolecode ou Cash) em cenários onde o novo certificado '''manter o CN e alterar somente sua validade''' basta remover o antigo e instalar o atual. Para validar se a configuração Open Banking está utilizando o novo certificado entre nas Credenciais dos Parâmetros Open Banking e verifique se o campo "Status do Certificado" foi atualizado.

O acesso as parâmetros Open Banking serão realizados através do menu [[Finanças]] > [[GF_Gestão Financeira|Gestão Financeira]] > [[GF_Parâmetros|Parâmetros]] > [[GF_Parâmetros_Configuração de Bancos|Configuração de Bancos]]. Selecione o banco desejado, e em modo modificar, acesse o botão '''Open Banking''':

[[Arquivo:Renovacao do Certificado Itau.png|centro]]
 
[[Arquivo:Renovacao do Certificado Itau 2.png|centro]]

Caso o certificado tenha o '''CN alterado''' será necessário a atualização no banco e no CIGAM informar o novo '''Client Id/Client Id BOLECODE'''. Para validar a atualização verifique se o campo "Status do Certificado" foi atualizado.

[[Arquivo:Renovacao do Certificado Itau 3.png|centro]]

Para mais informações de instalação do certificado acesse a [[OpenBanking - Como fazer/revisar a instalação, para que o certificado digital, apareça nas configurações de banco em Parâmetros em seguida Status do certificado? | FAQ]] sobre instalação e revisão do certificado digital.


== Assistente Open Banking - Itaú ==

O acesso aos parâmetros Open Banking serão realizados através do menu [[Finanças]] > [[GF_Gestão Financeira|Gestão Financeira]] > [[GF_Parâmetros|Parâmetros]] > [[GF_Parâmetros_Configuração de Bancos|Configuração de Bancos]]. Selecione o banco desejado, e em modo modificar, acesse o botão '''Open Banking''':

Conforme explicado no tópico anterior, a tela de boas-vindas do assistente do Itaú especifica os dados referentes às credenciais para as APIs do Itaú:

[[Arquivo:Abertura do Assistente Itau.png|centro]]
 

'''Passo 1: '''Aqui serão solicitados todos os dados relativos a credenciais e serão explicados um a um. O Itaú a partir a versão 2 (atual) da sua API, deixou de disponibilizar ambientes de teste, desta forma, preencha apenas os dados da guia “Produção”, caso você tenha a necessidade de cadastrar alguns títulos de teste, utilize o campo “etapa processo do boleto = validação” conforme as instruções abaixo.

[[Arquivo:Passo 1 Assistente Itau.png|centro]]

<ul>
'''a. API Cobrança:''' 02 – API cash_management ou 03 – BOLECODE. Conforme explicado acima, utilize a opção 02 para registro e retorno de cobrança sem QR Code no boleto, para esta opção são necessárias apenas as informações com sufixo “CASH”. Já para utilizar a opção 03 que possui registro de cobrança com QR Code, é necessário utilizar as credenciais com sufixo “BOLECODE” e também as de sufixo “CASH” pois a API de retorno permanece nesta segunda API.
 
'''b. Client_id Remessa/Retorno Cobrança CASH:''' id da API cash Management para registro sem QR Code e retorno de cobrança;
 
'''c. Client_secret Remessa/Retorno Cobrança CASH:''' secret da API cash Management para registro sem QR Code e retorno de cobrança;
 
'''d. Chave Itaú:''' campo desabilitado, era utilizado na V1 já descontinuada;
 
'''e. Etapa Processo do Boleto:''' Aqui é onde existe a possibilidade de realizar registros de testes no Itaú, a opção “etapa processo” permite realizar registros em ambiente não produtivo conforme abaixo:
 
<ul>
01 – Efetivação: este é o formato oficial onde os títulos serão registrados em ambiente de produção.
 
02 – Validação: mantendo este parâmetro, os títulos serão enviados para um ambiente de testes restritos (apenas registro, sem possibilidade de alteração uma vez que o título não fica registrado, apenas é feita uma validação inicial).
</ul>
'''f. Status Certificado Cobrança CASH:''' campo preenchido automaticamente pelo CIGAM ao localizar um certificado nomeado com o seu CN=Client_id da API de CASH. Exemplo:
<ul>
Client_ID Remessa/Retorno CASH: 1234567891011121314
 
Nome do Certificado: “1234567891011121314”
</ul>
'''g. Identificador (CNPJ/CPF):''' campo desabilitado, era utilizado na V1 já descontinuada;
 
'''h. Versão da API:''' campo preenchido automaticamente pelo CIGAM;
 
'''i. Client_id BOLECODE:''' id da API BOLECODE para registro de cobrança com QR Code;
 
'''j. Client_Secret BOLECODE:''' secret da API BOLECODE para registro de cobrança com QR Code;
 
'''k. Status Certificado BOLECODE:''' campo preenchido automaticamente pelo CIGAM ao localizar um certificado nomeado com o seu CN=Client_id da API BOLECODE. Exemplo:
<ul>
Client_ID BOLECODE: 1234567891011121314
 
Nome do Certificado: “1234567891011121314”
</ul>
'''l. x-apigw-api-id:''' campo desabilitado, era utilizado na V1 já descontinuada;
 
'''m. Scope:''' campo desabilitado, era utilizado na V1 já descontinuada;
 
'''n. URL Autorização:''' campo preenchido automaticamente pelo CIGAM;
 
'''o. URL API:''' campo preenchido automaticamente pelo CIGAM;
 
'''p. URL BOLECODE:''' campo preenchido automaticamente pelo CIGAM;
 
'''q. Usuário para Alerta:''' informe aqui o usuário que receberá os alertas de vencimento do certificado digital utilizado na parametrização. Esta informação é muito importante pois o processo de renovação junto ao Itaú pode levar alguns dias e não será possível registrar títulos com um certificado vencido.
</ul>

 

'''Passo 2: '''Este passo diz respeito à seleção de convênios, ela é uma característica do Itaú e serve para que possa ser apontado o convênio para o qual as credenciais geradas serão válidas. O CIGAM irá apresentar todos os códigos de convênios localizados dentre os portadores cujo código de banco é “341”. Porém aqui cabe uma ressalva: a não ser que esteja discriminado nas suas credenciais, sugerimos que você clique em “pular” nesta tela, assim as suas credenciais valerão para qualquer convênio que a empresa possua.

[[Arquivo:Passo 2 Assistente Itau.png|centro]]

O resultado de clicar em “pular” neste passo resultará em uma parametrização de convênio “Geral” na tela de parâmetros open banking. Depois disso, caso você deseje adicionar uma parametrização adicional, será obrigatório informar um convênio para as credenciais que se deseja adicionar (o botão pular estará desabilitado). Caso a parametrização atual possua um convênio especificado, será possível tanto configurar um novo convênio quanto pular a seleção, desta forma, as novas credenciais utilizarão um convênio “Geral”.

 

'''Passo 3: '''Neste passo você irá informar os portadores de remessa e retorno que serão utilizados para esta parametrização do Open Banking, aqui você pode informar mais de um portador, por exemplo, o de carteira SIMPLES e o de carteira VINCULADA e ambos utilizarão a mesma instância de credenciais. A informação do portador de retorno é para auxiliar na sugestão da rotina de retorno.

[[Arquivo:Passo 3 Assistente Itau.png|centro]]

'''Importante:''' mesmo com a utilização da opção de convênio “Geral”, os portadores de remessa e retorno devem obrigatoriamente possuir o mesmo convênio, isso é importante para que a rotina de retorno funcione corretamente.


'''Importante 2:''' O Itaú possui as opções de envio direto e registro PIX no boleto disponíveis, esta última só está disponível caso tenha sido selecionada a opção 03 – BOLECODE no passo 1 do assistente, bem como está condicionada à existência de credenciais válidas para esta API.

 

'''Passo 4:''' o passo 4 serve para realizar o apontamento do relatório de remessa que servirá como padrão tanto para a rotina de registro quanto para retorno do Open Banking. O CIGAM irá sugerir o caminho padrão para o modelo de relatório (RF00071), mas caso os seus modelos sejam salvos em algum outro local, basta alterá-lo neste momento, após, clique em “avançar”.

[[Arquivo:Passo 4 Relatorio SICOOB.png|centro]]

'''Pronto! '''Caso tenha dado tudo certo com as suas credenciais, o CIGAM irá emitir uma mensagem de sucesso para cada um dos ambientes para o qual você informou as credenciais.

[[Arquivo:Assistente Conclusao Itau.png|centro]]

Após clicar em “concluir” você será apresentado à tela “Parâmetros” Open Banking (conforme abaixo), você encontrará o descritivo de cada área dela no item [http://ww2.cigam.com.br/mediawiki/index.php/GF_-_Como_Fazer_-_Open_Banking#Tela_de_par%C3%A2metros_Open_Banking Tela parâmetros Open Banking] do manual Open Banking Geral.

[[Arquivo:Parametros Open Banking Itau .png|centro]]

A partir daqui o seu CIGAM já está parametrizado para utilizar o Open Banking do Banco Itaú, os serviços disponíveis para ele estão na tabela apresentada no início deste manual. Nas sessões a seguir estarão descritas apenas as características específicas do '''Itaú'''. Demais instruções de uso do open banking estão no [http://ww2.cigam.com.br/mediawiki/index.php/GF_-_Como_Fazer_-_Open_Banking Manual Open Banking - Geral].


== Ambiente de testes - Itaú ==

A partir da V2 (01/01/2022) não está mais disponível o ambiente de testes do Itaú, para registrar títulos nesta modalidade é necessário utilizar a opção “validação” disponível nos parâmetros open banking (campo “etapa processo do boleto”), neste formato os títulos são enviados para um ambiente de testes onde é possível realizar o registro, mas não o retorno de títulos.

[[Arquivo:Botao Credenciais Parametros Open Banking Itau.png|centro]]

== Registro de cobrança - Itaú ==

O registro do Itaú é, de maneira geral realizado como todos os outros bancos, abaixo seguem algumas explicações exclusivas.


=== Particularidades do cadastro de Portador - Itaú ===

'''- Agência e Conta:''' O portador do Itaú precisa de 12 caracteres entre Agência + Conta (completar com zeros a esquerda), do contrário, o erro abaixo será apresentado:

[[Arquivo:Erro Itau 12 Caracteres.png|centro]]
 
[[Arquivo:Cadastro de Portadores 12 Caracteres.png|centro]]
 


'''- Recebimentos divergentes da cobrança:''' Para portadores do Itaú (341) disponibilizamos o campo <ref group="Versão 231002.a"> Liberado a partir da OS 816822/2. </ref>"Aceita recebimento divergente da cobrança". Se o checkbox for marcado, a tag "codigo_tipo_autorizacao" do envio para registro no banco será enviada com o dado "01", permitindo que o título aceite recebimentos divergentes, caso contrário, a tag será enviada como "03" e o título não permitirá este tipo de recebimento.

[[Arquivo:Aceita recebimento divergente da cobranca Itau.png|centro]]
 


'''- Espécie:''' Para portadores do Itaú (341) no campo Espécie na guia CNAB do cadastro de Portadores, utilize uma das opções da coluna '''Código''' listadas abaixo a partir da documentação técnica fornecida pelo banco.

[[Arquivo:Especie itau.png|centro]]

=== Protesto e Negativação ===

'''Protesto e negativação:''' O Itaú possui os serviços de protesto e negativação e apenas um destes serviços pode ficar ativo.

Conforme Manual BoleCode via API, disponibilizado pelo Itaú, os códigos das instruções para Protesto e Negativação são:
{| class="wikitable"
|-
! Código !! Instrução
|-
| 1 || Protestar
|-
| 2|| Negativar
|-
| 4 || Não protestar
|-
| 5|| Não negativar
|-
| 7|| Não receber após o vencimento
|-
| 8|| Baixar após vencimento
|}

No mesmo manual, não está prevista instrução para envio dos dias de protesto ou negativação, como úteis ou corridos, sendo assim consulte seu gerente de cash ou o suporte de API do Banco.

Fonte: [https://www.cigam.com.br/wiki/images/a/a3/Manual_API_EmissaoBoleCode.pdf Manual BoleCode Itaú via API]

=== Impressão de QR Code no Boleto - Itaú (Bolecode) ===

Conforme já demonstrado na área de parametrização do assistente open banking do Itaú, uma empresa que queira emitir QR Codes em seus boletos deve possuir credenciais e certificado digital para a API - 03 BOLECODE. Adicionalmente, ela precisa:
* Marcar a opção “PIX” dos parâmetros open banking;
* Informar a sua chave PIX (tipo e dado) no cadastro do portador de remessa;
* Possuir a TAG qrcode_pix no seu modelo de boleto caminho para modelo padrão salvo em: ''I:\CIGAM\DOC\Modelos_relatorios\Gestão Financeira\Bloquetos Merge\0098 - Itau_pix.rtf''


Chave obtida no cadastro do portador de remessa:
 
Necessário direito de ''Menu GF Configurações'' e configuração ''3099 - GF - GE Permitir acesso aos Parâmetros PIX'' marcada para o usuário para acesso ao botão ''Parâmetros PIX''.

[[Arquivo:Dado Pix Portador Itau.png|centro]]

Identificação no arquivo JSON de remessa:

[[Arquivo:Dados QRCode Itau JSON.png|centro]]

Impressão do boleto com QR Code (Bolecode):

[[Arquivo:Impressao Bolecode Itau.png|centro]]

=== Particularidades de baixa - Itaú ===

O Itaú só permite a baixa de títulos após passado pelo menos um dia do registro.


'''Descrição do Erro (Banco):'''


''"Erro na validação de Campos.''
 
''Atualização não permitida na mesma data de emissão do título."''

[[Arquivo:Particularidades de baixa.png|centro]]

Observação: o registro de títulos do itaú é instantâneo, mas as alterações serão processadas somente no dia seguinte.


===Alterações de títulos registrados Via Open Banking - Alteração de Multa===

De acordo com as orientações do Portal Developers do Itaú, a tag obrigatória '''codigo_tipo_multa''', poderá ser:
*'''01''' - Quando se deseja cobrar um valor fixo de multa após o vencimento
*'''02''' - Quando se deseja cobrar um percentual do valor do título de multa após o vencimento
*'''03''' - Quando não se deseja cobrar multa caso o pagamento seja feito após o vencimento (isento)
 
[[Image: OpenItau_codigo_tipo_multa.png|750px|centro]]
 

=== Origem das tags ===
{| class="wikitable"
|-
! Tag !! Origem no Cigam
|-
| texto_seu_numero|| Número da NF + desdobramento da duplicata, do lançamento financeiro
|}

== Retorno de cobrança - Itaú ==

A rotina de retorno do Itaú funciona da forma padrão com exceção da explicação contida no botão de alerta disponível na rotina:

[[Arquivo:Open Banking Itau 0001.png|centro]]
 
[[Arquivo:Open Banking Itau 0002.png|centro]]
 
===Guia Filtros===

====Busca Liquidações por "Detalhamento"====


'''Unidade de Negócio''': Filtro para a unidade de negócio do lançamento financeiro.

'''Empresa:''' Filtro para a empresa do lançamento financeiro.

'''Lançamento:''' Filtro para o número do lançamento financeiro.

'''Vencimento:''' Filtro para o vencimento do lançamento financeiro.

'''Data:''' Filtro para a data do lançamento financeiro. É necessário informar data inicial e final para execução da rotina.

<ref group="Versão 240506"> Liberado a partir da OS 816822/4. </ref>'''Situação do Boleto:''' Neste filtro teremos duas opções.
* Todos: retornará todos lançamentos registrados independente da situação (entrada, baixado ou liquidado).
* Somente Abertos: retornará somente lançamentos registrados com situação em aberto (entrada). '''Observação:''' Nessa opção também serão retornados os títulos pagos via QRCode que ainda não foram liquidados manualmente no CIGAM. Feita a liquidação, o título não será mais apresentado no relatório, somente se o filtro for alterado para "Todos".


====<ref group="Versão 251103"> Liberado a partir da OS 816822/8. </ref>Busca Liquidações por "Listagem"====

'''Data:''' Filtro para a data do título. O método "Listagem" exige que seja informado data inicial e final para execução da rotina, caso contrário haverá retorno de erro do banco.


'''Situação do Boleto:''' Neste filtro teremos quatro opções:
* Todos: retornará todos lançamentos registrados independente da situação (entrada, baixado ou liquidado).
* Em aberto: retornará somente lançamentos registrados com situação em aberto.
* Liquidado: retornará somente lançamentos pagos.
* Baixado: retornará somente lançamentos baixados. Observação: como o pagamento via qrcode efetua a liquidacao e baixa do boleto físico, ele será retornado tanto na baixa quanto na liquidação.


'''Pesquisa por Data:''' Neste filtro teremos cinco opções:
* Data de Entrada;
* Data de Emissão;
* Data de Vencimento;
* Data de Pagamento - esta opção será habilitada apenas quando "Situação do Boleto" estiver como "Liquidado";
* Data de Pagamento(Baixa) - esta opção será habilitada apenas quando "Situação do Boleto" estiver como "Baixado".


A opção selecionada no campo "Pesquisa por Data" determinará qual data será utilizada na busca. Por exemplo, se o usuário selecionar “Data de Vencimento” e informar 29/10/2025, o sistema irá buscar todos os títulos cuja data de vencimento seja 29/10/2025.


Lembrando que o retorno de títulos do Itaú é realizado pela API “CASH MANAGEMENT” que possui credenciais próprias, dessa forma, mesmo um cliente que use a forma de consumo 03 – BOLECODE, irá precisar de credenciais da V2 para realizar os seus retornos. Além disso, o banco não retorna os títulos pagos via QR CODE com status de liquidado quando a busca de liquidações for "Detalhamento", desta forma, a rotina de retorno neste formato apenas indica que o título foi pago via QR Code, mas não o liquida, mesmo utilizando a opção “Retorno”. Os títulos recebidos via QR Code no Itaú quando utilizada a busca de liquidações por '''Detalhamento''' devem ser liquidados manualmente dentro do CIGAM ou via retorno CNAB. Já se a busca for por '''Listagem''' então a liquidação do QRCode será automática'''.

[[Arquivo:Retorno Itau pago por QRCode.png|centro]]

= Alterações de títulos registrados Via Open Banking =
== Abatimento de títulos ==

<ref group="Versão 251103">Liberado a partir da OS 816297/7.</ref>Este recurso permite realizar o registro e cancelamento de abatimentos de forma integrada ao Open Banking no CIGAM. Por meio da configuração de um portador específico do tipo Abatimento, o sistema identifica automaticamente as liquidações relacionadas, gera os comandos bancários necessários e envia as informações aos bancos homologados, tornando o processo mais ágil, seguro e automatizado.

=== Registro de Abatimento ===

Para instruções completas de uso, consulte o manual [[GF - Como Fazer - Open Banking#Registro de abatimento|Como Fazer - Open Banking - Abatimento de títulos]].

=== Cancelamento de abatimento ===

Para instruções completas de uso, consulte o manual [[GF - Como Fazer - Open Banking#Cancelamento de abatimento|Como Fazer - Open Banking - Cancelamento de abatimento]].

= Retenção P/C/C - PIS, COFINS, CSLL =

Para quem utiliza o recurso de Controlar Retenções na Saída, ou seja, configuração [[GF - GE - 2505 - Código de imposto para controlar retenção de CSLL na saída]], e deseja registrar o lançamento financeiro no valor líquido, já descontando as retenções, é necessário:
*Parametrizar a configuração [[GF - GE - 3214 - Diminuir valor das retenções do valor total do boleto]], como '''1 - Sempre''' ou '''2 - Por Empresa''', e
*Se a configuração estiver como '''2 - Por Empresa''', deve-se marcar as empresas desejadas no campo '''Descontar Retenção no Boleto'''.

Para mais informações de como funciona esse recurso, consulte a WIKI [[OS 816297/10 – Retenções P/C/C + Boletos + CNAB e Open Banking]].

Para informações sobre o uso do Controle das Retenções na Saída, consulte [[GF - Como Fazer - Controlar Retenções de PIS-COFINS-CSSL-IRRF-INSS-ISS para Nota Fiscal de Saída]].

= Documentos Relacionados =

* [[GF - Como Fazer - Open Banking|Manual Open Banking - Geral]]
* [[FAQ_GF#Open Banking|FAQs Open Banking]]
* [[Open Banking - Em qual tabela fica gravado o registro do campo "Situação Open Banking" do lançamento financeiro]]
* [[OpenBanking - Como fazer/revisar a instalação, para que o certificado digital, apareça nas configurações de banco em Parâmetros em seguida Status do certificado?]]
* [[Open Banking Itaú - Retorno de títulos acusando erro "Não encontrado"]]
* [[Open Banking - O que é Endpoint, Request e Response?]]
* [[Open Banking Itaú: Orientações referente comunicado do Banco Itaú, sobre alteração de URLs, para evitar interrupções nas cobranças]]


= Documentação Itaú =

* [https://devportal.itau.com.br/baas/#/ Portal Developers Itaú]
* [https://www.itau.com.br/atendimento-itau/para-voce/telefones Atendimento Itaú]


= Versões =
== Versão 231002 ==
<references group="Versão 231002"/>
=== Patch 'a' ===
<references group="Versão 231002.a"/>
== Versão 240506 ==
<references group="Versão 240506"/>
== Versão 251103 ==
<references group="Versão 251103"/>

CIGAM WIKI - Contribuições do usuário [pt-br]

GF - Como Fazer - Open Banking para Banco Itaú