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:

{
  "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

Tipologie di Saldo (PSD2)​

Tipologie di Saldo (PSD2)