Importación bancaria y conciliación para Dolibarr


Bank Import para Dolibarr
Importe sus extractos bancarios, obtenga coincidencias puntuadas con sus facturas y cree los pagos nativos de Dolibarr — tras validación humana
   Importación multiformato
   Conciliación bancaria
   Coincidencias puntuadas
   Pagos nativos
   Validación humana
   Antiduplicados
   CSV · OFX · QIF · CAMT.053 · MT940

Presentación

Bank Import es un módulo externo para Dolibarr ERP/CRM (editor KSIDol) que automatiza la conciliación bancaria, del extracto al pago.

Importa los movimientos de un extracto bancario (CSV, OFX, QIF, CAMT.053, MT940), propone coincidencias puntuadas con sus facturas, anticipos, salarios y cargas abiertos, y luego crea los pagos nativos de Dolibarr — únicamente tras su validación. El módulo propone, el usuario decide: no se crea ningún pago automáticamente, no se modifica ni se elimina ningún movimiento existente.

El módulo no modifica ningún archivo del núcleo de Dolibarr.

Editor y soporte

Elemento Información
Editor KSIDol
Especialidad Integrador Dolibarr
Servicios Desarrollo a medida, alojamiento SaaS, acompañamiento Dolibarr
Sitio web https://www.ksidol.io
Soporte support@ksidol.io
Módulos Dolistore https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search=

Información del módulo

Información Detalle
Nombre del módulo Bank Import
Uso principal Importar los extractos bancarios y crear los pagos de Dolibarr tras conciliación puntuada
Tipo Módulo externo de Dolibarr
Familia Finanzas / Contabilidad
Versión documentada 24.0.0
Compatibilidad Dolibarr Dolibarr 18.0 a 24.x
Compatibilidad PHP PHP 8.0 o superior
Modificación del núcleo de Dolibarr No
Licencia GNU GPLv3
Idiomas disponibles Francés, Inglés, Alemán, Español, Italiano

Enlaces oficiales

Objetivos del módulo

Reducir el tiempo dedicado a la conciliación bancaria manteniendo un control humano sobre cada pago:

  • importar un extracto de cualquier banco gracias al reconocimiento multiformato;
  • conciliar automáticamente cada movimiento con los documentos abiertos de Dolibarr, con una puntuación y motivos;
  • validar la coincidencia correcta, elegir el modo y la fecha, y luego crear el pago nativo de Dolibarr;
  • no tocar nunca un movimiento existente: el módulo propone, el humano aprueba.

¿Para quién?

  • Microempresas, pymes y asociaciones que aún registran sus cobros a mano.
  • Contables y gestores que quieren puntear un extracto en unos minutos, sin doble registro.
  • Integradores Dolibarr que buscan una conciliación bancaria fiable, respetuosa con la inalterabilidad.

Funcionalidades principales

  • Importación multiformato: CSV (delimitador y columnas debe/haber detectados, codificación tolerante), OFX (bloques STMTTRN), QIF, CAMT.053 XML (entradas Ntry), MT940 (:61:/:86:). Formato reconocido automáticamente o elegido manualmente.
  • Antiduplicados: huella calculada sobre la cuenta, la fuente, la referencia, las fechas, el importe, el concepto normalizado y la contraparte; las líneas ya importadas nunca se reinyectan.
  • Conciliación puntuada: comparación del importe (exacto, próximo, diferencia por comisiones/redondeo, pago parcial), de la referencia de factura (y sus variantes), del tercero (nombre, palabras, código), del sentido bancario y de la fecha. Cada candidato muestra su puntuación y sus motivos.
  • Fuentes de coincidencia: facturas y anticipos de clientes/proveedores, abonos (solo punteo), salarios no pagados y cargas sociales/fiscales no pagadas (activables), y movimientos bancarios nativos existentes (solo punteo, sin doble pago).
  • Validación y pago: aprobación de una línea (o asignación parcial), elección del modo y la fecha, y luego creación del pago nativo de Dolibarr (pago de factura, de salario o de carga) y del movimiento bancario; bloqueo de la conciliación.
  • Detección del tipo de pago: cheque, tarjeta, transferencia, domiciliación, efecto domiciliado, efectivo.
  • Gestión de los lotes de importación: eliminación de un lote o de una línea, reinicio de los juegos de prueba; las líneas punteadas/pagadas/bloqueadas están protegidas; nunca se elimina un pago de Dolibarr ya creado.
  • Cuadro de mando: KPI (transacciones, candidatos, aprobados, pagos ejecutados) y filtro de flujo (por procesar, aprobados por pagar, rechazados, terminados).

Menús

