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é