...
...
Informações |
---|
|
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 liberada 2 (V2), con certificado. |
03. REGISTRO DEL BANCO - MATA070
...
- Código de la cartera debe informarse en el campo Cód. Cartera (EE_CODCART).
- Nuestro número se debe parametrizaren los campos rango inicial (EE_FAXINI), rango final (EE_FAXFIM) y rango actual (EE_FAXATU).
- Para utilizar las instrucciones de cobro, se debe informar el campo Banco Oficial (EE_CODOFI) con '341'.
- Itaú VERSÃO 1 - Solamente se podrán enviar instrucciones de cobro a partir de la cumplimentación de los campos en la carpeta Itaú:siguientes campos:
- Banco Oficial
- Cód. Cob. 1 (EE_CODCOB1) → Instrucción de cobro para la boleta
- Cód. Cob. 2 (EE_CODCOB2) → Instrucción de cobro para la boleta
- Cód. Cob. 3 (EE_CODCOB3)→ Instrucción de cobro para la boleta
- Días Protest (EE_ITAUPRT) - Cantidad de días de protesto de la boleta
- Días Devolu. (EE_ITAUDEV)- Cantidad de días para devolver la boleta
- Días No Rec (EE_ITAUNAO) → Cantidad de días para no recibir boleta
Itaú VERSÃO 2 - Solamente se podrán enviar instrucciones de cobro a partir de la cumplimentación de los siguientes campos: - CODOFI) → No cumplimentar.
- Mensaje 1 (EE_FORMEN1) - Instrucción de cobro cobranza para la boleta (Fórmula)
- Mensaje 2 (EE_FORMEN2) - Instrucción de cobro cobranza para la boleta (Fórmula)
- Mens. Extra 1 (EE_FOREXT1) - Instrucción de cobro cobranza para la boleta (Formula)
- Mens. Extra 2 (EE_FOREXT2)→ No se utilizará para impresión de la instrucción. Itaú permite solamente 03 mensajes
- Días Protest (EE_DIASPRT) - Cantidad de días de protesto de la boleta
- Días Cobranza (EE_DIASREC) → Cantidad de días para devolución de la Boleta
Aviso |
---|
|
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. |
05. LAYOUT - FINA710 - NUEVO ADMINISTRADOR FINANCIERO
Al iniciar la configuración de layout para una nueva cuenta de Itaú se presentarán los pasos:
01.
...
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 convertidos por el Wizard de conversión de certificado - CFGX060certificado (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 código de barras.
...
Para utilizar el registro 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 intereses.
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
Image Removed
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 boleta.
Donde Dónde puede ser:
- Número del Título título (E1_NUM)
- ID CNAB (E1_IDCNAB)
- Expresión definida por el usuario.
- El resultado de la expresión se atribuirá al campo “Número del documento”. 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 Modified
Image Modified
Aviso |
---|
|
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. |
- 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.
![](/download/attachments/736979110/image2023-2-8_11-30-53.png?version=1&modificationDate=1676464708103&api=v2&effects=drop-shadow)
- Beneficiario sucursal: En este campo debe informarse la sucursal que se utilizará para la transmisión e impresión de la boleta.
...
Aviso |
---|
|
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. |
- Descuento:En este campo podrá informarse o no un valor de descuento para la boleta.
Donde puede ser:
- Vacío -Si el valor original estuviera calculado con la deducción de los valores de descuento o no exista descuento para la boleta.
- 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)" .
- 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
Aviso |
---|
|
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. |
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
Aviso |
---|
|
- No es posible utilizar las opciones "Como mensaje" y "Campo descuento" en conjunto.
- Después de la transmisión de la boleta las modificaciones realizadas en el campo Imprime descuento no se aplicarán a las boletas ya transmitidas. Las modificaciones solamente se aplicarán a las boletas transmitidas después de la modificación.
|
09. WEBHOOK - BAJA TÍTULOS DEVOLUCIÓN
Aviso |
---|
|
Importante - Webhook para el banco Itaú esta en proceso de piloto, de esta manera, aún NO está liberado para uso.
|
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ú.