Banki szinkronizáció

Az Odoo automatikusan le tudja tölteni a banki tranzakciókat, így nem kell naponta kivonatfájlt feltöltenie. Az Online Bank Sync modulok összekötnek egy bank- vagy fizetési számlát egy Odoo naplóval, adott időközönként lekérdezik a szolgáltatót, és létrehozzák a megfelelő bankkivonat-sorokat, amelyek készen állnak az egyeztetésre.

A funkció két rétegre oszlik:

  • Az Online Bank Sync (account_bank_sync) biztosítja a kapcsolatokat, a távoli számlákat, a naplóhoz rendelést, az ütemezett importálást és a szolgáltatói hitelesítő adatok biztonságos tárolását.

  • Egy szolgáltatói modul egy konkrét pénzintézetet vagy aggregátort valósít meg. Három érhető el:

    • Enable Banking (PSD2) (account_bank_sync_enablebanking) — PSD2 szerinti számlainformációs szolgáltató spanyol és más európai bankokhoz, a banknál megadott hozzájárulással. Lásd: Enable Banking (PSD2).

    • Nyíltbankolás Partner (account_bank_sync_bankszamlakivonat) – több bankot lefedő aggregátor, amely a bankszamlakivonat.hu szolgáltatáson keresztül éri el a magyar bankokat.

    • Wise (account_bank_sync_wise) – a Wise (korábban TransferWise) többdevizás egyenlegei, a kimenő kifizetésekkel együtt.

Megjegyzés

Az online szinkronizáláshoz legalább egy szolgáltatói modul szükséges. Ha a bankját egyik szolgáltató sem fedi le, helyette importálja a kivonatfájlokat.

Fájlimport vagy online szinkronizálás?

Mindkét módszer ugyanoda vezet: bankkivonati sorok egy banki naplóban, készen az egyeztetésre. Válasszon aszerint, hogy a bankja mit kínál, és mennyire friss adatokra van szükség.

Fájlimport

Online szinkronizálás

Frissesség

Olyan friss, mint az utoljára letöltött fájl.

Automatikus; ütemezett futtatások és egy manuális Szinkronizálás most gomb.

Beállítás

A bankszámlán és a naplón kívül nincs mit beállítani.

Szolgáltatói fiók, hitelesítő adatok és – PSD2-es bankoknál – a banknál megadott hozzájárulás.

Karbantartás

Valakinek rendszeresen le kell töltenie és fel kell töltenie egy fájlt.

A hozzájárulást a banknál meg kell újítani (PSD2: legfeljebb 180 naponta), az automatikus lekérések napi számát pedig a bank korlátozza.

Előzmények

Bármilyen időszak, amelyet a fájl lefed.

A kapcsolat létrejöttekor kezdődik; a régebbi előzmények nem kerülnek letöltésre.

A két módszer jól kiegészíti egymást. Kösse össze a naplót a napi forgalomhoz, majd töltse fel a régebbi előzményeket egy kivonatfájlból. Ha az Online bankszinkron és a fájlimport is telepítve van, a fájlnak azokat a sorait, amelyeket a szinkronizálás már könyvelt, a rendszer automatikusan kihagyja.

Hozzáférési jogok

A szinkronizáció saját hozzáférési csoportokat vezet be, amelyeket a Beállítások ‣ Felhasználók és vállalatok ‣ Felhasználók menüpontban, az Online bankszinkron kategóriában rendelhet a felhasználókhoz:

Csoport

Jogosultságok

Bankszinkron / Felhasználó

A szinkronizáció állapotának és eredményeinek olvasása. A hitelesítő adatokhoz nincs hozzáférése.

Bankszinkron / Menedzser

Kapcsolatok, számlák és a naplóhoz rendelés beállítása. A Bankszinkron menü megjelenéséhez szükséges. Nem fér hozzá a hitelesítő adatokhoz.

Bankszinkron / Kifizetés-jóváhagyó

Kimenő kifizetések jóváhagyása és elküldése.

Bankszinkron / Adminisztrátor

A szolgáltatói hitelesítő adatok és titkok, például privát kulcsok olvasása és írása.

A csoportok egymásra épülnek: a Menedzser magában foglalja a Felhasználó csoportot, a Kifizetés-jóváhagyó és az Adminisztrátor pedig egyaránt magában foglalja a Menedzser csoportot.

Figyelem

A Bankszinkron / Adminisztrátor csoport a Beállítások adminisztrátori jogosultságait is megadja. Csak azoknak rendelje hozzá, akik a teljes adatbázist kezelhetik.

Kapcsolat létrehozása

