Anbindung Interactive Brokers / Einstellung der Flex-Web-Services
Der automatisierte Abruf von Transaktionsdaten ist zum gegenwärtigen Zeitpunkt nur für Depots bei Interactive Brokers bzw. den jeweiligen Introducing Brokern (in Deutschland z.B. AGORA direct, BANX, CapTrader, FinoBroker, FXFlat, LYNX und Promisioo) möglich.
Die erforderlichen Schritte sind im folgenden beschrieben und gliedern sich in:
- Aktivierung der Flex-Web-Services und Generierung eines ‘Aktiven Tokens’
- Definition der Flex-Queries für Handelsbstätigungen, Dividenden sowie Bartransaktionen – sofern jeweils gewünscht.
- Als vierte Query ist die Definition einer Flex-Query für Transaktionssteuern erforderlich, da Interactive Brokers Transaktionssteuern bestimmter Länder nicht als Bestandteil der Handelsbestätigungen ausweist.
Generierung eines ‘Aktiven Tokens’
Wählen Sie im Menü bei Interactive Brokers den Punkt ‘Berichtswesen’ und darunter den Punkt ‘Flex-Queries’ aus.
Rechts unten auf der Seite im Abschnitt ‘Flex-Web-Service-Konfiguration’ klicken Sie auf das Zahnrad-Symbol.
Aktivieren Sie den Flex-Web-Service-Status und kopieren Sie den angezeigten ‘Aktiven Token’ in Ihre Profil-Einstellungen auf wertpapiere-verbuchen.de wie hier beschrieben
Definition der Flex-Query für Handelsbestätigungen
Klicken Sie im Menü oben links erneut auf auf ‘Berichtswesen’ und dann auf ‘Flex Queries’. Klicken Sie im oberen Abschnitt ‘Kontoumsatz-Flex-Queries’ auf das Plus-Symbol und erstellen Sie eine neue Kontoumsatz-Flex-Query.
Konfigurieren Sie die Flex-Query wie links dargestellt:
- Query-Name: vergeben Sie einen frei wählbaren Namen
- Abschnitte: Klicken Sie auf den Abschnitt “Trades” und wählen Sie die links markierten Felder aus.
Achten Sie darauf, dass sich diese Felder unbedingt in genau dieser Reihenfolge befinden müssen!
- Zustellungskonfiguration: Wählen Sie als Format CSV und als Zeitraum die letzten 7 Kalendertage. (Der Abruf der Daten erfolgt täglich, sodass 7 Kalendertage einen Puffer für evtl. Störungen, Wartungsfenster o.ä. darstellen.)
Hinweis:Wir können Erlöse aus Wertpapier-Verkäufen nur richtig berechnen, wenn die entsprechende Kauf-Transaktion zuvor eingelesen wurde. D.h. für einen erstmaligen Import der Flex-Query-Daten wollen Sie ggf. einen größeren Zeitraum einstellen, um so alle Kauf-Transaktionen der momentan in Ihrem Portfolio befindlichen Wertpapiere abgedeckt zu haben.
- Allgemeine Konfiguration: Wählen Sie das Datumsformat ‘yyyy-MM-dd’, als Zeitformat ‘HH:mm:ss’, als Trennzeichen ‘ ‘ (Leerzeichen).
- Alle anderen Einstellung können unverändert bleiben bzw. sollten wie links dargestellt ausgewählt werden.
Speichern Sie die Flex-Query. Ihnen werden alle Einstellung noch einmal zur Überprüfung angezeigt. Oberhalb des Query-Namens finden Sie die Query-ID, die Sie in Ihre Profil-Einstellungen auf wertpapiere-verbuchen.de wie hier beschrieben übernehmen.
Definition der Flex-Query für Dividenden
Klicken Sie im Menü oben links erneut auf auf ‘Berichtswesen’ und auf ‘Flex Queries’. Klicken Sie im oberen Abschnitt ‘Kontoumsatz-Flex-Queries’ auf das Plus-Symbol und erstellen Sie eine neue Kontoumsatz-Flex-Query.
Konfigurieren Sie die Flex-Query wie rechts dargestellt:
- Query-Name: vergeben Sie einen frei wählbaren Namen
- Abschnitte: Klicken Sie auf ‘Veränderungen der Dividendenanhäufung’ (rechts unten) und wählen Sie folgende Felder aus: Currency, Symbol, ISIN, Report Date, Ex Date, Pay Date, Quantity, Tax, Gross Amount, Net Amount.
Achten Sie darauf, dass sich diese Felder unbedingt in genau dieser Reihenfolge befinden müssen!
- Zustellungskonfiguration: Wählen Sie als Format CSV und als Zeitraum die letzten 7 Kalendertage. (Der Abruf der Daten erfolgt täglich, sodass 7 Kalendertage einen Puffer für evtl. Störungen, Wartungsfenster o.ä. darstellen.)
- Allgemeine Konfiguration: Wählen Sie das Datumsformat ‘yyyy-MM-dd’, als Zeitformat ‘HH:mm:ss’, als Trennzeichen ‘ ‘ (Leerzeichen), sowie ‘Konto-Alias anstelle der Konto-ID anzeigen’
Speichern Sie die Flex-Query. Ihnen werden alle Einstellung noch einmal zur Überprüfung angezeigt. Oberhalb des Query-Namens finden Sie die Query-ID, die Sie in Ihre Profil-Einstellungen auf wertpapiere-verbuchen.de wie hier beschrieben übernehmen.
Definition der Flex-Query für Bartransaktionen
Klicken Sie im Menü oben links erneut auf auf ‘Berichtswesen’ und auf ‘Flex Queries’. Klicken Sie im oberen Abschnitt ‘Kontoumsatz-Flex-Queries’ auf das Plus-Symbol und erstellen Sie eine neue Kontoumsatz-Flex-Query.
Konfigurieren Sie die Flex-Query wie links dargestellt:
- Query-Name: vergeben Sie einen frei wählbaren Namen
- Abschnitte: Klicken Sie auf ‘Bartransaktionen’ (links oben).
- Innerhalb des Abschnitts ‘Optionen’ deaktivieren Sie folgendes: Dividenden, Emissionsgutschriften, Gesamtübersicht
- Wählen Sie folgende Felder aus: Currency, Description, Security ID, Settle Date, Amount, Type, Transaction ID.
Achten Sie darauf, dass sich diese Felder unbedingt in genau dieser Reihenfolge befinden müssen!
- Zustellungskonfiguration: Wählen Sie als Format CSV und als Zeitraum die letzten 7 Kalendertage. (Der Abruf der Daten erfolgt täglich, sodass 7 Kalendertage einen Puffer für evtl. Störungen, Wartungsfenster o.ä. darstellen.)
- Allgemeine Konfiguration: Wählen Sie das Datumsformat ‘yyyy-MM-dd’, als Zeitformat ‘HH:mm:ss’, als Trennzeichen ‘ ‘ (Leerzeichen), sowie ‘Konto-Alias anstelle der Konto-ID anzeigen’
Speichern Sie die Flex-Query. Ihnen werden alle Einstellung noch einmal zur Überprüfung angezeigt. Oberhalb des Query-Namens finden Sie die Query-ID, die Sie in Ihre Profil-Einstellungen auf wertpapiere-verbuchen.de wie hier beschrieben übernehmen.
Definition der Flex-Query für Transaktionssteuern
Klicken Sie im Menü oben links erneut auf auf ‘Berichtswesen’ und auf ‘Flex Queries’. Klicken Sie im oberen Abschnitt ‘Kontoumsatz-Flex-Queries’ auf das Plus-Symbol und erstellen Sie eine neue Kontoumsatz-Flex-Query.
Konfigurieren Sie die Flex-Query wie links dargestellt:
- Query-Name: vergeben Sie einen frei wählbaren Namen
- Abschnitte: Klicken Sie auf ‘Transaktionsgebühren’ (rechts in der Mitte).
- Innerhalb des Abschnitts ‘Optionen’ wählen Sie ‘Gesamtübersicht’ und deaktivieren ‘Details’.
- Wählen Sie folgende Felder aus: Currency, Asset Class, Symbol, Conid, Security ID, Security ID Type, CUSIP, ISIN, Date, Tax Description, Quantity, Report Date, Tax Amount, Trade ID, Trade Price, Source, Level of Detail.
Achten Sie darauf, dass sich diese Felder unbedingt in genau dieser Reihenfolge befinden müssen!
- Zustellungskonfiguration: Wählen Sie auch hier wieder als Format CSV und als Zeitraum die letzten 7 Kalendertage. (Der Abruf der Daten erfolgt täglich, sodass 7 Kalendertage einen Puffer für evtl. Störungen, Wartungsfenster o.ä. darstellen.)
- Allgemeine Konfiguration: Wählen Sie das Datumsformat ‘yyyy-MM-dd’, als Zeitformat ‘HH:mm:ss’, als Trennzeichen ‘ ‘ (Leerzeichen), sowie ‘Konto-Alias anstelle der Konto-ID anzeigen’
Speichern Sie die Flex-Query. Ihnen werden alle Einstellung noch einmal zur Überprüfung angezeigt. Oberhalb des Query-Namens finden Sie die Query-ID, die Sie in Ihre Profil-Einstellungen auf wertpapiere-verbuchen.de wie hier beschrieben übernehmen.
Bereitstellung historische Transaktionsdaten
Für die oben beschriebenen Flex-Queries empfehlen wir einen Zeitraum von 7 Tagen einzustellen. Wie beschrieben können wir die Erlöse aus Wertpapier-Verkäufen nur richtig berechnen, wenn wir alle entsprechende Kauf-Transaktion zuvor eingelesen haben.Für den erstmaligen Import der Flex-Query-Daten können Sie einen maximalen Zeitraum von 365 Tagen einstellen. Sollte diese Zeitspanne nicht ausreichen, d.h. Ihre Transaktionen liegen teilweise mehr als 365 Tage zurück, gehen Sie wie folgt vor:
- Klicken Sie für die entsprechende Flex-Query das Pfleilsymbol an.
- Wählen Sie in dem darauffolgenden Fenster einen benutzerdefinierten Zeitraum mit entsprechendem von/bis-Datum aus.
- Nach einem Klick auf “Starten” können Sie die entsprechenden Daten als CSV-Datei herunterladen und uns über den Menüpunkt CSV-Upload zukommen lassen.
- Auf diese Weise können Sie uns die Daten für zurückliegende Handelsbestätigungen, Dividenden, Bartransaktionen und Transaktionssteuern zukommen lassen.