Guía de Configuración: Exportador de Pagos a Interbanking (Transferencias)
Esta guía detalla los pasos para integrar Finnegans con el servicio de APIs de Interbanking, permitiendo exportar lotes de pagos con transferencias de forma directa y automática.
Glosario de términos
-
API: Interfaz que permite que dos sistemas (Finnegans e Interbanking) se comuniquen entre sí.
-
Bproc: Botón de acción que gestiona la exportación en el sistema.
-
DEALS: Herramienta de Finnegans para el intercambio electrónico de documentos.
-
Lote: Conjunto de órdenes de pago agrupadas para ser enviadas al banco en una sola operación.
Checklist de requisitos previos
Antes de comenzar, asegúrese de contar con:
-
Usuario Administrador en Interbanking.
-
Credenciales de Aplicación (Client ID y Client Secret) obtenidas en el portal de Interbanking.
-
Permisos de configuración en Finnegans (acceso a maestros y parámetros de sistema).
Fase 1: Configuración en el Portal de Interbanking
Este paso es fundamental para obtener los datos que luego cargaremos en Finnegans.
1.1. Creación de la Aplicación
-
Siga el instructivo “1. InterAPIS V1_6” de Interbanking para registrar una nueva aplicación.
-
Al finalizar, el portal mostrará dos valores críticos: Clave (Client ID) y Secreto (Client Secret).
IMPORTANTE:
Guarde ambos datos en un lugar seguro. El “Secreto” no se puede recuperar; si lo pierde, deberá dar de baja la aplicación y crear una nueva.
1.2. Alta de Operador de API
-
Inicie sesión en Interbanking y diríjase a Administración > Colaboradores (u Operadores).
-
Presione el botón Crear Nueva.
-
En “Tipo”, seleccione Operador de API y presione Continuar.
-
Complete los datos requeridos (descripción, usuario y clave). Anote estos datos, ya que el sistema le asignará un número de operador que necesitará más adelante.
-
Punto clave: En la sección de cuentas, asegúrese de agregar y autorizar todas las cuentas bancarias con las que operará. Las cuentas bancarias ademas de estar habilitadas y con el check de transferencias en el operador deben estar configuradas en usos de la cuenta, como tipo de transferencias Proveedores, tal como se visualiza en la imagen.
Fuente: Instructivo interbanking Api
Fase 2: Configuración en Finnegans
2.1. Códigos Bancarios y activación de BPROC
-
Ingrese al maestro de Códigos Bancarios.
-
Verifique si ya existen los códigos para sus bancos. Si no, presione Nuevo y créelos, asegurándose de que el nombre y banco coincidan exactamente con su entidad financiera.
-
Activación de bproc
Activar el botón que permite exportar pagos de Finnegans directo a Interbanking.
2.2. Maestro de Proveedores y CBU
-
Verifique que sus proveedores tengan sus CBU correctamente cargados en el maestro.
-
Nota: El sistema prioriza el CBU de la orden de pago; si falta, usará el CBU por defecto del proveedor. Si no encuentra ninguno, Finnegans emitirá una alerta y no podrá exportar.
2.3. Configuración de DEALS
Debe configurar dos registros en la sección de DEALS:
A. Método de Publicación (Activación)
-
Vaya a Deals - Publicaciones Propias > Nuevo.
-
En Documento, seleccione: PagoAProveedoresInterbanking.
-
En Método de publicación, elija: PagoAProveedoresInterbankingPub.
B. Método de Descarga (Parámetros de Conexión)
-
Cree un nuevo registro de descarga para el documento PagoAProveedoresInterbanking con el método PagoAProveedoresInterbankingDesc.
-
En la pestaña Parámetros Públicos, complete la información según la siguiente tabla:
PARÁMETROS Valor / Instrucción Explicación USERNAME -3 NúmeroOperadorUsuarioAPI PASSWORD Su contraseña de API La clave que definió para el operador de API. CLIENT_ID Su Clave de Aplicación El identificador obtenido en la Fase 1.1. URL https://api-gw.interbanking.com.ar/api/prod/v1 Enlace fijo de conexión con Interbanking. RESEND_VALIDATED true o false True/vacio:Procesa lo válido y avisa errores. false: Frena todo si hay un error. CONSOLIDATED_CHECK true o false Si elige true o vacio, el lote aparecerá como un solo movimiento total en su extracto. UNIFIED_SEND true o false true/vacio: Lote se autoriza y envíe completo, sin posibilidad de hacerlo parcialmente EMAIL_NOTIFICACIONES Su correo electrónico Dirección donde recibirá el resultado de cada envío. INTERBANKING_AUTH_URL https://auth.interbanking.com.ar/cas/oidc/accessToken Enlace fijo de conexión con Interbanking.
Estos parámetros públicos incluyen parámetros propios de interbanking y parámetros de configuración de aplicación a definir por el usuario.
Es importante para poder completar los parámetros siguientes leer el siguiente Instructivo brindado por interbanking. Estos parámetros consisten en:
USERNAME: es el usuario de api transaccional del usuario. El parámetro Username se forma uniendo el numero -3 fijo mas número de operador api que se creo siguiendo el anterior instructivo de interbanking mencionado mas el usuario de acceso a interbanking. En resumen el username debe quedar formado de la siguiente forma:
-3| Número Operador |usuarioapi
Ante dudas sobre la formación del username verificar instructivo interbanking.
PASSWORD: contraseña de operador api.
CLIENT_ID: id de cliente de la aplicación creada en primera instancia. Verificar instructivo interbanking adjunto. (Paso 1)
URL: esta url identifica al usuario en interbanking.
Es un dato fijo que se completa con el siguiente link: https://api-gw.interbanking.com.ar/api/prod/v1
RESEND_VALIDATED: Define cómo se procesan las transferencias:
-Si se envía en true o vacio: el sistema procesa las transferencias válidas e informa los errores sin procesarlos.
-Si se envía en false: no se procesa ninguna transferencia si hay errores, y se informa cuál fue el problema.
CONSOLIDATED_CHECK (consolidado en extracto):
-Si se envia en true o vacio : Indica al banco que el lote de TEFs debe aparecer en el extracto como un único movimiento por el total. Es una decisión del cliente (en el front de Interbanking es un checkbox).
-Si se envía en true, también debe enviarse unified_send en true.
UNIFIED_SEND (envío unificado): Obliga a que el lote se autorice y envíe completo, sin posibilidad de hacerlo parcialmente.
EMAIL_NOTIFICACIONES: Email donde necesitan que lleguen las notificaciones del resultado del proceso.
INTERBANKING_AUTH_URL: Este parámetro** es un dato fijo** que se completa para todos los usuarios con la siguiente url: https://auth.interbanking.com.ar/cas/oidc/accessToken
Fase 3: Ejecución y Exportación (Uso diario)
Una vez configurado, el proceso operativo es sencillo:
-
Acceda a la Grilla Exportador de pagos.
-
Complete los filtros (Fecha, Banco, Cuenta y Grupo de Código Bancario) y presione Aceptar.
-
Seleccione las órdenes de pago que desea enviar.
-
Presione el botón Interbanking > Asignar Lote y Exportar Pago.
-
El sistema confirmará con el mensaje: {“success”: true, “message”: “Lote enviado…”}.
-
Recibirá un email con el detalle del lote procesado por el banco.
Resolución de Problemas Comunes
Errores de autenticación/token: Verifique que el USERNAME tenga el formato correcto y la password sea la correcta. También verificar autorizaciones del administrador de cualquier cambio de dato que se realice en el operador.
El lote no aparece en Interbanking: Asegúrese de que las cuentas bancarias estén autorizadas específicamente para el Operador de API dentro de la administración de Interbanking (ademas de estar habilitadas cuando se utiliza usuario administrador es necesaria una segunda autorización). Ademas las cuentas deben estar habilitadas con tipo de uso transferencias-proveedores, como mencionamos anteriormente.