Налаштування змінного символу
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.
Що таке змінний код?
Змінний символ — це числовий ідентифікатор, прив'язаний до платежу, який служить для зіставлення платежів з рахунками-фактурами або замовленнями. У чеській та словацькій банківській системі VS зазвичай є 10-значним числом. У міжнародних платіжних системах (наприклад, PayPal, Wise, Amazon) замість VS використовуються текстові ідентифікатори (номери замовлень, референтні коди).
Biatec дозволяє налаштувати, як ці текстові ідентифікатори перетворюються на числовий VS для формату GPC, і як вони відображаються у форматі SEPA XML.
Процес обробки VS (5 кроків)
Під час трансформації змінний символ проходить наступні кроки в точному порядку:
- Витяг VS з тексту — якщо стовпець VS містить складений текст (наприклад,
Číslo objednávky: ABC123, Kód: XYZ), встановіть префікс і кінець значення (роздільник) для вилучення чистого значення. Кілька префіксів — кожен у новому рядку, перший має найвищий пріоритет. Якщо префікс не знайдено, VS буде порожнім. - Об'єднання рядків за VS — опціонально. Рядки з однаковим витягнутим VS об'єднуються в одну транзакцію (наприклад, сума брутто та комісія у двох рядках). Об'єднання відбувається за повним витягнутим VS, а не за скороченим 10-значним номером.
- Форматування для GPC — застосовується обраний режим (Тільки цифри / Перетворити символи / Перемапувати).
- Форматування для SEPA XML — окремий режим, незалежний від GPC.
- Мапування VS (remap) — опціональне перемапування за власною таблицею.
Режими VS для виводу GPC
Формат GPC підтримує лише цифри, а VS має рівно 10 позицій (доповнюється нулями зліва).
| Режим | Опис | Вхід | Вихід GPC |
|---|---|---|---|
| Тільки цифри | Видаляє всі нечислові символи, залишає тільки цифри | ABC-123/X | 0000000123 |
| Перетворити символи на цифри | Кожен символ перетворюється на цифру згідно з таблицею перетворення | ABC123 | 0120123000 |
| Перемапувати на VS | Власна таблиця перекладу (джерельне значення = цільовий VS) | ORD-001 | 1234567890 |
Режими VS для виводу SEPA XML
SEPA XML підтримує як літери, так і цифри, а VS має змінну довжину.
| Режим | Опис | Вхід | Вихід XML |
|---|---|---|---|
| Усі символи Перейменовано | Зберігає оригінальне значення без змін (включно з літерами та спеціальними символами). Раніше називався «Без змін». | ABC-123/X | ABC-123/X |
| Зберегти спеціальні символи Нове | Зберігає літери, тире, ламки та інші символи — ідеально підходить для посилань із платіжних шлюзів та платформ маркетплейсів (Stripe, PayPal, Allegro, Amazon). Обмеження довжини EndToEndId 35 символів (ISO 20022 Max35Text) продовжує дотримуватися. |
ORD-2026/04-001 | ORD-2026/04-001 |
| Тільки цифри | Видаляє всі нечислові символи | ABC-123/X | 123 |
| Перетворити символи на цифри | Кожен символ перетворюється на цифру | ABC123 | 012012300 |
| Перемапувати на VS | Власна таблиця перекладу | ORD-001 | 1234567890 |
Максимальна довжина VS (SEPA XML)
Налаштування «Макс. довжина» обмежує кількість символів змінного символу у вихідних даних SEPA XML:
- 0 — без обмеження, VS не обрізається
- 10 — така сама довжина, як GPC (рекомендовано для сумісності)
- Інше значення — VS буде обрізано до вказаної кількості символів
Для виводу GPC довжина завжди становить рівно 10 символів (доповнюється нулями зліва, або обрізається справа).
Теги /VS (SEPA XML)
Налаштування «Використовувати тег /VS» визначає, чи буде змінний символ включений у структуроване повідомлення для одержувача:
| Налаштування | Вихід у XML |
|---|---|
| Увімкнено | /VS1234567890/SS/KS0308 |
| Вимкнено | 1234567890 |
Таблиця перетворення символів у цифри
Ця таблиця використовується в режимі «Перетворити символи на цифри»:
| Символ | Цифра | Символ | Цифра | Символ | Цифра | ||
|---|---|---|---|---|---|---|---|
| А | 0 | J | 9 | S | 8 | ||
| B | 1 | К | 0 | Т | 9 | ||
| C | 2 | L | 1 | U | 0 | ||
| Д | 3 | М | 2 | В | 1 | ||
| E | 4 | N | 3 | W | 2 | ||
| F | 5 | О | 4 | X | 3 | ||
| G | 6 | P | 5 | Y | 4 | ||
| H | 7 | Q | 6 | Z | 5 | ||
| I | 8 | R | 7 |
Спеціальні символи:
| Символ | Цифра |
|---|---|
| - (тире) | 0 |
| _ (підкреслення) | 7 |
| + (плюс) | 8 |
| / (коса риска) | 9 |
Власне відображення (Перемапувати на VS)
У режимі «Перемапувати на VS» ви можете визначити власне мапування вихідних значень на цільові змінні символи. Формат простий — один рядок на одне мапування:
ORD-001=1234567890 ORD-002=9876543210 SUBSCRIPTION-MONTHLY=5555555555 REF/2024/001=1111111111
Правила відображення:
- Кожен рядок містить
zdrojová_hodnota=cieľový_vs - Порівняння є точним (з урахуванням регістру)
- Якщо вихідне значення не знайдено у відображенні, використовується режим резервного варіанту «Тільки цифри»
- Цільова VS повинна містити лише цифри (для GPC) або алфавітно-цифрові символи (для XML)
Комісія за транзакцію (fee)
0000000000 (GPC) або порожнє значення (XML), незалежно від встановленого режиму. Це також стосується режиму «Перемапувати на VS».
Підсумок
- GPC — VS завжди є 10-значним числом (тільки цифри, доповнюється нулями)
- SEPA XML — VS має змінну довжину і може містити літери (залежно від режиму)
- Мапування є спільним для GPC та XML — визначається один раз
- Налаштування є індивідуальними для кожного файлу — кожен завантажений файл може мати інший режим VS
- За замовчуванням налаштування успадковуються від типу файлу під час завантаження