Documentacion KSIDol > Modulos KSIDol > Importación bancaria

Guia del modulo: Importación bancaria

Guía de uso no técnica: para qué sirve el módulo, cómo utilizarlo y cómo se articula con Dolibarr.

Formatos bancarios importados5: CSV, OFX, QIF, CAMT.053, MT940

Documentos conciliadosFacturas, anticipos, abonos, salarios, cargas

Pago DolibarrCreado solo tras validación humana

CompatibilidadDolibarr 18+ - PHP 8+

1. Descripcion del modulo

Importación bancaria (Bank Import) es un módulo KSIDol que introduce sus extractos bancarios en Dolibarr y le ayuda a puntear cada movimiento con el documento contable correcto. Usted importa un archivo de su banco (o prepara un perfil de conector API), el módulo propone automáticamente las facturas, anticipos, abonos, salarios o cargas que mejor se corresponden con cada línea y, tras su validación, crea el pago nativo de Dolibarr y salda la factura. El objetivo: menos introducción manual, una conciliación más rápida y una contabilidad al día, sin dejar nunca que el módulo actúe solo.

Se apoya por completo en los objetos nativos de Dolibarr: cuentas bancarias, facturas de clientes y proveedores, anticipos, abonos, salarios, cargas sociales/fiscales y formas de pago.
Ninguna modificación del núcleo de Dolibarr: el módulo añade sus propias páginas y sus propias tablas, en el menú Bancos/Cajas.
El control sigue siendo humano: el pago de Dolibarr nunca se crea sin que usted haya validado la correspondencia.
Una vez que un apunte bancario está pagado o punteado, queda bloqueado y ya no se vuelve a proponer, lo que evita los pagos duplicados.

2. Importación de extractos bancarios

La página Importación bancaria permite cargar un archivo facilitado por su banco y transformar cada operación en un apunte listo para conciliar, en la cuenta bancaria de Dolibarr que usted elija.

Compatibilidad con 5 formatos: CSV, OFX, QIF, CAMT.053 XML y MT940 (archivos .sta), con una opción de detección automática del formato.
Lectura tolerante de las exportaciones CSV: separadores variados, codificaciones Windows/ISO, fechas antiguas y columnas de debe/haber separadas.
Elección de la cuenta bancaria de Dolibarr de destino (se puede preseleccionar una cuenta por defecto en la configuración).
Cada archivo importado se convierte en un lote de importación identificado, con una huella, para llevar el registro de lo que se ha cargado.
Protección antiduplicados: el módulo rechaza una operación ya presente (huella del archivo y clave de negocio fecha + cuenta + importe + concepto + contrapartida).
Visualización de un diagnóstico de las primeras líneas con error para corregir un archivo mal formado.
Controles de seguridad: extensiones de archivo permitidas y tamaño máximo de importación configurable.

3. Panel de control y seguimiento de las importaciones

La página de inicio del módulo ofrece una visión de conjunto de la actividad de conciliación y un acceso rápido a las últimas operaciones importadas.

Cuatro fichas con cifras y clicables: transacciones importadas, correspondencias propuestas, líneas aprobadas y pagos ejecutados.
Panel Últimas importaciones que lista los lotes recientes: fecha, origen, nombre del archivo, cuenta bancaria (enlace clicable a la ficha de la cuenta), número de líneas importadas/leídas, duplicados y estado.
Lista ordenable por columna y accesos directos a la importación, las correspondencias y los lotes de importación.

4. Conciliación inteligente de los apuntes

La página Correspondencias bancarias es el corazón del módulo: compara cada línea bancaria con los documentos abiertos de Dolibarr y propone las mejores asociaciones, sin decidir nunca en su lugar.