Bajo el menú principal Banco, el módulo añade:

  • Cuadro de mando — indicadores de conciliación
  • Importación bancaria — envío de un archivo de extracto
  • Coincidencias bancarias — movimientos, candidatos puntuados y validación
  • Lotes de importación — detalle, eliminación, reinicio
  • Conectores bancarios — perfiles de conector (administrador)
  • Configuración — parámetros del módulo

Configuración

Desde Inicio → Configuración → Módulos → Bank Import:

  • cuenta bancaria por defecto (BANKIMPORT_DEFAULT_BANK_ACCOUNT_ID);
  • modo de pago por defecto (BANKIMPORT_DEFAULT_PAYMENT_MODE_ID);
  • tolerancia de importe (BANKIMPORT_AMOUNT_TOLERANCE, por defecto 0,02);
  • puntuación «candidato fuerte» (BANKIMPORT_AUTO_APPROVE_SCORE, por defecto 90);
  • puntuación mínima de coincidencia (BANKIMPORT_MATCH_MIN_SCORE, por defecto 40);
  • número máx. de facturas analizadas por transacción (BANKIMPORT_MATCH_SCAN_LIMIT, por defecto 1000);
  • candidatos máx. por transacción (BANKIMPORT_MATCH_TOP_PER_TRANSACTION, por defecto 10);
  • tamaño máximo de un archivo importado (BANKIMPORT_IMPORT_MAX_FILESIZE_MB, por defecto 20 MB);
  • buscar también en los salarios / las cargas sociales y fiscales (activadas por defecto).

Permisos de usuario

El módulo define cinco permisos:

  • Consultar Bank Import — cuadro de mando y listas (read)
  • Importar extractos bancarios — envío y lectura de los archivos (import)
  • Generar y validar las coincidencias — cálculo, aprobación/rechazo, punteo (match)
  • Crear los pagos de Dolibarr — pagos nativos tras validación (pay)
  • Administrar Bank Import — configuración, conectores, lotes (admin)

Flujo tipo

  1. Importe un archivo de extracto (Importación bancaria).
  2. Genere las coincidencias (Coincidencias bancarias).
  3. Compruebe la puntuación y los motivos de cada candidato.
  4. Apruebe la coincidencia correcta, elija el modo y la fecha de cobro.
  5. El pago nativo de Dolibarr se crea, el movimiento bancario se alimenta y la conciliación se bloquea.

Nota técnica

  • Tablas: llx_bankimport_transaction, llx_bankimport_import, llx_bankimport_match, llx_bankimport_connector.
  • Estándares de Dolibarr respetados: permisos, tokens CSRF, GETPOST, escape.
  • Los secretos de conector están referenciados (nombre de un secreto gestionado fuera del webroot), nunca almacenados en claro.
  • Inalterabilidad: el módulo crea pagos nativos tras validación humana; no modifica ni elimina ningún asiento contable existente, y nunca elimina un pago ya creado.
  • Sin modificación del núcleo de Dolibarr.

Instalación

  1. Descomprima el archivo para obtener una carpeta bankimport/.
  2. Cópiela en htdocs/custom/ de su Dolibarr.
  3. Active el módulo desde Inicio → Configuración → Módulos/Aplicaciones (familia Finanzas).
  4. Abra la configuración y elija una cuenta bancaria y un modo de pago por defecto.

Actualización

  1. Sustituya la carpeta htdocs/custom/bankimport/ por la nueva versión.
  2. Recargue una página de administración: las tablas y constantes que falten se crean automáticamente, de forma idempotente.
  3. La actualización no elimina ningún dato existente.

Resolución de problemas

  • Ninguna línea detectada en la importación CSV: compruebe el separador y la presencia de una cabecera (columnas fecha, concepto, importe, divisa, tercero).
  • Archivo rechazado: se supera el tamaño máximo configurado (BANKIMPORT_IMPORT_MAX_FILESIZE_MB).
  • Ningún candidato: baje la puntuación mínima, aumente el límite de análisis, o compruebe que las facturas estén realmente abiertas.
  • Ningún modo de pago: active al menos un modo de pago en Dolibarr.

Véase también

  • Terminal de firma KSIDol: firma de todas las fichas nativas de Dolibarr, compatible con todos los módulos KSIDol.
  • Compatibilidad: Dolibarr 18.0 a 24.x — PHP 8.0+ — Licencia GPLv3 — Editor: KSIDol.

Resumen

Bank Import importa sus extractos bancarios (CSV, OFX, QIF, CAMT.053, MT940), concilia cada movimiento con sus facturas y documentos abiertos con una puntuación y motivos, y luego crea los pagos nativos de Dolibarr tras validación — sin modificar nunca un movimiento existente ni romper la inalterabilidad.