Connessioni bancarie

Questa guida descrive la connessione in tempo reale a una banca (open banking PSD2): come effettuare il collegamento, come associare i conti della banca al libro mastro, come fare in modo che ogni sincronizzazione crei anagrafiche, riconcilii le fatture e registri gli oneri tramite un modello di importazione, e cosa restituisce la sincronizzazione. I dettagli dell'API sono disponibili in Importazioni da banche e pagamenti. Se si preferisce utilizzare file di estratto conto anziché una connessione in tempo reale, consultare Importazione di estratti conto bancari (camt.053).

1. Connettersi alla banca

In Banca → Connessioni, seleziona il paese e premi Mostra banche. Scegli la tua banca e il tipo di titolare del conto (azienda o privato), quindi premi Connetti. Verrai reindirizzato alla pagina di consenso della banca, dove potrai effettuare l'accesso e approvare l'accesso; la banca ti riporterà quindi su Nordlet. La connessione apparirà nell'elenco con la relativa data di scadenza del consenso. I consentono hanno una durata limitata stabilita dalla banca (solitamente 90 o 180 giorni); quando uno di essi scade, è necessario ripetere la connessione.

L'elenco delle banche proviene dal provider di open banking configurato per l'istanza di Nordlet. Se per il paese non vengono visualizzate banche, significa che il provider non copre ancora quell'area geografica.

2. Associare i conti della banca

Sotto la connessione, ciascun conto esposto dalla banca viene elencato con il relativo IBAN e valuta. Per ognuno di essi, seleziona un conto bancario esistente dal libro mastro oppure Crea un nuovo conto bancario, imposta facoltativamente la data a partire dalla quale avviare la sincronizzazione e premi Associa. Vengono sincronizzati solo i conti associati. Senza una data di inizio sincronizzazione, la prima sincronizzazione recupererà gli ultimi 90 giorni.

3. Creare il modello di importazione

In Banca → Modelli di importazione, premi Nuovo modello di importazione, seleziona il tipo Connessione bancaria e assegna un nome. Le righe rappresentano gli attributi restituiti dal feed bancario per ogni transazione. La casella Obbligatorio nel file viene mantenuta per completezza; un feed in tempo reale non viene convalidato rispetto a essa.

Conto del libro mastro. La riga dell'importo semplice transaction_amount.amount e le righe delle regole possono essere assegnate a un conto del libro mastro; ogni transazione sincronizzata prodotta da una riga assegnata viene registrata immediatamente e contrassegnata come riconciliata con la registrazione di prima nota. Le righe delle regole selezionano le transazioni in base al codice della transazione bancaria o alla direzione:

Riga	Seleziona	Conto tipico
Oneri bancari (codice CHRG)	transazioni la cui famiglia di codici è CHRG	costo per commissioni bancarie (6800 nel piano dei conti standard)
Interessi (codice INTR)	famiglia di codici INTR	proventi o oneri finanziari
Toste e imposte (codice TAXE)	famiglia di codici TAXE	pagamenti di tasse
Altre uscite di denaro	qualsiasi altro addebito	lasciare "Non registrato" affinché i pagamenti vengano riconciliati con le fatture d'acquisto
Altre entrate di denaro	qualsiasi altro accredito	lasciare "Non registrato" affinché gli incassi vengano riconciliati con le fatture di vendita
transaction_amount.amount	qualsiasi transazione non intercettata da regole	solitamente "Non registrato"

Una transazione viene registrata nel conto della prima riga che soddisfa: prima la famiglia di codici, poi la direzione e infine la riga dell'importo semplice. Il codice proviene dal campo bank_transaction_code della banca; le banche che non ne inviano alcuno lasciano le righe dei codici senza corrispondenze.

Crea clienti o fornitori mancanti. Spunta Crea clienti mancanti sulla riga debtor.name per creare un cliente per ogni pagatore sconosciuto di denaro in entrata, e Crea fornitori mancanti sulla riga creditor.name per ogni beneficiario sconosciuto di denaro in uscita. Le anagrafiche vengono riconosciute tramite l'IBAN (debtor_account.iban / creditor_account.iban, memorizzato sui conti bancari dell'anagrafica), quindi tramite il nome esatto; a un'anagrafica trovata tramite nome viene aggiunto l'IBAN. Una nuova anagrafica è un'azienda se il suo nome contiene una forma giuridica (S.r.l., S.p.A., UAB, MB, SIA, GmbH, Ltd, …) e una persona fisica in caso contrario.

Crea anagrafica per la banca. Spunta questa opzione sulla riga della regola Oneri bancari. La sincronizzazione crea un fornitore denominato con il nome della banca connessa e registra ogni onere in prima nota associandolo a tale anagrafica.

Collega fatture tramite questo campo. Spunta questa opzione sulla riga remittance_information o reference_number. Ogni nuova transazione il cui testo della causale o il cui riferimento contiene il numero di una fattura di vendita emessa aperta (denaro in entrata) o di una fattura d'acquisto registrata (denaro in uscita) viene riconciliata con essa e il pagamento viene registrato. Quando il pagatore è un'anagrafica nota, tramite un IBAN salvato oppure tramite il nome o codice esatto dell'anagrafica, la fattura deve appartenere a tale anagrafica. Un pagamento proveniente da un pagatore sconosciuto viene riconciliato solo se corrisponde esattamente al saldo residuo e il numero della fattura include il prefisso della sua serie. Un pagamento superiore al saldo residuo non viene mai riconciliato. Le transazioni che non superano questi controlli rimangono non riconciliate affinché tu possa abbinarle manualmente. L'opzione Crea fatture di acconto per incassi in entrata non riconciliati trasforma un incasso non riconciliato proveniente da un'anagrafica nota in una fattura di acconto emessa per l'importo corrispondente, datata alla data del pagamento, con l'aliquota IVA specificata o con l'articolo di catalogo selezionato; richiede l'attivazione di Crea clienti mancanti affinché l'anagrafica sia nota.

Salva il modello.

4. Applicare il modello e scegliere la pianificazione

Tornando in Banca → Connessioni, ogni conto associato dispone di un menu a tendina per la selezione del modello e di uno per la pianificazione. Scegli il modello, seleziona Sincronizza manualmente, Sincronizza giornalmente, Sincronizza settimanalmente o Sincronizza mensilmente e premi Applica. Un conto associato sprovvisto di modello si sincronizza comunque, ma si limita a registrare le transazioni; non viene registrato, riconciliato o creato nient'altro.

Con una pianificazione giornaliera, settimanale o mensile, l'API sincronizza il conto autonomamente: una volta all'ora verifica quali conti hanno un'ultima sincronizzazione antecedente al loro periodo di riferimento (24 ore, 7 giorni o 30 giorni) e li sincronizza esattamente come farebbe un comando Sincronizza ora, eseguendo successivamente il modello. Una sincronizzazione pianificata concorre al consumo dell'utilizzo al pari di una sincronizzazione manuale (ogni 10 transazioni recuperate equivalgono a una richiesta). Se la banca rifiuta la sincronizzazione, ad esempio a causa della scadenza del consenso, la connessione viene contrassegnata con l'errore e saltata fino a una nuova connessione.

5. Sincronizzazione

Premi Sincronizza ora sulla connessione. Nordlet recupera le nuove transazioni contabilizzate per ogni conto associato; le transazioni in sospeso vengono saltate finché la banca non le contabilizza. Il sistema le recupera (a partire dall'ultima sincronizzazione, con una sovrapposizione di una settimana per evitare di perdere registrazioni tardive), le registra una sola volta - le transazioni vengono riconosciute tramite il riferimento di registrazione della banca - ed esegue quindi il modello del conto. La riga di risultato riporta il numero di transazioni importate e il numero di quelle già esistenti; tramite l'API, la sincronizzazione restituisce inoltre il numero di movimenti registrati, anagrafiche create, fatture collegate e create, pagamenti riconciliati e avvisi relativi ai pagamenti che non è stato possibile riconciliare.

Le sincronizzazioni possono essere attivate dall'API (bank/feeds/sync) su base pianificata; ogni 10 transazioni recuperate equivale a una richiesta API.

6. Dove verificare in seguito

• Banca → Transazioni - ogni transazione sincronizzata, suddivisa nelle schede per conto; quelle riconciliate contengono il collegamento alla fattura o alla registrazione di prima nota.
• Fatture - fatture di acconto create per gli incassi non riconciliati.
• Anagrafiche - clienti e fornitori creati, ciascuno con il relativo IBAN memorizzato nei conti bancari.
• Libro mastro → Prima nota - le registrazioni contabili relative agli oneri (con la banca come fornitore), agli interessi, alle tasse e ai pagamenti.

Quando la connessione smette di funzionare

Una sincronizzazione non riuscita contrassegna la connessione con il messaggio di errore restituito dalla banca. La causa più comune è la scadenza del consenso: premi nuovamente Connetti per la stessa banca e approva l'accesso; i conti associati e i relativi modelli verranno conservati. L'opzione Disconnetti rimuove la connessione e i collegamenti ai relativi conti, ma non le transazioni già registrate.