Nordlet

← Alapok / SDK-k

Bankakapcsolatok

Bank csatlakoztatása a nyílt banki (open banking) interfészen keresztül, a számlák összekapcsolása, importálási sablon kiválasztása és a tranzakciók szinkronizálása a főkönyvbe.

Ez az útmutató bemutatja az élő bankkapcsolat (PSD2 open banking) működését: a csatlakozást, a bank számláinak összekapcsolását a főkönyvvel, azt, hogy a szinkronizálás hogyan hoz létre partnereket, párosít számlákat és könyvel le tételeket egy importálási sablon segítségével, valamint azt, hogy mit ad vissza a szinkronizálás. Az API részleteit a Banki és fizetési importok cikk tartalmazza. Ha az élő kapcsolat helyett kivonadfájlokat szeretne használni, tekintse meg a Bankkivonatok importálása (camt.053) útmutatót.

1. A bank csatlakoztatása

A Bank → Kapcsolatok menüpontban válassza ki az országot, majd kattintson a Bankok megjelenítése gombra. Válassza ki a bankot és a számlatulajdonos típusát (vállalkozási vagy magánszemély), majd kattintson a Csatlakozás gombra. A rendszer átirányítja a bank saját jóváhagyási oldalára, ahol be kell jelentkeznie és jóvá kell hagynia a hozzáférést; ezt követően a bank visszairányítja Önt a Nordlet rendszerébe. A kapcsolat megjelenik a listában a hozzájárulás lejárati dátumával. A hozzájárulások érvényességi idejét a bank korlátozza (jellemzően 90 vagy 180 nap); amikor egy hozzájárulás lejár, csatlakozzon újra.

A bankok listája a Nordlet-példányhoz beállított nyílt banki (open banking) szolgáltatótól származik. Ha az ország mellett nem jelennek meg bankok, a szolgáltató még nem fedi le azt.

2. A bank számláinak összekapcsolása

A kapcsolat alatt a bank által elérhető összes számla szerepel az IBAN számával és a pénznemével. Mindegyikhez válasszon ki egy meglévő bankszámlát a főkönyvből vagy kattintson az Új bankszámla létrehozása lehetőségre, adja meg a szinkronizálás kezdő dátumát (opcionális), majd kattintson az Összekapcsolás gombra. A rendszer csak az összekapcsolt számlákat szinkronizálja. Kezdődátum megadása nélkül az első szinkronizálás az elmúlt 90 nap adatait tölti le.

3. Az importálási sablon létrehozása

A Bank → Importálási sablonok menüpontban kattintson az Új importálási sablon gombra, válassza ki a Bankkapcsolat típust, és adjon nevet a sablonnak. A sorok a banki hírfolyam tranzakciónkénti attribútumait jelölik. A Kötelező a fájlban mező megmaradt a teljesség kedvéért, de az élő hírfolyamot a rendszer nem érvényesíti ezzel szemben.

Főkönyvi számla. Az egyszerű transaction_amount.amount összeget tartalmazó sorhoz és a szabálysorokhoz főkönyvi számla rendelhető; a hozzárendelt sor alapján generált minden szinkronizált tranzakció azonnal lekönyvelődik, és a rendszer a naplóbejegyzéshez párosítottként jelöli meg. A szabálysorok banki tranzakciós kód vagy irány alapján szűrik a tranzakciókat:

Sor Kiválasztás Jellemző számla
Bankköltségek (CHRG kód) azok a tranzakciók, amelyek kódcsaládja CHRG bankköltség ráfordítás (6800 a standard számlatükörben)
Kamat (INTR kód) INTR kódcsalád kamatbevétel vagy ráfordítás
Adók (TAXE kód) TAXE kódcsalád adófizetések
Egyéb kiáramló pénzösszeg bármilyen egyéb terhelés maradjon „Nem könyvelt”, hogy a kifizetések párosíthatók legyenek a beszerzési számlákkal
Egyéb beáramló pénzösszeg bármilyen egyéb jóváírás maradjon „Nem könyvelt”, hogy a bevételek párosíthatók legyenek az értékesítési számlákkal
transaction_amount.amount minden olyan tranzakció, amelyre egy szabály sem illeszkedett általában „Nem könyvelt”

A tranzakció arra a számlára könyvelődik, amelyik az első illeszkedő sorra vonatkozik: először a kódcsalád, aztán az irány, végül az egyszerű összegsort figyelembe véve. A kód a bank bank_transaction_code mezőjéből származik; azok a bankok, amelyek nem küldenek ilyet, üresen hagyják a kódsorokat.

Hiányzó vevők / szállítók létrehozása. Jelölje be a Hiányzó vevők létrehozása opciót a debtor.name soron, hogy a rendszer minden olyan ismeretlen bejövő pénz küldőjéhez létrehozzon egy vevőt, valamint a Hiányzó szállítók létrehozása opciót a creditor.name soron minden olyan ismeretlen kimenő pénz kedvezményezettjéhez. A partnereket a rendszer az IBAN (debtor_account.iban / creditor_account.iban, amely a partner bankszámláin tárolódik), majd a pontos név alapján ismeri fel; a név alapján talált partnerhez a rendszer hozzáadja az IBAN-t. Az új partner vállalatnak minősül, ha a neve céges formát tartalmaz (UAB, MB, SIA, GmbH, Ltd, ...), egyébként természetes személynek.

