Banki export — rendszerleírás
Az átutalási csomagok, tételek és sablonok adatmodellje, a számla-átvétel szabályai, a pain.001 XML-előállítás ellenőrzései és a jogosultsági rétegek.
Áttekintés
Utalási csomagok kezelése: számlák (a Számlák lista csoportos kijelöléséből), kézi és sablon-tételek egy csomagban, tételenként értéknappal, összeggel, jóváírandó számlaszámmal. A csomagból ISO 20022 pain.001.001.03 XML tölthető le ERSTE vagy UniCredit protokollal.
Adatmodell
A táblanevek a telepítés saját előtagjával állnak az adatbázisban.
| Tábla | Szerep | Fő mezők |
|---|---|---|
bank_export_batch | csomag-fej | név, client, terhelendő számla, protokoll, státusz (0 = Draft, 1 = Generated), generated_at, created_by |
bank_export_item | csomag-tétel | forrás (számla, kézi, sablon), partner neve, számlaszám, összeg, értéknap, közlemény |
bank_export_template | ismétlődő utalás sablonja | globális, cég-szűkítés nélkül; státusz |
invoice, bankaccount, company | olvasott törzsek | kintlévőség, határidő, alapértelmezett bankszámla |
Folyamat
- Új csomag: draft (0) státusszal, a létrehozó felhasználóval. Név, client és bankszámla kötelező; a client a tartalmi jogon belül.
- Tétel: a számlaszám 24 jegyre normalizálva; a közlemény legfeljebb 140 karakter.
- Számlák hozzáadása: jóváírandó számla a szállító alapértelmezett bankszámlája a számla devizanemében (
company::getDefaultBankaccountId), összeg a kintlévőség (ennek híján bruttó), értéknap a fizetési határidő, a közlemény a számlaszám és a rendszer saját, számla-azonosítót hordozó jele, amelyet a banki import fixen felismer. A csomagban már lévő számla kimarad; a számlaszám nélküli számlák listája visszajön. A modalból új csomag is létrehozható. - Generálás: ellenőrzi a terhelendő számla IBAN-ját, tételenként az érvényes normalizált IBAN-t, a pozitív összeget és az értéknapot; felépíti az XML-t (a számla-jel a közleménybe akkor is bekerül, ha kézzel átírták), a csomagot Generated (1) állapotra állítja, és letöltésként adja (fájlnév például
ERSTE_2026-11-20_batch12.xml). Hibánál a formra irányít, az üzenet a munkamenetben utazik. - Törlés: draft csomag fizikailag a tételeivel; generált csomag nem törölhető. Sablon csak akkor, ha egyetlen csomag-tétel sem hivatkozza.
Jogosultság
- 1. réteg: az oldal az útvonal alap hozzáférési jogával nyílik; mentés, tétel-, sablon-, generálás- és törlés-műveletek a módosítási jogot is kérik.
- 2. réteg:
list,add(a gomb; a mentés új rekordnáladd, katalógus-sor hiányábanedit),edit,generate,delete,debug(a csomaglista SQL-je). - 3. réteg: a lista a felhasználó engedett cégeire szűr (tiltott szűrőnél üres); a fej-, tétel-, sablon-tétel-, generálás- és törlés-műveletek ellenőrzik, hogy a csomag clientje a tartalmi jogon belül van; a számla-átvétel a számlák tulajdonos-clientjére is szűr. A sablonok globálisak.
Ismert korlátok
- A tétel-műveletek nem nézik a csomag státuszát, így generált csomag tételei is módosíthatók.
- Az előállított fájl nem kerül a dokumentumtárba.