Configuraciones necesarias para registrar las boletas mediante el API del banco Itaú.
Red interna
Para la comunicación del Protheus con el banco es necesario configurar la seguridad de red, si fuera necesario aceptar la salida del rango de IP referente al DNS:
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.
Versiones
Si el entorno está utilizando la primera versión 1 de la API (V1) liberada en el NGF, que no utiliza certificado, usted puede editar su layout y así actualizar a una nueva versión, después de realizar los puntos anteriores.
Nuevas configuraciones de cuentas se realizarán solo para la nueva versión 2 (V2), con certificado.
Importante
Es necesario el registro correcto del dígito verificador de la cuenta en el campo Dv Cuenta (A6_DVCTA).
Si el registro estuviera incorrecto en la tabla de bancos (SA6), el ajuste debe realizarse en su subcuenta en el Registro Parámetros de bancos (tabla SEE) en los campos Age. Oficial (EE_AGEOFI), Cta. Oficial (EE_CTAOFI) y DV Cta.Ofic. (EE_DVCTOFI).
Ejemplo de cuenta que debe adecuarse: Cuenta 12345-6
En el registro del banco, campo Nº Cuenta (A6_NUMCOM) = 123456 y DV Cuenta (A6_DVCTA) = vacío, el ajuste en su subcuenta debe ser Cta. Oficial (EE_CTAOFI) = 12345 y DV Cta.Ofic. (EE_DVCTOFI) = 6
ATENCIÓN
Para funcionamiento de la comunicación bancaria por API del Itaú el usuario debe configurar los parámetros del banco.
Los campos de la fórmula EE_FORXXX deben tener expresiones ADVPL válidas para evitar posibles inconformidades o interrupciones inesperadas en el proceso.
Al iniciar la configuración de layout para una nueva cuenta de Itaú se presentarán los pasos:
Seleccione la cuenta en que desea realizar la configuración
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).
En este paso, se configurarán todas las informaciones que se enviarán al banco para la transmisión de la boleta.
Cuando estamos en el entorno de homologación, el banco no devuelve las informaciones de línea digitable y código de barras.
Para utilizar el registro On Line de boletas para el Itaú Versión, se debe observar la siguiente regla:
Como estándar, ponemos a disposición el campo E1_PORCJUR multiplicado por 30, respetando la siguiente regla: interés diario X 30 días = interés mensual
Dónde puede ser:
Importante
La funcionalidad de la boleta híbrida (BoleCode) está en proceso de piloto, de esta manera, aún NO esta liberada para su utilización.
Los datos registrados en esta sucursal se utilizarán en la transmisión y en la impresión:
Atención
Si este campo no estuviera informado, la Sucursal actual (Sucursal conectada o Sucursal configurada en la agenda) se utilizará en los datos de la transmisión e impresión de la boleta.
Donde puede ser:
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:
Importante
Si el valor original estuviera calculado con la deducción de los valores de descuento, el campo "Descuento" no debe completarse para que no ocurra una duplicidad en el valor de descuento.
Si se completara el campo "Descuento" el campo "Valor original" debe contener el valor completo (Sin la deducción del descuento). Si existiera descuento se mostrará un mensaje en el cuerpo de la boleta informando el valor del descuento ya calculado.
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.
Permite que el usuario configure cómo será la impresión de la boleta.
Importante
Importante
Importante
Webhook es 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:
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ú.