A változó szimbólum beállításai
Variabilný symbol (VS) je identifikátor transakcie používaný v českom a slovenskom bankovníctve. Nastavte jeho formátovanie pre GPC aj SEPA XML výstupy.
Mi az a változó kód?
A változó szimbólum egy fizetéshez rendelt számos azonosító, amely a fizetések és a számlák vagy megrendelések összekapcsolására szolgál. A cseh és szlovák bankrendszerben a VS alapértelmezés szerint egy 10 számjegyű szám. A nemzetközi fizetési rendszerekben (pl. PayPal, Wise, Amazon) a VS helyett szöveges azonosítókat (megrendelésszámok, hivatkozási kódok) használnak.
A Biatec lehetővé teszi, hogy beállítsa, hogyan alakulnak át ezek a szöveges azonosítók numerikus VS-sé a GPC formátumhoz, és hogyan jelennek meg SEPA XML formátumban.
A VS feldolgozási folyamat (5 lépés)
A változó szimbólum átalakításakor a következő lépéseket végzi el pontosan ebben a sorrendben:
- VS kivonása a szövegből — ha a VS oszlop összetett szöveget tartalmaz (pl.
Číslo objednávky: ABC123, Kód: XYZ), állítsa be az előtagot és az érték végét (elválasztójelet) a tiszta érték kivonásához. Több előtag — mindegyik új sorban, az elsőnek van a legmagasabb prioritása. Ha az előtag nem található, a VS üres lesz. - Sorok egyesítése a VS szerint — opcionális. Az azonos kivont VS-sel rendelkező sorok egyetlen tranzakcióba egyesülnek (pl. bruttó és díj két sorban). Az egyesítés a teljes kivont VS szerint történik, nem a rövidített 10 számjegyű szám szerint.
- Formázás GPC-hez — a kiválasztott mód alkalmazásra kerül (Csak számok / Karakterek átalakítása / Újramapozás).
- Formázás SEPA XML-hez — külön mód, függetlenül a GPC-től.
- VS-térkép (remap) — opcionális átalakítás saját táblázat alapján.
VS módok a GPC kimenethez
A GPC formátum csak számjegyeket támogat, és a VS pontosan 10 karakter hosszú (balról nullákkal kiegészítve).
| Mód | Leírás | Bemenet | GPC kimenet |
|---|---|---|---|
| Csak számok | Eltávolítja az összes nem számjelleget, csak a számokat hagyja meg | ABC-123/X | 0000000123 |
| A karaktereket számjegyekké alakítja | Minden karaktert számmá alakít a konverziós táblázat szerint | ABC123 | 0120123000 |
| Átképezés VS-re | Saját leképezési táblázat (forrásérték = cél VS) | ORD-001 | 1234567890 |
VS-módok a SEPA XML kimenethez
A SEPA XML támogatja a betűket és a számokat is, és a VS hossza változó.
| Mód | Leírás | Bemenet | XML kimenet |
|---|---|---|---|
| Minden karakter Átnevezve | Az eredeti értéket változatlanul hagyja (beleértve a betűket és a speciális karaktereket is). Korábban „Módosítás nélkül” néven volt ismert. | ABC-123/X | ABC-123/X |
| Különleges karakterek megőrzése Új | Megtartja a betűket, kötőjeleket, törésjeleket és egyéb karaktereket — ideális fizetési átjárók és piactéri platformok (Stripe, PayPal, Allegro, Amazon) hivatkozásaihoz. A hosszúsági korlát EndToEndId A 35 karakteres hosszúsági korlát (ISO 20022 Max35Text) továbbra is érvényben marad. |
ORD-2026/04-001 | ORD-2026/04-001 |
| Csak számok | Eltávolítja az összes nem számjegy jelet | ABC-123/X | 123 |
| A karaktereket számjegyekké alakítja | Minden karaktert számjeggyé alakít | ABC123 | 012012300 |
| Átképezés VS-re | Saját leképezési táblázat | ORD-001 | 1234567890 |
A VS maximális hossza (SEPA XML)
A „Max. hossz” beállítás korlátozza a változó szimbólum karakterek számát a SEPA XML kimenetben:
- 0 — nincs korlátozás, a VS nem kerül levágásra
- 10 — ugyanolyan hosszúság, mint a GPC (kompatibilitás érdekében ajánlott)
- Egyéb érték — a VS a megadott karakterek számára lesz rövidítve
A GPC kimenet esetében a hossz mindig pontosan 10 karakter (balról nullákkal töltve ki, esetleg jobbról levágva).
/VS jel (SEPA XML)
A /VS címke használata beállítás határozza meg, hogy a változó szimbólum bekerül-e a címzettnek szóló strukturált üzenetbe:
| Beállítás | Kimenet XML-ben |
|---|---|
| Be | /VS1234567890/SS/KS0308 |
| Ki | 1234567890 |
Karakter-szám átalakítási táblázat
Ez a táblázat a „Karakterek számokká alakítása” módban használható:
| Karakter | Szám | Karakter | Szám | Karakter | Szám | ||
|---|---|---|---|---|---|---|---|
| A | 0 | J | 9 | S | 8 | ||
| B | 1 | K | 0 | T | 9 | ||
| C | 2 | L | 1 | U | 0 | ||
| D | 3 | M | 2 | V | 1 | ||
| E | 4 | N | 3 | W | 2 | ||
| F | 5 | O | 4 | X | 3 | ||
| G | 6 | P | 5 | Y | 4 | ||
| H | 7 | Q | 6 | Z | 5 | ||
| I | 8 | R | 7 |
Különleges karakterek:
| Karakter | Szám |
|---|---|
| - (kötőjel) | 0 |
| _ (aláhúzás) | 7 |
| + (plusz) | 8 |
| / (perjel) | 9 |
Egyéni leképezés (Átképezés VS-re)
Az „Átképezés VS-re” módban megadhatja a forrásértékek célváltozókra történő saját leképezését. A formátum egyszerű — egy sor egy leképezéshez:
ORD-001=1234567890 ORD-002=9876543210 SUBSCRIPTION-MONTHLY=5555555555 REF/2024/001=1111111111
Leképezési szabályok:
- Minden sor tartalmaz
zdrojová_hodnota=cieľový_vs - Az összehasonlítás pontos (kicsi-nagybetűk közötti különbséget tesz)
- Ha a forrásérték nem található a leképezésben, akkor a „Csak számok” fallback mód kerül alkalmazásra
- A cél VS-nek csak számokat (GPC esetén) vagy alfanumerikus karaktereket (XML esetén) szabad tartalmaznia
Tranzakciós díjak
0000000000 (GPC) vagy üres érték (XML) jelennek meg, függetlenül a beállított módtól. Ez a „VS-re átképezés” módra is érvényes.
Összefoglalás
- GPC — A VS mindig 10 számjegyű szám (csak számok, nullákkal kiegészítve)
- SEPA XML — A VS hossza változó, és tartalmazhat betűket (a módtól függően)
- A leképezés közös a GPC és az XML esetében — egyszer kell megadni
- A beállítások fájlonkénti alapúak — minden feltöltött fájlnak más VS módja lehet
- Az alapértelmezett beállítások a feltöltéskor a fájltípusból öröklődnek