Integración bancaria con Salt Edge

Javapackage: com.etendoerp.psd2.bank.integration

Javapackage: com.etendoerp.psd2.bank.integration.template

Antes de comenzar

Este módulo requiere que el Financial Extensions Bundle esté instalado en su entorno de Etendo. Si no está seguro de si está instalado, contacte con su administrador de sistemas antes de continuar. Para instrucciones de instalación, visite el marketplace: Financial Extensions Bundle. Para conocer las versiones disponibles y la compatibilidad con el core, visite Financial Extensions - Release notes.

Visión general

Esta página explica cómo conectar cuentas bancarias a Etendo para que las transacciones se importen automáticamente y los pagos salientes puedan iniciarse directamente desde el sistema. Está dirigida al personal de finanzas y contabilidad que realiza conciliaciones bancarias y ejecuciones de pagos a proveedores, y a los administradores que realizan la configuración inicial.

El módulo ofrece dos capacidades principales, ambas impulsadas por Salt Edge, una plataforma de Open Banking que actúa como intermediario seguro entre Etendo y las entidades bancarias, conforme a la directiva PSD2.

AIS (Account Information Service): conecte de forma segura las cuentas bancarias y descargue automáticamente las transacciones para su conciliación.

flowchart LR
    A([Conectar cuenta bancaria]) --> B[Otorgar permisos]
    B --> C[Descargar transacciones]
    C --> D([Extracto listo<br/>para conciliación ✅])

- PIS (Payment Initiation Service): inicie pagos a proveedores directamente desde Etendo, con la autorización gestionada a través del banco.

flowchart LR
    A([Crear Pago]) --> B[Generar pago bancario]
    B --> C[Autorizar en el portal del banco]
    C --> D[Verificar estado del pago]
    D --> E([Pago ejecutado ✅])

La importación de transacciones (AIS) funciona para cuentas de tipo Banco y Tarjeta; la iniciación de pagos bancarios (PIS) solo está disponible para cuentas de tipo Banco.

	AIS	PIS
	Importación automatizada de transacciones	Iniciación directa de pagos
	Varios bancos simultáneamente	Plantillas SEPA, FPS y DOMESTIC
	Las credenciales bancarias nunca se almacenan en Etendo	La autorización la gestiona el banco

Requisitos previos

Confirme lo siguiente antes de utilizar la funcionalidad de Integración bancaria:

Configuración del servidor: su administrador de sistemas ha configurado la URL de la aplicación context.url en el servidor de Etendo y ha ejecutado el proceso de configuración. El valor de context.url no debe incluir el context path: por ejemplo, context.url=http://localhost:8080 en un entorno local, o directamente la URL productiva del entorno. Contacte con su equipo de IT o con el partner de implementación para confirmar que esto se ha realizado.
Clave de API de Salt Edge: su organización necesita una Clave de API (solicítela al Soporte de Etendo). Un administrador la introduce una única vez, a nivel de Entidad (consulte Configuración, paso 1).
Cuentas financieras: las cuentas financieras que se vincularán a sus cuentas bancarias existen en Etendo.

Configuración

1. Configurar la clave de API de Salt Edge

Aplicación > Configuración General > Entidad > Entidad

Como Administrador:

Abra la ventana Entidad y seleccione su Entidad.
En el grupo de campos Integración bancaria, introduzca la Clave de API proporcionada por el servicio de soporte.

Info

La clave de API se configura una vez por Entidad y la comparten todos los usuarios de esa Entidad, incluidos los procesos planificados.

Visibilidad de botones y campos

Los botones y campos de Integración bancaria permanecen ocultos hasta que la Entidad tiene una clave de API. Si no ve Conectar cuenta o Generar pago bancario, revise la ventana Entidad. Generar pago bancario requiere además una Cuenta Financiera de tipo Banco (consulte Configuración requerida).

2. Sincronizar proveedores bancarios

Gestión Financiera > Gestión de Cobros y Pagos > Configuración > Integración bancaria > Sincronizar proveedores bancarios

Ejecute este proceso una vez durante la configuración inicial y de nuevo cada vez que falte un banco en la lista.

Info

Este paso es necesario antes de asignar un Proveedor bancario a una cuenta financiera o de iniciar pagos.

Mostrar bancos de prueba (solo entornos de pruebas)

