Importazione di estratti conto bancari (camt.053)

Questa guida descrive l'importazione di file di estratti conto bancari nel formato ISO 20022 camt.053 tramite un modello di importazione: cosa scaricare, come configurare il modello e cosa genera l'importazione. I dettagli dell'API sono disponibili in Importazioni di banche e pagamenti. Per una connessione in tempo reale alla banca invece dei file, consulta Connessioni bancarie.

1. Scarica l'estratto conto dalla tua banca

Nel tuo home banking, apri la sezione di esportazione degli estratti conto e seleziona il formato ISO 20022 camt.053 (XML). Le banche lituane lo elencano come "ISO 20022 XML" o "camt.053"; la maggior parte delle banche dell'Unione Europea lo offre nella sezione dedicata alle aziende. Seleziona l'intervallo di date e scarica il file. Un singolo file può contenere diversi estratti conto (ad esempio uno per conto valuta); gli estratti conto il cui IBAN non corrisponde al conto bancario selezionato vengono ignorati.

Vengono importate solo le registrazioni contabili definitive (Ntry/Sts = BOOK). Le registrazioni in sospeso vengono ignorate.

2. Crea il conto bancario

Ogni importazione viene associata a un conto bancario. Creane uno nella sezione Banca inserendo l'IBAN e la valuta del conto. Una volta impostato l'IBAN, l'importazione verifica che l'estratto conto si riferisca a quel conto specifico e rifiuta i file con un IBAN differente.

3. Crea il modello di importazione

Nella sezione Banca → Modelli di importazione fai clic su Nuovo modello di importazione, seleziona il tipo ISO 20022 camt.053 e assegna un nome.

Campi. Ogni elemento dell'estratto conto letto dal sistema di importazione corrisponde a una riga. La casella Obbligatorio nel file indica che l'elemento deve essere presente nel file caricato; un file privo di un elemento obbligatorio viene rifiutato e vengono mostrati i nomi dei campi mancanti. Gli elementi presenti in ogni estratto conto (Stmt/Id, Stmt/Acct/Id/IBAN, i saldi, Ntry/Amt, Ntry/CdtDbtInd, Ntry/Sts, Ntry/BookgDt) sono selezionati per predefinizione. Quelli opzionali, ovvero il nome della banca, il codice della transazione, i nomi e gli IBAN di debitore e creditore, il testo della causale e i riferimenti, non sono selezionati poiché non tutte le banche li compilano; spunta quelli forniti dalla tua banca.

Conto di mastro. Le righe che movimentano denaro possono essere assegnate a un conto di mastro (ledger account), scegliendone uno esistente oppure creandone uno nuovo direttamente dalla riga stessa. Ogni movimento generato da una riga assegnata viene registrato al momento dell'importazione: le entrate di denaro addebitano il conto di mastro della banca e accreditano il conto assegnato, le uscite fanno l'opposto e la transazione bancaria viene contrassegnata come associata a quella registrazione di prima nota. Oltre alla riga dell'importo semplice Ntry/Amt, sono disponibili le righe di regola che selezionano le registrazioni in base al codice o alla direzione della transazione bancaria:

Riga	Seleziona	Conto tipico
Oneri bancari (BkTxCd CHRG)	registrazioni la cui famiglia di codici di transazione è CHRG	costi per commissioni bancarie (6800 nel piano dei conti standard)
Interessi (BkTxCd INTR)	registrazioni la cui famiglia è INTR	proventi o oneri finanziari
Tasse (BkTxCd TAXE)	registrazioni la cui famiglia è TAXE	pagamenti di imposte
Altre uscite di denaro	qualsiasi altra registrazione in addebito	lascia "Non registrato" per associare i pagamenti alle fatture d'acquisto
Altre entrate di denaro	qualsiasi altra registrazione in accredito	lascia "Non registrato" per associare gli incassi alle fatture di vendita
Ntry/Amt	ogni registrazione non intercettata da alcuna regola	di solito "Non registrato"

Una registrazione viene contabilizzata sul conto della prima riga corrispondente, seguendo questo ordine: la famiglia del codice di transazione, la direzione e infine la riga dell'importo semplice. Le righe di regola non vengono verificate rispetto al file. Il codice di transazione proviene da Ntry/BkTxCd/Domn/Fmly/Cd; se una banca non lo trasmette, le righe dei codici rimarranno prive di corrispondenze.

