VICTAR Anleitung

Die VICTAR Web App ist seit dem 01.10.2021 für den Testbetrieb freigeschaltet. Du findest die Web App über das VICTAR Menü oder diesen Link.

Anmeldung

Eine Anmeldung an der VICTAR Web App ist nicht notwendig. Sobald du in deinem VICTAR-Mitgliedschafts-Account angemeldet bist, bist du automatisch auch in der VICTAR Web App angemeldet (Single Sign on).

Willkommen

VICTAR Web App Willkommen 3
VICTAR Web App Willkommensseite

Auf der Willkommen Seite siehst du einige Informationen über dein Depot wie beispielsweise den von dir gewählten Namen für das Depot. Ausserdem siehst du wann du deine letzten Buchungsläufe durchgeführt hast. VICTAR unterscheidet zwischen Daily Run, Last Week Run, Last Month Run, Year To Date Run und Upload Run. Über die Buttons auf der Willkommen-Seite kannst du jeden dieser Buchungsläufe per Hand einstellen.

Bei Upload Runs verbucht VICTAR alle Depotumsätze, die in der hochgeladenen Flex-Query XML-Datei enthalten sind. Du kannst die XML-Datei von deinem Gerät auswählen. Upload Runs sind sinnvoll für Daten, die länger als das laufende Jahr zurückliegen oder aus einem anderen Depot als deinem aktuellen Depot stammen. VICTAR holt die Depotumsätze ausschliesslich aus der hochgeladenen Datei und baut keine Verbindung zu deinem Broker auf.

Die Verarbeitung findet nicht sofort statt. Du solltest die Ergebnisse eines eingestellten Runs aber spätestens eine Stunde nach Einstellung erhalten. Aktuell kann jeder VICTAR-Nutzer jeweils einen Run gleichzeitig zur Verarbeitung einstellen.

Du erhältst eine Email mit den Ergebnissen deines Runs sobald die Verarbeitung abgeschlossen ist.

Bis dein eingestellter Run verarbeitet ist, ist die Veränderung der anderen Einstellungen nicht möglich (Die Buttons sind in dieser Zeit ausgegraut).

User-Einstellungen

VICTAR Web App User Einstellungen
VICTAR Web App Benutzereinstellungen

Im Bereich User kannst du die folgenden Einstellungen einsehen und anpassen:

  • E-Mail Adresse: An diese E-Mail-Addresse verschickt VICTAR die für dich erzeugten Dateien. Diese E-Mail-Adresse ist nicht änderbar. Sie entspricht der Email-Adresse, die du für den VICTAR-Mitgliederbereich verwendest.
  • Benutzername: Diesen Namen verwendet VICTAR in den versendeten Emails um dich anzusprechen. Ausserdem fliesst der Benutzername in die Namen der für dich erzeugten Buchungs-Dateien ein

Depot-Einstellungen

VICTAR Web App Depots 1
VICTAR Web App für Depot-Einstellungen

Im Bereich Depots kannst du die folgenden Einstellungen einsehen und anpassen. Falls du es noch nicht getan hast, solltest du jetzt auf der Webseite deines Brokers ein Active Token und die Flex-Queries einrichten.

  • Depot-Name: Diesen Namen verwendet VICTAR in den versendeten Emails um das Depot zu benennen, für das VICTAR Buchungsdaten generiert hat. Ausserdem fliesst der Depot-Name in die Namen der für dich erzeugten Buchungs-Dateien ein
  • Active-Token: Hier fügst du das Active-Token ein, dass du bei der Einrichtung erstellt hast.
  • Daily Flex-Query ID
  • Last Week Flex-Query ID
  • Last Month Flex-Query ID
  • Year To Date Flex-Query ID

Für jeden Zeitraum kannst du einen Test Run durchführen. Ein Test Run verarbeitet keine Daten. Es wird lediglich geprüft ob mit den Einstellungen deiner Flex Query die notwendigen Daten von deinem Broker abgeholt werden können.