De forma predeterminada, los proveedores de sandbox (falsos) están ocultos en la lista de bancos. Para mostrarlos, abra la ventana Preferencia ( Aplicación > Configuración General > Aplicación > Preferencias) y establezca la propiedad Mostrar proveedores falsos en Y. Está definida por defecto a nivel de Sistema (Organización *) con el valor N. Utilícela solo en entornos de pruebas.

3. Configurar cuentas financieras

Gestión Financiera > Gestión de Cobros y Pagos > Transacciones > Cuenta Financiera

El módulo admite cuentas financieras de tipo Banco y Tarjeta. Los campos que se describen a continuación se aplican por igual a ambos tipos.

Para cada cuenta financiera que desee sincronizar con un banco, ábrala y complete los siguientes campos en el grupo de campos Integración bancaria de la cabecera de la Cuenta Financiera:

Proveedor bancario: el banco asociado a esta cuenta. Si está configurado, el paso de selección de banco se omite al conectar (AIS) o al iniciar pagos (PIS). Déjelo vacío para seleccionar el banco manualmente cada vez; una vez que conecte con éxito, el sistema completa automáticamente este campo con el banco al que se conectó. La lista de proveedores debe sincronizarse primero; consulte el Paso 2.
Fecha de importación desde: fecha de inicio para importar transacciones. Si se deja vacía, el sistema utiliza la fecha del último extracto bancario importado. Establezca esta fecha solo para la importación inicial (p. ej., inicio del ejercicio fiscal); déjela vacía después para que las importaciones continúen automáticamente desde donde se detuvieron.
Fecha de importación hasta: fecha de fin para importar transacciones. Si se deja vacía, el sistema utiliza la fecha actual. Déjela vacía en la operación habitual. Déjela también vacía para que el proceso automático Obtener extractos bancarios incluya esta cuenta; si se establece una fecha, el proceso omite esa cuenta en cada ejecución programada.
Agrupación de extractos: controla cómo se agrupan las transacciones importadas en extractos bancarios:
- Dentro de un día (por defecto): agrupa las transacciones del mismo día en un único extracto.
- Nuevo extracto en cada ejecución: crea un nuevo extracto en cada importación.
- Dentro de 7 días: agrupa las transacciones en un único extracto por semana; reabre el extracto si ya había sido procesado.
- Dentro de 30 días: agrupa las transacciones en un único extracto por mes; reabre el extracto si ya había sido procesado.
Use una agrupación más amplia cuando importe con frecuencia para reducir el número total de extractos. - Identificador de la cuenta Salt Edge: solo lectura. Etendo lo completa automáticamente cuando la cuenta se conecta; no es necesario que lo introduzca.

Flujo de conexión bancaria (AIS)

Conectar una cuenta bancaria o de tarjeta

Antes de empezar, asegúrese de que la clave de API esté configurada (Configuración, paso 1) y de que la Cuenta Financiera exista.

Tip

Si ya conoce el IBAN, introdúzcalo en la Cuenta Financiera antes de conectar. Si está vacío, Etendo puede completarlo para las cuentas de tipo Banco (consulte el paso 4).

Abra la Cuenta Financiera (de tipo Banco o Tarjeta) y haga clic en Conectar cuenta. Se abre un widget de conexión en una ventana emergente. Busque su banco y selecciónelo.

La lista solo muestra los bancos del País indicado en la sección Cuenta Bancaria de la Cuenta Financiera. Si su banco no aparece, revise ese País y, si es necesario, ejecute de nuevo Sincronizar proveedores bancarios. Una vez conectado, el banco se guarda como Proveedor bancario de la Cuenta Financiera.

Info

Si ha asignado un Proveedor bancario a la Cuenta Financiera (consulte Configuración - Paso 3), el paso de selección de banco se omite automáticamente y será llevado directamente a la página de autenticación de su banco.
Autorice la conexión: su banco le pedirá que confirme el permiso para que Salt Edge acceda a la información de su cuenta.

Revise los permisos, confirme, y será redirigido a la página de inicio de sesión de su banco. Inicie sesión con sus credenciales bancarias (usuario, contraseña y cualquier autenticación adicional que requiera su banco).
Nota importante de seguridad
- Sus credenciales bancarias se introducen directamente en el sitio web de su banco, no en Etendo
- Salt Edge nunca almacena sus credenciales bancarias
- Etendo nunca tiene acceso a su usuario o contraseña del banco
Seleccione la cuenta a conectar.

