Nastavenia variabilného symbolu
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.
Čo je variabilný symbol?
Variabilný symbol je číselný identifikátor priradený k platbe, ktorý slúži na párovanie platieb s faktúrami alebo objednávkami. V českom a slovenskom bankovom systéme je VS štandardne 10-miestne číslo. V medzinárodných platobných systémoch (napr. PayPal, Wise, Amazon) sa namiesto VS používajú textové identifikátory (čísla objednávok, referenčné kódy).
Biatec umožňuje nastaviť, ako sa tieto textové identifikátory prevedú do číselného VS pre GPC formát, a ako sa zobrazia v SEPA XML formáte.
Režimy VS pre GPC výstup
GPC formát podporuje iba číslice a VS má presne 10 miest (dopĺňa sa nulami zľava).
| Režim | Popis | Vstup | Výstup GPC |
|---|---|---|---|
| Len číslice | Odstráni všetky ne-číselné znaky, ponechá len čísla | ABC-123/X | 0000000123 |
| Znaky preveď na číslice | Každý znak sa prevedie na číslicu podľa konverznej tabuľky | ABC123 | 0120123000 |
| Premapovať na VS | Vlastná tabuľka mapovania (zdrojová hodnota = cieľový VS) | ORD-001 | 1234567890 |
Režimy VS pre SEPA XML výstup
SEPA XML podporuje písmená aj číslice a VS má premenlivú dĺžku.
| Režim | Popis | Vstup | Výstup XML |
|---|---|---|---|
| Všetky znaky | Ponechá pôvodnú hodnotu bez zmeny (vrátane písmen a špeciálnych znakov) | ABC-123/X | ABC-123/X |
| Len číslice | Odstráni všetky ne-číselné znaky | ABC-123/X | 123 |
| Znaky preveď na číslice | Každý znak sa prevedie na číslicu | ABC123 | 012012300 |
| Premapovať na VS | Vlastná tabuľka mapovania | ORD-001 | 1234567890 |
Maximálna dĺžka VS (SEPA XML)
Nastavenie Max. dĺžka obmedzuje počet znakov variabilného symbolu v SEPA XML výstupe:
- 0 — bez obmedzenia, VS sa neustrihne
- 10 — rovnaká dĺžka ako GPC (odporúčané pre kompatibilitu)
- Iná hodnota — VS sa ostrihne na zadaný počet znakov
Pre GPC výstup je dĺžka vždy presne 10 znakov (dopĺňa sa nulami zľava, prípadne sa ostrihne sprava).
Značka /VS (SEPA XML)
Nastavenie Používať značku /VS určuje, či sa variabilný symbol zabalí do štruktúrovanej správy pre príjemcu:
| Nastavenie | Výstup v XML |
|---|---|
| Zapnuté | /VS1234567890/SS/KS0308 |
| Vypnuté | 1234567890 |
Konverzná tabuľka znakov na číslice
Táto tabuľka sa používa v režime "Znaky preveď na číslice":
| Znak | Číslica | Znak | Číslica | Znak | Číslica | ||
|---|---|---|---|---|---|---|---|
| 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 |
Špeciálne znaky:
| Znak | Číslica |
|---|---|
| - (pomlčka) | 0 |
| _ (podčiarkovník) | 7 |
| + (plus) | 8 |
| / (lomka) | 9 |
Vlastné mapovanie (Premapovať na VS)
V režime "Premapovať na VS" môžete definovať vlastné mapovanie zdrojových hodnôt na cieľové variabilné symboly. Formát je jednoduchý — jeden riadok na jedno mapovanie:
ORD-001=1234567890 ORD-002=9876543210 SUBSCRIPTION-MONTHLY=5555555555 REF/2024/001=1111111111
Pravidlá mapovania:
- Každý riadok obsahuje
zdrojová_hodnota=cieľový_vs - Porovnanie je presné (case-sensitive)
- Ak sa zdrojová hodnota nenájde v mapovaní, použije sa fallback režim "Len číslice"
- Cieľový VS by mal obsahovať len číslice (pre GPC) alebo alfanumerické znaky (pre XML)
Fee transakcie (poplatky)
0000000000 (GPC) alebo prázdna hodnota (XML), bez ohľadu na nastavený režim. Toto platí aj pri režime "Premapovať na VS".
Zhrnutie
- GPC — VS je vždy 10-miestne číslo (len číslice, dopĺňa sa nulami)
- SEPA XML — VS má premenlivú dĺžku a môže obsahovať písmená (podľa režimu)
- Mapovanie je spoločné pre GPC aj XML — definuje sa raz
- Nastavenia sú per-súbor — každý nahraný súbor môže mať iný režim VS
- Predvolené nastavenia sa dedia z typu súboru pri uploade