Importación de Movimientos Bancarios

Una vez conectada una cuenta bancaria, ALTUM ERP importa automáticamente sus movimientos mediante sincronización con Belvo. Esta página explica el proceso de importación y cómo consultar el historial de transacciones.

Cómo funciona la importación

La sincronización ocurre de dos maneras:

1. Automática (diaria a las 6:00 AM): el sistema calcula el rango de fechas desde la última sincronización exitosa y descarga los movimientos nuevos.
2. Manual: desde Banca > Cuentas bancarias > botón Sincronizar, o con Sincronizar todo en la pantalla principal.

En cada sincronización el sistema:

1. Obtiene las transacciones del rango de fechas desde Belvo (paginadas).
2. Filtra sólo las transacciones correspondientes a la cuenta específica (externalAccountId).
3. Deduplica mediante el campo externalId; si un movimiento ya existe, se omite.
4. Clasifica cada movimiento como Crédito (monto ≥ 0) o Débito (monto < 0).
5. Asigna estado de conciliación inicial UNMATCHED (sin conciliar).
6. Actualiza el saldo actual de la cuenta con el balance más reciente de Belvo.

Nota

La primera sincronización de una cuenta nueva recupera un historial de 90 días hacia atrás.

Pantalla de Transacciones

Acceda desde Banca > Transacciones (/banca/transacciones).

La pantalla muestra una tabla paginada con columnas:

Columna	Descripción
Fecha	Fecha valor del movimiento en el banco
Descripción	Texto del banco; ícono verde (entrada) o rojo (salida)
Cuenta	Institución y número de cuenta (últimos 4 dígitos)
Monto	Importe con signo + (crédito) o - (débito)
Estado	Estado de conciliación del movimiento

La tabla muestra 20 movimientos por página con controles de paginación al pie.

Filtros disponibles

Puede combinar los siguientes filtros:

Filtro	Opciones
Buscar	Texto libre sobre descripción o referencia
Cuenta bancaria	Todas o una cuenta específica
Estado de conciliación	Todos / Conciliado / Confirmado / Sin conciliar / Revisión pendiente / Excluido
Fecha desde / hasta	Rango de fechas de valor
Monto mínimo / máximo	Rango de importes

Haga clic en Limpiar filtros para restablecer todos a sus valores predeterminados.

Estados de conciliación

Estado	Significado
Sin conciliar	Movimiento importado, aún no vinculado a ningún registro
Conciliado	Vinculado a un registro del ERP (CFDI, pago, venta u orden de compra)
Confirmado	Vinculado y confirmado manualmente por el usuario
En revisión	El sistema encontró candidatos sugeridos; pendiente de revisión humana
Excluido	El usuario decidió excluirlo del proceso de conciliación

Detalle de un movimiento

Haga clic en cualquier fila de la tabla para abrir el panel de detalle. Muestra:

• Importe en grande con color verde (entrada) o rojo (salida) y moneda
• Fecha del movimiento
• Descripción completa
• Tipo (Crédito / Débito)
• Referencia externa (ID de Belvo, truncado en la tabla)
• Estado de conciliación actual
• Registro vinculado (si ya fue conciliado): tipo de entidad y referencia
• Nombre y número de la cuenta bancaria
• Notas adicionales (si se registraron)

Tipos de entidades vinculables

Al conciliar, un movimiento puede vincularse a los siguientes tipos de registros:

Tipo	Descripción
CFDI	Comprobante fiscal emitido (factura electrónica)
PAGO_CLIENTE	Registro de pago recibido de cliente
VENTA	Venta registrada en el sistema
ORDEN_COMPRA	Orden de compra a proveedor
GASTO	Gasto creado directamente desde el módulo

Log de sincronizaciones

Cada intento de sincronización genera un registro en BankSyncLog con:

• Estado: IN_PROGRESS → SUCCESS o FAILED
• Cantidad de transacciones importadas
• Saldo antes y después
• Mensaje de error (si falló)
• Contador de reintentos

Estos logs están disponibles en la API (endpoint GET /banca/connections/:id/sync-logs) para diagnóstico por parte de administradores.

Reglas y validaciones

• Un movimiento con el mismo externalId no se duplica aunque se sincronice varias veces.
• Si Belvo devuelve un error 401, el sistema actualiza el estado de la conexión a EXPIRED y no reintenta automáticamente; se requiere reautenticación manual.
• Para otros errores de sincronización, el estado de la conexión cambia a ERROR y se registra el mensaje en la tarjeta de la cuenta.
• El saldo actual mostrado en la tarjeta es el último reportado por Belvo, no un cálculo propio.

Casos frecuentes

Los movimientos del día de hoy no aparecen La sincronización automática corre a las 6:00 AM. Sincronice manualmente desde la tarjeta de la cuenta para obtener movimientos más recientes.

Un movimiento aparece duplicado No es posible si el externalId de Belvo es único. Si ve importes similares en fechas iguales, verifique que corresponden a transacciones distintas en el estado de cuenta bancario original.

La búsqueda por descripción no encuentra el movimiento La búsqueda aplica coincidencia parcial sin distinción de mayúsculas/minúsculas en el campo descripción. Pruebe con una parte más corta del texto o use los filtros de fecha y monto para reducir resultados.

El estado de una transacción sigue “Sin conciliar” aunque ya la vinculé Actualice la pantalla (F5). Si persiste, la vinculación pudo no guardarse; abra el detalle y verifique el campo “Vinculado a”.