View source for Importación bancaria y conciliación para Dolibarr

[[Category:Complementary modules]]
[[Category:K.S.I]]
[[Category:Financial]]
[[Category:Interface]]

{{TemplateDocDev}}
{{TemplateDocUtil}}

<div style="border:1px solid #d7e3f4; border-radius:14px; padding:22px; margin:12px 0 22px 0; background:linear-gradient(135deg,#f6faff,#ffffff); box-shadow:0 2px 10px rgba(20,60,110,0.08);">
  <div style="font-size:28px; font-weight:700; color:#17365d; margin-bottom:8px;">Bank Import para Dolibarr</div>
  <div style="font-size:18px; color:#345; margin-bottom:14px;">Importe sus extractos bancarios, obtenga coincidencias puntuadas con sus facturas y cree los pagos nativos de Dolibarr — tras validación humana</div>
  <div style="display:flex; flex-wrap:wrap; gap:8px; margin-top:10px;">
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Importación multiformato</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Conciliación bancaria</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Coincidencias puntuadas</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Pagos nativos</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Validación humana</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Antiduplicados</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">CSV · OFX · QIF · CAMT.053 · MT940</span>
  </div>
</div>

== 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 ==

{| class="wikitable" style="width:100%; border-collapse:collapse;"
! style="width:24%; background:#f0f6ff;" | Elemento
! style="background:#f0f6ff;" | 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 ==

{| class="wikitable" style="width:100%;"
! style="width:24%; background:#f7f7f7;" | Información
! style="background:#f7f7f7;" | 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 ==
* Vídeo de demostración : [https://youtu.be/zm1yBnvbWJg Bank Import — demo (YouTube)]
* Ficha del módulo : [https://www.ksidol.io/es/modules/detail?module=main_module_bankimport Bank Import en KSIDol]
* Demostración en línea : [https://www.ksidol.io/t/demo-erp/custom/bankimport/index.php?mainmenu=bank&leftmenu=bankimport Bank Import — abrir la demo]
* Manual del módulo : [https://www.ksidol.io/notices/ksidol_notice_es/bankimport.html Bank Import — consultar el manual]
* Página del editor K.S.I en DoliStore: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= Módulos K.S.I en DoliStore]

== 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 (<code>BANKIMPORT_DEFAULT_BANK_ACCOUNT_ID</code>);
* modo de pago por defecto (<code>BANKIMPORT_DEFAULT_PAYMENT_MODE_ID</code>);
* tolerancia de importe (<code>BANKIMPORT_AMOUNT_TOLERANCE</code>, por defecto 0,02);
* puntuación «candidato fuerte» (<code>BANKIMPORT_AUTO_APPROVE_SCORE</code>, por defecto 90);
* puntuación mínima de coincidencia (<code>BANKIMPORT_MATCH_MIN_SCORE</code>, por defecto 40);
* número máx. de facturas analizadas por transacción (<code>BANKIMPORT_MATCH_SCAN_LIMIT</code>, por defecto 1000);
* candidatos máx. por transacción (<code>BANKIMPORT_MATCH_TOP_PER_TRANSACTION</code>, por defecto 10);
* tamaño máximo de un archivo importado (<code>BANKIMPORT_IMPORT_MAX_FILESIZE_MB</code>, 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 ==

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

== Nota técnica ==

* Tablas: <code>llx_bankimport_transaction</code>, <code>llx_bankimport_import</code>, <code>llx_bankimport_match</code>, <code>llx_bankimport_connector</code>.
* Estándares de Dolibarr respetados: permisos, tokens CSRF, <code>GETPOST</code>, 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 ==

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

== Actualización ==

# Sustituya la carpeta <code>htdocs/custom/bankimport/</code> por la nueva versión.
# Recargue una página de administración: las tablas y constantes que falten se crean automáticamente, de forma idempotente.
# 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 (<code>BANKIMPORT_IMPORT_MAX_FILESIZE_MB</code>).
* '''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.