Importación automática desde tu banco
Conecta tu banco con un script y deja que los movimientos lleguen solos
Para qué sirve
Para que los movimientos de tu banco lleguen a Cuéntamo sin que tengas que descargar ficheros ni subirlos a mano. Un script externo se encarga de leer los movimientos del banco y enviarlos a Cuéntamo a través de su API pública. Tú solo configuras el script una vez y, a partir de ahí, tus cuentas se actualizan solas.
Cómo funciona
Cuéntamo no se conecta directamente a ningún banco ni almacena tus credenciales bancarias. La conexión funciona al revés:
- Tú obtienes (o generas con ayuda de una IA) un script que se ejecuta en tu propio ordenador.
- Ese script accede a tu banca online y extrae los movimientos recientes.
- El script los envía a Cuéntamo a través de la API de importación.
- Cuéntamo los pasa por el mismo motor que la importación bancaria manual: detecta duplicados, empareja con tus movimientos previstos (recurrentes), aplica las reglas de categorización que ya has enseñado y crea lo que sea nuevo.
Toda la parte bancaria la gestiona el script en tu equipo. Cuéntamo solo recibe el resultado final: los movimientos ya procesados. Y como usa el mismo pipeline que la importación manual, cada vez categoriza mejor: las reglas que aprendes con una importación manual sirven también para la automática, y viceversa.
El endpoint de importación
El script envía los movimientos a POST /api/v1/bank-imports/push con un JSON así:
{
"accountRef": "7890",
"transactions": [
{ "date": "2026-04-01", "concept": "MERCADONA", "amount": -45.80, "reference": "SEPA-20260401-001" },
{ "date": "2026-04-02", "concept": "NOMINA EMPRESA", "amount": 1850.00, "reference": "SEPA-20260402-002" }
],
"autoApply": "matched"
}En lugar de accountRef puedes usar accountId con el UUID de la cuenta. Con accountRef, Cuéntamo busca la cuenta cuya referencia bancaria (configurable en cada cuenta) coincida parcialmente con el valor que envías — por ejemplo, los últimos dígitos del IBAN o del número de tarjeta.
El campo reference es el identificador único de la transacción en tu banco (referencia SEPA, ID interno, etc.). Inclúyelo siempre que sea posible: Cuéntamo lo usa para evitar duplicados aunque ejecutes el script varias veces.
Con autoApply: "matched" (recomendado para scripts automáticos), Cuéntamo solo aplica los movimientos que reconoce con confianza. Los que no reconoce se guardan como pendientes: la próxima vez que abras la app verás un aviso para revisarlos. Al revisarlos puedes crear reglas de categorización que harán que la próxima importación los reconozca automáticamente.
También puedes usar autoApply: true para que se aplique todo sin dejar pendientes, o autoApply: false para revisión completa desde el script.
La referencia completa de la API está en la documentación de la API.
Autenticación
La autenticación se hace con un Token de acceso personal (PAT). Lo generas desde Configuración → Tokens de API. El token tiene el formato cmo_… y se envía en la cabecera Authorization: Bearer cmo_tu_token. Solo se muestra una vez al crearlo, así que guárdalo en un lugar seguro.
Nota: la API pública y los tokens de acceso solo están disponibles para usuarios con suscripción Cuéntamo Más.
Cómo obtener un script con IA
No hace falta que sepas programar. Puedes pedirle a Claude, ChatGPT o cualquier otra IA que te genere un script personalizado para tu banco. Copia este prompt, cambia el nombre del banco y el país por los tuyos, y pégalo en la IA que prefieras:
Escribe un script en Python que descargue mis movimientos bancarios recientes y los importe a Cuéntamo. Primero, lee la especificación OpenAPI de Cuéntamo en https://cuentamo.com/api/docs/openapi.json para conocer los endpoints disponibles y sus parámetros. La documentación legible está en https://cuentamo.com/api/docs. Necesito importar movimientos de todas mis cuentas: cuentas corrientes, cuentas de ahorro, depósitos y tarjetas de crédito. Ten en cuenta que la normativa europea PSD2 (open banking) solo cubre cuentas de pago (corrientes), pero NO incluye cuentas de ahorro, depósitos, tarjetas de crédito ni otros productos. Por eso necesito un script que acceda directamente a mi banca online y extraiga los movimientos de TODOS los productos, no solo los cubiertos por PSD2. El script debe: 1. Conectarse a mi banca online de [nombre de tu banco] ([país]) y obtener los movimientos recientes de todas las cuentas y tarjetas. 2. Para cada cuenta o tarjeta del banco, enviar los movimientos a Cuéntamo usando el endpoint bank-imports/push con autoApply: "matched". Para identificar la cuenta destino en Cuéntamo, usa el campo accountRef con el IBAN o número de tarjeta del banco — Cuéntamo emparejará automáticamente con la cuenta que tenga una referencia bancaria coincidente (puede ser parcial, como los últimos 4 dígitos). 3. Cada movimiento debe incluir un campo reference con el identificador único de la transacción en el banco (referencia SEPA, ID interno, etc.). Esto permite ejecutar el script varias veces sin crear duplicados. 4. Con autoApply: "matched", los movimientos que Cuéntamo no reconozca se guardarán como pendientes para que yo los revise manualmente desde la app. No es necesario que el script gestione los movimientos no reconocidos. El script debe leer el token de Cuéntamo (cmo_...) y el ID del libro de cuentas desde variables de entorno, NUNCA hardcodeados en el código. Lo mismo para las credenciales de acceso al banco. Mi banco es [nombre del banco] en [país].
La IA te devolverá un script listo para ejecutar. Revísalo antes de correrlo: asegúrate de que entiende el formato de tu banco y de que los campos coinciden con lo que Cuéntamo espera.
⚠ No pegues nunca tu token de Cuéntamo ni tus credenciales bancarias en el prompt de la IA. El script debe leerlos desde variables de entorno.
Aviso importante
La conexión con el banco la gestiona el script que ejecutas tú. Cuéntamo no se conecta directamente a ningún banco, no almacena credenciales bancarias y no es responsable del funcionamiento del script ni de la disponibilidad de la API de tu banco. Tú tienes el control total de la conexión.
Trucos
- Programa el script para que se ejecute cada día con una tarea programada (cron en Linux/Mac, Programador de tareas en Windows). Así no tienes ni que acordarte.
- No te preocupes por los duplicados: Cuéntamo detecta automáticamente los movimientos que ya tienes registrados y los descarta. Puedes ejecutar el script varias veces sin miedo.
- Cuanto más uses la importación bancaria (manual o automática), mejor categoriza. Las reglas que enseñas a Cuéntamo en una importación manual se aplican igual a la automática.
- Si tienes movimientos recurrentes bien configurados (hipoteca, nómina, suscripciones…), la importación automática los reconoce y confirma como reales. No crea duplicados.
- Guarda las credenciales del banco en variables de entorno o en un fichero aparte, nunca directamente en el código del script.
¿Listo para probarlo?
Pon en marcha tu previsión de saldo en unos minutos. Gratis.
Crear cuenta gratis