Konnessjonijiet mal-banek

Din il-gwida tispjega l-konnessjoni diretta ma' bank (PSD2 Open Banking): kif tikkonnettja, kif rabta l-kontijiet tal-bank mal-ledger tiegħek, kif tagħmel kull sinkronizzazzjoni toħloq imsieħba, tqabbel fatturi u tidħol spejjeż permezz ta' mudell tal-importazzjoni, kif ukoll x'jirritorna is-sinkronizzazzjoni. Id-dettalji tal-API jinsabu f'Importazzjonijiet ta' banek u pagamenti. Għal fajls tal-istatement minflok konnessjoni diretta, ara Importazzjoni ta' statements tal-bank (camt.053).

1. Qabbad il-bank

Taħt Bank → Konnessjonijiet agħżel il-pajjiż u agħfas Uri l-banek. Agħżel il-bank tiegħek u t-tip ta' detentur tal-kont (negozju jew personali), imbagħad agħfas Qabbad. Inti tintbagħat lejn il-paġna ta' kunsens tal-bank stess, illoggja hemmhekk u aprova l-aċċess; il-bank imbagħad jibgħatlek lura lejn Nordlet. Il-konnessjoni tidher fil-lista bid-data ta' skadenza tal-kunsens tagħha. Il-kunsens ikollu żmien limitat mill-bank (ġeneralment 90 jew 180 jum); meta jiskadi wieħed, erġa' qabbad.

Il-lista tal-banek tiġi mill-fornitur tal-Open Banking ikkonfigurat għall-istanza ta' Nordlet. Jekk il-pajjiż ma juri l-ebda bank, il-fornitur għadu ma jkoprihx.

2. Rabta l-kontijiet tal-bank

Taħt il-konnessjoni, kull kont li jesponi l-bank huwa elenkat bl-IBAN u l-munita tiegħu. Għal kull wieħed, agħżel kont bankarju eżistenti mill-ledger jew Oħloq kont bankarju ġdid, b'għażla ssettja d-data li minnha trid tissinkronizza, u agħfas Rabta. Il-kontijiet marbuta biss jiġu ssinkronizzati. Mingħajr data tas-sinkronizzazzjoni, l-ewwel sinkronizzazzjoni tġib l-aħħar 90 jum.

3. Oħloq il-mudell tal-importazzjoni

Taħt Bank → Mudelli tal-importazzjoni agħżel Mudell tal-importazzjoni ġdid, agħżel it-tip Konnessjoni bankarja, u agħtih isem. Ir-ringieli huma l-attributi li jirritorna l-għalf tal-bank (bank feed) għal kull transazzjoni. Il-kaxxa Meħtieġ fil-fajl tinżamm għall-kompletezza; għalf dirett ma jiġix ivvalidat kontriha.

Kont tal-ledger. Ir-ringiela tal-ammont sempliċi transaction_amount.amount u r-ringieli tar-regoli jistgħu jiġu assinjati lil kont tal-ledger; kull transazzjoni ssinkronizzata prodotta minn ringiela assinjata tiġi posting f'daqqa u mmarkata bħala mqabbla mad-dħul fil-ġurnal. Ir-ringieli tar-regoli jagħżlu transazzjonijiet skont il-kodiċi tat-transazzjoni tal-bank jew id-direzzjoni:

Ringiela	Tagħżel	Kont tipiku
Spejjeż bankarji (kodiċi CHRG)	transazzjonijiet li l-familja tal-kodiċi tagħhom hija CHRG	spejjeż ta' tariffi bankarji (6800 fiċ-chart standard)
Interessi (kodiċi INTR)	familja tal-kodiċi INTR	dħul jew spejjeż minn interessi
Taxxi (kodiċi TAXE)	familja tal-kodiċi TAXE	pagamenti tat-taxxa
Flus oħra 'l barra	kwalunkwe debitu ieħor	ħalli "Mhux posted" sabiex il-pagamenti jitqabblu mal-fatturi tax-xiri
Flus oħra 'l ġewwa	kwalunkwe kreditu ieħor	ħalli "Mhux posted" sabiex l-irċevuti jitqabblu mal-fatturi tal-bejgħ
transaction_amount.amount	kull transazzjoni li l-ebda regoli ma għażlet	normalment "Mhux posted"

Transazzjoni tiġi posting fil-kont tal-ewwel ringiela li taqbel magħha: il-familja tal-kodiċi tagħha, imbagħad id-direzzjoni tagħha, u mbagħad ir-ringiela tal-ammont sempliċi. Il-kodiċi jiġi mill-bank_transaction_code tal-bank; banek li ma jibagħtu l-ebda kodiċi jħallu r-ringieli tal-kodiċi mingħajr taqbiling.

Oħloq klijenti / fornituri neqsin. Immarka Oħloq klijenti neqsin fuq ir-ringiela debtor.name bَّiex toħloq klijent għal kull min iħallas li mhuwiex magħruf għal flus li dħul, u Oħloq fornituri neqsin fuq ir-ringiela creditor.name għal kull min jitħallas li mhuwiex magħruf għal flus li ħerġin. L-imsieħba jiġu rikonoxxuti bl-IBAN (debtor_account.iban / creditor_account.iban, maħżun fil-kontijiet bankarji tal-imsieħab), imbagħad bl-isem eżatt; sieħeb misjub bl-isem jiżdiedlu l-IBAN. Sieħeb ġdid ikun kumpanija meta the isem tiegħu jkollu forma legali (UAB, MB, SIA, GmbH, Ltd, …) u persuna f'każ ieħor.