Lépjen a Könyvelés ‣ Bankszinkron ‣ Kapcsolatok menüpontba, és kattintson az Új gombra. Töltse ki a következőket:

  • Név: tetszőleges megnevezés, például a bank neve.

  • Szolgáltató: az adott pénzintézetet kezelő szolgáltatói modul.

  • Környezet: Tesztkörnyezet a teszteléshez, Éles az éles adatokhoz.

  • A Hitelesítő adatok szakasz, amelynek mezői a kiválasztott szolgáltatótól függnek. A titkokat, például a privát kulcsokat csak a Bankszinkron / Adminisztrátor csoport látja.

A Képességek szakaszt a szolgáltatói modul tölti ki, és megmutatja, mit támogat a kapcsolat: Támogatja a kivonat-lekérést, Támogatja az árfolyamokat, Támogatja a webhookokat, Támogatja a kifizetéseket és Támogatja a hozzájárulás-átirányítást.

Kattintson a Kapcsolat tesztelése gombra a hitelesítő adatok ellenőrzéséhez: egy értesítés megerősíti, hogy a szolgáltató válaszolt, ha pedig elutasítja a hitelesítő adatokat, az okot hibaüzenet jeleníti meg.

Az állapotsor mutatja, hol tart a kapcsolat. Az, hogy a kapcsolat hogyan lesz Kapcsolódva, a szolgáltatótól függ: a Wise esetén egy sikeres Kapcsolat tesztelése, a Nyíltbankolás esetén a párosítás vége (Frissítés / felfedezés), az Enable Banking esetén a banknál megadott hozzájárulás. A sikertelen banki engedélyezés az állapotot Hiba értékre állítja, és az okot az Utolsó hiba mezőben tárolja. Az a kapcsolat, amelynek a hozzájárulása lejárt, Lejárt állapotba kerül, és meg kell újítani, lásd: Banki hozzájárulás és lejárat.

screenshot: accounting-bank-sync-connection
menu
Accounting ‣ Bank Sync ‣ Connections ‣ (open a connection)
shows
A connection form in state "Connected", with the Name, Provider, Environment, Last refresh fields, a filled Credentials section and the five Capabilities checkboxes.
highlight
The status bar and the "Test connection" / "Discover accounts" buttons.
data
Connection "OTP – Nyíltbankolás", provider "Nyíltbankolás Partner", environment "Production".
module
account_bank_sync, account_bank_sync_bankszamlakivonat
notes
English UI, light theme, 1440px width; use a throw-away API key.

Nyíltbankolás Partner

Az aggregátor az Ön nevében kapcsolódik a magyar bankokhoz. Adja meg a szolgáltatótól kapott Nyíltbankolás entitás azonosító és Nyíltbankolás API kulcs értéket, majd kattintson a Csatlakozási kód kérése gombra. Az Odoo lekér egy csatlakozási kódot, amely a Csatlakozási kód mezőben jelenik meg: ezzel engedélyezze a bankszámláit a szolgáltató oldalán. Az engedélyezés után kattintson a Frissítés / felfedezés gombra: a kapcsolat Kapcsolódva állapotba kerül, és az engedélyezett számlák listája bekerül az Odoo-ba. Új csatlakozási kód kérése a kapcsolatot Piszkozat állapotba állítja vissza, amíg a párosítást újra be nem fejezi.

Wise

Adja meg a Wise profil azonosító és a Wise API token értéket. A kifizetésekhez a Wise egy Wise SCA RSA privát kulcs (PEM) kulcsot is kér, amellyel az erős ügyfélhitelesítési kérések aláírása történik, a webhookok kézbesítéséhez pedig a Wise által az adott környezethez közzétett Wise webhook publikus kulcs (PEM) kulcsot. A Webhookok feliratkozás gombbal regisztrálhatja az Odoo-t a Wise-nál, hogy az új tranzakciók azonnali frissítést indítsanak, a Webhookok leiratkozás gombbal pedig leállíthatja ezeket.

Fontos

A webhook-események a /bank_sync/webhook/<provider> címre érkeznek az adatbázisában. Az aláírás-ellenőrzés zárt módon hibázik: a nem ellenőrizhető eseményt a rendszer elutasítja. Kérje meg a rendszergazdáját, hogy gondoskodjon arról, hogy ez a cím elérhető legyen az internetről.

A távoli számlák naplóhoz rendelése

Egy csatlakoztatott kapcsolaton kattintson a Számlák felfedezése gombra. Az Odoo lekérdezi a szolgáltatót, és minden távoli számlához vagy egyenleghez létrehoz egy Bankszinkron számla rekordot. Nyissa meg a Könyvelés ‣ Bankszinkron ‣ Számlák menüpontot, és mindegyiknél állítsa be a következőket:

  • Napló: az a banknapló, amelybe a tranzakciók kerülnek. Amíg nincs napló beállítva, semmi sem importálódik.

  • Szinkron engedélyezve: bekapcsolja az ütemezett importálást ehhez a számlához. Alapértelmezés szerint ki van kapcsolva, a szolgáltató által felfedezett számláknál is.

  • Szinkronizálás gyakorisága: a lekérdezési időköz (például 1 óra). Napi hívási korláttal rendelkező szolgáltatónál az Odoo soha nem kérdez le gyakrabban, mint amit a korlát megenged (napi 4 hívásnál 6 óránként).