Tras un inicio de sesión correcto, Salt Edge devuelve las cuentas que encuentra para esa conexión bancaria. Etendo siempre muestra una pantalla Seleccione su cuenta bancaria para que confirme cuál desea vincular a esta Cuenta Financiera.

La lista solo muestra las cuentas candidatas que coinciden con el Tipo de la Cuenta Financiera que está conectando (cuentas bancarias para una Cuenta Financiera de tipo Banco, tarjetas de crédito para una Cuenta Financiera de tipo Tarjeta), y cada opción muestra el nombre de la cuenta o tarjeta junto con su IBAN o número de tarjeta enmascarado para que pueda identificar la correcta. Seleccione una opción y haga clic en Confirmar.

Warning

El proceso se detiene con un mensaje explicativo si el sistema no puede encontrar una cuenta válida para vincular. Esto ocurre, por ejemplo, cuando ninguna cuenta candidata coincide con el tipo esperado, cuando la moneda no coincide, o cuando todas las cuentas candidatas ya están vinculadas a otra Cuenta Financiera. Resuelva el problema e inténtelo de nuevo.
Después de confirmar la cuenta, Etendo completa la conexión de forma diferente según el Tipo de la Cuenta Financiera:
BancoTarjeta
- IBAN vacío: Etendo lo completa con el IBAN devuelto por el banco (y completa el País a partir del IBAN si está vacío).
- IBAN devuelto no válido, distinto del IBAN ya introducido, o de un país diferente al País de la Cuenta Financiera: la conexión se establece y Etendo muestra una advertencia. Introduzca el IBAN manualmente.
- El sistema completa automáticamente el número de tarjeta enmascarado devuelto por el banco, por ejemplo •••• •••• •••• 1285.
Una página de éxito confirma la conexión. Cierre la ventana emergente. La ventana Cuenta Financiera se actualiza sola, por lo que Obtener extracto bancario está disponible sin recargar la página. Los detalles de la conexión aparecen en la pestaña Conexiones bancarias.

Importación de transacciones

Existen dos formas de importar transacciones bancarias:

Opción 1: Importación manual (cuenta única)

Para importar transacciones bajo demanda para cuentas específicas:

Abra la ventana Cuenta Financiera, seleccione una o más cuentas financieras y haga clic en el botón Obtener extracto bancario (en singular: importa solo la(s) cuenta(s) seleccionada(s)).
El sistema se conecta al banco, recupera las transacciones del rango de fechas configurado y crea o actualiza los extractos bancarios con sus líneas. Cada extracto se nombra según el rango de fechas (de la transacción más antigua a la más reciente) de las transacciones importadas.

Note

Solo se importan las transacciones comprendidas entre Fecha de importación desde y Fecha de importación hasta.

Transacciones contabilizadas frente a pendientes

Solo se importan las transacciones que el banco ya ha contabilizado. Las transacciones que aún están pendientes en el banco se excluyen y se recogerán en una importación posterior una vez que el banco las confirme; esto puede tardar desde unas horas hasta varios días según el banco, por lo que los movimientos más recientes pueden no aparecer inmediatamente después de conectar o tras ejecutar Obtener extracto bancario.
Un mensaje resumen muestra el resultado: si la importación se completó correctamente, si no se encontraron transacciones nuevas, o si se produjo un error.

Tip

Use esta opción cuando necesite importar transacciones de inmediato para cuentas específicas o cuando desee revisar los resultados de la importación al momento.

Opción 2: Importación automática (proceso planificado)

Para importaciones regulares y automatizadas en las cuentas conectadas a las que tiene acceso:

Configuración General > Planificador de procesos > Procesamiento de Peticiones

Haga clic en Nuevo para crear una petición de proceso y seleccione Obtener extractos bancarios (en plural: se ejecuta automáticamente para todas las cuentas conectadas a las que la petición de proceso tiene acceso, a diferencia del botón manual Obtener extracto bancario de la Opción 1) en el campo Proceso.
Establezca Programado en Programar, elija la Frecuencia (por ejemplo, Diaria) y haga clic en Programar Proceso. El proceso se ejecuta automáticamente en el intervalo elegido.

Warning

El proceso solo importa las cuentas a las que el usuario y el rol que crearon la petición de proceso tienen permitido el acceso. Las demás cuentas conectadas se omiten, así que cree la petición con un rol que pueda ver todas las cuentas que desea importar. Consulte Problemas comunes y soluciones si una cuenta no se importa.
Info

