Histórico da Página

01. 

...

Configurações necessárias para o registro de boletos por API do Itaú.

02. HABILITAR SERVIÇO - ITAÚ

Para a utilização da API do Itaú é necessário a ativação do serviço em sua conta. Esse processo deve ser solicitado diretamente ao seu gerente de conta.

...

VISIÓN GENERAL

Configuraciones necesarias para registrar las boletas mediante el API del banco Itaú.

02. HABILITAR SERVICIO - ITAÚ

Para utilizar la API de Itaú es necesario activar el servicio en su cuenta. Este proceso se debe solicitar directamente a su gerente de cuenta.

Para establecer una conexión segura con los API Gateways de Itaú es necesario enviar un client certificate. Este certificado se utiliza para establecer el mTLS (OAuth 2.0 Mutual Transport Layer Security).

...

Más detalles del proceso de generación del certificado se deben obtener en el portal de Itaú : https://devportal.itau.com.br/.

...

El acceso a este también se debe solicitar a su gerente de cuenta.

En este proceso se generarán dos archivos, uno con extensión CRT y el otro KEY que se utilizarán en el proceso de configuración y layout del Nuevo Administrador Financiero.

03.

...

REGISTRO DEL BANCO - MATA070

• Para habilitar a configuração la configuración de um un layout para o Itaú, deve ser informado no se debe informar en el campo Bco Oficial  (A6_BCOOFI) o el código 341.

04.

...

PARÁMETROS DEL BANCO - FINA130

• Código da carteira deve ser informado no de la cartera debe informarse en el campo Cód. Carteira Cartera (EE_CODCART).
• Nosso número deve ser parametrizadonos campos Faixa Inicio Nuestro número se debe parametrizaren los campos rango inicial (EE_FAXINI), Faixa Fim  rango final (EE_FAXFIM) e Faixa atual y rango actual (EE_FAXATU).
• Para utilizar as instruções de cobrança, deve ser preenchido o campo Banco Oficial (EE_CODOFI) com '341'.
• Itaú VERSÃO 1 - Somente será possível enviar instruções de cobrança a partir do preenchimento dos campos na pasta Itaú:
  1. Cod. Cob. 1 (EE_CODCOB1) → Instrução de cobrança para o boleto
  2. Cód. Cob. 2 (EE_CODCOB2) → Instrução de cobrança para o boleto
  3. Cód. Cob. 3 (EE_CODCOB3)→ Instrução de cobrança para o boleto
  4. Dias Protest (EE_ITAUPRT) → Quantidade de dias de protesto do boleto
  5. Dias Devolu. (EE_ITAUDEV) → Quantidade de dias para devolução do Boleto 
  6. Dias Não Rec (EE_ITAUNAO) → Quantidade de dias para não receber Boleto
• Solamente se podrán enviar instrucciones de cobro a partir de la cumplimentación de los siguientes campos: 
  1. Banco Oficial (EE_CODOFI) → No cumplimentar.
  2. Mensaje
  Itaú VERSÃO 2 - Somente será possível enviar instruções de cobrança a partir do preenchimento dos campos abaixo: 
  1. Mensagem 1 (EE_FORMEN1) → Instrução - Instrucción de cobrança cobranza para o boleto la boleta (FormulaFórmula)Mensagem
  2. Mensaje 2 (EE_FORMEN2) → Instrução - Instrucción de cobrança cobranza para o boleto la boleta (FormulaFórmula)
  3. Mens. Extra 1 (EE_FOREXT1) → Instrução - Instrucción de cobrança cobranza para o boleto la boleta (Formula)
  4. Mens. Extra 2 (EE_FOREXT2)→ Não será usado para impressão da instruçãoNo se utilizará para impresión de la instrucción. Itaú permite somente solamente 03 mensagensmensajes
  5. Dias Días Protest (EE_DIASPRT) → Quantidade - Cantidad de dias días de protesto do boletoDias Recebim de la boleta
  6. Días Cobranza (EE_DIASREC) → Quantidade Cantidad de dias para devolução do Boleto días para devolución de la Boleta 

05. LAYOUT - FINA710 -

...

NUEVO ADMINISTRADOR FINANCIERO

Al iniciar la configuración Ao iniciar a configuração de layout para uma nova conta do Itaú serão apresentados os passosuna nueva cuenta de Itaú se presentarán los pasos:

01.

...

Selecione a conta que deseja realizar a configuração

02. Inserção de credenciais

