🏛️🔐 Treasury Accounts
Saldos, movimientos y estados de cuenta en un solo lugar
Qué me ofrece el API de Accounts
Con el API de cuentas tienes la información centralizada de múltiples cuentas en múltiples bancos. En particular puedes obtener:
-
Saldos. Parece simple, pero existen distintos saldos según si es dinero que se puede usar o no (ej: dinero que entra vía cheques no siempre queda disponible para usar inmediatamente). También hay distintos grados de certeza de un saldo. El saldo de un estado de cuenta está cuadrado y ha sido oficializado por un banco. El saldo de una cuenta en tiempo real es una "foto" que en ciertas situaciones debe ser corregido por el banco dependiendo de lo que haya ocurrido en el día (ej: reversas no contabilizadas correctamente).
-
Estados de cuenta y sus movimientos. Los estados de cuenta son la fuente de la verdad. Son los documentos oficiales que emite un banco con todos los movimientos de una cuenta en el pasado. Lo malo es eso, que siempre se trata del pasado, a veces incluso del mes anterior. Aunque varios clientes de Shinkansen usan estados de cuenta diarios para facilitarse la vida (pues Shinkansen soporta estados de cuenta diario sin problemas).
-
Reportes de cuenta y sus movimientos. Son como los estados de cuenta, pero provisorios mientras todavía no sale el siguiente estado de cuenta mensual o diario.
Cómo obtengo el saldo de una cuenta
Es de los endpoints mas sencillos de todo Shinkansen. Accedes vía https://api.treasury.shinkansen.finance/v1/accounts/{fin_id}/{account}/balances/latest
(donde fin_id
es el identificador en shinkansen de tu banco y account
es el número de cuenta). Shinkansen te responderá con los saldos contables en los distintos "sabores" de saldos que pueden haber (snapshot
para la "foto" actual, end_of_booking_day
para el saldo del dia contable anterior que es prácticamente imposible que cambie, y end_of_statement
para el ultimo saldo del último estado de cuenta que sabemos que jamás cambiará).
Cómo obtengo un estado o un reporte de cuenta con sus movimientos
Fácil. Primero tienes que saber el reporte o estado de cuenta para el cual querrás obtener los movimientos
Y luego, puedes usar esa información para obtener los movimientos ("entries"):
Y si el último reporte no es reciente y no tiene los movimientos que necesito?
Pues necesitamos que el banco nos envíe un reporte actualizado. Afortunadamente, Shinkansen Treasury está construido por sobre la infraestructura de Shinkansen Core. Y en Shinkansen Core tenemos endpoints que te permiten solicitarle al banco que genere un reporte nuevo:
Updated 5 months ago