← Índice de manuales
Manual funcional · Sistema Plenario v14

Configuración API Banco Itaú

El Banco Itaú expone servicios web (API REST y SOAP) que Plenario utiliza para dos operaciones principales:

Módulo: HerramientasVersión: 1.0Actualizado: 2026-06-23

Configuración API Banco Itaú

Detalle

Manual de Usuario Configuración API Banco Itaú - Herramientas

Introducción

El Banco Itaú expone servicios web (API REST y SOAP) que Plenario utiliza para dos operaciones principales:

  • Consulta de CBU/CVU: validar y obtener los datos de una cuenta a partir de su CBU o CVU antes de realizar una acreditación.
  • Transferencia de archivos de pago: enviar al banco el archivo de pagos a terceros (acreditaciones a beneficiarios) generado a partir de las solicitudes de crédito/préstamos.

Estos servicios requieren autenticación mediante certificado digital cliente (un archivo .pfx) con su contraseña (passphrase), más la URL base del servicio. Esta pantalla de Setup de Itaú es donde se cargan esas credenciales y la dirección del servicio, y donde se activa o desactiva la integración.

Importante: es una pantalla de configuración con credenciales sensibles. El certificado .pfx y su contraseña son datos confidenciales: no compartirlos ni exponerlos. Solo deben cargarlos personas autorizadas, con el material que provee el banco.

Acceso al módulo

Menú principal → Herramientas → Configuraciones → Más → API Banco Itau

El botón API Banco Itau se encuentra dentro del submenú Más del grupo de configuraciones de Herramientas. Al presionarlo se abre la ventana Setup de Itau.

Pantalla principal

La ventana es un formulario de configuración de credenciales. Al abrirse, el sistema busca la configuración ya guardada (registro único) y muestra los valores actuales. En el campo del certificado, en lugar del archivo, indica si ya hay un certificado cargado:

  • Si hay certificado guardado, muestra en verde "Certificado Cargado Correctamente".
  • Si no hay certificado, muestra en rojo "No se cargo ningun archivo".
Campo Descripción
URL Consulta URL base (raíz) del servicio de Itaú contra el cual se realizan las consultas y los envíos. Es obligatoria.
Certificado PFX Archivo .pfx con el certificado digital cliente que autentica a la empresa frente a Itaú. Se carga con el botón Cargar. Este campo es de solo lectura: muestra el estado del certificado, no se escribe a mano.
Contraseña Passphrase del certificado .pfx. Necesaria para que el sistema pueda usar el certificado al firmar las solicitudes.
Activo Habilita la integración. Si no está tildado, el sistema no ejecuta consultas ni envíos a Itaú y devuelve un aviso de configuración inactiva.
Modo Test Activo Indica que la operación se ejecuta en modo de prueba. En las transferencias de archivos, el modo test no envía realmente el archivo al banco: simula una respuesta exitosa para validar el circuito sin impactar en producción.

Parámetros

Parámetro Obligatorio Detalle
URL Consulta (ApiRoot) Sí No se puede guardar sin una URL.
Certificado PFX Sí (en el alta inicial) En la primera configuración es obligatorio seleccionar un .pfx. En modificaciones posteriores, si no se elige uno nuevo, se conserva el ya cargado.
Contraseña Recomendada Passphrase del certificado.
Activo — Casilla. Debe estar tildada para que la integración opere.
Modo Test Activo — Casilla. Tildar solo para pruebas.

Resultados

Al guardar correctamente, el sistema cierra la ventana. Si falta la URL o, en el alta inicial, falta el certificado, muestra un mensaje de error y no guarda:

  • "Debe especificar una URL valida"
  • "Debe especificar una ruta para el certificado PFX valida"

Una vez configurada y Activo tildado, la integración queda lista para que los procesos del sistema (consulta de CBU/CVU y transferencia de archivos de pago) operen contra Itaú.

Importante: si la integración está inactiva, cualquier intento de consulta o envío devuelve un aviso indicando que los datos de configuración de Itaú están inactivos y que deben activarse en el setup.

Acciones disponibles

Acción Descripción
Cargar Abre un cuadro de diálogo para seleccionar el archivo de certificado .pfx desde el disco. Filtra solo archivos *.pfx.
Aceptar Valida y guarda la configuración. Si se seleccionó un nuevo certificado, lo lee del disco y lo almacena.
Cancelar / Cerrar Cierra la ventana sin guardar cambios.

Pasos para configurar la API de Itaú:

  1. Abrir la pantalla — desde Herramientas → Configuraciones → Más → API Banco Itau.
  2. Cargar la URL — escribir en URL Consulta la dirección base del servicio que provee el banco.
  3. Seleccionar el certificado — presionar Cargar y elegir el archivo .pfx entregado por Itaú. El estado pasa a "Certificado Cargado Correctamente".
  4. Cargar la contraseña — escribir la passphrase del certificado en Contraseña.
  5. Activar — tildar Activo para habilitar la integración. Dejar Modo Test Activo destildado para operar en producción.
  6. Guardar — presionar Aceptar.

Ejemplo práctico

Una empresa que paga a sus beneficiarios mediante acreditación bancaria configura la API de Itaú:

  1. Ingresa a Herramientas → Configuraciones → Más → API Banco Itau.
  2. En URL Consulta carga la URL base del servicio Itaú.
  3. Presiona Cargar, selecciona el archivo .pfx provisto por el banco y verifica que aparezca "Certificado Cargado Correctamente".
  4. Escribe la Contraseña del certificado.
  5. Tilda Activo y deja Modo Test Activo destildado.
  6. Presiona Aceptar.

