Importvorlage für PDF

Eine Importvorlage für PDF ist eine Definition für eine einzelne Wertpapier Transaktion pro Dokument. Eine Importvorlage für ein PDF besteht aus einem in Text umgewandelten PDF Dokument der Handelsplattform. Danach werden die für die Transaktion relevanten Werte durch Variablen mit Ankerpunkten ersetzt. Ein Feld mit Ankerpunkte wird mit “{}” umschlossen, die Ankerpunkt sind mit einem “|” vom Feldnamen und unter sich getrennt. Ein Beispiel für eine gültiges Feld mit Ankerpunkten, auch Feldposition genannt, könnte wie folgt aussehen {datetime|P|N}.

Ankerpunkte

Die für die Transaktion relevanten Werte sind über das gesamte PDF-Dokument verteilt. Jedes dieser Transaktionsdokumente hat eine feste Struktur die sich für gleiche Art von Transaktion nur geringfügig ändert. Diese gleichartige Struktur kann GT mit Ankerpunkten für die Erkennung von Werten benutzen. Dabei referenziert der Ankerpunkt einen statischen Textteil der sich pro Dokument nicht ändert.

• Der Wert kann aus einer Dokumentenzeile erkannt werden. Falls die Struktur in einer Zeile sich kaum ändert, können die folgenden Ankerpunkte verwendet werden.
  • P: Vorhergehendes Wort. Funktioniert auch wenn sich der Wert am Beginn einer Zeile befindet. Dieser Ankerpunkt kann auf einen Regulären Ausdruck verweisen.
  • Pc: Der Wert hat ein Präfix, d.h. zwischen dem Wert und der Präfix hat es kein Leerzeichen.
  • N: Nachfolgendes Wort. Funktioniert auch wenn sich der Wert am Ende einer Zeile befindet. Dieser Ankerpunkt kann auf einen Regulären Ausdruck verweisen.
  • Nc: Der Wert hat ein Suffix, d.h. zwischen dem Wert und der Suffix hat es kein Leerzeichen.
  • SL: Das erste Wort derselben Zeile.
• PL und NL kommen zur Anwendung, falls sich der Ankerpunkt nicht auf einen statischen Textteil innerhalb der zu verarbeitende Zeile fixieren lässt. Möglicherweise ist der Zeilenanfang der vorhergehenden oder nachfolgende Zeile statischer Text.
  • PL: Das erste Wort des Zeilenanfanges der vorhergehenden Zeile.
  • NL: Das erste Wort des Zeilenanfanges der nachfolgenden Zeile.

Die Anzahl der Wörter und Zahlen in der Zeile des Ankerpunktes muss übereinstimmen, wenn SL, PL und NL als einziger Ankerpunkt gesetzt werden.

Auslesbarer Bereich

Der auslesbare Bereich definiert den zusammenhängenden Bereich von Zeilen des Dokuments wo die relevanten Werte liegen und welche durch Ankerpunkte referenziert werden. Normalerweise sind die paar ersten und letzten Zeile nicht im auslesbaren Bereich enthalten, daher dürfen diese sowohl in der Importvorlage wie auch im transformierten PDF-Dokument fehlen.

Ankerpunkte referenziert Menge von statischen Wörter am Zeilenanfang

Manchmal möchte man mit einem Ankerpunkt zwei Varianten eines statischen Wortes referenzieren. Diese Flexibilität ist für den Zeilenanfang derselben, vorhergehenden und nachfolgenden Zeile gegeben. Damit funktioniert dieses Konstrukt für PL, SL und NL. Die möglichen Wörter der Zeilenanfänge werden mit Klammer umschlossen und mit “|” [w1|w2|w…] getrennt. Im folgenden Beispiel kann der Zeilenanfang von Feld tt1 mit “Quellensteuer” oder “Verrechnungssteuer” beginnen:

[Quellensteuer|Verrechnungssteuer] 35% (CH) CHF {tt1|SL|N|O}

Mehr Varianz bei vorhergehenden und nachfolgenden Wort

Für das vorhergehende und nachfolgende Wort kann der Ankerpunkt eine grosse Flexibilität aufweisen. Wobei die Konfiguration ziemlich Anspruchsvoll sein kann, da diese den Einsatz von Regulärer Ausdrücke erlaubt. Bei Ankerpunkten P und N kann (?:) angewendet werden. Dieser erlaubt die Anwendung von einem Regulären Ausdruck, der nicht als Gruppe verarbeitet wird. Es ist ein sehr mächtiges Konstrukt, was uns eine gewisse Varianz für das vorhergehende und nachfolgende Wort erlaubt. Dazu zwei Beispiele:

BETRAG, DEN WIR DEM KONTO (?:GUTSCHREIBEN|BELASTEN) {cac|P|SL} {ta|SL|N}
{units|P|NL} Vanguard FTSE Japan ETF {quotation|NL|N} (?:[A-Z]{3}$)

Feldposition Konfiguration

Machmal muss eine Feldposition zusätzlich Konfiguriert werden, diese werden wie die Ankerpunkte in der Feldposition ausgedrückt.

• O: Es gibt optionale Werte wie Steuerkosten, die nur in bestimmten Dokumenten vorkommen. Mit der Konfiguration “O” lässt sich dies konfigurieren.
• R: Der Inhalt dieser Zeile kann sich mehrfach wiederholen. Diese Konfiguration ist hilfreich bei Verkauf und Kauf von einem Wertpapier, da manchmal die Transaktion über mehrere Börsentransaktionen ausgeführt wird. Die Konfiguration muss in der ersten Feldposition stehen. Folgende Wiederholungen kann nicht bewältigt werden, da sich die Anzahl der Spalten in den zwei Zeilen unterscheidet:

17 ZUM KURS VON 136,5
53 VON 136,5

Beispiel einer PDF Vorlage

In folgenden ist ein solche Vorlage für den Kauf und Verkauf von Wertpapieren aufgeführt.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

Gland, {datetime|P|N}
(?:Börsengeschäft:|Börsentransaktion:) {transType|P|N} Unsere Referenz: 12121212 
Gemäss Ihrem Kaufauftrag vom 12.12.2012 haben wir folgende Transaktionen vorgenommen:
Titel Ort der Ausführung
ISHARES $ CORP BND ISIN: {isin|P} SIX Swiss Exchange
NKN: 1613957
Anzahl Preis Betrag
{units|PL|R} {quotation} {cac} 8’000.00
Total USD 8’250.00
Kommission Swissquote Bank AG USD {tc1|SL|N|O}
[Abgabe (Eidg. Stempelsteuer)|Eidgenössische Stempelsteuer] USD {tt1|SL|N}
Börsengebühren USD {tc2|SL|N}
Zu Ihren Lasten USD {ta|SL|N}
[END]
transType=ACCUMULATE|Kauf
transType=REDUCE|Verkauf
dateFormat=dd.MM.yyyy
overRuleThousandSeparators= '’

• Zeile 1: Das {datetime|P|N} bezieht sich auf das Transaktionsdatum, als Ankerpunkt wurde das vorhergehende und nachfolgende Wort gewählt. In diesem Fall bezieht sich das P auf “Gland,” und N auf das Zeilenende.
• Zeile 2: Diese Zeile enthält einen Regulären Ausdruck, damit dies funktioniert muss der Ausdruck als Rückwärtsreferenz (?:…) definiert werden, andernfalls kann die Gruppierung von GT nicht mehr korrekt funktionieren.
• Zeile 5: Aus dieser Zeile wird die ISIN gelesen, normalerweise sollten mindestens zwei Ankerpunkte gesetzt werden. In diesem Fall ist {isin|P} über das gesamte Dokument eindeutig und ein Ankerpunkt genügt. Mit P wird hier der statische Text “ISIN:” referenziert.
• Zeile 8: {units|PL|R} {quotation} {cac} Diese Zeile kann sich wiederholen. Die Konfiguration R muss in der ersten Feldposition stehen.
• Zeile 10: Diese Feldposition der Haupttransaktionskosten {tc1|SL|N|O} ist optional. Die Ankerpunkte beziehen sich auf das Wort “Kommission” und dem Zeilenende.

Drei Gebührenpositionen

Ein CornerTrader-Beleg kann neben der Handelsgebühr und den Fremdgebühren eine zusätzliche «Ausführungsgeb. Swx» enthalten. Diese dritte Gebühr wird mit tc3 erfasst. Der folgende Ausschnitt zeigt die Zuordnung; die Stempelsteuer bleibt getrennt in tt1:

Handelsgebühr {tc1|SL|P|Nc|O}- CHF
Fremdgebühren {tc2|SL|P|Nc|O}- CHF
Stempel {tt1|SL|P|Nc|O}- CHF
Ausführungsgeb. Swx {tc3|SL|P|Nc|O}- CHF

Bei diesem Zahlenformat lautet die Konfiguration overRuleSeparators=All<.|,>. Nc berücksichtigt das direkt angehängte Minuszeichen; O erlaubt, dass eine Gebühren- oder Steuerzeile fehlt. Aus CHF 4,85, CHF 1,15 und CHF 0,77 entstehen Transaktionskosten von CHF 6,77. Die Stempelsteuer von CHF 11,53 wird separat erfasst. Die dritte Gebühr gehört weder in ein Steuerfeld noch in eine Rundungstoleranz.

Dividende in einer anderen Währung

Die Vorlage übernimmt die Ausschüttungswährung aus dem Beleg in cin, die Kontowährung in cac und den angegebenen Wechselkurs in cex. Bei einer Dividende kann die Ausschüttungswährung von der Handelswährung des gehaltenen Wertpapiers abweichen.

GT ordnet das Wertpapier über ISIN und cac zu. Mit dem Wechselkurs des Belegs rechnet GT die Dividende je Stück sowie die noch in Ausschüttungswährung angegebenen Steuern und Gebühren in die Kontowährung um. Bereits in Kontowährung angegebene Kosten werden nicht nochmals umgerechnet. Die errechnete Gutschrift muss dabei nach Rundung mit dem Beleg übereinstimmen. Für diese Zuordnung ist keine Bestandsabfrage erforderlich.

Beispiel: Eine Ausschüttung von DKK 3,75 je Stück für 500 Stück mit DKK 506,25 Quellensteuer und dem Wechselkurs 0,13378437 ergibt EUR 0,50169139 je Stück und EUR 67,73 Quellensteuer. Die Gutschrift bleibt EUR 183,12. GT ordnet die Dividende dem EUR-Wertpapier mit derselben ISIN zu. Die Transaktion wird vollständig in EUR abgebildet; der Wechselkurs wird nach der Umrechnung entfernt. Die ursprünglichen DKK-Beträge sind weiterhin im Beleg nachlesbar.

Fehlt das Wertpapier mit der Kombination ISIN und Kontowährung oder ein gültiger Wechselkurs, liegen Kosten in einer dritten Währung vor oder weicht die errechnete Gutschrift ab, erfolgt diese automatische Umrechnung nicht. Prüfen und ergänzen Sie dann die Zuordnung und Beträge vor dem Buchen.