Planificación recomendada:
- Ejecute el proceso una vez al día, ya que la disponibilidad de las transacciones depende de la frecuencia de actualización de cada banco.
- Tenga en cuenta la frecuencia de actualización de su banco y las necesidades de su negocio.
Detalle de registro por cuenta

Cada ejecución de Obtener extractos bancarios registra una entrada por cada cuenta procesada en esa ejecución, tenga o no actividad, vinculada a la Cuenta Financiera a la que pertenece. Revise la ventana Registros de la integración bancaria (consulte Monitorización y registros) para comprobar este detalle cuenta por cuenta; abra el campo JSON Info de cada entrada para ver el detalle completo.

Gestión de conexiones

Gestión Financiera > Gestión de Cobros y Pagos > Transacciones > Cuenta Financiera

Para ver todas sus conexiones bancarias, abra la ventana Cuenta Financiera y vaya a la pestaña Conexiones bancarias.

Estado de la conexión

Las conexiones bancarias pueden estar Activo, Inactivo o Deshabilitado (p. ej., cuando la autenticación caduca).

La pestaña Conexiones bancarias muestra el estado de cada conexión y su último error:

Estado	Qué hacer
Activo	No se requiere ninguna acción, salvo que la conexión esté fallando (consulte la nota a continuación).
Inactivo	Reconecte cuando lo necesite; consulte Reconectar una conexión bancaria.
Deshabilitado	Consulte Reconectar una conexión bancaria o Problemas comunes y soluciones.

Activo con Mensaje del último fallo

Una conexión marcada como Activo puede seguir fallando, por ejemplo cuando el consentimiento de su banco ha caducado. Revise la columna Mensaje del último fallo. Si contiene un mensaje, utilice Reconectar la cuenta.

Desconectar una conexión bancaria

Etendo ofrece dos formas de desconectar una conexión bancaria: una desconexión simple, que conserva el historial de la conexión, y un borrado permanente, que la elimina por completo.

Abra la ventana Cuenta Financiera, vaya a la pestaña Conexiones bancarias y seleccione la conexión que desea desconectar. Haga clic en el botón Desconectar cuenta. Se abre un diálogo Desconectar cuenta con una casilla Eliminación permanente.

Opción 1: Desconexión simple

Deje la casilla Eliminación permanente sin marcar y haga clic en HECHO. El estado de la conexión cambia a Inactivo y no se elimina ningún dato. Vuelva a conectar la misma cuenta más adelante, en cualquier momento (consulte Reconectar una conexión bancaria), para restaurar la conexión y conservar su historial de transacciones existente.

Opción 2: Eliminación permanente

Marque la casilla Eliminación permanente y haga clic en HECHO.

Warning

Importante:

Esta acción es irreversible.
Todos los rastros de la conexión se eliminan permanentemente tanto de Etendo como de Salt Edge.
Si vuelve a conectar la misma cuenta más adelante, las transacciones recuperadas tienen identificadores diferentes y pueden duplicarse si importa periodos que ya habían sido conciliados.

Info

En ambos casos, las transacciones pendientes ya importadas no se ven afectadas, y no se podrán importar nuevas transacciones desde la conexión hasta que la reconecte.

Tras la desconexión, verifique el resultado en la pestaña Conexiones bancarias: la conexión aparece como Inactivo en una desconexión simple, o deja de aparecer en la lista en una eliminación permanente.

Reconectar una conexión bancaria

Si una conexión aparece como Inactivo o Deshabilitado, o está Activo pero tiene un Mensaje del último fallo (consulte Estado de la conexión), abra la Cuenta Financiera: el botón Reconectar la cuenta aparece en la barra de herramientas superior de la ventana. Haga clic en él para volver a autenticarse con su banco y restaurar la conexión a Activo. Seguirá los mismos pasos de autorización bancaria, inicio de sesión y selección de cuenta descritos anteriormente (consulte los pasos 2 a 4 en Conectar una cuenta bancaria o de tarjeta).

Iniciación de pagos bancarios (PIS)

Además de importar transacciones bancarias (AIS), este módulo le permite iniciar pagos bancarios directamente desde Etendo. Cuando crea un registro de Pago en Etendo, puede enviarlo a su banco para su autorización y ejecución, todo sin salir de Etendo.

Cómo funcionan los pagos bancarios

El flujo de iniciación de pagos funciona de la siguiente manera:

