Skip to main content
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.
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.