Renvoie le Needed de piste live pour chaque boîte non supprimée (max 30). Si status est ready : expectedInAccountToday (ouverture, bills du jour inclus) et expectedAfterTodaysBills (fermeture). Autres statuts sans montants. asOfDate optionnel (yyyy-MM-dd, défaut aujourd’hui UTC) = reprojection du plan actuel, pas l’historique Reports — utiliser get_report pour le Needed tamponné.
GET
/v1/list_box_neededRequête
| Champ | Type | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
| budgetId | string | Oui | — | Budget à évaluer. |
| boxId | string | Non | — | Limiter à une boîte de dépenses. |
| asOfDate | string | Non | today (UTC) | Jour calendaire yyyy-MM-dd pour la projection. |
Forme de réponse : { items }. Montants dans la devise de la boîte.
Réponse data
| Champ | Type | Description |
|---|---|---|
| items | array | Lignes de Needed par boîte. |
Champs des éléments
| Champ | Type | Description |
|---|---|---|
| boxId | string | Id de la boîte de dépenses. |
| boxName | string | Nom de la boîte de dépenses. |
| currency | string | Devise de la boîte. |
| asOfDate | string | Jour de projection yyyy-MM-dd. |
| status | string | ready, undatedExpenses, missingCreditCycleEndDay ou noPlannedExpenses. |
| expectedInAccountToday | number | Needed d’ouverture si status ready. |
| expectedAfterTodaysBills | number | Needed de fermeture si status ready. |
| hasOutflowsToday | boolean | Vrai s’il y a des sorties prévues le asOfDate. |