Cree un registro de Pago en Etendo como de costumbre (o pague una Factura (Proveedor)) y haga clic en el botón Generar pago bancario, disponible en el Pago y, una vez procesado el pago, en la cabecera de la Factura (Proveedor). Aparece un formulario con valores precargados (importe, acreedor, plantilla, etc.).
Revise y confirme: se abre un popup de autorización bancaria donde autoriza el pago en el entorno seguro de su banco.
El estado del pago se rastrea automáticamente en Etendo.

Plantillas de pago

El sistema soporta tres plantillas de pago, que determinan el formato y la información requerida para el pago:

Plantilla	Moneda	Campos obligatorios	Caso de uso
SEPA	Solo EUR	IBAN del acreedor	Transferencias bancarias en la zona euro
FPS	Solo GBP	Código de banco + Número de cuenta	Pagos rápidos del Reino Unido (Faster Payments)
DOMESTIC	Cualquiera	Al menos uno de: IBAN, BBAN o Número de cuenta	Otras transferencias nacionales

Note

La plantilla se selecciona automáticamente en función de la moneda del pago, tal como se indica en la tabla anterior. Cámbiela manualmente en el formulario si es necesario.

Configuración requerida

Antes de generar pagos bancarios, asegúrese de que el método de pago asignado a la cuenta financiera esté configurado correctamente.

Gestión Financiera > Gestión de Cobros y Pagos > Transacciones > Cuenta Financiera

Abra la Cuenta Financiera vinculada a la conexión bancaria, vaya a la pestaña Método de Pago y seleccione el método de pago utilizado para las transferencias bancarias.
En la sección Pago, asegúrese de que Reintegro automático en cuenta esté deshabilitado (sin marcar). Esto permite que el pago se cree sin ejecutarse automáticamente, de modo que pueda ejecutarlo luego desde el botón Generar pago bancario (en el Pago o, una vez procesada, en la Factura (Proveedor)).
Asegúrese de que la casilla Transferencia bancaria esté habilitada para este método de pago; si no lo está, el botón Generar pago bancario no aparecerá al momento de generar pagos. Puede habilitarla globalmente en la ventana Método de Pago, o como excepción en esta misma pestaña Método de Pago de la Cuenta Financiera.

Warning

El botón Generar pago bancario aparece en el registro de Pago, y en la cabecera de la Factura (Proveedor) una vez que el pago ha sido procesado, solo cuando se cumplen todas estas condiciones:

La Cuenta Financiera es de tipo Banco (no Tarjeta ni Caja).
Reintegro automático en cuenta está deshabilitado.
Transferencia bancaria está habilitada, globalmente o como excepción en esta Cuenta Financiera.

Generar un pago bancario

Puede crear el pago desde una Factura (Proveedor) ( Aplicación > Gestión de Compras > Transacciones > Factura (Proveedor)) o directamente desde un Pago ( Gestión Financiera > Gestión de Cobros y Pagos > Transacciones > Pago). En ambos casos, al agregar el pago seleccione el importe y, en Acción relacionada con el documento, elija Procesar Pago(s).

Agregue el pago y seleccione el importe a pagar. En Acción relacionada con el documento, seleccione Procesar Pago(s).

Info

Procesar Pago(s) procesa el pago sin ejecutarlo, lo que hace que el botón Generar pago bancario aparezca en el registro.
Haga clic en el botón Generar pago bancario, disponible en el registro de Pago resultante y, una vez que el pago ha sido procesado, también en la cabecera de la Factura (Proveedor).

Aparece un formulario de proceso con los siguientes campos precargados:

Campo	Valor por defecto	Descripción
Plantilla	Según la moneda	Plantilla de pago (SEPA, FPS o DOMESTIC)
Identificación extremo a extremo	Número de documento	Referencia única del pago (máx. 35 caracteres)
Nombre del acreedor	Nombre del Tercero	Nombre del beneficiario del pago
Importe	Importe del pago	Importe a transferir
Moneda	Moneda del pago	Moneda de la transferencia
Descripción	Descripción del pago; `Invoice No.: <número de factura>` cuando el pago proviene de una factura	Descripción del pago
IBAN del acreedor	IBAN del Tercero	Obligatorio para SEPA y opcional para DOMESTIC. Queda vacío si el Tercero no tiene IBAN
Número de cuenta del acreedor	Cuenta del Tercero	Obligatorio para FPS, opcional para DOMESTIC. No se muestra para la plantilla SEPA

