Devuelve el Needed de runway en vivo para cada caja no eliminada (máx. 30). Con status ready: expectedInAccountToday (apertura) y expectedAfterTodaysBills (cierre). Otros estados sin importes. asOfDate opcional (yyyy-MM-dd, predeterminado hoy UTC) es una reproyección del plan actual, no el historial de Reports — usa get_report para Needed sellado.
GET
/v1/list_box_neededConsulta
| Campo | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| budgetId | string | Sí | — | Presupuesto a evaluar. |
| boxId | string | No | — | Limitar a una caja de gastos. |
| asOfDate | string | No | today (UTC) | Día de calendario yyyy-MM-dd de la proyección. |
Forma de la respuesta: { items }. Importes en la moneda de la caja.
Respuesta data
| Campo | Tipo | Descripción |
|---|---|---|
| items | array | Filas de Needed por caja. |
Campos del elemento
| Campo | Tipo | Descripción |
|---|---|---|
| boxId | string | Id de la caja de gastos. |
| boxName | string | Nombre de la caja de gastos. |
| currency | string | Moneda de la caja. |
| asOfDate | string | Día de proyección yyyy-MM-dd. |
| status | string | ready, undatedExpenses, missingCreditCycleEndDay o noPlannedExpenses. |
| expectedInAccountToday | number | Needed de apertura cuando status ready. |
| expectedAfterTodaysBills | number | Needed de cierre cuando status ready. |
| hasOutflowsToday | boolean | Verdadero cuando hay salidas planificadas en asOfDate. |