← 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.