A listanézet megjeleníti az Utolsó sikeres futás értéket és egy színes Utolsó állapot jelvényt (OK, Futó, Hiba), így egy pillantással észreveheti, ha egy számla importálása leállt. Az opcionális Egyenlegeltérés oszlop az egyenlegellenőrzéshez tartozik.

Amint egy naplóhoz hozzárendelték, a Banki tételek beállítása (a napló Könyvelési tételek lapján) Online bankszinkron értékre áll, és a Könyvelési vezérlőpult naplókártyáján megjelenik a Szinkronizálás most gomb. A kivonatfájlok ettől függetlenül importálhatók a naplóba, lásd: Előzmények betöltése online szinkronizált naplóba.

screenshot: accounting-bank-sync-accounts
menu
Accounting ‣ Bank Sync ‣ Accounts
shows
The Accounts list with three rows: connection, account name, currency, mapped journal, the "Sync enabled" toggle, the last successful run and the colored state badges (one "Ok", one "Error").
highlight
The "Last state" column (red frame).
data
Two HUF accounts mapped to "Bank" and "Bank (OTP)", one EUR Wise balance.
module
account_bank_sync
notes
English UI, light theme, 1440px width.

Szinkronizálás futtatása

A szinkronizálás háromféleképpen futhat:

  • Ütemezetten: az Online Bank Sync: pull statements ütemezett művelet 15 percenként megnézi, mely számlák esedékesek, és importálja azokat. Ez az ütemezett művelet alapértelmezés szerint ki van kapcsolva; kérje meg a rendszergazdáját, hogy kapcsolja be, amint a naplóhoz rendelés kész.

  • Kézzel: kattintson a Szinkronizálás most gombra a számla űrlapján, vagy a Könyvelési vezérlőpult naplókártyáján. A kézi futtatások az Ön jelenlétében történnek, ezért nem használják fel az alább ismertetett ütemezett futtatások napi korlátját.

  • Webhook által kiváltva: a webhookokat támogató szolgáltatóknál a beérkező esemény megjelöli a számlát, és a következő ütemezett futás azonnal importálja, még akkor is, ha az időzített lekérdezés ki van kapcsolva.

Minden futás az utolsó sikeres futás óta keletkezett tranzakciókat tölti le, 48 órás átfedéssel, hogy a bank által későn könyvelt tranzakciók se maradjanak ki. Az importálás idempotens: a naplóban már meglévő tranzakciót a rendszer kihagyja, így a szinkronizálás kétszeri futtatása sem hoz létre duplikátumot.

Megjegyzés

A szinkronizálás az első futtatás előtt csak rövid időre tekint vissza. A kapcsolat létrehozását megelőző előzményeket nem tölti be: importálja azokat kivonatfájlból, lásd: Előzmények betöltése online szinkronizált naplóba.

A PSD2-es bankok napi korlátja. A PSD2 lehetővé teszi, hogy a bank napi 4-nél több számlalekérést elutasítson, ha az ügyfél nincs jelen. Ha a kapcsolatnál a Max. automatikus szinkron naponta mezőben van érték, az ütemezett futtatások a nap hátralévő részére (UTC) leállnak, amint egy számlánál elérik ezt a számot, és másnap folytatódnak. A kézi futtatásokat nem számítja bele.

Ha egy futás meghiúsul, a számla Hiba állapotba kerül, az üzenet pedig a Last error mezőbe. A többi számlát ez nem érinti. A tárolt üzenetekből a hitelesítő adatok és a tokenek el vannak távolítva.

Figyelem

A Szinkronizálás most a Bankszinkronizálás befejezve. üzenetet jeleníti meg akkor is, ha a futtatás sikertelen volt, mert a hibát a rendszer a számlán rögzíti, nem pedig kivételként dobja. Kézi szinkronizálás után ellenőrizze az Utolsó állapot és az Utolsó hiba mezőt a számlán.

Egyenlegellenőrzés

Ha a szolgáltató jelenti a számla egyenlegét (az Enable Banking igen), minden sikeres futtatás összeveti a bank könyvelt egyenlegét a napló bankszámlájának egyenlegével a könyvelésben, a banki egyenleg dátumáig. Csak a könyvelt tételek számítanak. A számla űrlapja az eredményt az Egyenlegellenőrzés szakaszban mutatja (Egyenleg, Banki egyenleg dátuma, Könyvelési egyenleg és Egyenlegeltérés, pirossal, ha nem nulla).