Generación automática de propuestas (candidatos) para los apuntes a tratar.
Puntuación de pertinencia calculada según varios criterios: importe (exacto, cercano, aproximado, diferencia compatible con gastos/redondeo, pago parcial), referencia de la factura, nombre o código del tercero, sentido del movimiento y proximidad de fecha.
Cada propuesta muestra sus motivos, respaldados por la prueba encontrada (palabra del tercero, referencia detectada...).
Pestañas de seguimiento del flujo de trabajo: A tratar, Aprobados a pagar, Rechazados, Terminados, Todos.
Detección del tipo de pago (cheque, tarjeta, transferencia, domiciliación, efecto, efectivo) para rellenar previamente la forma de pago.
Punteo guiado en una ventana dedicada: validación de una correspondencia propuesta, asignación manual de una factura o cobro parcial con importe a puntear.
Acciones por línea: aprobar, rechazar, reabrir un rechazo, anular una aprobación, bloquear tras el pago.
Los apuntes ya punteados, pagados o bloqueados dejan de proponerse en los nuevos cálculos.
Conciliación posible con apuntes bancarios ya presentes en Dolibarr: en ese caso, solo punteo, nunca un segundo pago.

5. Creación de los pagos de Dolibarr

Una vez validada una correspondencia, el módulo crea el pago nativo de Dolibarr correspondiente y actualiza el documento, siempre que se tenga el permiso.

Factura de cliente saldada mediante un pago de cliente nativo; factura de proveedor mediante un pago de proveedor nativo.
Los anticipos de clientes y proveedores también se admiten para la creación del pago.
Salarios no pagados y cargas sociales/fiscales: creación del pago de salario o de carga nativo de Dolibarr.
El pago genera el enlace a la factura, el apunte en la cuenta bancaria y el paso al estado pagado si el documento está saldado.
Pago parcial posible introduciendo el importe a puntear.
Caso particular de los abonos: solo se puntean y se bloquean, sin creación automática de pago.

6. Integracion con las paginas de Banco nativas de Dolibarr

Desde la version 1.3.0, el modulo aparece directamente en los apuntes bancarios nativos de Dolibarr (Banco, cuenta, apuntes), sin salir de la pantalla habitual.

Boton «Importar un extracto» en la lista de apuntes de una cuenta: abre una ventana de validacion (el banco correspondiente y los extractos ya importados) y luego reutiliza la importacion del modulo, sin doble captura.
Columna «Conciliacion» en cada apunte: distingue de un vistazo las lineas punteadas mediante un lote Bank Import de las conciliadas de forma nativa en Dolibarr.
Accion «Puntear» en un apunte no conciliado: abre la conciliacion del modulo para vincular el apunte a una o varias facturas.
Sin movimiento bancario duplicado: el pago se adjunta al apunte existente (sin nueva linea) y luego la conciliacion nativa se marca automaticamente cuando el apunte queda totalmente asignado.
Funcionamiento bidireccional: los punteos y las conciliaciones se comparten entre el modulo y la pantalla de Banco nativa de Dolibarr.
Activa en cuanto se activa el modulo: tras una actualizacion, basta con desactivar y volver a activar el modulo para registrarla, sin configuracion manual. Se puede desactivar en la configuracion del modulo si es necesario.

7. Gestión de los lotes de importación

La página Lotes de importación permite volver sobre lo que se ha cargado, consultar su detalle y limpiar correctamente, en particular durante las fases de prueba.

Lista de los lotes con referencia, origen, archivo, fecha, número de líneas presentes y protegidas, y estado.
Detalle de un lote: consulta línea por línea de los apuntes importados.
Eliminación de un lote completo o de una línea de importación.
Las líneas ya punteadas o pagadas están protegidas; su eliminación forzada está reservada a los administradores y nunca elimina los pagos de Dolibarr ya creados.
Útil para reinicializar un conjunto de pruebas antes de una puesta en producción.

8. Conectores bancarios (preparación de API)

La página Conectores bancarios permite declarar perfiles de conexión a las API bancarias, con vistas a automatizar la recuperación de los apuntes.

