---
title: "Balances details"
description: "Per entrambi, TPP e FPP, la risposta ottenuta a seguito di una richiesta dei saldi è esattamente la stessa ed è descritta di seguito."
url: "https://docs.fabrick.com/payment-institution/open-banking-and-psd2/pass/products/ais-common/account-info-apis/balances-details/"
language: "it"
---

# Balances details

Per entrambi, **TPP** e **FPP**, la risposta ottenuta a seguito di una richiesta dei saldi è esattamente la stessa ed è descritta di seguito.\
Le API di richiesta variano leggermente; per i dettagli di implementazione è possibile fare riferimento alla documentazione specifica.

Un esempio di risposta è mostrato di seguito:

```json
{
  "status": "OK",
  "payload": {
    "list": [
      {
        "balanceId": "1",
        "userId": "1",
        "bankId": "19",
        "tppUid": "150116",
        "accountId": "35689",
        "amount": {
          "value": 2000.00,
          "currency": "EUR"
        },
        "type": "INTERIM_BOOKED",
        "referenceDate": "2020-08-24T00:00:00.000+0000",
        "retrievedDatetime": "2020-08-24T16:51:16.408+0000",
        "balanceType": "BOOKED",
        "balanceTimePeriod": "INTERIM",
        "balancePriority": 1,
        "bankProfileId": "20523",
        "isCreditLimitIncluded": false,
        "lastChangeDatetime": "2020-08-24T16:51:16.408+0000"
      },
      {
        "balanceId": "2",
        "userId": "1",
        "bankId": "19",
        "tppUid": "150116",
        "accountId": "35689",
        "amount": {
          "value": 17.07,
          "currency": "EUR"
        },
        "type": "INTERIM_AVAILABLE",
        "referenceDate": "2020-08-24T00:00:00.000+0000",
        "retrievedDatetime": "2020-08-24T16:51:16.408+0000",
        "balanceType": "AVAILABLE",
        "balanceTimePeriod": "INTERIM",
        "balancePriority": 1,
        "bankProfileId": "20523",
        "isCreditLimitIncluded": false,
        "lastChangeDatetime": "2020-08-24T16:51:16.408+0000"
      }
    ]
  }
}
```

---

- **balanceId**: ID univoco del saldo
- **userId**: identifica l’utente
- **bankId**: identifica la banca
- **tppUid**: può essere ignorato. Indica l’ID del TPP
- **accountId**: identifica l’account (o *cardId* solo per TPP)
- **amount**: oggetto che contiene il *value* del saldo e la *currency* nella valuta locale
- **amountInEuro**: oggetto che contiene valore e valuta del saldo convertiti in EUR. La conversione è effettuata internamente in tempo reale sulla base dei tassi di cambio correnti
- **exchangeRate**: fattore utilizzato per convertire un importo dalla valuta locale in EUR
- **type**: indica il tipo di saldo. I valori possono differire in base all’ASPSP. Per questo motivo Fabrick espone due campi aggiuntivi per identificare univocamente il saldo: **balanceType** e **balanceTimePeriod**
- **balanceType**: può assumere i valori *Booked* e *Available*
- **balanceTimePeriod**: può assumere i valori *Opening*, *Interim*, *Forward* e *Closing*
- **balancePriority**: parametro che suggerisce una priorità in caso di più tipologie di saldo, facilitando la progettazione della UI. 1 è la priorità più alta

| Remote Bank Balance | Balance Type | Balance Time Period | Priority Suggested by FBK |
| ------------------- | ------------ | ------------------- | ------------------------- |
| INTERIM_AVAILABLE   | AVAILABLE    | INTERIM             | 1                         |
| AUTHORISED          | AVAILABLE    | FORWARD             | 2                         |
| EXPECTED\*          | AVAILABLE    | FORWARD             | 3                         |
| FORWARD_AVAILABLE   | AVAILABLE    | FORWARD             | 4                         |
| INTERIM_BOOKED      | BOOKED       | INTERIM             | 1                         |
| EXPECTED\*          | BOOKED       | FORWARD             | 2                         |
| NON_INVOICED        | BOOKED       | FORWARD             | 3                         |
| CLOSING_BOOKED      | BOOKED       | CLOSING             | 4                         |
| OPENING_BOOKED      | BOOKED       | OPENING             | 5                         |

Il valore Expected varia a seconda dell'ASPSP.

- **bankProfileId**: parametro noto per TPP, può essere ignorato per FPP
- **isCreditLimitIncluded**: flag che indica se il limite di credito (es. fido) è incluso nel calcolo del saldo, ove applicabile
- **referenceDate**: indica la data di riferimento del saldo. Sia nei giorni lavorativi che nei weekend, questo campo contiene la data del saldo, cioè quando l’utente ha effettuato una transazione e/o ha effettuato l’accesso all’home banking. La richiesta di saldo tramite canale PSD2 **non** modifica la data del saldo, ma mostra solo la situazione in quel momento
- **retrievedDatetime**: indica la data e l’ora dell’ultima sincronizzazione con la banca. In caso di refresh impostato a true, coincide con *referenceDate*
- **lastChangeDatetime**: indica la data dell’ultima variazione del saldo

---

## Tipologie di Saldo (PSD2)

- **closingBooked**: saldo del conto alla fine del periodo di rendicontazione concordato. È la somma del saldo contabile iniziale all’inizio del periodo e di tutte le operazioni contabilizzate durante il periodo
- **expected**: saldo composto da operazioni contabilizzate e operazioni pendenti conosciute al momento del calcolo, che proietta il saldo di fine giornata se tutto viene contabilizzato e non vengono registrate ulteriori operazioni
- **openingBooked**: saldo contabile all’inizio del periodo di rendicontazione. Corrisponde sempre al saldo contabile finale del periodo precedente
- **interimAvailable**: saldo disponibile calcolato durante la giornata operativa dell’ASPSP, soggetto a ulteriori variazioni durante la giornata
- **forwardAvailable**: saldo disponibile futuro alla data specificata, ovvero l’importo che sarà a disposizione del titolare del conto in quella data