Nastavení 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.
Co je variabilní symbol?
Variabilní symbol je číselný identifikátor přiřazený k platbě, který slouží k přiřazování plateb k fakturám nebo objednávkám. V českém a slovenském bankovním systému je VS standardně 10místné číslo. V mezinárodních platebních systémech (např. PayPal, Wise, Amazon) se místo VS používají textové identifikátory (čísla objednávek, referenční kódy).
Biatec umožňuje nastavit, jak se tyto textové identifikátory převedou na číselný VS pro formát GPC a jak se zobrazí ve formátu SEPA XML.
Pipeline zpracování VS (5 kroků)
Variabilní symbol prochází při transformaci následujícími kroky v přesném pořadí:
- Extrakce VS z textu — pokud sloupec VS obsahuje složený text (např.
Číslo objednávky: ABC123, Kód: XYZ), nastavte prefix a konec hodnoty (oddělovač) pro extrakci čisté hodnoty. Více prefixů — každý na novém řádku, první má nejvyšší prioritu. Pokud se prefix nenajde, VS bude prázdný. - Sloučení řádků podle VS — volitelné. Řádky se stejným extrahovaným VS se sloučí do jedné transakce (např. hrubá částka a poplatek ve dvou řádcích). Sloučení se provádí podle celého extrahovaného VS, nikoli podle zkráceného 10místného čísla.
- Formátování pro GPC — použije se zvolený režim (Pouze číslice / Převést znaky / Přemapovat).
- Formátování pro SEPA XML — samostatný režim, nezávislý na GPC.
- Mapování VS (remap) — volitelné přemapování podle vlastní tabulky.
Režimy VS pro výstup GPC
Formát GPC podporuje pouze číslice a VS má přesně 10 míst (doplňuje se nulami zleva).
| Režim | Popis | Vstup | Výstup GPC |
|---|---|---|---|
| Pouze číslice | Odstraní všechny nečíselné znaky, ponechá pouze čísla | ABC-123/X | 0000000123 |
| Převést znaky na číslice | Každý znak se převede na číslici podle konverzní tabulky | ABC123 | 0120123000 |
| Přemapovat na VS | Vlastní mapovací tabulka (zdrojová hodnota = cílový VS) | ORD-001 | 1234567890 |
Režimy VS pro výstup SEPA XML
SEPA XML podporuje písmena i číslice a VS má proměnnou délku.
| Režim | Popis | Vstup | Výstup XML |
|---|---|---|---|
| Všechny znaky Přejmenováno | Zachová původní hodnotu beze změny (včetně písmen a speciálních znaků). Dříve se nazývalo „Bez úprav“. | ABC-123/X | ABC-123/X |
| Zachovat speciální znaky Nové | Zachová písmena, pomlčky, lomítka a další znaky — ideální pro odkazy z platebních bran a tržišť (Stripe, PayPal, Allegro, Amazon). Limit délky EndToEndId 35 znaků (ISO 20022 Max35Text) se nadále respektuje. |
ORD-2026/04-001 | ORD-2026/04-001 |
| Pouze číslice | Odstraní všechny nečíselné znaky | ABC-123/X | 123 |
| Převést znaky na číslice | Každý znak se převede na číslici | ABC123 | 012012300 |
| Přemapovat na VS | Vlastní mapovací tabulka | ORD-001 | 1234567890 |
Maximální délka VS (SEPA XML)
Nastavení Max. délka omezuje počet znaků variabilního symbolu ve výstupu SEPA XML:
- 0 — bez omezení, VS se nezkracuje
- 10 — stejná délka jako GPC (doporučeno z důvodu kompatibility)
- Jiná hodnota — VS se zkrátí na zadaný počet znaků
Pro výstup GPC je délka vždy přesně 10 znaků (doplňuje se nulami zleva, případně se zkrátí zprava).
Značka /VS (SEPA XML)
Nastavení Použít značku /VS určuje, zda bude variabilní symbol zabalen do strukturované zprávy pro příjemce:
| Nastavení | Výstup v XML |
|---|---|
| Zapnuto | /VS1234567890/SS/KS0308 |
| Vypnuto | 1234567890 |
Převodní tabulka znaků na číslice
Tato tabulka se používá v režimu „Převést znaky na číslice“:
| Znak | Číslice | Znak | Číslice | Znak | Číslice | ||
|---|---|---|---|---|---|---|---|
| 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 |
Zvláštní znaky:
| Znak | Číslice |
|---|---|
| - (pomlčka) | 0 |
| _ (podtržítko) | 7 |
| + (plus) | 8 |
| / (lomítko) | 9 |
Vlastní mapování (Přemapovat na VS)
V režimu „Přemapovat na VS“ můžete definovat vlastní mapování zdrojových hodnot na cílové proměnné symboly. Formát je jednoduchý — jeden řádek na jedno mapování:
ORD-001=1234567890 ORD-002=9876543210 SUBSCRIPTION-MONTHLY=5555555555 REF/2024/001=1111111111
Pravidla mapování:
- Každý řádek obsahuje
zdrojová_hodnota=cieľový_vs - Porovnání je přesné (rozlišuje velká a malá písmena)
- Pokud zdrojová hodnota není v mapování nalezena, použije se záložní režim „Pouze číslice“
- Cílová VS by měla obsahovat pouze číslice (pro GPC) nebo alfanumerické znaky (pro XML)
Poplatky za transakcii
0000000000 (GPC) nebo prázdná hodnota (XML), bez ohledu na nastavený režim. To platí i v režimu „Přemapovat na VS“.
Shrnutí
- GPC — VS je vždy 10místné číslo (pouze číslice, doplněné nulami)
- SEPA XML — VS má proměnnou délku a může obsahovat písmena (podle režimu)
- Mapování je společné pro GPC i XML — definuje se jednou
- Nastavení jsou pro každý soubor zvlášť — každý nahraný soubor může mít jiný režim VS
- Výchozí nastavení se při nahrávání přebírá z typu souboru