Creación de perfiles de tipo PSD2/AISP, EBICS o Custom JSON.
Introducción del proveedor o del banco, de la URL de la API, de la cuenta bancaria vinculada y del estado activo.
El secreto nunca se almacena en claro: se indica una referencia de secreto (variable de entorno o secreto del servidor), introducida en un campo protegido.
Advertencia que recuerda que una API bancaria supone un contrato/proveedor dedicado.
Punto de atención: la sincronización real requiere un adaptador específico del banco o del proveedor; los perfiles preparan la integración pero no desencadenan una importación automática de serie.

9. Configuración del módulo

La pantalla de configuración adapta el comportamiento del módulo a su empresa y a su manera de conciliar.

Cuenta bancaria por defecto utilizada para las importaciones y los pagos.
Forma de pago por defecto propuesta durante la validación.
Tolerancia de importe para absorber los redondeos o pequeños gastos (0,02 por defecto).
Puntuación de candidato fuerte y puntuación mínima de correspondencia, para ajustar la precisión de las propuestas.
Número máximo de facturas analizadas y número de candidatos conservados por apunte (rendimiento).
Tamaño máximo de los archivos importados.
Opciones a activar/desactivar: buscar también en los salarios, buscar también en las cargas sociales/fiscales y filtrar por la diferencia de importe (evita las propuestas cuyo importe no tiene ninguna relación).

10. Derechos de acceso (permisos)

El módulo proporciona derechos de Dolibarr distintos para separar la consulta, la importación, la conciliación y la acción contable.

Leer Bank Import: consultar el panel de control y los apuntes.
Importar extractos bancarios.
Generar y validar las correspondencias.
Crear los pagos de Dolibarr (acción contable).
Administrar Bank Import: configuración y conectores.
Esta separación permite, por ejemplo, dejar que un colaborador importe y puntee sin autorizarle a crear los pagos.

11. Vinculos con Dolibarr

El modulo no funciona de forma aislada: se integra con los bloques nativos de Dolibarr.

Cuentas bancarias (Bancos/Cajas) : Cada importación apunta a una cuenta bancaria de Dolibarr; en el pago, el apunte se registra en esa cuenta mediante el flujo nativo, y la cuenta sigue siendo clicable desde el panel de control.
Facturas de clientes : Los apuntes de cobro se concilian con las facturas de clientes abiertas; la validación crea un pago de cliente nativo y salda la factura si el importe es completo.
Facturas de proveedores : Los desembolsos se concilian con las facturas de proveedores; la validación crea un pago de proveedor nativo y actualiza la factura.
Anticipos y abonos : Las facturas de anticipo de clientes/proveedores pueden generar un pago; los abonos de clientes y proveedores solo se puntean y se bloquean, sin pago automático.
Terceros (empresas) : El módulo reconoce al tercero en el concepto bancario (nombre, palabras clave, código) para proponer los documentos correctos, apoyándose en los terceros de Dolibarr.
Salarios y cargas sociales/fiscales : Opcionalmente, se proponen los salarios no pagados y las cargas sociales/fiscales; la validación crea el pago de salario o de carga nativo de Dolibarr.
Formas de pago : La forma de pago propuesta procede del diccionario de formas de pago de Dolibarr (c_paiement) activas, y puede detectarse previamente según el tipo de operación.
Contabilidad y estado de los documentos : Como los pagos se crean mediante los mecanismos nativos de Dolibarr, alimentan la contabilidad estándar y hacen pasar las facturas saldadas al estado pagado, con la línea bancaria asociada.
Banco / Conciliacion : El modulo se integra en la pagina de apuntes bancarios nativa (Banco, cuenta, apuntes): boton de importacion, columna de punteo y accion «Puntear». Los pagos creados se adjuntan al apunte existente y marcan la conciliacion nativa de Dolibarr, sin crear un movimiento duplicado.