Sincronización bancaria¶
Odoo puede obtener sus transacciones bancarias de forma automática en lugar de tener que subir un archivo de extracto cada día. Los módulos de sincronización bancaria en línea conectan una cuenta bancaria o de pago con un diario de Odoo, consultan al proveedor a intervalos fijos y crean las líneas de extracto bancario correspondientes, listas para la conciliación.
La función se divide en dos capas:
Sincronización bancaria en línea (
account_bank_sync) proporciona las conexiones, las cuentas remotas, la asignación de diarios, la importación programada y el almacenamiento seguro de las credenciales del proveedor.Un módulo de proveedor implementa una institución o agregador específico. Hay dos disponibles:
Nyíltbankolás Partner (
account_bank_sync_bankszamlakivonat): un agregador multibanco que cubre los bancos húngaros a través del serviciobankszamlakivonat.hu.Wise (
account_bank_sync_wise): los saldos multidivisa de Wise (antes TransferWise), incluidos los pagos salientes.
Nota
La sincronización en línea requiere al menos un módulo de proveedor. Si su banco no está cubierto por ningún proveedor, importe los archivos de extracto en su lugar.
Permisos de acceso¶
La sincronización introduce sus propios grupos de acceso, que se asignan en dentro de la categoría Sincronización bancaria en línea:
Grupo |
Permisos |
|---|---|
Sincronización bancaria / Usuario |
Lee el estado y los resultados de la sincronización. No tiene acceso a las credenciales. |
Sincronización bancaria / Gerente |
Configura las conexiones, las cuentas y la asignación de diarios. Es necesario para ver el menú Sincronización bancaria. |
Sincronización bancaria / Aprobador de pagos |
Aprueba y envía los pagos salientes. |
Sincronización bancaria / Administrador |
Lee y escribe las credenciales y los secretos del proveedor. |
Crear una conexión¶
Vaya a y haga clic en Nuevo. Complete lo siguiente:
Nombre: una etiqueta a su elección, por ejemplo, el nombre del banco.
Proveedor: el módulo de proveedor que gestiona esta institución.
Entorno: Sandbox para pruebas, Producción para datos reales.
La sección Credenciales, cuyos campos dependen del proveedor seleccionado. Las credenciales solo son visibles para el grupo Sincronización bancaria / Administrador.
La sección Funciones la completa el módulo de proveedor e indica lo que admite la conexión: Admite la obtención de extractos, Admite tipos de cambio, Admite webhooks y Admite pagos salientes.
Haga clic en Probar conexión para verificar las credenciales. La barra de Estado pasa de Borrador a Conectado; si el proveedor rechaza las credenciales, el estado cambia a Error y el motivo se muestra en Último error. Una conexión cuya autorización haya caducado se marca como Caducada y debe renovarse con el proveedor.
- menu
- Accounting ‣ Bank Sync ‣ Connections ‣ (open a connection)
- shows
- A connection form in state "Connected", with the Name, Provider, Environment, Last refresh fields, a filled Credentials section and the four Capabilities checkboxes.
- highlight
- The status bar and the "Test connection" / "Discover accounts" buttons.
- data
- Connection "OTP – Nyíltbankolás", provider "Nyíltbankolás Partner", environment "Production".
- module
- account_bank_sync, account_bank_sync_bankszamlakivonat
- notes
- English UI, light theme, 1440px width; use a throw-away API key.
Nyíltbankolás Partner¶
El agregador se conecta a los bancos húngaros en su nombre. Introduzca el ID de entidad y la Clave de API que recibió del servicio y haga clic en Obtener código de conexión. Odoo solicita un código de conexión, que se muestra en el campo Código de conexión: úselo en el sitio del proveedor para autorizar sus cuentas bancarias. Una vez realizada la autorización, haga clic en Actualizar / detectar para importar a Odoo la lista de cuentas autorizadas.
Wise¶
Introduzca el ID de perfil de Wise y el token de API. Para los pagos salientes, Wise también requiere una Clave privada que se usa para firmar los desafíos de autenticación reforzada del cliente y, para la entrega de webhooks, la Clave pública del webhook que Wise publica para el entorno elegido. Use Suscribir webhooks para registrar Odoo en Wise de forma que las nuevas transacciones activen una actualización inmediata, y Cancelar suscripción de webhooks para detenerlas.
Importante
Los eventos de webhook se entregan en /bank_sync/webhook/<provider> en su base de datos. La verificación de la firma falla de forma segura: un evento que no se puede verificar se rechaza. Pida a su administrador de sistemas que se asegure de que esta dirección sea accesible desde internet.
Asignar las cuentas remotas a los diarios¶
En una conexión ya conectada, haga clic en Detectar cuentas. Odoo consulta al proveedor y crea un registro de Cuenta de sincronización bancaria por cada cuenta remota o saldo. Abra y configure lo siguiente para cada una:
Diario: el diario bancario en el que se registran las transacciones. No se importa nada hasta que se configure un diario.
Sincronización habilitada: activa la importación programada para esta cuenta.
Sincronizar cada: el intervalo de consulta (por ejemplo, 1 hora).
La vista de lista muestra la Última ejecución correcta y una insignia de color Último estado (Ok, Error, Obsoleto), de forma que puede identificar de un vistazo una cuenta que dejó de importar.
- menu
- Accounting ‣ Bank Sync ‣ Accounts
- shows
- The Accounts list with three rows: connection, account name, currency, mapped journal, the "Sync enabled" toggle, the last successful run and the colored state badges (one "Ok", one "Error").
- highlight
- The "Last state" column (red frame).
- data
- Two HUF accounts mapped to "Bank" and "Bank (OTP)", one EUR Wise balance.
- module
- account_bank_sync
- notes
- English UI, light theme, 1440px width.
Ejecutar una sincronización¶
Hay tres formas en las que se puede ejecutar una sincronización:
Programada: la acción programada Sincronización bancaria en línea: obtener extractos comprueba cada 15 minutos qué cuentas están pendientes y las importa. Esta acción programada está deshabilitada de forma predeterminada; pida a su administrador de sistemas que la habilite una vez que la asignación esté configurada.
Manual: haga clic en Sincronizar ahora en el formulario de la cuenta o en la tarjeta del diario del tablero de Contabilidad.
Activada por webhook: en los proveedores compatibles con webhooks, un evento entrante marca la cuenta y la siguiente ejecución programada la importa de inmediato, incluso si la consulta periódica está desactivada.
Cada ejecución obtiene las transacciones desde la última ejecución correcta, con un solapamiento de 48 horas para no perder las transacciones que el banco registra con retraso. La importación es idempotente: una transacción que ya está presente en el diario se omite, por lo que ejecutar una sincronización dos veces nunca crea duplicados.
Si una ejecución falla, la cuenta se marca como Error y el mensaje se guarda en Último error; las demás cuentas no se ven afectadas. Las credenciales y los tokens se eliminan de los mensajes guardados.
Pagos salientes¶
Los proveedores compatibles con pagos salientes (actualmente Wise) también pueden enviar dinero desde Odoo. Como esto mueve fondos reales, los pagos salientes están protegidos por un flujo de trabajo de doble control (creador-verificador).
Configuración¶
En el formulario de la conexión, en la sección Controles de pagos salientes:
Pagos salientes habilitados: el indicador de la función, que solo puede editar el grupo Sincronización bancaria / Administrador. Los pagos salientes son imposibles mientras esté desactivado, incluso si el proveedor los admite.
Umbral de doble control de pagos salientes: por encima de este importe, una segunda persona debe aprobar el pago. Establézcalo en 0 para requerir siempre un aprobador independiente.
Límite por transacción de pago saliente: el mayor pago saliente individual permitido. 0 significa que no hay límite.
Límite diario de pagos salientes: el mayor total que se puede aprobar por día (UTC). 0 significa que no hay límite.
Crear y enviar un pago saliente¶
Vaya a y haga clic en Nuevo. Configure el Beneficiario, la Cuenta bancaria del destinatario, el Importe y la divisa, y una Referencia de pago (35 caracteres como máximo, según lo exige SEPA). A continuación, use los botones del encabezado:
Cotizar solicita al proveedor el tipo de cambio y la comisión, que se muestran en la sección Cotización junto con una hora de vencimiento.
Solicitar envía el pago saliente para su aprobación. En ese momento se fija si se aplica el doble control, por lo que aumentar el umbral después no puede debilitarlo.
Aprobar lo realiza un usuario con el grupo Sincronización bancaria / Aprobador de pagos. Cuando se aplica el doble control, el aprobador debe ser una persona distinta de quien lo solicitó.
Enviar mediante Wise transmite el pago saliente al proveedor.
La barra de estado sigue el pago saliente a través de Borrador, Pendiente de verificación, Aprobado, Enviado, Ejecutado y Conciliado, con Fallido y Cancelado como resultados alternativos. Cancelar está disponible hasta que se ejecute el pago saliente. Una vez que el proveedor confirma la transferencia, el comprobante del pago se puede obtener y guardar en el registro.
Nota
Cada pago saliente lleva una clave de idempotencia, por lo que un problema de red durante el envío nunca puede provocar que el dinero se transfiera dos veces.
Lotes de pagos salientes¶
Para pagar a varios destinatarios a la vez, use . Un lote guarda sus pagos salientes en la pestaña Miembros y ofrece los mismos pasos a nivel de lote: Cotizar todo, Solicitar, Aprobar, Enviar, Reembolsar y Cancelar. Los límites y la regla de doble control de la conexión se aplican al total del lote.
- menu
- Accounting ‣ Bank Sync ‣ Payouts ‣ (open a payout)
- shows
- A payout form in state "Pending checker" with the header buttons Quote / Request / Approve / Send via Wise / Cancel, the Payee, amount and payment reference, and the Quote section showing the rate, the fee and the expiry.
- highlight
- The status bar and the Approval section (requester and approver).
- data
- Payee "Deco Addict", amount 1,250.00 EUR, reference "INV/2026/0042".
- module
- account_bank_sync, account_bank_sync_wise
- notes
- English UI, light theme, 1440px width.