Extracción de estados de cuenta · México

Convierte estados de cuenta de NU México a JSON

TL;DR

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

NU México es neobanco digital. Sus estados PDF son cortos (4-6 hojas) y siguen un layout minimalista. Pueden generarse desde la app con periodo personalizado.

Ver documentación del API

Tipos de cuenta soportados

finO$ procesa los siguientes layouts de NU México:

Cuenta NU Tarjeta de crédito NU

Qué extrae finO$ de un estado de NU México

El schema v5 aplica igual para los 2 tipos de cuenta de NU México. NU México es neobanco digital. Sus estados PDF son cortos (4-6 hojas) y siguen un layout minimalista. Pueden generarse desde la app con periodo personalizado. 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 México en 30 segundos

1. PDF de entrada

Sube el PDF descargado de la banca en línea o app de NU México.

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-mexico-statement.pdf" \
  -F "bank_hint=nu_mx"

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

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

# {
#   "bank": "NU México",
#   "country": "MX",
#   "period": { "start": "2026-04-01", "end": "2026-04-30" },
#   "transactions": [ ... ]
# }

Preguntas sobre extracción de NU México

¿Cuánto cuesta extraer un estado de cuenta de NU México?

El API de finO$ cuesta $5 MXN por hoja procesada. Un estado típico de NU México 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 México?

Sí. finO$ soporta los formatos vigentes (Cuenta NU, Tarjeta de crédito 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 México?

NU México 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.