Buchhaltungseinstellungen

VICTAR Web App Buchhaltung 1
VICTAR Seite für Buchhaltungs-Einstellungen

Im Bereich Buchhaltung kannst du für die folgenden Einstellungen für die Verbuchung deiner Depot-Transaktionen einsehen und anpassen:

  • Kontenrahmen: Bei der Verbuchung deiner Depot-Transaktionen kannst du auswählen, ob diese nach dem DATEV Standardkontenrahmen SKR03 oder SKR04 verbucht werden sollen. Die Standardeinstellung ist SKR04. Falls du dir unschlüssig bist, kannst du deinen Steuerberater fragen welchen Kontenrahmen er bevorzugt. VICTAR fügt in beide Kontenrahmen zusätzliche Kontennummern ein, die für eine ordentliche Verbuchung notwendig sind. Eine Übersicht findest du in der Tabelle der von VICTAR genutzten Kontennummern.
  • Format: VICTAR erzeugt aus deinen Depot-Transaktionen Dateien, in denen die erzeugten Buchungssätze enthalten sind. Du kannst aus den folgenden Formaten auswählen.
    • DATEV CSV: Erzeugt erzeugt für deine Buchungssätze Dateien im standardisierten Dateiformat DATEV Pro. Alle Steuerberater sind in der Lage dieses Format automatisiert einzulesen und weiterzuverarbeiten.
    • MonKey CSV: Erzeugt für deine Buchungssätze Dateien im CSV Format, das du mit der Buchhaltungs-Software MonKey Office einlesen kannst.

Zustellungseinstellungeneinstellungen

VICTAR Web App Zustellung
VICTAR Seite für Buchhaltungs-Einstellungen

Im Bereich Zustellung kannst du auswählen in welchem Intervall VICTAR automatisch Buchungssätze für dich erzeugen und dir per E-Mail zustellen soll.

  • wöchentlich: VICTAR stellt dir wöchentlich die Buchungssätze für deine Transaktionen der Vorwoche zu
  • monatlich: VICTAR stellt die monatlich die Buchungssätze für deine Transaktionen des Vormonats zu

Abmelden

Um dich von der VICTAR Web App abzumelden, reicht es aus, dass du dich aus dem VICTAR-Mitgliederbereich abmeldest.

Active Token und Flex-Query IDs erstellen

Du kannst VICTAR deine Depotumsätze über zwei verschiedene Wege zur Verfügung stellen. Ein Weg ist der Upload von Flex-Query-XML-Dateien, die du vorher selbst erzeugt hast.

Der bequemere Weg ist die Einrichtung von Flex-Queries für die automatische Datenabfrage. Hast du die Flex-Queries für die automatische Datenabfrage einmal eingerichtet, dann kann VICTAR regelmässig automatisch die notwendigen Daten zur Verbuchung von deinem Broker abholen.

Die folgenden Abschnitte beschreiben die Einrichtung der Flex-Queries für die automatische Datenabfrage.

Verbuchungszeiträume

VICTAR erzeugt deine Buchungssätze in Buchungsläufen, sogenannten „Runs“. Dazu besorgt sich VICTAR zunächst alle Daten für den Run von deinem Broker. Die folgenden Runs unterstützt VICTAR:

Daily Run

Für einen Daily Run verwendet VICTAR die Transaktionen deines Depots des letzten Geschäftstages. Ein Daily Run, der am Dienstag den 19.10.2021 ausgeführt wird erzeugt also Buchungssätze für alle Transaktionen, die am Montag dem 18.10.2021 stattgefunden haben.

Daily Runs werden nicht automatisch ausgeführt, sondern können über die WebApp bei Bedarf ausgelöst werden.

Last Week Run

Für einen Last Week Run verwendet VICTAR die Transaktionen deines Depots der letzten Woche. Ein Last Week Run, der am Dienstag den 19.10.2021 ausgeführt wird erzeugt also Buchungssätze für alle Transaktionen, die in der Vorwoche (11.10.2021 bis 17.10.2021) stattgefunden haben.