Tip

Los valores del formulario se calculan automáticamente a partir de los datos del Pago y del Tercero. Asegúrese de que sus Terceros tengan configurada su información de cuenta bancaria (IBAN o número de cuenta) para una mejor experiencia.

Revise los valores y haga clic en HECHO para iniciar el pago. Se abre un popup de autorización bancaria donde debe autorizar el pago con su banco.

Warning

No cierre el popup hasta haber completado el proceso de autorización con su banco. El pago no puede continuar sin su autorización.
Tras completar la autorización, verá una página de confirmación que indica que el pago se ha registrado. Cierre el popup y vuelva a Etendo; el estado del pago se actualizará automáticamente.

Consultar los pagos bancarios

Todos los pagos bancarios iniciados se registran en la pestaña Pagos bancarios del registro de Pago ( Gestión Financiera > Gestión de Cobros y Pagos > Transacciones > Pago). Cada entrada muestra el Estado, el Importe, la Moneda, el Nombre del acreedor y el IBAN del acreedor, además del Nombre del deudor y el IBAN del deudor (su propia Cuenta Financiera) y la Cuenta Financiera vinculada. Utilice Actualizar pago para consultar el estado más reciente bajo demanda.

Actualización del estado del pago

El estado del pago se mantiene actualizado de tres maneras: actualizaciones automáticas, actualización manual y actualización programada.

Actualizaciones automáticas

El servicio de conexión bancaria envía notificaciones automáticas de estado a Etendo cada vez que el estado del pago cambia en el banco. Estas actualizaciones se procesan de forma inmediata y el registro del pago se actualiza en tiempo real.

Actualización manual

Si desea consultar el estado más reciente de inmediato:

Vaya a la pestaña Pagos bancarios, seleccione uno o varios registros de pago y haga clic en el botón Actualizar pago.

El sistema consulta al banco el estado actual y actualiza el registro.

Tip

Utilice la actualización manual cuando desee verificar el estado actual de un pago sin esperar a la siguiente actualización automática.

Actualización automática programada

El proceso Actualizar pagos pendientes se ejecuta cada 10 minutos de forma predeterminada y actúa como red de seguridad por si no se procesa alguna actualización automática. Para ajustar la frecuencia, cree una nueva Petición de proceso para este proceso y anule la programación de la entrada importada por el sistema ( Configuración General > Planificador de procesos > Procesamiento de Peticiones).

Problemas comunes y soluciones

Conexión y clave de API

No hay clave de API disponible

Asegúrese de que la Entidad tenga configurada la clave de API de Salt Edge.
Compruebe que la clave de API sea correcta y esté activa.

Clave de API inválida o caducada

Su clave de API ha caducado o ya no es válida.
Contacte con su administrador de Etendo o con el Soporte de Etendo para obtener una nueva clave de API.
Actualice la clave de API en la ventana Entidad (campo Clave de API, en el grupo de campos Integración bancaria).

No se pudo obtener el enlace de redirección

El servicio de conexión bancaria puede estar temporalmente no disponible.
Inténtelo de nuevo en unos minutos. Contacte con soporte si el problema persiste.

No se encontraron transacciones nuevas

Revise la configuración de Fecha de importación desde / Fecha de importación hasta.
Verifique que existan nuevas transacciones en su cuenta bancaria y que el rango de fechas cubra el periodo esperado.
Si la importación proviene del proceso programado Obtener extractos bancarios, compruebe que el usuario y el rol de la petición de proceso tengan acceso a la Cuenta Financiera.
Recuerde que las transacciones que aún estén pendientes en el banco todavía no se importan; consulte Transacciones contabilizadas frente a pendientes. Espere a que el banco las confirme y vuelva a ejecutar Obtener extracto bancario.

La fecha solicitada excede el historial máximo admitido por el banco

Cada Proveedor bancario tiene un rango histórico máximo que puede proporcionar realmente (Intervalo máximo de consulta). Si la Fecha de importación desde configurada en la Cuenta Financiera es anterior a lo que admite el banco, el resultado de la importación incluye una advertencia indicando que la fecha solicitada excede el máximo admitido por ese banco.
Esta advertencia es solo informativa: no se requiere ninguna acción. El banco no dispone de más historial.
El sistema ya importa el máximo historial que puede recuperar, comenzando desde la fecha más antigua que admite el banco.