A partir de ese momento, los procesos de consulta de CBU/CVU y de transferencia de archivos de pago pueden operar contra Itaú con esas credenciales.

Consejos útiles

  • Antes de pasar a producción, conviene probar con Modo Test Activo tildado: las transferencias de archivos simulan una respuesta exitosa sin enviar realmente al banco, lo que permite validar el circuito.
  • El certificado .pfx y su contraseña son confidenciales. Guardarlos en un lugar seguro y cargarlos solo desde la pantalla de setup.
  • Si en una modificación no se vuelve a cargar el certificado, se conserva el que ya estaba guardado; solo hay que volver a cargarlo si cambió.
  • Los certificados digitales tienen vencimiento: si las consultas empiezan a fallar, verificar que el .pfx siga vigente y volver a cargarlo con el nuevo si el banco lo renovó.
  • Recordar tildar Activo: con la integración inactiva el sistema no ejecuta ninguna operación contra Itaú.

Preguntas frecuentes

¿Por qué el sistema dice que la configuración de Itaú está inactiva? Porque la casilla **Activo** no está tildada. Mientras esté destildada, el sistema no ejecuta consultas ni envíos a Itaú y devuelve ese aviso. Hay que entrar al setup, tildar **Activo** y guardar.
¿Qué hace el Modo Test Activo? Marca la operación como de prueba. En la transferencia de archivos de pago, el modo test no envía el archivo real al banco: devuelve una respuesta simulada de "archivo transferido con éxito" para validar el circuito sin impactar en producción.
El campo del certificado no me deja escribir, ¿está bien? Sí. El campo **Certificado PFX** es de solo lectura: solo muestra el estado ("Certificado Cargado Correctamente" o "No se cargo ningun archivo"). El archivo se selecciona con el botón **Cargar**.
Si modifico la configuración y no cargo de nuevo el certificado, ¿lo pierdo? No. Si no se selecciona un nuevo `.pfx`, se conserva el certificado que ya estaba guardado. Solo hace falta volver a cargarlo cuando el certificado cambió.
¿Para qué se usa esta integración? Para dos cosas: consultar/validar CBU o CVU contra Itaú, y enviar al banco el archivo de pagos a terceros (acreditaciones a beneficiarios) generado desde las solicitudes de préstamos.

Permisos

El acceso a esta pantalla se realiza desde el botón API Banco Itau del menú de Herramientas. En el código actual, el botón no aplica un control de permiso por objeto (IsAllowedObject) al abrir la ventana: la única línea de verificación de permiso que existía en el handler está comentada. Por lo tanto, cualquier usuario con el menú de configuraciones de Herramientas visible puede acceder. El control de acceso depende, en la práctica, de la visibilidad del menú según el perfil del usuario.

Permiso Descripción
(sin permiso de objeto específico) El botón de menú no verifica un permiso IsAllowedObject al abrir el formulario (la verificación quedó comentada en el código). El acceso se controla por la visibilidad del menú de Herramientas.

Información técnica

Sección de referencia para soporte/desarrollo. Basada en el análisis del formulario real de la v14 (FormItauApiAccount.cs, Itau_Setup_Manager.cs, Itau_Setup.cs). Existen dos clases Itau_Setup_Manager en el repositorio (una en Externos, otra en ServiciosExternos, esta última con logging y SOAP de transferencia de archivos); verificar cuál usa el binario instalado.

Formularios principales

Form Rol
FormItauApiAccount Pantalla de configuración (hereda de FrmAddMod); campos txtApiRoot, txtpfx (solo lectura, estado del certificado), txtpass, casillas CheckActivo y ck_modotest, botón simpleButton1 ("Cargar").
frmNewMain Pantalla principal; el botón BarButtonItem40 (Caption "API Banco Itau", submenú "Más") instancia y abre el formulario con ShowDialog().
Itau_Setup_Manager Capa de negocio/datos (EF, hereda de Base_Manager); Save() valida URL y certificado y persiste el .pfx como byte[]. Métodos ConsultarCBUAsync (REST) y TransferenciaFicheros_Itau_ByIdSolicitudAsync (SOAP).

Permisos reales

Permiso Acción
(ninguno activo) El handler que abre el formulario tiene la verificación de permiso comentada; no se ejecuta ningún IsAllowedObject ni KeyLicences.

Tablas de base de datos principales

Tabla Uso
Itau_Setup Configuración única: Id, ApiRoot (URL), Certificado (byte[] del .pfx), Passphrase (contraseña), Activo, Testing. El campo FileNameCertificado es [NotMapped] (solo ruta temporal en memoria).
Itau_Log Registro de las consultas/envíos a Itaú (request, response, status, número de envío, CUIT, solicitud asociada). Se escribe desde la variante del manager con logging.

Relación con otros módulos / manuales

Manual relacionado Vínculo operativo
Configuración SETUP (NOSIS/VERAZ/AFIP/SMS) - Herramientas Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad.

Notas para soporte

  • El certificado se guarda en base de datos como arreglo de bytes (Certificado); el archivo del disco solo se usa al momento de cargar y luego se lee a byte[].
  • El modo test (Testing) cortocircuita el envío SOAP real de archivos y devuelve un XML de respuesta exitosa simulada.
  • En el envío de archivos de pago hay valores hardcodeados (CUIT 30713754109, producto 700, convenio 000002) en la variante de manager con SOAP: verificar contra el binario instalado si el cliente opera con otra empresa/convenio.
  • No hay control de permiso por objeto (verificación comentada): validar el acceso por la visibilidad del menú según perfil. Verificar contra el binario instalado.
¿Te resultó útil este manual?