Extracción de estados de cuenta · Colombia

Convierte estados de cuenta de Nu Colombia a JSON

TL;DR

finO$ extrae transacciones, saldos, conceptos y categorías de estados de cuenta de Nu Colombia en JSON estructurado. Pricing: $5 MXN por hoja. Un estado típico de 4 hojas cuesta $20 MXN. Soporta tarjeta nu, cuenta nu.

Nu Colombia es la operación local del neobanco Nubank. Estados PDF cortos generados desde la app, con categorización propia de Nu.

Ver documentación del API

Tipos de cuenta soportados

finO$ procesa los siguientes layouts de Nu Colombia:

Tarjeta Nu Cuenta Nu

Qué extrae finO$ de un estado de Nu Colombia

El schema v5 aplica igual para los 2 tipos de cuenta de Nu Colombia. Nu Colombia es la operación local del neobanco Nubank. Estados PDF cortos generados desde la app, con categorización propia de Nu. El JSON resultante tiene la misma estructura que para cualquier otro banco soportado.

Identidad del banco y cuenta

bank_name

Nombre raw como aparece en el PDF (con sufijos legales).

string

bank_canonical_name

Brand reconocible (BBVA, Rappi, Nu, DólarApp).

string

account_number

Número de cuenta, tarjeta enmascarada o CLABE.

string

account_type

debit · credit · null

enum

Saldos

Cada uno con amount + ISO 4217

opening_balance

Saldo inicial del periodo.

currency

closing_balance

Saldo al corte.

currency

average_balance

Saldo promedio (solo débito; null en CC).

currency

Resumen del periodo

total_commissions

Comisiones cobradas totales.

currency

statement_period_start

Inicio del periodo.

date

statement_period_end

Fin del periodo.

date

Titular

account_holder_name

Nombre del titular.

string

account_holder_rfc

RFC (12-13 caracteres).

string

account_holder_address

Dirección registrada.

string

transactions[]

14 campos por movimiento

Cada movimiento del periodo. Las líneas tipo "AMAZON A MESES 2/12" van al array de meses sin intereses, NO aquí — solo la compra original aparece como transaction.

day

Día del mes.

number 1-31

month

Mes; el año se deriva de statement_period_start.

number 1-12

description

Texto verbatim como sale en el PDF.

string

transaction_concept

Versión normalizada del concepto.

string

counterparty_name

Beneficiario o comercio del otro lado.

string

counterparty_rfc

RFC de la contraparte (común en SPEI).

string

merchant_canonical_name

Marca limpia: "Uber Eats", "Amazon", "OXXO" (null si no aplica).

string

amount

Magnitud SIEMPRE positiva.

post-v3 schema fix

number ≥ 0

currency

MXN, USD, EUR…

ISO 4217

transaction_type

DEBIT (inflow) · CHARGE (outflow).

enum

direction

inflow · outflow.

Señal redundante para detectar discrepancias.

enum

channel

SPEI · card · cash · check · direct_debit · internal_transfer · interest · fee · other.

enum

category

food · transport · shopping · bills · entertainment · healthcare · travel · fees · income · transfer · cash · savings_investment · taxes · other.

enum

kind_hint

expense · income · internal_transfer_likely · refund_likely · cashback_likely.

enum

is_recurring_likely

True para Netflix, CFE, nómina, MSI, suscripciones SaaS.

boolean

zero_interest_installments[]

8 campos por plan MSI

Planes de meses sin intereses activos. Cada uno se rastrea por separado para evitar inflar el flujo del periodo con cuotas.

description

"AMAZON A MESES", "AVIANCA", "BEST BUY".

string

purchase_date

Fecha de la compra original.

date

original_amount

Total de la compra antes de partirla.

currency

current_payment_number

Cuál de las cuotas se está pagando este corte.

number

total_payments_number

Cuotas totales del plan (3, 6, 12, 18, 24…).

number

monthly_installment

Mensualidad fija.

currency

interest_rate

% anual (0 para MSI puro).

number

pending_amount

Saldo aún por pagar en cuotas futuras.

currency

Ver el schema completo y ejemplo de response en /api/#data-structure

Ejemplo: Nu Colombia en 30 segundos

1. PDF de entrada

Sube el PDF descargado de la banca en línea o app de Nu Colombia.

2. Procesamiento

finO$ extrae transacciones, saldos, conceptos. ~15s típico.

3. JSON estructurado

Listo para tu API contable, ERP o motor de scoring.

Ejemplo · curl

curl -X POST https://api.getfinos.com/v1/upload \
  -H "Authorization: Bearer $FINOS_API_KEY" \
  -F "file=@nu-colombia-statement.pdf" \
  -F "bank_hint=nu_co"

# {"job_id": "job_abc123", "status": "processing"}

curl https://api.getfinos.com/v1/extractions/job_abc123 \
  -H "Authorization: Bearer $FINOS_API_KEY"

# {
#   "bank": "Nu Colombia",
#   "country": "CO",
#   "period": { "start": "2026-04-01", "end": "2026-04-30" },
#   "transactions": [ ... ]
# }

Otros bancos en Colombia

finO$ soporta los principales bancos de Colombia:

Bancolombia Davivienda BBVA Colombia Banco de Bogotá Banco Popular Banco Caja Social Ver todos los bancos →

Preguntas sobre extracción de Nu Colombia

¿Cuánto cuesta extraer un estado de cuenta de Nu Colombia?

El API de finO$ cuesta $5 MXN por hoja procesada. Un estado típico de Nu Colombia tiene alrededor de 4 hojas, lo que da un costo aproximado de $20 MXN por estado. Sin suscripción mínima.

¿finO$ soporta el formato actual de PDF de Nu Colombia?

Sí. finO$ soporta los formatos vigentes (Tarjeta Nu, Cuenta Nu) incluyendo los layouts actualizados en 2025. Si encuentras un formato no soportado, lo agregamos en 48-72 horas con una muestra anonimizada.

¿Funciona con PDFs escaneados de Nu Colombia?

Nu Colombia típicamente exporta PDFs nativos desde su app/web, no requiere OCR. Si recibes un screenshot impreso de la app, finO$ aplica OCR automático.

¿Puedo categorizar las transacciones automáticamente?

Sí. finO$ aplica auto-categorización basada en patrones de comerciantes locales y NLP en español. La taxonomía es ajustable y compatible con el catálogo SAT (México), DIAN (Colombia), AFIP (Argentina), SII (Chile) y SUNAT (Perú) según corresponda.