Límite de solicitudes alcanzado o servicio temporalmente no disponible

El sistema ha superado el número permitido de solicitudes a la API, o Salt Edge está en mantenimiento.
Estos errores son transitorios: espere unos minutos e inténtelo de nuevo. Los procesos planificados reintentan automáticamente.

El estado de la conexión aparece como Deshabilitado

Una conexión puede aparecer como Deshabilitado debido a la caducidad de la autenticación, errores de comunicación con Salt Edge o indisponibilidad temporal del banco.

Ejecute Obtener extractos bancarios de nuevo para ver si el problema persiste.
Si sigue apareciendo como Deshabilitado, haga clic en Reconectar la cuenta en la barra de herramientas de la Cuenta Financiera (consulte Reconectar una conexión bancaria).

Iniciación de pagos

Plantilla requerida / Nombre del acreedor requerido

No se pudo determinar la plantilla de pago, o falta el nombre del Tercero.
Asegúrese de que el pago tenga una moneda válida y un Tercero con un nombre válido asignado.

IBAN requerido para SEPA

Los pagos SEPA requieren el IBAN del acreedor.
Configure la cuenta bancaria del Tercero con un IBAN válido.

SEPA requiere EUR / FPS requiere GBP / Código de banco o número de cuenta requerido para FPS

Los pagos SEPA solo utilizan EUR; FPS solo utiliza GBP y requiere tanto el código de banco como el número de cuenta.
Compruebe la moneda del pago, cambie a la plantilla DOMESTIC si es necesario y verifique los datos de la cuenta bancaria del Tercero.

El estado del pago queda en INICIADO o AUTORIZANDO

Es posible que el usuario no haya completado la autorización en el banco.
Haga clic en Actualizar pago para comprobar el estado más reciente. Si el problema persiste, contacte con el Soporte de Etendo indicando los datos del pago.

El popup de autorización bancaria fue bloqueado / Pago no encontrado al volver del banco

Es posible que su navegador haya bloqueado la ventana emergente; permita las ventanas emergentes para el sitio de Etendo e inténtelo de nuevo.
Si la redirección falló, revise la pestaña Pagos bancarios. Es posible que el pago se haya procesado correctamente y el estado se haya actualizado automáticamente poco después.

Obtener soporte

Antes de contactar con soporte, revise la ventana Registros de la integración bancaria para obtener detalles del error, verifique su clave de API e intente el botón Reconectar la cuenta para problemas de conexión. Al contactar con el Soporte de Etendo, incluya el mensaje de error, las entradas de registro relevantes (incluyendo JSON Info), la cuenta financiera afectada y la fecha y hora del incidente.

Monitorización y registros

El módulo ofrece dos ventanas dedicadas para monitorizar la actividad de la integración.

Registros de la integración bancaria

Gestión Financiera > Gestión de Cobros y Pagos > Configuración > Integración bancaria > Registros de integración bancaria

Muestra toda la actividad y los registros de error generados por la integración. Cada entrada incluye:

Campo	Descripción
Cuenta Financiera	La cuenta financiera asociada al evento.
Día de la ejecución	La fecha y hora en que ocurrió el evento.
Estado	El resultado de la operación: Inicial, Procesado, Éxito o Error.
Fuente	El proceso que generó el registro (p. ej., Cuentas, Consentimientos, Transacciones, PIS Crear pago, PIS Actualizar Pago).
Log	Una descripción legible del evento, cuando está disponible. Este campo puede aparecer vacío en algunas entradas; en ese caso, recurra a JSON Info.
JSON Info	La respuesta cruda de la API. Esta es la fuente de referencia definitiva con el detalle para la resolución de problemas y el soporte.

Info

Las entradas de registro se conservan durante 90 días y las entradas más antiguas se purgan automáticamente. Exporte o copie el JSON Info relevante antes de que se cierre esa ventana de tiempo si necesita conservar un registro con fines de soporte o auditoría.

Tip

Filtre por Cuenta Financiera y ordene por Día de la ejecución de forma descendente para encontrar rápidamente los eventos más recientes.

Proveedor bancario

Gestión Financiera > Gestión de Cobros y Pagos > Configuración > Integración bancaria > Proveedor bancario

Muestra todos los bancos disponibles a través de Salt Edge. Cada entrada muestra el Código del proveedor y el Nombre del proveedor.

Recursos adicionales

This work is licensed under CC BY-SA 2.5 ES by Futit Services S.L.