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.
Pipeline spracovania VS (5 krokov)
Variabilný symbol prechádza pri transformácii nasledujúcimi krokmi v presnom poradí:
- Extrakcia VS z textu — ak stĺpec VS obsahuje zložený text (napr.
Číslo objednávky: ABC123, Kód: XYZ), nastavte prefix a koniec hodnoty (delimiter) pre vytiahnutie čistej hodnoty. Viac prefixov — každý na novom riadku, prvý má najvyššiu prioritu. Ak sa prefix nenájde, VS bude prázdny. - Zlúčenie riadkov podľa VS — voliteľné. Riadky s rovnakým extrahovaným VS sa zlúčia do jednej transakcie (napr. brutto a poplatok v dvoch riadkoch). Zlučuje sa podľa celého extrahovaného VS, nie podľa skráteného 10-ciferného čísla.
- Formátovanie pre GPC — aplikuje sa zvolený režim (Len číslice / Znaky preveď / Premapovať).
- Formátovanie pre SEPA XML — samostatný režim, nezávisle od GPC.
- VS mapovanie (remap) — voliteľné premapovanie podľa vlastnej tabuľky.
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 Premenované | Ponechá pôvodnú hodnotu bez zmeny (vrátane písmen a špeciálnych znakov). Predtým sa volalo „Bez úprav". | ABC-123/X | ABC-123/X |
| Zachovaj špeciálne znaky Nové | Ponechá písmená, pomlčky, lomky a ďalšie znaky — ideálne pre referencie z platobných brán a marketplace platforiem (Stripe, PayPal, Allegro, Amazon). Limit dĺžky EndToEndId 35 znakov (ISO 20022 Max35Text) sa naďalej rešpektuje. |
ORD-2026/04-001 | ORD-2026/04-001 |
| 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