Einstellungen für den variablen Verwendungszweck
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.
Was ist ein Verwendungszweck?
Ein variabler Symbol ist eine numerische Kennung, die einer Zahlung zugeordnet wird und dazu dient, Zahlungen mit Rechnungen oder Bestellungen abzugleichen. Im tschechischen und slowakischen Bankensystem ist das VS standardmäßig eine 10-stellige Nummer. In internationalen Zahlungssystemen (z. B. PayPal, Wise, Amazon) werden anstelle des VS Textkennungen (Bestellnummern, Referenzcodes) verwendet.
Biatec ermöglicht es, festzulegen, wie diese Textkennungen in ein numerisches VS für das GPC-Format umgewandelt werden und wie sie im SEPA-XML-Format angezeigt werden.
VS-Verarbeitungs-Pipeline (5 Schritte)
Das variable Symbol durchläuft bei der Transformation die folgenden Schritte in genau dieser Reihenfolge:
- Extraktion des VS aus dem Text – wenn die VS-Spalte zusammengesetzten Text enthält (z. B.
Číslo objednávky: ABC123, Kód: XYZ), legen Sie ein Präfix und ein Ende des Werts (Trennzeichen) fest, um den reinen Wert zu extrahieren. Mehrere Präfixe – jedes in einer neuen Zeile, wobei das erste die höchste Priorität hat. Wenn kein Präfix gefunden wird, bleibt das VS leer. - Zusammenführung von Zeilen nach VS — optional. Zeilen mit demselben extrahierten VS werden zu einer Transaktion zusammengefasst (z. B. Brutto und Gebühr in zwei Zeilen). Die Zusammenführung erfolgt anhand des gesamten extrahierten VS, nicht anhand der verkürzten 10-stelligen Nummer.
- Formatierung für GPC – der ausgewählte Modus wird angewendet (Nur Ziffern / Zeichen konvertieren / Neuzuordnen).
- Formatierung für SEPA XML – separater Modus, unabhängig von GPC.
- VS-Zuordnung (Remap) – optionale Neuzuordnung nach eigener Tabelle.
VS-Modi für GPC-Ausgabe
Das GPC-Format unterstützt nur Ziffern und VS hat genau 10 Stellen (wird von links mit Nullen aufgefüllt).
| Modus | Beschreibung | Eingabe | GPC-Ausgabe |
|---|---|---|---|
| Nur Ziffern | Entfernt alle nicht-numerischen Zeichen, behält nur Zahlen bei | ABC-123/X | 0000000123 |
| Zeichen in Ziffern umwandeln | Jedes Zeichen wird gemäß der Konvertierungstabelle in eine Ziffer umgewandelt | ABC123 | 0120123000 |
| Auf VS umwandeln | Eigene Zuordnungstabelle (Quellwert = Ziel-VS) | ORD-001 | 1234567890 |
VS-Modi für SEPA-XML-Ausgabe
SEPA XML unterstützt sowohl Buchstaben als auch Ziffern, und die VS hat eine variable Länge.
| Modus | Beschreibung | Eingabe | XML-Ausgabe |
|---|---|---|---|
| Alle Zeichen Umbenannt | Behält den ursprünglichen Wert unverändert bei (einschließlich Buchstaben und Sonderzeichen). Früher hieß dieser Modus „Keine Änderungen“. | ABC-123/X | ABC-123/X |
| Sonderzeichen beibehalten Neu | Behält Buchstaben, Bindestriche, Schrägstriche und andere Zeichen bei – ideal für Referenzen aus Zahlungsgateways und Marktplatzplattformen (Stripe, PayPal, Allegro, Amazon). Die Längenbeschränkung EndToEndId Die Längenbeschränkung von 35 Zeichen (ISO 20022 Max35Text) wird weiterhin eingehalten. |
ORD-2026/04-001 | ORD-2026/04-001 |
| Nur Ziffern | Entfernt alle nicht-numerischen Zeichen | ABC-123/X | 123 |
| Zeichen in Ziffern umwandeln | Jedes Zeichen wird in eine Ziffer umgewandelt | ABC123 | 012012300 |
| Auf VS umwandeln | Eigene Zuordnungstabelle | ORD-001 | 1234567890 |
Maximale Länge des VS (SEPA XML)
Die Einstellung „Max. Länge“ begrenzt die Anzahl der Zeichen des variablen Symbols in der SEPA-XML-Ausgabe:
- 0 — keine Begrenzung, VS wird nicht gekürzt
- 10 — gleiche Länge wie GPC (empfohlen aus Kompatibilitätsgründen)
- Anderer Wert — VS wird auf die angegebene Zeichenanzahl gekürzt
Für die GPC-Ausgabe beträgt die Länge immer genau 10 Zeichen (wird links mit Nullen aufgefüllt oder gegebenenfalls rechts gekürzt).
Tag /VS (SEPA XML)
Die Einstellung „Tag /VS verwenden“ legt fest, ob das variable Symbol in eine strukturierte Nachricht für den Empfänger eingebettet wird:
| Einstellung | Ausgabe in XML |
|---|---|
| Aktiviert | /VS1234567890/SS/KS0308 |
| Aus | 1234567890 |
Konvertierungstabelle von Zeichen in Ziffern
Diese Tabelle wird im Modus „Zeichen in Zahlen umwandeln“ verwendet:
| Zeichen | Ziffer | Zeichen | Ziffer | Zeichen | Ziffer | ||
|---|---|---|---|---|---|---|---|
| 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 |
Sonderzeichen:
| Zeichen | Ziffer |
|---|---|
| - (Bindestrich) | 0 |
| _ (Unterstrich) | 7 |
| + (Plus) | 8 |
| / (Schrägstrich) | 9 |
Benutzerdefinierte Zuordnung (Auf VS umordnen)
Im Modus „Auf VS ummappen“ können Sie eine benutzerdefinierte Zuordnung von Quellwerten zu Zielvariablensymbolen festlegen. Das Format ist einfach – eine Zeile pro Zuordnung:
ORD-001=1234567890 ORD-002=9876543210 SUBSCRIPTION-MONTHLY=5555555555 REF/2024/001=1111111111
Zuordnungsregeln:
- Jede Zeile enthält
zdrojová_hodnota=cieľový_vs - Der Vergleich ist exakt (Groß-/Kleinschreibung wird berücksichtigt)
- Wenn der Quellwert in der Zuordnung nicht gefunden wird, wird der Fallback-Modus „Nur Ziffern“ verwendet
- Das Ziel-VS sollte nur Ziffern (für GPC) oder alphanumerische Zeichen (für XML) enthalten
Transaktionsgebühren
0000000000 (GPC) oder als leerer Wert (XML) angezeigt, unabhängig vom eingestellten Modus. Dies gilt auch für den Modus „Auf VS umwandeln“.
Zusammenfassung
- GPC – VS ist immer eine 10-stellige Zahl (nur Ziffern, mit Nullen aufgefüllt)
- SEPA XML – VS hat eine variable Länge und kann Buchstaben enthalten (je nach Modus)
- Die Zuordnung ist für GPC und XML gleich – sie wird einmal definiert
- Die Einstellungen gelten pro Datei – jede hochgeladene Datei kann einen anderen VS-Modus haben
- Die Standardeinstellungen werden beim Hochladen vom Dateityp übernommen