> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lapyme.com.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# Tesorería

> Consultá cuentas bancarias, saldos y movimientos contables desde una integración.

La API de tesorería es de solo lectura. Sirve para resolver los IDs de cuentas
bancarias que usan otros recursos, consultar saldos y recorrer movimientos sin
abrir el dashboard. La creación y administración de cuentas bancarias continúa
en la interfaz de La Pyme y en los procesos de migración.

Los cuatro endpoints requieren `treasury:read`:

* `GET /api/v1/bank-accounts`
* `GET /api/v1/bank-accounts/{bank_account_id}`
* `GET /api/v1/treasury/balances`
* `GET /api/v1/treasury/movements`

## Cuentas bancarias

La colección y el detalle devuelven configuración segura como banco, nombre,
moneda, CBU, alias, uso de chequera y estado. No exponen el ID de la cuenta
contable vinculada, la organización, actores internos ni un saldo calculado.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.lapyme.com.ar/api/v1/bank-accounts?status=active&currency=PES" \
    -H "Authorization: Bearer $LAPYME_API_KEY"
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch(
    "https://api.lapyme.com.ar/api/v1/bank-accounts?status=active&currency=PES",
    { headers: { Authorization: `Bearer ${process.env.LAPYME_API_KEY}` } }
  );

  const bankAccounts = await response.json();
  ```

  ```python Python theme={null}
  import os, requests

  bank_accounts = requests.get(
      "https://api.lapyme.com.ar/api/v1/bank-accounts",
      headers={"Authorization": f"Bearer {os.environ['LAPYME_API_KEY']}"},
      params={"status": "active", "currency": "PES"},
  ).json()
  ```
</CodeGroup>

Las referencias incluyen cuentas `PES` y `DOL`. Esta distinción no implica que
la API ya publique saldos DOL: los endpoints financieros de esta primera versión
son exclusivamente PES.

## Saldos

`GET /api/v1/treasury/balances` devuelve cuentas bancarias, cajas registradoras
y cajas fuertes visibles denominadas en PES. Podés filtrar por `balance_type`,
`balance_id`, `status` y `as_of`.

Los importes son enteros en unidades menores de la moneda indicada. Por ejemplo,
`125000` representa ARS 1.250,00. El saldo se calcula sumando todos los efectos
funcionales del diario contable de la fuente PES, incluso cuando la transacción
original fue ingresada en moneda extranjera. No se lee desde un campo manual
mutable.

Las fuentes denominadas en DOL no aparecen en saldos ni movimientos todavía.
La Pyme necesita preservar por separado el importe nativo USD y su importe
contable ARS antes de publicar esa proyección; etiquetar un débito contable ARS
como si fueran centavos USD produciría un saldo incorrecto.

`visibility_scope` informa si la respuesta representa toda la organización o
solo hechos propios del usuario delegado:

* `organization`: proyección organizacional permitida.
* `own`: suma limitada a movimientos creados por el usuario delegado.

## Movimientos

`GET /api/v1/treasury/movements` devuelve un ledger inmutable y paginado. Los
filtros disponibles son `balance_type`, `balance_id`, `movement_type`,
`date_from` y `date_to`.

Un `amount` positivo aumenta el saldo y uno negativo lo reduce. En esta versión,
`currency` siempre es `PES` y `amount` representa el efecto funcional ARS.
`occurred_on` es la fecha operativa; `created_at` es el timestamp real de
persistencia. El `id` identifica la línea durable del movimiento y puede
guardarse para deduplicación local.

La respuesta no incluye débitos/créditos internos, IDs del plan de cuentas ni
una operación para editar movimientos. Las correcciones financieras se
representan mediante hechos contables explícitos en La Pyme.

## Paginación y sincronización

Las tres colecciones usan `cursor` y `limit`. Guardá `next_cursor` y repetí la
misma consulta mientras `has_more` sea `true`. Consultar estos endpoints no
produce efectos ni requiere `Idempotency-Key`.

La API no agrega eventos webhook de tesorería. Para una sincronización periódica,
consultá saldos o movimientos con los filtros de fecha y cursor adecuados.