Partner létrehozása a bank számára. Jelölje be ezt a lehetőséget a Bankköltségek szabálysorán. A szinkronizálás létrehoz egy szállítót a csatlakoztatott bank nevében, és minden költséget rögzít a naplóban ezzel a partnerrel.

Számlák összekapcsolása e mező alapján. Jelölje be ezt a remittance_information vagy reference_number soron. Minden új tranzakció, amelynek a közleménye vagy hivatkozása tartalmazza egy nyitott kiállított értékesítési számla (beáramló pénz) vagy egy rögzített beszerzési számla (kiáramló pénz) számát, párosításra kerül azzal, és a kifizetés lekönyvelődik. Ha a fizető fél ismert partner (mentett IBAN, pontos partnernév vagy kód alapján), a számlának az adott partnerhez kell tartoznia. Az ismeretlen fizető féltől származó kifizetést a rendszer csak akkor párosítja, if a fennmaradó egyenleggel megegyezik, és a számlaszám tartalmazza a sorozat előtagját. A fennmaradó egyenleget meghaladó kifizetést a rendszer soha nem párosítja. Azok a tranzakciók, amelyek nem felelnek meg ezeknek a feltételeknek, párosítatlanul maradnak, hogy kézzel párosíthassa őket. A Előlegszámlák létrehozása párosítatlan bejövő fizetésekhez opció a párosítatlan bevételeket egy ismert partnertől kiállított előlegszámlává alakítja az adott összegben, a fizetés napjára datálva, a megadott ÁFA-kulccsal vagy a kiválasztott katalóguselemmel; ehhez szükség van a Hiányzó vevők létrehozása opcióra is, hogy a partner ismert legyen.

Mentse el a sablont.

4. A sablon alkalmazása és az ütemezés kiválasztása

Visszatérve a Bank → Kapcsolatok menüpontba, minden összekapcsolt számlához tartozik egy sablonválasztó és egy ütemezésválasztó. Válassza ki a sablont, válassza a Szinkronizálás kézzel, a Napi szinkronizálás, a Heti szinkronizálás vagy a Havi szinkronizálás lehetőséget, majd kattintson az Alkalmazás gombra. Sablon nélküli összekapcsolt számla esetén a szinkronizálás szintén lefut, de csak a tranzakciókat rögzíti; könyvelés, párosítás vagy létrehozás nem történik.

Napi, heti vagy havi ütemezés esetén az API önállóan szinkronizálja a számlát: óránként egyszer keresi azokat a számlákat, amelyek utolsó szinkronizálása régebbi, mint az adott időszak (24 óra, 7 nap vagy 30 nap), és pontosan úgy szinkronizálja őket, mint a Szinkronizálás most gomb megnyomásakor, majd lefuttatja utánuk a sablont. Az ütemezett szinkronizálás a kézi szinkronizáláshoz hasonlóan számít bele a keretbe (minden 10 lekérdezett tranzakció egy kérésnek felel meg). Ha a bank elutasítja a szinkronizálást, például mert a hozzájárulás lejárt, a kapcsolat hibajelölést kap, és a rendszer kihagyja addig, amíg újra nem csatlakozik.

5. Szinkronizálás

Kattintson a Szinkronizálás most gombra a kapcsolatnál. A Nordlet lekéri az új könyvelt tranzakciókat minden összekapcsolt számlához; a függőben lévő tranzakciókat a rendszer kihagyja addig, amíg a bank le nem könyveli őket. A lekérdezés az utolsó szinkronizálás óta történt eseményeket fedi le (egyhetes átfedéssel, hogy a késői könyvelések se maradjanak ki), egyszer rögzíti őket - a tranzakciókat a bank bejegyzési hivatkozása alapján ismeri fel -, majd lefuttatja a számla sablonját. Az eredménysor jelzi, hogy hány tranzakciót importált a rendszer, és hány létezett már; az API-n keresztül a szinkronizálás visszaadja a lekönyvelt mozgások, a létrehozott partnerek, az összekapcsolt és létrehozott számlák, a párosított kifizetések számát, valamint a párosíthatatlan fizetésekre vonatkozó figyelmeztetéseket is.

A szinkronizálás ütemezés szerint az API-n keresztül is indítható (bank/feeds/sync); minden 10 lekérdezett tranzakció egy API-kérésnek számít.

6. Hová érdemes ezután ellátogatni

  • Bank → Tranzakciók - minden szinkronizált tranzakció, számlánkénti füleken; a párosított tételek hivatkoznak a számlára vagy a naplóbejegyzésre.
  • Számlák - a párosítatlan bevételekhez létrehozott előlegszámlák.
  • Partnerek - a létrehozott vevők és szállítók, mindegyiknél a bankszámlák alatt szereplő IBAN-nal.
  • Főkönyv → Napló - a költségek (a bank mint partner megjelölésével), kamatok, adók és kifizetések könyvelései.

Mi a teendő, ha a kapcsolat leáll

A sikertelen szinkronizálás a bank hibaüzenetével jelöli meg a kapcsolatot. A lejárt hozzájárulás a leggyakoribb ok: kattintson újra a Csatlakozás gombra ugyaneznél a banknál, és hagyja jóvá a hozzáférést; az összekapcsolt számlák és a sablonjaik megmaradnak. A Leválasztás törli a kapcsolatot és a számlaösszekapcsolásokat, de a már rögzített tranzakciókat nem.