Ha a kettő eltér, a Könyvelési vezérlőpult naplókártyáján a Szinkronizálás most mellett egy Egyenleg eltér figyelmeztetés jelenik meg. A szokásos okok:

  • a számla első importált tranzakciója előtti egyenleget soha nem könyvelték az Odoo-ban. Könyveljen egy nyitóegyenleg-tételt a napló bankszámláján;

  • még hiányoznak tranzakciók, például mert az előzmények feltöltése nem történt meg;

  • egy tranzakció még függőben van a banknál: az Enable Banking csak a könyvelt tranzakciókat importálja.

Az ellenőrzés kontroll, nem korrekció: semmi sem könyvelődik automatikusan.

Kimenő kifizetések

A kifizetéseket támogató szolgáltatók (jelenleg a Wise) pénzt is tudnak kiutalni az Odoo-ból. Mivel ez valódi pénzmozgás, a kifizetéseket rögzítő–ellenőrző (maker–checker) folyamat védi.

Konfiguráció

A kapcsolat űrlapján, a Kifizetési korlátok szakaszban:

  • Payout enabled: a funkciókapcsoló, amelyet csak a Bankszinkron / Adminisztrátor csoport szerkeszthet. Amíg ki van kapcsolva, kifizetés nem lehetséges, még akkor sem, ha a szolgáltató támogatja.

  • Payout dual control threshold: ezen összeg felett egy második személynek is jóvá kell hagynia. Állítsa 0-ra, ha mindig külön jóváhagyót szeretne megkövetelni.

  • Payout per tx limit: a legnagyobb megengedett egyedi kifizetés. A 0 azt jelenti, hogy nincs korlát.

  • Payout daily limit: a naponta (UTC szerint) jóváhagyható legnagyobb összeg. A 0 azt jelenti, hogy nincs korlát.

Kifizetés létrehozása és elküldése

Lépjen a Könyvelés ‣ Bankszinkron ‣ Kifizetések menüpontba, és kattintson az Új gombra. Adja meg a Kedvezményezett mezőt, a Recipient bank account értéket, az Összeg összeget és a pénznemet, valamint egy Payment reference hivatkozást (legfeljebb 35 karakter, a SEPA előírása szerint). Ezután használja a fejlécben lévő gombokat:

  1. A Árajánlat lekéri a szolgáltatótól az árfolyamot és a díjat, amelyek a Árajánlat szakaszban jelennek meg a lejárati idővel együtt.

  2. A Igénylés jóváhagyásra küldi a kifizetést. Az, hogy kell-e kettős kontroll, ebben a pillanatban rögzül, így a küszöbérték utólagos emelése nem gyengítheti azt.

  3. Az Jóváhagyás gombot a Bankszinkron / Kifizetés-jóváhagyó csoportba tartozó felhasználó használja. Ha kettős kontroll van érvényben, a jóváhagyónak más személynek kell lennie, mint aki kérelmezte.

  4. A Küldés Wise-on továbbítja a kifizetést a szolgáltatónak.

Az állapotsáv a kifizetést a Piszkozat, Ellenőrzőre vár, Jóváhagyva, Elküldve, Végrehajtva és Egyeztetve állapotokon vezeti végig, alternatív kimenetként pedig a Sikertelen és a Cancelled szerepel. A Cancel a kifizetés végrehajtásáig érhető el. Miután a szolgáltató visszaigazolta az átutalást, a kifizetési bizonylat letölthető és a rekordon tárolható.

Megjegyzés

Minden kifizetés idempotenciakulcsot kap, így a küldés közbeni hálózati hiba sem eredményezheti azt, hogy a pénz kétszer kerül átutalásra.

Kifizetési kötegek

Ha egyszerre több kedvezményezettnek fizet, használja a Könyvelés ‣ Bankszinkron ‣ Kifizetési kötegek menüpontot. A köteg a Tagok fülön tartalmazza a kifizetéseit, és köteg szinten ugyanazokat a lépéseket kínálja: Összes árajánlat, Igénylés, Jóváhagyás, Küldés, Visszatérítés és Cancel. A kapcsolat korlátai és a kettős kontroll szabálya a köteg teljes összegére vonatkoznak.

screenshot: accounting-bank-sync-payout
menu
Accounting ‣ Bank Sync ‣ Payouts ‣ (open a payout)
shows
A payout form in state "Pending checker" with the header buttons Quote / Request / Approve / Send via Wise / Cancel, the Payee, amount and payment reference, and the Quote section showing the rate, the fee and the expiry.
highlight
The status bar and the Approval section (requester and approver).
data
Payee "Deco Addict", amount 1,250.00 EUR, reference "INV/2026/0042".
module
account_bank_sync, account_bank_sync_wise
notes
English UI, light theme, 1440px width.

Lásd még