Über die Web App kannst du einstellen, ob du deine Buchungsdaten automatisch wöchentlich oder monatlich zugestellt bekommen möchtest.

Last Month Run

Für einen Last Month Run verwendet VICTAR die Transaktionen deines Depots des letzten Monats. Ein Last Month Run, der am Dienstag den 19.10.2021 ausgeführt wird, erzeugt also Buchungssätze für alle Transaktionen, die im Vormonat (01.09. 2021 bis 30.09. 2021 stattgefunden haben.

Year to Date Run

Für einen Year To Date Run verwendet VICTAR die Transaktionen des laufenden Jahres bis zum gestrigen Tag. Ein Year To Date Run, der am Dienstag den 19.10.2021 ausgeführt wird, erzeugt also Buchungssätze für alle Transaktionen vom 01.01.2021 bis zum 18.10.2021.

Upload Run

Für einen Upload Run verwendet VICTAR die Transaktionen die durch den Upload einer XML-Datei zur Verfügung gestellt hast. Für welchen Zeitraum VICTAR Buchungssätze erzeugt hängt also von den Einstellungen ab, die du für die Erzeugung der XML-Datei verwendet hast.

Einstellungen für VICTAR Flex Queries

Die im Folgenden beschriebenen Einstellungen sind für alle VICTAR FlexQueries (Daily, Last Week, Last Month, Year To Date) identisch. Die Flex Queries unterscheiden sich nur im eingestellten Zeitraum.

VICTAR FlexQuery Abschnitte
Abschnitte für die Daily Flex-Query
  • In deinem Broker Account wechselst du in den Bereich „Berichte/Steuerdokumente“ und dort zum Punkt Flex-Queries.
  • Es gibt zwei Arten von Flex-Queries: Kontoumsatz-FlexQueries und Handelsbestätigung-Flex-Queries.
  • Du legst eine neue Kontoumsatz-Flex-Query an, der du einen beliebigen Namen geben kannst.
  • Im Bereich „Abschnitte“ wählst du die folgenden Abschnitte aus
    • „Bartransaktionen“
    • „Debit-Card-Kontoumsätze“
    • „Eingehende/Ausgehende Transaktionstransfers“
    • „Forex-G&V-Details“
    • „Informationen zum Finanzinstrument“
    • „Kapitalflussrechnung“
    • „Kapitalmaßnahmen“
    • „Komplexe Positionen“
    • „Kontoinformationen“
    • „Optionsausübungen, Zuteilungen und -fälligkeiten“
    • „Trades“
    • „Transfers“

Bei den folgenden Abschnitten gibt es keine Optionen. Bei diesen wählst du also immer nur für die Attribut-Liste „Alle Auswählen“.

  • „Debit-Card-Kontoumsätze“
  • „Kontoinformationen“
  • „Optionsausübungen, Zuteilungen und -fälligkeiten“
  • „Transfers“

Für die anderen Abschnitte ist die Auswahl im Folgenden beschrieben.

IB

Optionen für den Bereich Bartransaktionen

  • Für den Abschnitt „Bartransaktionen“ wählst du alle Optionen ausser „Gesamtübersicht
  • In der Attributliste darunter dann „Alle Auswählen„.
  • Die Reihenfolge der Attribute („Account ID“, „Account Alias“ etc.) ist für VICTAR egal.
  • Danach vergisst du nicht auf „speichern“ zu klicken.

IB Einrichtung 0042 Transaktionstransfers
Optionen für den Abschnitt Eingehende/Ausgehende Transaktionstransfers
  • Für den Abschnitt „Eingehende/Ausgehende Transaktionstransfers“ wählst du nur die Option „Transaktionstransfers
  • Die Reihenfolge der Attribute („Account ID“, „Account Alias“ etc.) ist für VICTAR egal.
  • Danach vergisst du nicht auf „speichern“ zu klicken.
IB

IB Einrichten 03 FlexQueries Kapitalfluss
  • Für den Abschnitt „Kapitalflussrechnung“ wählst du nur „Basiswährungsansicht
  • In der Attribut-Liste darunter dann „Alle Auswählen„.
  • Die Reihenfolge der Attribute („Account ID“, „Account Alias“ etc.) ist für VICTAR egal.
  • Danach vergisst du nicht auf „speichern“ zu klicken.
IB Einrichten 04 FlexQueries Trades
  • Für den Abschnitt „Trades“ wählst du nur die Ansicht „Ausführungen“ und darunter dann „Alle Auswählen„.
  • Die Reihenfolge der Attribute ist für VICTAR wieder egal.
  • Du denkst daran auf „speichern“ zu klicken.
FlexQueryZustellungseinstellungen
  • Nachdem du die Abschnitte wie oben beschrieben ausgewählt und gespeichert hast scrollst du nach unten zur „Zustellungskonfiguration
  • Dort wählst du als Format „XML“ aus und als Zeitraum den passenden Zeitraum für deine FlexQuery .
  • Die Einstellungen unter „Allgemeine Konfiguration“ setzt du wie im Screenshot gezeigt.
  • Besonders wichtig:
    • Datumsformat: yyyy-MM-dd
    • Gewinn und Verlust: Standard
  • Sobald du fertig bist klickst du auf „Weiter„.
  • Auf der folgenden Seite bekommst du eine Zusammenfassung der Einstellungen für deine Flex-Query angezeigt.
  • Falls du alles wie oben beschrieben eingestellt hast, kannst du einfach auf „Erstellen“ klicken.
IB Einrichten 07 FlexQueries fertig
  • Du bekommst jetzt die Bestätigung, daß deine Flex-Query erfolgreich angelegt wurde.
  • Die Erstellung der Flex-Query kannst du mit einem Klick auf „Ok“ abschließen.
  • Damit VICTAR die Daten für diese Flex-Query automatisch abholen kann musst du noch die folgenden Schritte durchführen
IB Einrichten Einstellungen
  • Im Bereich Einstellungen scrollst du bis zu dem Abschnitt „Reporting
  • Mt einem Klick auf das Zahnrad „Flex-Web-Service“ kommst du zu den Flex-Web-Service Einstellungen

Active Token

IB Einrichten 09 Einstellungen2FlexQueryWebService
  • Dort aktivierst du den Flex-Web-Service und kopierst dir die Nummer des Aktiven Tokens.
  • Diese Nummer brauchst du später für die VICTAR Depoteinstellungen.
  • Du speicherst die Einstellungen mit einem Klick auf „Speichern„.

Query-ID

IB Einrichten 08 Query ID ablesen
  • Für den letzten Schritt kehrst du in den Bereich „Berichte/Steuerdokumente“ zurück und wechselst wieder zum Punkt Flex-Queries.
  • Du klickst auf die Flex-Query die du vorher angelegt hast und kopierst die Query-ID.
  • Diese Nummer brauchst du ebenfalls für die VICTAR Depoteinstellungen.

Den beschrieben Ablauf wiederholst für alle Flex Queries (Daily, Last Week, Last Month und Year To Date). Dabei sind alle Einstellungen gleich. Nur die Einstellung für den Zeitraum darfst du entsprechend variieren.

Hast du die Werte für das Active Token und die Query Ids, dann kannst du die VICTAR Web App einrichten.

VICTAR App einrichten

Herzlichen Glückwunsch! Du hast die Schritte der VICTAR Anleitung für die Einrichtung der Flex-Queries erledigt!.Du hast nun

  • Active Token,
  • Daily Query-Id,
  • Last Week Query-Id,
  • Last Month Query-Id
  • Year to Date Query-Id.

Diese Daten gibst du jetzt in den Depot-Einstellungen der VICTAR-Web-App ein.