Conciliación del Balance de Apertura y Cierre
Dos Formas de Lograrlo
| Enfoque | Endpoint | Cuándo usarlo |
|---|---|---|
| Calcular a partir de Transacciones | GET /accounts/{acct_id}/transactions | Cifras del mismo día / intradía, o cuando necesitas detalle a nivel de transacción |
| Leer valores precalculados | GET /accounts/{acct_id}/daily_balance_history | Conciliación de fin de día, una vez que se ha generado el historial del día |
Calcular Balances a partir de Transacciones
previous_balance, current_balance, amount, credit_debit_type, y transaction_date. Para calcular las cifras de un día:1.
date para un día exacto, o date_gte/date_lte para un rango).2.
transaction_date, ascendentemente.3.
previous_balance de la primera Transacción.4.
current_balance de la última Transacción.5.
amount de todas las Transacciones donde credit_debit_type = credit; el total de débitos es la suma de amount de todas las Transacciones donde credit_debit_type = debit.GET /accounts/acc_hyb36Rp7XS/transactions?date=2025-06-06{
"total_items": 3,
"total_pages": 1,
"is_last_page": true,
"page_items": 3,
"contents": [
{
"id": "trx_a1B2c3D4e5F6",
"type": "col_credit",
"account_id": "acc_hyb36Rp7XS",
"amount": 50000,
"previous_balance": 100000,
"current_balance": 150000,
"currency": "COP",
"credit_debit_type": "credit",
"transaction_date": "2025-06-06T09:15:00Z",
"created_at": "2025-06-06T09:15:01Z",
"metadata": {
"money_movement_id": "mm_g7H8i9J0k1L2",
"description": "Sent from Cobre"
}
},
{
"id": "trx_b2C3d4E5f6G7",
"type": "col_debit",
"account_id": "acc_hyb36Rp7XS",
"amount": -20000,
"previous_balance": 150000,
"current_balance": 130000,
"currency": "COP",
"credit_debit_type": "debit",
"transaction_date": "2025-06-06T14:30:00Z",
"created_at": "2025-06-06T14:30:01Z",
"metadata": {
"money_movement_id": "mm_m3N4o5P6q7R8",
"description": "Sent from Cobre"
}
},
{
"id": "trx_c3D4e5F6g7H8",
"type": "col_cb_credit",
"account_id": "acc_hyb36Rp7XS",
"amount": 150000,
"previous_balance": 130000,
"current_balance": 280000,
"currency": "COP",
"credit_debit_type": "credit",
"transaction_date": "2025-06-06T18:45:00Z",
"created_at": "2025-06-06T18:45:01Z",
"metadata": {
"money_movement_id": "mm_s9T0u1V2w3X4",
"description": "Sent from Cobre"
}
}
]
}100000 (primer previous_balance), balance de cierre = 280000 (último current_balance), total de créditos = 50000 + 150000 = 200000, total de débitos = 20000.balance_de_cierre = balance_de_apertura + total_de_creditos - total_de_debitos — en este ejemplo, 100000 + 200000 - 20000 = 280000.Usar el Historial de Balance Diario en su Lugar
| Campo del Historial de Balance Diario | Equivalente en Transacciones |
|---|---|
initial_balance | previous_balance de la primera Transacción del día |
end_balance | current_balance de la última Transacción del día |
total_credits | Suma de amount donde credit_debit_type = credit |
total_debits | Suma de amount donde credit_debit_type = debit |
balance_date | El día al que aplican las cifras (YYYY-MM-DD) |
offset | Desfase UTC aplicado para determinar los límites del día |
offset es el mismo desfase UTC usado para agrupar transaction_date en días calendario en Obtener las Transacciones de una Cuenta. El Historial de Balance Diario y las Transacciones coinciden en los mismos límites de día, por lo que las cifras calculadas manualmente a partir de las Transacciones para un día determinado siempre coinciden con el objeto de Historial de Balance Diario de ese mismo día.GET /accounts/acc_pW9hRz2Qxv/daily_balance_history?balance_date=2026-08-19{
"total_items": 1,
"total_pages": 1,
"is_last_page": true,
"page_items": 1,
"contents": [
{
"id": "dbh_MpW6uPF9YMAR",
"offset": "-05:00",
"balance_date": "2026-08-19",
"initial_balance": 295500,
"total_credits": 150000000,
"total_debits": 0,
"end_balance": 150295500,
"created_at": "2026-08-20T08:03:03Z",
"updated_at": "2026-08-20T08:03:03Z"
}
]
}295500 + 150000000 - 0 = 150295500. Observa que initial_balance, total_credits, total_debits, y end_balance son numéricos (no strings). Usa este endpoint directamente en lugar de recalcular los totales a partir de las Transacciones, y recurre a las Transacciones solo cuando necesites detalle a nivel de transacción o cifras del mismo día.Acciones Permitidas en la Conciliación de Balance
🔍 Consulta — Transacciones
🔍 Consulta — Historial de Balance Diario
Descripción: Recupera cada Transacción de una cuenta, incluyendo Qué esperar después de la acción: Una lista paginada de Transacciones filtrable por fecha, 📘 Más información:
previous_balance y current_balance, para calcular tú mismo los balances de apertura/cierre.credit_debit_type, tipo y monto.Cómo Empezar
Decide entre conciliación del mismo día o de fin de día
Usa Transacciones para cifras del mismo día o intradía; usa el Historial de Balance Diario una vez que se haya generado el objeto del día (al menos 5 horas después del fin del día).
Acota tu consulta al día objetivo
Usa
date / date_gte / date_lte en Transacciones, o balance_date / balance_date_gte / balance_date_lte en el Historial de Balance Diario.Pagina a través de todos los resultados antes de calcular totales a partir de Transacciones
Un día con alta actividad puede abarcar varias páginas — no calcules los balances de apertura/cierre a partir de un conjunto de resultados parcial.
Qué Esperar Después de Usar esta API
Los balances de apertura y cierre se validan de dos formas
Las cifras calculadas manualmente a partir de Transacciones coinciden con el objeto de Historial de Balance Diario precalculado para el mismo día.
Los totales diarios se concilian contra tu propia contabilidad
total_credits y total_debits por día te dan un punto de control independiente de la conciliación de Movimientos de Dinero individuales.Las discrepancias se aíslan a un día y una cuenta específicos
Cualquier discrepancia se acota a un solo
account_id y balance_date que puedes investigar a nivel de Transacción.Modified at 2026-08-21 01:07:20