A BinX utaláskönnyítő olyan exportot készít a QUiCK-ben, amelyet a BinX vállalati banki felülete képes beolvasni. A cél: gyors, hibamentes utalás-előkészítés, a BinX által elvárt formátummal és szabályokkal, minél kevesebb kézi munkával. A QUiCK ökoszisztémában az utaláskönnyítő az a pont, ahol az adatok minősége is validálódik (szabályok, kötelező mezők, tartományok), ezzel csökkentve a banki visszautasításokat.
A BinX utaláskönnyítő a QUiCK-ben létrehozott utalási csomagokat olyan CSV formátumba exportálja, amelyet a BinX vállalati banki felülete be tud olvasni. A cél a gyors, hibamentes utalás-előkészítés, a BinX által elvárt mező- és formátumszabályok automatikus érvényesítésével (név/közlemény hossza és karakterkészlete, kötelező mezők, dátumszabályok stb.).
Fájl specifikáció (BinX)
Formátum & limitek:
Fájl: csv, elválasztó: ;, kódolás: utf-8, sortörés: \n. Tétellimit: maximum 100 tétel / fájl (BinX oldali korlát). Mezőszabályok (BinX-követelmények):
Kedvezményezett neve (partner_name) Csak betűk és számok (magyar ékezetek támogatottak), max. 70 karakter. (A QUiCK a túl hosszú vagy tiltott karaktereket eltávolítja/levágja) Kedvezményezett számlaszám/azonosító (partner_account_number) 8 jegyű BinX e-pénzszámla azonosító, vagy 16/24 jegyű számlaszám, vagy magyar IBAN (HU + 2 számjegy + 24 számjegy) Értéknap (payment_date, YYYY-MM-DD) Kötelező; nem lehet a mai nap vagy korábbi, és legfeljebb +90 nap adható. (A BinX felület nem engedi aznapi értéknap betöltését – de erre a QUiCK is figyelmeztet a fájl letöltésekor) Csak egész szám (mindig HUF). Deviza (payment_currency) Fixen HUF (BinX jelenleg csak HUF-ot fogad az importban). Közlemény (payment_details) max. 140 karakter. Betűk és számok mellett az alábbi speciális karakterek engedélyezettek: kötőjel - és perjel /. A nem megengedett karaktereket a QUiCK eltávolítja és 140 karakternél vág. UI és felhasználói üzenetek
BinX értéknap figyelmeztetés:
Ha a felhasználó BinX pénztárcára készít (vagy szerkeszt) utalási csomagot, a felületen jelenjen meg:
„BinX esetében az utalások aznapi dátummal egyelőre nem tudnak teljesülni. Ha a csomagban mai fizetési időpontot állítasz be, akkor azt a BinX el fogja utasítani.” Használati lépések
Válaszd ki az utalási csomagot, és a BinX pénztárcát. Állítsd be az értéknapot (holnap vagy későbbi, de legfeljebb +90 nap). Ellenőrizd a tételeket (partnernév, számlaszám/IBAN, összeg, közlemény). Exportáld a BinX CSV-t, és importáld a BinX felületére. Írd alá a beolvasott tételeket BinX oldalon. Limitációk és specialitások
Értéknap = ma / múlt → a BinX nem tölti be, QUiCK-figyelmeztetés jelenik meg a BinX pénztárca választásakor. Deviza: csak HUF támogatott az importban. Tétel limit: ≤100 sor / fájl. Mezőhossz: név ≤70, közlemény ≤140; a QUiCK automatikusan vág, és eltávolítja a nem megengedett karaktereket. Tipikus hibák és elhárítás
Értéknap = ma / múlt → BinX elutasítja. Állíts be holnapi vagy későbbi dátumot, de ≤ +90 nap. Számlaszám formátum hibás → használd a támogatott formákat (8 jegyű BinX azonosító / 16/24 jegy / HU IBAN). >100 tétel egy fájlban → BinX oldali limitbe ütközöl; bontsd több fájlra.
Értéknap ma/múlt → állíts holnapra vagy későbbre (≤ +90 nap). Túl hosszú név/közlemény → QUiCK vág (70/140), de érdemes manuálisan is ellenőrizni. Hibás számlaszám → csak 8/16/24 jegy vagy HU IBAN elfogadott. >100 tétel → oszd több fájlra. QUiCK – BinX utaláskönnyítő (szolgáltatásdokumentáció-fejezet, frissített)
Hol helyezkedik el a QUiCK-ben?
Pénzügyek → Utaláskönnyítő: válassz egy utalási csomagot (egy vagy több tétel), majd Export → BinX CSV. Az export előtt a QUiCK érvényesíti a mező- és formátumszabályokat, ezzel csökkentve a banki visszautasítások arányát. Folyamat (rendszeroldal)
Tételek begyűjtése: a QUiCK lekéri a csomag tételeit és a felhasználó cégjogosultságát. Transzformáció: a kimenetet a BinX-előírásai szerint formázza (mezőhossz, karaktertisztítás, dátumformátum). CSV gyártás: ; elválasztó, UTF-8 kódolás, UNIX sortörés. Letöltés és banki import: a fájl BinX-ben rögzítésre kerül; a sikeres tételek aláírásra várnak. Felhasználói lépések
Válaszd ki az utalási csomagot és a BinX pénztárcát. Állítsd be az értéknapot (holnaptól +90 napig). A mai napra állított csomag elutasításra kerül BinX oldalon. Ellenőrizd a tételeket (név, számlaszám/IBAN, összeg, közlemény). Exportáld a BinX CSV-t, majd importáld a BinX felületén. Aláírás BinX-ben: a megfelelt tételek aláírásra várnak. Összefoglaló
A BinX utaláskönnyítő a QUiCK-ben olyan exportot készít, amit a BinX vállalati banki felülete közvetlenül be tud olvasni, így a tömeges utalás-előkészítés gyors és hibamentes lesz. A szolgáltatás a BinX által elvárt mező- és formátumszabályok szerint automatikusan ellenőriz és tisztít, ezzel minimalizálva a banki visszautasításokat. Neked marad a jóváhagyás és az aláírás, a “piszkos munkát” a QUiCK elvégzi helyetted. Mi ez? (fogalom meghatározás)
A BinX utaláskönnyítő a QUiCK pénzügyi moduljának azon szolgáltatása, amely a QUiCK-ben létrehozott utalási csomagokat BinX-kompatibilis CSV fájlba exportálja. Ez a CSV fájl megfelel a BinX vállalati banki felülete által elvárt mezőstruktúrának, hossz- és formátumszabályoknak (név, számlaszám/IBAN, összeg, deviza, értéknap, közlemény stb.). A szolgáltatás célja, hogy a QUiCK-ben összeállított és ellenőrzött kifizetési csomagok minél kevesebb kézi munkával kerüljenek át a BinX felületére.
A QUiCK ökoszisztémában a BinX utaláskönnyítő egyben minőségbiztosítási pont is: az export előtt szabályokat és kötelező mezőket ellenőriz, tartományokat validál (pl. értéknap, mezőhossz) és szükség esetén automatikus tisztítást/levágást végez.
Hogy működik? (rendszer szempontból)
Rendszeroldalról a BinX utaláskönnyítő a következő lépésekben dolgozik: 1. Csomag és jogosultságok lekérdezése A QUiCK lekéri az adott utalási csomaghoz tartozó tételeket. Ellenőrzi, hogy a bejelentkezett felhasználó jogosult-e a kiválasztott cég/pénztárca nevében exportot készíteni. 2. Adattisztítás és transzformáció (BinX-szabályokra) A csomag tételeit a BinX által elvárt mezőkbe rendezi (pl. partner_name, partner_account_number, payment_date, payment_amount, payment_currency, payment_details). Mezőnként érvényesíti a BinX-követelményeket: név max. 70 karakter, csak engedélyezett karakterkészlettel, közlemény max. 140 karakter, csak engedélyezett karakterekkel, számlaszám/azonosító formátuma megfelel a támogatott típusok egyikének, értéknap szabályok: nem lehet a mai nap vagy korábbi, maximum +90 nap. A túl hosszú vagy tiltott karaktereket tartalmazó mezőket automatikusan vágja/tisztítja (nem megengedett karakterek kiszűrése). Ellenőrzi, hogy a fájlban legfeljebb 100 tétel szerepel-e (BinX oldali limit). Amennyiben több tétel tartozna a csomaghoz, a rendszer jelzi, hogy több fájlra kell bontani. Sortörés: \n (UNIX stílus) A generált fájl struktúrája és mezőformátuma megfelel a BinX import követelményeinek. 5. Letöltés és külső folyamat A QUiCK letöltésre kínálja az elkészült BinX CSV-t. Innentől a folyamat a BinX felületén folytatódik: a fájl beolvasása, a tételek ellenőrzése, majd a jóváhagyás/aláírás már a banki környezetben történik. Hogy használd? (felhasználó szempontból) Hol találod a QUiCK-ben?
Pénzügyek → Utaláskönnyítő Válassz egy utalási csomagot (egy vagy több tétellel), majd az Export menüpontból válaszd a BinX CSV lehetőséget. Felhasználói lépések – teljes folyamat
Válaszd ki az utalási csomagot és a BinX pénztárcát Lépj a Pénzügyek → Utaláskönnyítő menübe. Válaszd ki a szükséges utalási csomagot. Állítsd be a cél pénztárcát BinX-re. Állítsd az értéknapot holnaptól számítva legfeljebb +90 napig. A mai napra (vagy korábbra) beállított értéknapot a BinX el fogja utasítani. A QUiCK a BinX pénztárca választásakor figyelmeztet: „BinX esetében az utalások aznapi dátummal egyelőre nem tudnak teljesülni. Ha a csomagban mai fizetési időpontot állítasz be, akkor azt a BinX el fogja utasítani.” Nézd át a csomagban szereplő sorokat: Kedvezményezett neve (max. 70 karakter) Kedvezményezett számlaszám/IBAN vagy BinX azonosító Közlemény (max. 140 karakter, engedélyezett karakterekkel) A QUiCK automatikusan vágja a túl hosszú mezőket, és kiszedi a nem engedélyezett karaktereket, de érdemes manuálisan is átnézned a kritikus tételeket. Kattints az Export → BinX CSV lehetőségre. A QUiCK lefuttatja a formátum- és mezőellenőrzéseket. Ha minden rendben, letöltésre kerül a BinX-kompatibilis CSV fájl. Importáld a BinX felületére és írd alá Jelentkezz be a BinX vállalati banki felületére. Válaszd ki az import funkciót, és töltsd fel a QUiCK-ből letöltött CSV-t. Ellenőrizd a beolvasott tételeket, majd írd alá őket a BinX felületén. Tipikus hibák és megoldások (felhasználói nézőpontból)
Értéknap = ma / múltbeli dátum Probléma: a BinX nem tölti be, elutasítja az ilyen tételeket. Megoldás: állítsd az értéknapot holnapra vagy későbbre, de maximum +90 napra. Túl hosszú név vagy közlemény Probléma: a BinX korlátokat alkalmaz (név ≤ 70 karakter, közlemény ≤ 140 karakter). A QUiCK automatikusan vág, de emiatt lényegi információ vesződhet el. Megoldás: szerkeszd a nevet/ közleményt a QUiCK-ben, hogy a lényeg maradjon a mezőben. Hibás számlaszám formátum Probléma: a BinX csak bizonyos formátumokat fogad el (8 jegyű BinX azonosító, 16/24 jegyű számlaszám, HU IBAN). Megoldás: javítsd a számlaszámot a támogatott formátum valamelyikére. Túl sok tétel egy fájlban (>100) Probléma: a BinX import tétellimitje 100 sor/fájl. Megoldás: bontsd több utalási csomagra vagy több exportfájlra, és külön importáld őket. 3.1 Mire használható (lehetőségek)
A BinX utaláskönnyítőt az alábbi helyzetekben érdemes használnod:
Tömeges belföldi HUF utalások előkészítése BinX felé Egyszerre sok, kisebb összegű kifizetés Rendszeres, ismétlődő kifizetések kezelése QUiCK-ből Ugyanarra a partnerlistára történő gyakori utalások (pl. havi számlák, bérjellegű kifizetések – ha BinX-en keresztül történnek). Adattisztítás és egységesítés BinX szabályok szerint Ha biztosra akarsz menni, hogy a nevek, közlemények és számlaszámok formailag megfelelnek a BinX elvárásainak. Adminisztráció csökkentése a pénzügyi csapatnál Nem kell a BinX felületén kézzel rögzíteni minden tételt, elég a QUiCK-ben felépített csomagot exportálni és importálni. 3.2 Mire nem használható? (limitációk)
A BinX utaláskönnyítő használata során az alábbi korlátokat és kizárásokat tartsd szem előtt:
Nem alkalmas más bankok exportjára A generált CSV kifejezetten BinX vállalati banki felületre készült. Más banki rendszerekhez külön exportformátum szükséges. Nem használható devizás utalásokhoz A BinX import jelenleg csak HUF devizanemet fogad el. Külföldi devizás utalásokhoz más csatornát vagy folyamatot kell használnod. Nem alkalmas aznapi értéknappal futó utalások teljesítésére BinX oldali korlát, hogy aznapi értéknappal az importált utalások egyelőre nem tudnak teljesülni. Ha ma szeretnél utalni, azt más módon (pl. közvetlen rögzítés a BinX felületén) kell megoldanod. Nem kerül meg minden banki ellenőrzést A QUiCK sok formátum- és mezőellenőrzést elvégez, de a végső döntés a BinX rendszeréé. Banki oldalon továbbra is lehetnek limitációk (pl. partner státusz, banki belső szabályok), amelyeket a QUiCK nem lát. Nem kezeli automatikusan a 100 tétel feletti csomagokat A BinX importban maximum 100 tétel/fájl engedélyezett. A QUiCK jelzi a limitet, de a logikai bontást (melyik tétel melyik fájlba kerüljön) neked kell eldöntened. Fájlformátum és általános paraméterek
Tétellimit: maximum 100 tétel / fájl (BinX oldali korlát) Mezőspecifikációk (BinX-követelmények)
Kedvezményezett neve (partner_name) Tartalom: betűk és számok, magyar ékezetek támogatottak. a túl hosszú nevet automatikusan levágja 70 karakterre, a tiltott karaktereket (nem engedélyezett speciális jelek) eltávolítja. Kedvezményezett számlaszám/azonosító (partner_account_number) 8 jegyű BinX e-pénzszámla azonosító, vagy 16/24 jegyű számlaszám, vagy magyar IBAN: HU + 2 számjegy + 24 számjegy. A QUiCK ellenőrzi, hogy a számlaszám a fenti formák valamelyikének megfelel-e, hibás formátum esetén hiba- vagy figyelmeztető üzenetet ad. nem lehet a mai nap vagy korábbi dátum, legfeljebb +90 napra állítható. BinX pénztárca választásakor a felületen figyelmeztető üzenetet jelenít meg az aznapi értéknap korlátozásáról: „BinX esetében az utalások aznapi dátummal egyelőre nem tudnak teljesülni. Ha a csomagban mai fizetési időpontot állítasz be, akkor azt a BinX el fogja utasítani.” Típus: egész szám, tizedesjegyek nélkül. Nem engedélyezett: negatív érték, nem numerikus karakterek. Deviza (payment_currency) A BinX import jelenleg csak HUF devizát fogad el, a QUiCK nem enged más devizanemet a BinX exportban. Közlemény (payment_details) Hossz: max. 140 karakter. Tartalom: betűk, számok, valamint az alábbi speciális karakterek: a nem megengedett karaktereket eltávolítja, 140 karakternél hosszabb érték esetén levágja a mezőt. Validációs logika összefoglalva
Export indításakor a QUiCK: Ellenőrzi a kötelező mezők meglétét. Formátumellenőrzést végez az értéknapon, összegen, számlaszámon. Tisztítja és vágja a szöveges mezőket (név, közlemény) a BinX-limitnek megfelelően. Ellenőrzi, hogy a tételszám ≤ 100. A fenti szabályok biztosítják, hogy a QUiCK-ből generált BinX CSV a lehető legnagyobb valószínűséggel hiba nélkül beolvasásra kerül a BinX vállalati banki felületén, és a felhasználó számára átlátható, reprodukálható folyamatot ad a napi pénzügyi működéshez.