Crea clienti o fornitori mancanti. Spunta Crea clienti mancanti sulla riga del nome del debitore (…/RltdPties/Dbtr/Nm) per creare automaticamente un cliente per ogni pagatore sconosciuto in caso di entrate, e Crea fornitori mancanti sulla riga del nome del creditore (…/RltdPties/Cdtr/Nm) per ogni beneficiario sconosciuto in caso di uscite. I partner vengono riconosciuti prima tramite IBAN (l'IBAN viene salvato nei conti bancari del partner) e successivamente tramite riscontro esatto del nome; a un partner trovato tramite nome viene aggiunto l'IBAN, in modo che l'importazione successiva lo riconosca direttamente tramite IBAN. Un nuovo partner viene classificato come azienda se il suo nome include una forma giuridica (UAB, MB, AB, VšĮ, SIA, OÜ, GmbH, Ltd, …) o come persona fisica in tutti gli altri casi.

Crea partner per la banca. Seleziona questa opzione sulla riga di regola relativa agli oneri bancari. L'importazione crea un fornitore denominato con il nome della banca (Stmt/Acct/Svcr/FinInstnId/Nm, o il nome del conto bancario se l'estratto conto è privo del nome della banca) una sola volta e registra ogni onere in prima nota associandolo a quel partner.

Collega le fatture tramite questo campo. Spunta questa opzione sulla riga della causale (…/RmtInf/Ustrd), sulla riga del riferimento strutturato (…/RmtInf/Strd/CdtrRefInf/Ref) o sulla riga del riferimento end-to-end (…/Refs/EndToEndId). Può essere selezionata una sola riga alla volta, ma l'importazione leggerà tutti e tre i testi indipendentemente dalla riga spuntata. Verranno visualizzate due opzioni aggiuntive:

• Crea fatture di acconto per i pagamenti in entrata non associati: un pagamento in entrata che non corrisponde ad alcuna fattura e proviene da un partner noto genera una fattura di acconto emessa (serie AV) per l'importo corrispondente, datata alla data del pagamento, e il pagamento viene associato ad essa. Il partner deve essere noto, quindi è necessario spuntare anche Crea clienti mancanti.
• Aliquota IVA e Articolo di catalogo per tali fatture di acconto. Quando viene selezionato un articolo, verranno utilizzati il suo conto di mastro e, se l'aliquota è vuota, la sua aliquota IVA.

Salva il modello.

4. Importa il file

Nella sezione Banca seleziona il conto bancario, il modello e il file, quindi fai clic su Importa. La riga dei risultati indicherà quante transazioni sono state importate, quante erano già esistenti, quanti movimenti sono stati registrati, quanti partner sono stati creati e quante fatture sono state collegate o generate. Gli avvisi elencheranno i pagamenti che non è stato possibile associare e ne spiegheranno il motivo.

È sicuro importare nuovamente lo stesso file: le registrazioni vengono riconosciute tramite il riferimento di registrazione della banca (NtryRef, AcctSvcrRef o l'ID transazione TxId) oppure, in assenza di questi, tramite un hash calcolato su data di registrazione, importo, valuta, IBAN della controparte e testo, conteggiato in modo tale da mantenere distinte registrazioni identiche presenti in punti diversi dello stesso file. I partner vengono riconosciuti tramite IBAN e nome. Le registrazioni contabili con importo pari a zero vengono ignorate e generano un avviso.

5. Cosa fa la funzione "Collega le fatture tramite questo campo"

Ogni nuova registrazione bancaria viene confrontata con i documenti aperti:

• le entrate vengono confrontate con le fatture di vendita emesse e non interamente saldate, cercando il numero di fattura (ad esempio SF-123) all'interno del testo della causale, del riferimento strutturato o del riferimento end-to-end;
• le uscite vengono confrontate con le fatture d'acquisto registrate e non interamente saldate, tramite il numero di documento del fornitore.

Un riscontro positivo registra il pagamento a fronte della fattura e contabilizza l'incasso o il pagamento; la transazione viene contrassegnata come associata nella sezione Banca → Transazioni con un collegamento diretto alla fattura. Le registrazioni prive di un numero riconoscibile rimangono non associate e possono essere collegate manualmente dall'elenco delle transazioni oppure, nel caso di denaro in entrata da un cliente noto, convertite in una fattura di acconto se tale opzione è attiva.

6. Dove verificare i risultati

• Banca → Transazioni: ogni registrazione importata; quelle associate contengono il collegamento alla fattura o alla registrazione di prima nota.
• Fatture: fatture di acconto generate per gli incassi non associati.
• Partner: clienti e fornitori creati, ciascuno con il proprio IBAN associato nella sezione dei conti bancari.
• Mastro → Prima nota: le registrazioni contabili relative a oneri (con la banca come partner), interessi, tasse e pagamenti.

Fatturazione

File fino a 10 MB e 50.000 registrazioni. Ogni 10 registrazioni importate equivalgono a una richiesta API.