Nesse passo serão inseridas as informações obtidas junto ao banco no processo de habilitar o serviço em sua conta.

Informe nesse passo o ID do cliente e Chave secreta do cliente fornecidos pelo banco.

Informe o nome do Arquivo chave do certificado e Arquivo de certificado convertidos pelo Wizard de conversão de certificado - CFGX060.

03. Configuração de layout

Nesse passo, serão configuradas todas as informações que serão encaminhadas para o banco na transmissão do boleto.

04. Ambiente de homologação

SELECCIÓN DE LA CUENTA

Seleccione la cuenta en que desea realizar la configuración

02. INCLUSIÓN DE CREDENCIALES

En este paso se incluirán las informaciones obtenidas en el banco en el proceso de habilitar el servicio en su cuenta.

Informe en este paso el ID del cliente y Clave secreta del cliente suministrados por el banco.

Informe el nombre del Archivo clave del certificado (KEY) y el Archivo de certificado (CRT).

03. CONFIGURACIÓN DE LAYOUT

En este paso, se configurarán todas las informaciones que se enviarán al banco para la transmisión de la boleta.

04. ENTORNO DE HOMOLOGACIÓN

Cuando estamos en el entorno de homologación, el banco no devuelve las informaciones de línea digitable y Quando em ambiente de homologação, o banco não retorna as informações de linha digitável e código de barras.

06.

...

CONFIGURACIÓN DE LAYOUT

Para a utilizar o el registro online de boletos para o Itaú Versão 2, deve-se observar a seguinte regra:On Line de boletas para el Itaú Versión, se debe observar la siguiente regla:

• Porc interés mensual: En este campo se debe informar el porcentaje mensual de interesesPorc Juros Mensal: Neste campo, deve ser informado o percentual mensal de juros.

     Como padrão, disponibilizamos o estándar, ponemos a disposición el campo E1_PORCJUR já multiplicado por 30, respeitando a seguinte regra: juros diário X 30 dias = juros mensal

Image Removed

respetando la siguiente regla: interés diario X 30 días = interés mensual

Image Added

• Número del documento: En este campo debe informarse cuál será el número del documento que se transmitirá al banco y posteriormente se imprimirá en la boletaNúmero do documento: Neste campo deverá ser informado qual será o número do documento que será transmitido ao banco e posteriormente impresso no boleto.

      Onde poderá Dónde puede ser:

1. 1. Número do Título del título (E1_NUM)
   2. ID CNAB (E1_IDCNAB)
   3. Expressão definida pelo usuárioExpresión definida por el usuario.
      • O resultado da expressão será atribuído ao El resultado de la expresión se atribuirá al campo “Número do del documento”. Para as macros-execuções a expressão a ser executada deverá ser válida. Para informar uma expressão clique na “Engrenagem” que está ao lado do campo.

Image Removed

1. 1. • las macroejecuciones la expresión que se ejecutará debe ser válida. Para informar una expresión, haga clic en el “Engranaje” que está al lado del campo.

Image Added

Image Added

• BoleCode (Boleta + Pix): Este campo indica si la boleta tendrá opción de pago vía QR Code (Pix). El QR Code se imprime en la boleta y es posible que el cliente efectúe el pago por el QRCode o por el Código de barras.
  
  • Sí - La boleta se registrará con el PIX, en la impresión aparecerá el QR Code PIX para cobranza del valor.
  • No - La Boleta se registrará sin el PIX, en la impresión no aparecerá el QR Code PIX.
    
    • Para activar esta funcionalidad es necesario entrar en contacto con el banco Itaú. El banco Itaú pondrá a disposición un nuevo certificado y nuevas credenciales que deben informarse en 'Configurar BoleCode'Image Added
                                                                                                                                                                                                          Image Added

• Aceptación: Este campo indica el reconocimiento formal de la deuda (firma en el documento) por el pagador, deben informarse los valores:
  • Sí - Cuando existe la necesidad de que el pagador reconozca/acepte la cobranza.
  • No - Cuando no existe la necesidad de reconocimiento de la cobranza.

Image Added

• Beneficiario sucursal: En este campo debe informarse la sucursal que se utilizará para la transmisión e impresión de la boleta. 

Image Added

Los datos registrados en esta sucursal se utilizarán en la transmisión y en la impresión:

Image Added

• Descuento:En este campo podrá informarse o no un valor de descuento para la boleta.  

       Donde puede ser:

1. 1. Vacío -Si el valor original estuviera calculado con la deducción de los valores de descuento o no exista descuento para la boleta.
   2. Valor descuento (SomaAbat()) - Cálculo estándar del sistema de acuerdo con la expresión: "SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)" .
   3. Expresión definida por el usuario.
      • El resultado de la expresión se atribuirá al campo “Descuento”. Para las macroejecuciones la expresión que se ejecutará debe ser válida. Para informar una expresión, haga clic en el “Engranaje” que está al lado del campo.

Image Added

Es posible informar el valor original deduciendo el valor del descuento. Basta hacer clic en el engranaje en el campo "Valor original" e informar una expresión válida:

Ejemplo:

• • "SE1->E1_SALDO - SomaAbat(SE1->E1_PREFIXO,SE1->E1_NUM,SE1->E1_PARCELA,"R",SE1->E1_MOEDA,dDataBase,SE1->E1_CLIENTE,SE1->E1_LOJA)"

Image Added

07. PAGO CON VALORES DIVERGENTES

El Protheus no envía la información si la boleta podrá o no pagarse con valores divergentes, pues esta configuración se efectúa en la propia cuenta en el Banco Itaú. Es decir, el cliente que recibe la boleta podrá o no pagar con valores divergentes de acuerdo con la configuración de la cuenta que emitió la boleta, no habiendo ninguna configuración para eso en el Protheus. Por lo tanto pedimos que entre en contacto con su gerente de cuentas y verifique si su cuenta está configurada de acordo con la necesidad.

08. CONFIGURACIÓN DE BOLETA

Permite que el usuario configure cómo será la impresión de la boleta.

• Imprime descuento
  • Como mensaje - El valor del descuento se imprimirá en los mensajes de la boleta
  • Campo descuento - El valor del descuento en el título se imprimirá en (-) Descuento de la boleta

Image Added

09. WEBHOOK - BAJA TÍTULOS DEVOLUCIÓN

Webhookes un servicio donde el banco envía informaciones de bajas de boletas para el ERP Protheus.

La comunicación del Itaú para el Protheus ocurre vía autenticación de certificados mTLS. Para más detalles, acceda a la documentación Portal Dev Itaú de cada Webhook a continuación.

Es necesario un servicio REST habilitado en el Protheus. El REST debe estar habilitado con SSL utilizando un certificado A1 (Ejemplo de configuración).

El banco Itaú pone a disposición dos servicios de Webhook:

• Webhook Boleta
  • Notificación de boletas pagadas vía código de barras.
  • URL → ejemplo: https://seuip:suaporta/api/fin/v1/itau/bol/receivables/
  • Registro de la URL debe realizarse en la Configuración de cuentas deseada en el NGF, opción Baja títulos (Devolución).
  • Condiciones previas:
    • Solicitar al banco Itaú acceso a la API Webhook Boleta.
  • Para más detalles, acceda a la documentación que está disponible en el Portal Dev Itaú - Boleta.
• Webhook Pix
  • Notificación de boletas pagadas vía QR Code.
  • URL → ejemplo: https://seuip:suaporta/api/fin/v1/itau/pix/receivables/pix
  • Registro de la URL debe realizarse en la Configuración de cuentas deseado en el NGF, opción Configurar Bolecode.
  • Condiciones previas:
    • Clave Pix principal registrada en: Banco(MATA070) → Otras acciones → Claves PIX
    • Habilitar el campo BoleCode (Boleta + Pix)= Sí en el Layout de la configuración de cuentas.
    • Solicitar al banco Itaú la activación de la funcionalidad Bolecode/Pix. El Itaú debe poner a disposición un nuevo certificado con un nuevo Id Cliente y clave que deben informarse en la opción Configurar Bolecode.
    • Solicitar al banco Itaú el acceso a la API Webhook Pix.
  • Para más detalles, acceda a la documentación que está disponible en el Portal Dev Itaú - Pix.

El registro de la URL junto con el banco Itaú se realiza por medio del Protheus. Al informar las URL de Webhook en la configuración de la cuenta, al activar la opción grabar las modificaciones, el Protheus se comunica con la API del banco Itaú para el registro de la URL informada junto al Itaú. Si ocurriera algún error, se mostrará en pantalla y no se grabarán las modificaciones. Asegúrese de que todas las condiciones previas se atenderán y que el acceso se pondrá a disposicón por el banco Itaú para utilizar las API de Webhook. Al dejar el campo de la URL en blanco, el Protheus retira el registro de la URL en el banco Itaú.Image Removed