A Gránit Bank – Forint átutalási megbízás (EDIFACT PAYORD) export a QUiCK utaláskönnyítő moduljának része. Feladata, hogy a QUiCK-ben összeállított utalási csomag tételeiből a Gránit Ügyfélterminál által elfogadott kötött szélességű szövegfájlt állítson elő.
A QUiCK itt is adatvalidációs pontként működik: a mezők mérete, karakterkészlete és igazítása a Gránit specifikációnak megfelelően kerül előállításra, így csökken a banki elutasítások kockázata.
Formátum összefoglaló (Gránit PAYORD)
Formátum: kötetlen sorokból álló kötött szélességű rekord (EDIFACT PAYORD). Rekord hossza: 941 karakter/sor (a záró CR/LF-fel együtt). Karakterkészlet / kódolás: IBM Code Page 852 (cp852) – közép-európai. Alfanumerikus mezők: balra igazított, jobbról szóközökkel feltöltve a mező hosszáig. Numerikus mezők: jobbra igazított, balról nullákkal feltöltve a mező hosszáig. Sorelválasztó: CR (0x0D) + LF (0x0A). Ezeket a szabályokat a QUiCK exportkódja közvetlenül érvényesíti (ld. lent, „Kód és adatáramlás”).
Kód és adatáramlás (röviden)
Az export a kiválasztott utalási csomag tételeit ( data_provider.fetch_payments(payment_id, company_user) ) dolgozza fel.
Minden tételből egy rekord készül. A program a Gránit-féle mezőhatárokat és hossztartományokat tartja, és a következő mező–forrás megfeleltetést alkalmazza (részlet a főbb mezőkről):
Folyamat (felhasználói nézőpont)
Utalási csomag összeállítása a QUiCK-ben (kedvezményezettek, összeg, közlemény, értéknap). Exportálás → „Gránit (PAYORD)”: a rendszer a fenti mezőtérkép szerint épít 941 karakteres sorokat, és cp852 kódolású .txt fájlt ad. Import a Gránit Ügyfélterminálba, ellenőrzés és aláírás banki oldalon. Kontextus: az utalás-előkészítés a QUiCK ökoszisztémában „funkcionális adatvalidációs pont”, így a hibás mezőket még a banki beküldés előtt észreveszed.
Validációk és üzleti szabályok
Értéknap (M28): YYYYMMDD formátum; a gyakorlatban a jövőbeni nap megadása javasolt (banki oldali elfogadás). Összeg (M26): egész HUF összeg, tizedes nélkül; jobbra igazított, balról nullákkal kitöltve 13 karakterre. Deviza/Tizedesjegy (M24/M25): fixen HUF / 0. Számlaszámok (M4/M8): a specifikáció 24 jegyű hazai számlaszámot ír elő; a QUiCK a csomagban szereplő számlaszámokat változtatás nélkül helyezi el, a mezőhosszra igazítva. Közlemény (M18): max. 96 karakter; alfanumerikus + (banktól függően) néhány egyszerű írásjel. Ha a QUiCK-be hosszabb szöveget visznek fel, az export levágja a mezőt 96-nál. Kódolás (fájl): cp852, CR/LF sorzárás – ez megfelel a Gránit Ügyfélterminál import-előírásainak. A QUiCK más banki csatornák (pl. BinX) esetén CSV-t ad és eltérő mezőszabályokat alkalmaz; az utaláskönnyítés – adatvalidáció koncepció mindegyik exportnál azonos.
Hibaelhárítás – gyakori okok
Sorhossz/karakterkészlet hiba – a fájl nem cp852-ben készült vagy hiányzik a CR/LF. Exportálj újra QUiCK-ből. Számlaszám formátum – nem 24 jegyű belföldi számlaszám kerül a mezőbe: cseréld a partner adatát a QUiCK-ben. Hossz túllépés (név / közlemény) – a bank elutasíthatja; a QUiCK vág, de a tartalmat érdemes átírni, ha információ vész el. Értéknap – múltbeli/aznapi dátum banki elutasítást okozhat; állíts be jövőbeli napot. Intercom FIN AI – rövid kivonat
Mi ez? Gránit Bank PAYORD (EDIFACT) export; 941 hosszú, cp852 kódolású, CR/LF-fal zárt sorok. Kötelezők: PAYORD / DO; feladó & címzett 24-jegyű számlaszám; név mezők; közlemény ≤96; HUF, tizedesjegy 0; összeg 13-as jobb igazítás, balról nullák; értéknap YYYYMMDD; státusz 00. Igazítás: alfanumerikus balra + szóköz, numerikus jobbra + nulla. Használat: QUiCK → „Gránit (PAYORD)” export → import az Ügyfélterminálba, aláírás banknál. Kontextus: az utalás-előkészítés a QUiCK-ben adatvalidációs pont (kevesebb banki visszadobás). Kapcsolódó QUiCK-dokumentumok
Utaláskönnyítés – koncepció és validáció (rendszerszintű szemlélet). BinX utaláskönnyítő – CSV-specifikáció, eltérő szabályok (értéknap, hossz, karakterek). Szeretnél hozzá QA ellenőrzőlistát (mezőhossz, kódolás, pozíció, sorhossz, szélsőértékek) és makrókat a gyakori banki visszautasításokra? Összerakom.
Oké, Martin — összeraktam a „Gránit Bank – utaláskönnyítő (PAYORD)” fejezetet úgy, hogy egyszerre legyen használható a felhasználóknak és az Intercom FIN AI-nek. A lépésről-lépésre útmutatót a QUiCKIPEDIA cikk alapján írtam, a fájlformátum és a technikai követelmények pedig a GRÁNIT (Electra) PAYORD specifikációból származnak.
Gránit Bank – utaláskönnyítő (PAYORD)
Mi ez és mire való?
A QUiCK utaláskönnyítője olyan, a Gránit Bankba importálható utalási „csomagot” készít (EDIFACT PAYORD kötött szélességű formátum), amely több forintátutalást tartalmazhat. Cél: a kézi rögzítés kiváltása, gyors és hibamentes tömeges utalás. A csomag a Gránit Ügyfélterminál felületén importálható.
Gyors indítás (felhasználóknak)
1) Pénztárca létrehozása QUiCK-ben
Pénzmozgások → Pénztárcák Új hozzáadása → típus: bankszámla, szolgáltató: Gránit → add meg a számlaszámot és pénznemet (HUF), adj nevet. 2) Utalási csomag létrehozása QUiCK-ben
Tranzakciók → Költségek: jelöld ki a kifizetendő számlákat. Kattints az Utaláskönnyítő (bankkártya) ikonra → válaszd ki a Gránit pénztárcát → döntsd el, hogy teljes összeget utalsz-e. Letöltés → bank: Gránit → fájl mentése. 3) Import a Gránit Bank felületén
Lépj be a Gránit netbankba/Ügyfélterminálba. Megbízások → Csomag importálása → töltsd fel a QUiCK által generált fájlt → Import → Csomag importálása. Formátum és technikai részletek (FIN AI + haladó felhasználóknak)
Fájlszintű követelmények
Formátum: EDIFACT PAYORD (kötött szélességű sorok). Sorméret: 941 karakter/sor, a CR/LF sorelválasztóval együtt. Sorelválasztó: CR (0x0D) + LF (0x0A). Kódlap: IBM Code Page 852 (cp852).
Megjegyzés: Az Electra-alapú importoknál általános a CP852 használata; a QUiCK export is ezt alkalmazza. Tartalmi mező-kiosztás (forint átutalás, „DO”)
A legfontosabb mezők a Gránit PAYORD táblázata szerint (pozíciók/hosszak a banki specifikációé):
M1 Rekord típus (1–6): PAYORD M2 Forint átutalás (7–8): DO M3 Azonosító (9–22): YYYYMMDD + 6 számjegy (QUiCK: a fájlon belüli sorszámmal bővített dátum) M4 Feladó számlaszáma (23–69): 24 jegyű belföldi számlaszám (szóköz, kötőjel nélkül) M5 Számlaszám típusa (70): 0 M6 Feladó neve (71–102): cégnév (max. 32) M8 Címzett számlaszáma (220–266): 24 jegyű M9 Számlaszám típusa (267): 0 M12 Címzett neve (332–363): partner név (max. 32) M18 Megjegyzés (593–688): közlemény (max. 96; 3×32) M24 Deviza (806–808): HUF M25 Tizedesjegyek száma (809): 0 (HUF-hoz) M26 Összeg (810–822): 13 jegy, balról nullázva, tizedespont nélkül M28 Valutanap (835–842): YYYYMMDD M61 Státusz (938–939): 00 CR/LF (940–941) sorzárás. QUiCK → PAYORD mező-leképezés (implementációs logika)
M1–M2: fix értékek: PAYORD / DO. M3: YYYYMMDD + 6 jegyű futó sorszám a csomagon belül (export-azonosító). M4: „feladói” számlaszám a kiválasztott Gránit pénztárcából. M6: feladó név = cég neve a QUiCK-ben (max. 32, túlhossz vágás). M8/M12: címzett számlaszám és név = partner adatai (név max. 32). M18: közlemény = QUiCK „payment_details” (max. 96, túlhossz vágás). M24/M25/M26: deviza: HUF, tizedes: 0, összeg: egész forint, 13 jegyre balról nullázva. M28: értéknap = kiválasztott fizetési dátum (YYYYMMDD). M61: státusz: 00 (alapértelmezett feldolgozás). Karakterkészlet: a QUiCK export cp852 kódolású, a magyar ékezetek támogatottak. (Electra/Gránit specifikáció alapján.) Mit tud / mit nem tud (funkcionalitás & limitációk)
Támogatott:
Több tétel egy fájlban (tömeges import a Gránit Ügyfélterminálon). Belföldi HUF átutalás (PAYORD „DO”). Közlemény automatikus feltöltése (max. 96). Értéknap megadása (valutanap, M28). Nem támogatott / nem cél:
Devizaátutalás (PAYORD „IN”) – ezt a QUiCK Gránit export nem készíti el. VIBER/T+1 mód állítása (M29) – jelenleg nem paraméterezett, alapértelmezett feldolgozás fut (M61=00). Jogcímkód és bizonylatszám használata – üresen marad. Mezőlimitek és vágások (a banki specifikáció miatt):
Feladó/Partner név: 32 karakter. Összeg: 13 számjegy, tizedespont nélkül. Számlaszám: 24 számjegy, csak numerikus. (Szóköz, kötőjel nélkül.) Tipikus hibák és elhárításuk
Folyamat-ellenőrző lista (belső/FIN AI)
Gránit pénztárca létezik és aktív a QUiCK-ben. Partnerek bankadatai 24 jegyű számlaszámmal rögzítve. Kiválasztott tranzakciók státusza és fizetési dátuma rendben. Export Gránit bankhoz készült (PAYORD-DO, cp852). Gránit Ügyfélterminálban Csomag importálása lefutott hiba nélkül. Felhasználói lépések egy mondatban (FIN AI „quick answer”)
QUiCK-ben hozd létre a Gránit pénztárcát → a költségek között jelöld ki a számlákat → Utaláskönnyítővel töltsd le a Gránit PAYORD fájlt → Gránit Ügyfélterminálban Megbízások → Csomag importálása menüpontban töltsd fel és importáld.
0. Összefoglaló
A Gránit Bank – Forint átutalási megbízás (EDIFACT PAYORD) export a QUiCK utaláskönnyítő moduljának része, amely a QUiCK-ben összeállított utalási csomagból a Gránit Ügyfélterminál által elfogadott kötött szélességű szövegfájlt készít.
A QUiCK itt funkcionális adatvalidációs pontként működik: a mezők hossza, igazítása, karakterkészlete és formátuma már az exportkor megfelel a Gránit PAYORD specifikációnak, így jelentősen csökken a banki elutasítások kockázata.
Az eredmény egy 941 karakteres sorokból álló, cp852 kódolású .txt fájl, amely közvetlenül importálható a Gránit Ügyfélterminálba tömeges forint utalásokhoz.
1. Mi ez? (fogalom meghatározás)
A „Gránit Bank – Forint átutalási megbízás (EDIFACT PAYORD) export” egy olyan QUiCK-export formátum, amely:
a QUiCK-ben összeállított utalási csomag tételeiből EDIFACT PAYORD szabványnak megfelelő, kötött szélességű, 941 karakter/sor hosszú rekordsorokból álló IBM Code Page 852 (cp852) kódolású szövegfájlt hoz létre, amelyet a Gránit Ügyfélterminál (Electra-alapú felület) képes beolvasni és tömeges forintátutalási megbízásként kezelni.
Lényegében: a QUiCK az utalás-előkészítés rendszerszintű validációs pontja, a Gránit Bank pedig a végrehajtó fél. A felhasználó a QUiCK-ben állítja össze az utalásokat, a bank pedig a PAYORD fájl importja után teljesíti azokat.
2. Hogy működik? (rendszer szempontból)
Rendszeroldali nézőpontból az export működése a következő fő lépésekre bontható:
Adatgyűjtés az utalási csomagból A QUiCK backend a kiválasztott utalási csomag tételeit az alábbi hívással tölti be:
data_provider.fetch_payments(payment_id, company_user) Minden tétel egy leendő PAYORD rekordnak felel meg (egy tétel = egy sor). Mezők előkészítése és leképezése A backend a Gránit PAYORD specifikációban meghatározott mezőket (M1, M2, M3, …, M61) tölti fel QUiCK-adatokkal: