BCI PyME

BCI PyME es una fuente activa de Nodda. Una conexión a BCI PyME sincroniza saldos de cuenta y movimientos detallados, proyectando sus registros a un formato consultable por API.

Scopes de BCI PyME

Scope	Qué sincroniza
`saldos`	Saldo de cada cuenta (historial de saldos observados)
`movimientos`	Movimientos detallados de la cuenta corriente

Habilítalos al crear la conexión (enabled_scopes) y elígelos al gatillar un sync.

Los movimientos siguen el modelo de movimientos de bancos normalizado, compartido con los demás bancos.

Scope `saldos` — Saldos de cuenta

A diferencia de movimientos (una lista por período), saldos es puntual: cada sync registra el saldo observado en ese momento, conservando el historial de saldos (una observación por cuenta/moneda por sync).

Metadata de sync

El scope saldos no recibe parámetros en metadata. La fecha de observación (observed_at) la registra Nodda al momento de leer el saldo.

Listar saldos (historial)

GET /connections/{id}/bci-balances

Lista el historial de saldos observados, del más reciente al más antiguo y paginado (50 por página por defecto).

Query	Tipo	Notas
`latest`	string	`true` devuelve solo el saldo más reciente por cuenta/moneda (sin paginación)
`currency`	string	filtra por moneda (formato ISO de 3 letras, p. ej. `CLP`, `USD`)
`from`	string	fecha mínima `YYYY-MM-DD` (sobre `observed_at`)
`to`	string	fecha máxima `YYYY-MM-DD` (sobre `observed_at`)
`limit`	number	máximo de registros (por defecto 50, máximo 200)
`offset`	number	registros a omitir para paginar (por defecto 0)

# saldo actual de cada cuenta
curl "https://app.nodda.cl/api/connections/3f1c9e2a-7b44-4d51-9a0e-1c2d3e4f5a6b/bci-balances?latest=true" \
  -H "Authorization: Bearer nodda_sk_tu_token_aqui"

Respuesta (200):

{
  "data": [
    {
      "id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
      "numero_cuenta": "00012345678",
      "currency": "CLP",
      "saldo_contable": "12500000",
      "saldo_disponible": "11800000",
      "saldo_contable_9am": "12500000",
      "retencion": "700000",
      "observed_at": "2026-06-19T14:30:00.000Z"
    }
  ]
}

Con latest=true la respuesta no incluye pagination (es el saldo vigente por cuenta/moneda). Sin latest, la respuesta es el historial paginado e incluye pagination como en los demás endpoints.

Campos de un saldo

Campo	Tipo	Notas
`id`	UUID	identificador en Nodda
`numero_cuenta`	string	número de cuenta
`currency`	string	moneda (`CLP`, `USD`)
`saldo_contable`	string \| null	saldo contable (decimal como string)
`saldo_disponible`	string \| null	saldo disponible (decimal como string)
`saldo_contable_9am`	string \| null	saldo contable a las 9am (decimal como string)
`retencion`	string \| null	montos retenidos (decimal como string)
`observed_at`	datetime	momento en que Nodda observó el saldo (ISO 8601)

Scope `movimientos` — Movimientos detallados

Metadata de sync

Parámetro	Tipo	Notas
`period`	string	`YYYY-MM`. Por defecto el mes actual (America/Santiago).

Listar movimientos

GET /connections/{id}/bci-movements

Lista los movimientos proyectados de una conexión, ordenados por fecha de movimiento descendente y paginados (50 por página por defecto).

Query	Tipo	Notas
`period`	string	período en formato `YYYY-MM`
`from`	string	fecha mínima `YYYY-MM-DD`
`to`	string	fecha máxima `YYYY-MM-DD`
`limit`	number	máximo de registros (por defecto 50, máximo 200)
`offset`	number	registros a omitir para paginar (por defecto 0)
`direction`	string	filtra por `received` o `issued`

curl "https://app.nodda.cl/api/connections/3f1c9e2a-7b44-4d51-9a0e-1c2d3e4f5a6b/bci-movements?period=2026-05" \
  -H "Authorization: Bearer nodda_sk_tu_token_aqui"

Respuesta (200):

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef0123456789",
      "numero_cuenta": "00012345678",
      "period": "2026-05",
      "fecha_movimiento": "2026-05-15T00:00:00.000Z",
      "fecha_contable": "2026-05-15T00:00:00.000Z",
      "descripcion": "Pago proveedor",
      "amount": "-2500000",
      "saldo_contable": "11800000",
      "tipo": "C",
      "mnemonico": "TEF"
    }
  ],
  "pagination": { "total": 68, "limit": 50, "offset": 0, "has_more": true }
}

Campos de un movimiento

Campo	Tipo	Notas
`id`	UUID	identificador en Nodda
`numero_cuenta`	string	número de cuenta
`period`	string	período `YYYY-MM`
`fecha_movimiento`	datetime \| null	fecha del movimiento
`fecha_contable`	datetime \| null	fecha contable
`descripcion`	string \| null	glosa / descripción
`amount`	string \| null	monto con signo (decimal como string); negativo para cargos
`saldo_contable`	string \| null	saldo contable tras el movimiento
`tipo`	string \| null	`C` = cargo (débito) · `A` = abono (crédito)
`mnemonico`	string \| null	código del tipo de operación del banco
`direction`	string \| null	`received` (entrada) o `issued` (salida)
`category`	string \| null	categoría del banco (Transferencias, Pagos, …)
`counterparty_name`	string \| null	nombre de la contraparte
`counterparty_rut`	string \| null	RUT de la contraparte
`counterparty_bank`	string \| null	banco de la contraparte
`counterparty_account`	string \| null	cuenta de la contraparte

Períodos disponibles (movimientos)

GET /connections/{id}/bci-movements/periods

Devuelve la lista de períodos YYYY-MM con al menos un movimiento proyectado.

curl "https://app.nodda.cl/api/connections/3f1c9e2a-7b44-4d51-9a0e-1c2d3e4f5a6b/bci-movements/periods" \
  -H "Authorization: Bearer nodda_sk_tu_token_aqui"

Respuesta (200):

{
  "data": ["2026-05", "2026-04", "2026-03"]
}

On this page