Oħloq sieħeb għall-bank. Immarka dan fuq ir-ringiela tar-regola tal-ispjizeż bankarji. Is-sinkronizzazzjoni toħloq fornitur bl-isem tal-bank konness darba u tirreġistra kull spejjeż fil-ġurnal ma' dak is-sieħeb.

Rabta l-fatturi b'dan il-qasam. Immarka dan fuq ir-ringiela remittance_information jew reference_number. Kull transazzjoni ġdida li t-test jew ir-referenza tar-remittance tagħha jkun fihom in-numru ta' fattura tal-bejgħ maħruġa miftuħa (flus 'l ġewwa) jew fattura tax-xiri reġistrata (flus 'l barra) tiġi mqabbla magħha u l-pagament jiġi posting. Meta min iħallas ikun sieħeb magħruf, permezz ta' IBAN salvat jew bl-isem jew il-kodiċi eżatt tas-sieħeb, il-fattura trid tkun ta' dak is-sieħeb. Pagament minn min iħallas mhux magħruf jitqabbel biss meta jkun daqs il-bilanċ li fadal u n-numru tal-fattura jinkludi l-prefiss tas-serje tiegħu. Pagament akbar mill-bilanċ li fadal qatt ma jitqabbel. Transazzjonijiet li jonqsu minn dawn il-kontrolli jibqgħu mhux imqabblin biex inti tqabbilhom bl-idejn. L-għażla Oħloq fatturi ta' ħlas bil-quddiem għal irċevuti mhux imqabblin tibdel irċevuta mhux imqabbla minn sieħeb magħruf f'fattura ta' ħlas bil-quddiem maħruġa għall-ammont, bid-data tal-pagament, bir-rata tal-VAT mogħtija jew l-oġġett tal-katalgu magħżul; din teħtieġ Oħloq klijenti neqsin sabiex is-sieħeb ikun magħruf.

Salva l-mudell.

4. Applika l-mudell u agħżel l-iskeda

Lura taħt Bank → Konnessjonijiet, kull kont marbut għandu għażla ta' mudell u għażla ta' skeda. Agħżel il-mudell, agħżel Sinkronizza manwalment, Sinkronizza kuljum, Sinkronizza kull ġimgħa jew Sinkronizza kull xahar, u agħfas Applika. Kont marbut mingħajr mudell xorta jissinkronizza, iżda jirreġistra biss it-transazzjonijiet; xejn ma jiġi posting, imqabblin jew maħluq.

Bi skeda ta' kuljum, ta' kull ġimgħa jew ta' kull xahar, l-API tissinkronizza l-kont waħedha: darba fis-siegħa tfittex kontijiet li l-aħħar sinkronizzazzjoni tagħhom hija eqdem mill-perjodu tagħhom (24 siegħa, 7 ijiem jew 30 jum) u tissinkronizzahom eżattament kif tagħmel Sinkronizza issa, filwaqt li tħaddem il-mudell wara. Sinkronizzazzjoni skedata tqis lejn l-użu bħal waħda manwali (kull 10 transazzjonijiet miġjuba = talba waħda). Jekk il-bank jirrifjuta s-sinkronizzazzjoni, per eżempju minħabba li l-kunsens skada, il-konnessjoni tiġi mmarkata bl-iżball u tinqabeż sakemm erġa' tikkonnettja.

5. Sinkronizzazzjoni

Agħfas Sinkronizza issa fuq il-konnessjoni. Nordlet iġib transazzjonijiet ġodda bbukjati għal kull kont marbut; transazzjonijiet pendenti jinqabżu sakemm il-bank jibbukkjahom. Huwa jġibhom (mill-aħħar sinkronizzazzjoni, b'koinċidenza ta' ġimgħa sabiex ibbukkjar tard ma jintilifx), jirreġistrahom darba - it-transazzjonijiet jiġu rikonoxxuti bir-referenza tad-dħul tal-bank - u mbagħad imexxi l-mudell tal-kont. Ir-ringiela tar-riżultat tirrapporta kemm ġew importati transazzjonijiet u kemm kien diġà hemm; permezz tal-API is-sinkronizzazzjoni tirritorna wkoll in-numru ta' movimenti posted, imsieħba maħluqa, fatturi marbuta u maħluqa, pagamenti mqabbla, u twissijiet għal pagamenti li ma setgħux jitqabblu.

Is-sinkronizzazzjonijiet jistgħu jiġu attivati mill-API (bank/feeds/sync) fuq skeda; kull 10 transazzjonijiet miġjuba jgħoddu bħala talba waħda tal-API.

6. Fejn għandek tħares wara

• Bank → Transazzjonijiet - kull transazzjoni ssinkronizzata, bit-tabs għal kull kont; dawk imqabbla jorbtu mal-fattura jew mad-dħul fil-ġurnal.
• Fatturi - fatturi ta' ħlas bil-quddiem maħluqa għal irċevuti mhux imqabblin.
• Imsieħba - klijenti u fornituri maħluqa, kull wieħed bl-IBAN taħt il-kontijiet bankarji.
• Ledger → Ġurnal - il-postings għall-ispejjeż (bil-bank bħala sieħeb), interessi, taxxi u pagamenti.

Meta l-konnessjoni tieqaf taħdem

Sinkronizzazzjoni li tfalli timmarka l-konnessjoni bil-messaġġ ta' żball tal-bank. Kunsens skadut huwa l-kawża tas-soltu: agħfas Qabbad għall-istess bank mill-ġdid u aprova l-aċċess; il-kontijiet marbuta u l-mudelli tagħhom jinżammu. Skonnettja tneħħi l-konnessjoni u r-rabtiet tal-kontijiet tagħha, mhux it-transazzjonijiet diġà reġistrati.