Ustawienia symbolu zmiennego
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.
Czym jest symbol zmienny?
Symbol zmienny to numeryczny identyfikator przypisany do płatności, który służy do kojarzenia płatności z fakturami lub zamówieniami. W czeskim i słowackim systemie bankowym symbol zmienny to standardowo 10-cyfrowy numer. W międzynarodowych systemach płatniczych (np. PayPal, Wise, Amazon) zamiast VS stosuje się identyfikatory tekstowe (numery zamówień, kody referencyjne).
Biatec umożliwia skonfigurowanie sposobu, w jaki te identyfikatory tekstowe zostaną przekształcone na numeryczny VS dla formatu GPC oraz jak będą wyświetlane w formacie SEPA XML.
Proces przetwarzania VS (5 kroków)
Podczas transformacji symbol zmienny przechodzi przez następujące kroki w dokładnej kolejności:
- Ekstrakcja VS z tekstu — jeśli kolumna VS zawiera złożony tekst (np.
Číslo objednávky: ABC123, Kód: XYZ), ustaw prefiks i koniec wartości (delimiter), aby wyodrębnić czystą wartość. Wiele prefiksów — każdy w nowym wierszu, pierwszy ma najwyższy priorytet. Jeśli prefiks nie zostanie znaleziony, VS będzie pusty. - Łączenie wierszy według VS — opcjonalne. Wiersze z tym samym wyodrębnionym VS zostaną połączone w jedną transakcję (np. kwota brutto i opłata w dwóch wierszach). Łączenie odbywa się na podstawie całego wyodrębnionego VS, a nie skróconego 10-cyfrowego numeru.
- Formatowanie dla GPC — stosowany jest wybrany tryb (Tylko cyfry / Konwertuj znaki / Przemapuj).
- Formatowanie dla SEPA XML — oddzielny tryb, niezależny od GPC.
- Mapowanie VS (remap) — opcjonalne przemapowanie według własnej tabeli.
Tryby VS dla wyjścia GPC
Format GPC obsługuje tylko cyfry, a VS ma dokładnie 10 miejsc (uzupełniane zerami od lewej).
| Tryb | Opis | Wejście | Wyjście GPC |
|---|---|---|---|
| Tylko cyfry | Usuwa wszystkie znaki niecyfrowe, pozostawiając tylko cyfry | ABC-123/X | 0000000123 |
| Zamień znaki na cyfry | Każdy znak zostanie zamieniony na cyfrę zgodnie z tabelą konwersji | ABC123 | 0120123000 |
| Przemapuj na VS | Własna tabela mapowania (wartość źródłowa = docelowy VS) | ORD-001 | 1234567890 |
Tryby VS dla wyjścia SEPA XML
SEPA XML obsługuje zarówno litery, jak i cyfry, a VS ma zmienną długość.
| Tryb | Opis | Wejście | Wyjście XML |
|---|---|---|---|
| Wszystkie znaki Przemianowane | Zachowuje pierwotną wartość bez zmian (w tym litery i znaki specjalne). Wcześniej nazywało się to „Bez zmian”. | ABC-123/X | ABC-123/X |
| Zachowaj znaki specjalne Nowe | Zachowuje litery, myślniki, ukośniki i inne znaki — idealne do odniesień z bram płatniczych i platform marketplace (Stripe, PayPal, Allegro, Amazon). Limit długości EndToEndId 35 znaków (ISO 20022 Max35Text) jest nadal przestrzegany. |
ORD-2026/04-001 | ORD-2026/04-001 |
| Tylko cyfry | Usuwa wszystkie znaki niecyfrowe | ABC-123/X | 123 |
| Zamień znaki na cyfry | Każdy znak zostanie zamieniony na cyfrę | ABC123 | 012012300 |
| Przemapuj na VS | Własna tabela mapowania | ORD-001 | 1234567890 |
Maksymalna długość VS (SEPA XML)
Ustawienie „Maks. długość” ogranicza liczbę znaków symbolu zmiennego w wyjściu SEPA XML:
- 0 — bez ograniczeń, VS nie zostanie skrócony
- 10 — taka sama długość jak GPC (zalecane ze względu na kompatybilność)
- Inna wartość — VS zostanie skrócony do podanej liczby znaków
W przypadku wyjścia GPC długość wynosi zawsze dokładnie 10 znaków (uzupełniana zerami od lewej strony lub skracana od prawej strony).
Znacznik /VS (SEPA XML)
Ustawienie Użyj znacznika /VS określa, czy symbol zmienny zostanie zawarty w ustrukturyzowanej wiadomości dla odbiorcy:
| Ustawienie | Wyjście w formacie XML |
|---|---|
| Włączone | /VS1234567890/SS/KS0308 |
| Wyłączone | 1234567890 |
Tabela konwersji znaków na cyfry
Ta tabela jest używana w trybie „Zamień znaki na cyfry”:
| Znak | Cyfra | Znak | Cyfra | Znak | Cyfra | ||
|---|---|---|---|---|---|---|---|
| A | 0 | J | 9 | S | 8 | ||
| B | 1 | K | 0 | T | 9 | ||
| C | 2 | L | 1 | U | 0 | ||
| D | 3 | M | 2 | W | 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 |
Znaki specjalne:
| Znak | Cyfra |
|---|---|
| - (myślnik) | 0 |
| _ (podkreślenie) | 7 |
| + (znak plus) | 8 |
| / (ukośnik) | 9 |
Mapowanie niestandardowe (Przemapuj na VS)
W trybie „Premapuj na VS” można zdefiniować własne mapowanie wartości źródłowych na docelowe symbole zmiennych. Format jest prosty — jeden wiersz na jedno mapowanie:
ORD-001=1234567890 ORD-002=9876543210 SUBSCRIPTION-MONTHLY=5555555555 REF/2024/001=1111111111
Zasady mapowania:
- Każdy wiersz zawiera
zdrojová_hodnota=cieľový_vs - Porównanie jest dokładne (wrażliwe na wielkość liter)
- Jeśli wartość źródłowa nie zostanie znaleziona w mapowaniu, zostanie zastosowany tryb awaryjny „Tylko cyfry”
- Celem VS powinny być wyłącznie cyfry (dla GPC) lub znaki alfanumeryczne (dla XML)
Opłaty transakcyjne
0000000000 (GPC) lub jako wartość pusta (XML), niezależnie od ustawionego trybu. Dotyczy to również trybu „Przemapuj na VS”.
Podsumowanie
- GPC — VS to zawsze 10-cyfrowy numer (tylko cyfry, uzupełniony zerami)
- SEPA XML — VS ma zmienną długość i może zawierać litery (w zależności od trybu)
- Mapowanie jest wspólne dla GPC i XML — definiuje się je raz
- Ustawienia są dla każdego pliku — każdy przesłany plik może mieć inny tryb VS
- Ustawienia domyślne są dziedziczone z typu pliku podczas przesyłania