Aktionen

Automatischer Abruf der Kontoumsätze (AutoAuszug)

Aus windata WIKI

Allgemein

Der AutoAuszug (Selbstbeweger) ist eine Funktionserweiterung zur Automatisierung von windata professional, welche den automatisierten, zeitgesteuerten Abruf von Kontoumsätzen sowie deren Export im beliebigen Format in definierte Verzeichnisse ermöglicht.
Der automatische Abruf von Kontoumsätzen ist für folgende Kommunikationsverfahren möglich:

HBCI mit PIN/TAN
HBCI mit Schlüsseldatei
FTAM
EBICS

Zusätzlich kann der Selbstbeweger automatisiert und zeitgesteuert windata-Datensicherungen erstellen, die im hinterlegten Verzeichnis abgespeichert werden.

 

Voraussetzung

Damit windata professional automatisiert Kontoumsätze abrufen und weitere Aktionen ausführen kann, müssen einige Voraussetzungen geschaffen werden:

  • Alle für den Zugang erforderlichen Daten, wie z. B. die HBCI-PIN bzw. EBICS-Passwort, müssen in windata hinterlegt bzw. in verfügbaren Verzeichnissen abgelegt sein (HBCI-Schlüsseldatei).
  • Der Rechner / Server, auf dem der windata AutoAuszug läuft, muss aktiv sowie mit dem Internet verbunden sein.
  • In windata muss mind. ein windata-Benutzer angelegt sein.
  • Wenn der windata AutoAuszug nicht als Hintergrundprogramm auf dem Rechner aktiv ist, kann der windata AutoAuszug per Parameter ausgeführt werden.

Aufruf

Die Funktion "Automatischer Abruf der Kontoumsätze (AutoAuszug)" kann in windata professional 8 unter dem Punkt Tools gestartet werden:

windata AutoAuszug starten

Zu Beginn ist noch kein Konto / Bankzugang für den AutoAuszug eingerichtet. Daher stellt sich die erste Ansicht wie folgt dar:

Übersicht windata AutoAuszug ohne HBCI-Kontakte

Wenn diese Übersicht wie dargestellt vollständig leer ist, wird direkt der Einrichtungsassistent aufgerufen:
Alternativ kann der Einrichtungsassistent über den Button "Einstellung" aufgerufen werden.

Einrichtung

HBCI

Hinweis: Hier werden nur die Konten angezeigt, für welche die HBCI-PIN gespeichert ist. Alle anderen HBCI-Konten können nicht vom AutoAuszug bedient werden:

AAEinstellungHBCI.PNG

Ausnahme: HBCI-Kontakte welche mittels Chipkarte autorisiert werden, können mit dem windata AutoAuszug nicht bedient werden.

Abruf

Mögliche Einstellmöglichkeiten für HBCI-Konten:

  • Intervall: Der Abruf kann im Rhythmus von X Stunden durchgeführt werden. Ebenfalls kann hier das gewünschte Zeitfenster für den Abruf definiert werden.
  • Nächster Abruf: Wann soll der nächste automatische Abruf erfolgen? Sollen die Kontoumsätze auch am Wochenende abgerufen werden? Soll ein Hinweis auf fehlende Umsätze nach erfolgtem Abruf erfolgen?
  • Abruf per HBCI: Umsätze seit dem letzten Abruf oder verfügbare Umsätze abrufen. Hier kann auch festgelegt werden, ob der HBCI-Kontakt vor jedem Abruf neu synchronisiert werden soll.
  • Kontoumsätze im Format MT940 abrufen

Export der Kontoumsätze

  • Abgerufene Umsätze exportieren...: Hier kann ein Exportformat ausgewählt werden. Auf den Punkten dahinter kann der Exportpfad festgelegt werden:

Einstellungen für den Umsatzexport durch den windata AutoAuszug
Kontoauszug exportieren... MT940
Nach dem Abruf der Kontoauszugsinformationen wird im Verzeichnis
<Pfad>
eine Datei mit dem nachfolgenden Dateinamensformat angelegt. Diese Datei enthält die abgerufenen Kontoauszugsinformationen im Format Swift MT940.
Als Dateinamen stehen zwei Varianten zur Verfügung:

  • MT940-[KontoNr]-[BLZ]-[VonDatum]-[BisDatum].sta
  • MT940-[IBAN]-[VonDatum]-[BisDatum].sta
  • MT-[laufendeNummer].sta
  • [Bezeichnung]-[VonDatum]-[BisDatum].sta
  • MT940.sta (Daten werden an vorhandene Datei angehängt)


Als weitere Möglichkeit können die abgerufenen Kontoumsätze in jeweils eigene Ordner exportiert werden. Hier kann je Kontengruppe ein eigenes Exportverzeichnis definiert werden.

Hintergrund: Einzelne Programme am Markt können keine MT940-Dateien mit mehreren Auftraggeberkonten importieren.

Zusätzlich kann hier definiert werden, ob der letzte Tag ebenfalls exportiert werden soll. ACHTUNG: Ggf. werden einzelne Umsätze doppelt exportiert!

Drucken der Kontoumsätze

  • Abgerufene Umsätze drucken: Hier können umfangreiche Einstellungen zum Druck der abgerufenen Kontoumsätze hinterlegt werden:

Drucken der abgerufenen Kontoumsätze

  • Auswahl des Druckers
  • Definition der Exemplare je Druck
  • Auswahl des Druckbereichs
      • Abgänge und Zugänge
      • Nur Zugänge
      • Nur Abgänge
    • Mit Salden
    • Ohne Salden
    • Tagesumsätze summieren
    • Auszugs-Nr. drucken (falls vorhanden)
    • Incl. Primanota
  • Sortierung
      • Aufsteigend
      • Absteigend
    • innerhalb des Buchungstages nach Betrag
      • Reihenfolge des Eingangs
      • Aufsteigend
      • Absteigend

Export der Kontostände

  • Kontostände exportieren: Hier können die abgerufenen Kontostände automatisch exportiert werden:

Einstellugnen für den Export von Kontoständen durch den windata AutoAuszug
Exportierte Kontostände werden im festgelegten Pfad in der Datei Kontostand.csv abgespeichert.
Der Satzaufbau der Datei Kontostand.csv ist wie folgt:
Datum; Bezeichnung; Name; Konto-Nr.; BLZ; Kontostand; Währung;

Für den Export kann gewählt werden:

  • Aktuell abgerufene Konten exportieren
  • Alle gespeicherten Konten exportieren

Export von Depots

Abgerufene Depots im Format MT571 exportieren...

Aktion nach Abruf

Diese Beschreibung ist weiter unten zu finden.

EBICS

Hinweis: Hier werden nur die Konten angezeigt, für welche das EBICS-Passwort gespeichert ist. Alle anderen EBICS-Kontakte können nicht vom AutoAuszug bedient werden:

AAEinstellungEBICS.PNG

Mögliche Einstellmöglichkeiten für EBICS-Kontakte:

Abruf der Kontoumsätze

  • Format: Der Abruf der Kontoumsätze kann im Format MT940 sowie camt.053 erfolgen.
  • Intervall: Der Abruf kann im Rhythmus von X Stunden / Tage / Wochen / Monaten durchgeführt werden. Ebenfalls kann hier das gewünschte Zeitfenster für den Abruf definiert werden.
  • Nächster Abruf: Wann soll der nächste automatische Abruf erfolgen? Sollen die Kontoumsätze auch am Wochenende abgerufen werden? Soll ein Hinweis auf fehlende Umsätze nach erfolgtem Abruf erfolgen?
  • Kontoumsätze im Format MT940 abrufen

Export der Kontoumsätze

  • Abgerufene Umsätze exportieren...: Hier kann ein Exportformat ausgewählt werden. Auf den Punkten dahinter kann der Exportpfad festgelegt werden:

Einstellungen für den Export der Kontoumsätze mittels windata AutoAuszug
Kontoauszug exportieren... MT940
Nach dem Abruf der Kontoauszugsinformationen wird im Verzeichnis
<Pfad>
eine Datei mit dem nachfolgenden Dateinamensformat angelegt. Diese Datei enthält die abgerufenen Kontoauszugsinformationen im Format Swift MT940.
Als Dateinamen stehen folgende Varianten zur Verfügung:
Dateiname für Export von Originaldatei:

  • <Kontaktname>-[VonDatum]-[Abrufdatum]-[AbrufUhrzeit].sta
  • <Kontaktname>.sta
  • MT940.sta (Daten werden an vorhandene Datei angehängt)

Dateiname für Export von Einzeldateien (Splitt der Originaldatei je Auftraggeberkonto):

  • MT940-[KontoNr]-[BLZ]-[VonDatum]-[BisDatum].sta
  • MT940-[IBAN]-[VonDatum]-[BisDatum].sta
  • [Bezeichnung]-[VonDatum]-[BisDatum].sta
  • MT-[laufendeNummer].sta


Als weitere Möglichkeit kann hier festgelegt werden, dass das Feld 86 in der exportierten MT940-Datei nach 65 Zeichen getrennt werden soll.
Als weitere Möglichkeit können die abgerufenen Kontoumsätze in jeweils eigene Ordner exportiert werden. Hier kann je Kontengruppe ein eigenes Exportverzeichnis definiert werden.

Hintergrund: Einzelne Programme am Markt können keine MT940-Dateien mit mehreren Auftraggeberkonten importieren.

Drucken der Kontoumsätze

  • Abgerufene Umsätze drucken: Hier können umfangreiche Einstellungen zum Druck der abgerufenen Kontoumsätze hinterlegt werden:

Ausdruck der abgerufenen Umsätze

  • Auswahl des Druckers
  • Definition der Exemplare je Druck
  • Auswahl des Druckbereichs
      • Abgänge und Zugänge
      • Nur Zugänge
      • Nur Abgänge
    • Mit Salden
    • Ohne Salden
    • Tagesumsätze summieren
    • Auszugs-Nr. drucken (falls vorhanden)
    • Incl. Primanota
  • Sortierung
      • Aufsteigend
      • Absteigend
    • innerhalb des Buchungstages nach Betrag
      • Reihenfolge des Eingangs
      • Aufsteigend
      • Absteigend

Export der Kontostände

  • Kontostände exportieren: Hier können die abgerufenen Kontostände automatisch exportiert werden:

AAEinstellungEBICSExportKontostand.PNG
Exportierte Kontostände werden im festgelegten Pfad in der Datei Kontostand.csv abgespeichert.
Der Satzaufbau der Datei Kontostand.csv ist wie folgt:
Datum; Bezeichnung; Name; Konto-Nr.; BLZ; Kontostand; Währung;

Für den Export kann gewählt werden:

  • Aktuell abgerufene Konten exportieren
  • Alle gespeicherten Konten exportieren

Vormerkposten abrufen

camt.052-Dateien bzw. MT942-Dateien (Vormerkposten) können automatisch abgerufen und in einen definierten Pfad exportiert werden.
Der Dateiname der Exportdatei lautet: camt.052<Kontaktname>-<Datum>-<Uhrzeit>.xml
Für den Abruf der camt.052-Dateien kann ein individueller Rhythmus definiert werden.

camt.054 abrufen

camt.054-Dateien (Sammelbuchungsdatei) können automatisch abgerufen und in einen definierten Pfad exportiert werden.
Der Dateiname der Exportdatei lautet: camt.054<Kontaktname>-<Datum>-<Uhrzeit>.zip
Für den Abruf der camt.054-Dateien kann ein individueller Rhythmus definiert werden.

Protokolle abrufen

EBICS-Protokolle können abgerufen und auf Wunsch auch direkt gedruckt werden.
Für den Abruf der EBICS-Protokolle kann ein individueller Rhythmus definiert werden.

BKA (Elektronischer Kontoauszug)

Elektronische Kontoauszüge können abgerufen und auf Wunsch auch direkt exportiert werden.
Für den Abruf der elektronischen Kontoauszüge kann ein individueller Rhythmus definiert werden.

Aktion nach Abruf

Diese Beschreibung ist weiter unten zu finden.

Datensicherung

AAEinstellungDatensicherung.PNG

Hier kann definiert werden, ob windata automatisch eine Datensicherung erstellen soll.
Zusätzlich kann der Intervall der Datensicherung sowie der Zeitpunkt der nächsten Datensicherung festgelegt werden.
Der Pfad, unter welchem die erstellte Datensicherung abgelegt werden soll, wird in den windata-Optionen hinterlegt.

Beim regulären AutoAuszug-Aufruf per Parameter wird die Datensicherung nicht durchgeführt. Hierfür ist der Parameterzusatz /Sicherung notwendig.

windata.connect

AutoAuszug für windata.connect

Für windata.connect können alle vorher beschriebenen Optionen für den AutoAuszug ebenfalls konfiguriert werden.

AutoAuszug per Parameter starten

Um sicherzustellen, dass die Funktionserweiterung AutoAuszug zum Zeitpunkt der Ausführung auch aktiv ist, kann diese per Parameter gestartet werden.

Der AutoAuszug kann mit folgendem Parameter gestartet werden: \\windata-Installationsverzeichnis\mAA.exe /Mandant:<Mandant>/Benutzer:<Benutzer>

Hinweise:
Mandant: Hier muss die Bezeichnung des gewünschten windata-Mandanten angegeben werden.
Benutzer: Hier muss die Bezeichnung eines windata-Benutzers angegeben werden.

Da die Anwendung mAA.exe immer nur einmal gestartet sein kann, kann dieser Parameter auch vor jedem geplanten Abruf über einen windows-Task aufgerufen werden.

 

AutoAuszug per Parameter ausführen

Die Funktionserweiterung AutoAuszug kann neben der zeitlich gesteuerten Verwendung auch per Parameter (z. B. BAT-Datei) aufgerufen werden. Somit besteht die Möglichkeit, einen windata-AutoAuszug auch für mehrere windata-Mandanten zu verwenden. Hierzu muss die Anwendung mAA.exe (im windata-Installationsverzeichnis) in Verbindung mit den Parametern /Mandant und /Benutzer aufgerufen werden:
"\\windata-Installationsverzeichnis\mAA.exe" /Mandant:"<Mandant>" /Benutzer:"<Benutzer>" /Sofort

Hinweise:
Mandant: Hier muss die Bezeichnung des gewünschten windata-Mandanten angegeben werden.
Benutzer: Hier muss die Bezeichnung eines windata-Benutzers angegeben werden.
/Sofort: Dieser Parameter bewirkt, dass der AutoAuszug sofort, unabhängig von den hinterlegten Zeiten, ausgeführt wird. Nach erfolgreicher Ausführung wird die Anwendung mAA.exe wieder beendet. Somit kann der AutoAuszug auch für mehrere windata-Mandanten nacheinander genutzt werden.
/Sicherung: Dieser Parameter bewirkt, dass der AutoAuszug automatisch eine Datensicherung durchführt und die anderen hinterlegten Aktionen nicht berücksichtigt. Mit dem Aufruf ohne Zusatz /Sicherung werden alle hinterlegten Aktionen des AutoAuszugs ausgeführt, außer die Datensicherung (verfügbar ab Version 8.8.0.26).

Historischer Abruf von Kontoumsätzen per Parameter im AutoAuszug

Mit dem ergänzenden Parameter /BackX können historische Kontoumsätze mittels windata AutoAuszug abgerufen werden. Anstelle von X wird die Anzahl der Kalendertage gesetzt, wieviele rückwirkend abgerufen werden sollen. Als Wert können die Zahlungen 1 - 9 verwendet werden, z. B. /Back7 führt einen historischen Umsatzabruf von sieben Tage rückwirkend durch.

Datensicherung per Parameter ausführen

Für die automatische Datensicherung kann folgender Aufruf verwendet werden: "\\windata-Installationsverzeichnis\mAA.exe" /Mandant:"<Mandant>" /Sicherung

Aktion nach Abruf

Dieser Befehl kann in der HBCI-Konfiguration sowie der EBICS-Konfiguration, jeweils unten links, hinterlegt werden. Dieser Befehl wird vollautomatisch nach dem erfolgreichen Abruf der Kontoumsätze abgerufen. So kann z. B. ein Script oder eine *.BAT-Datei aufgerufen werden, welche die Weiterverarbeitung von exportierten Kontoumsätzen veranlasst (z. B. Import in ein anderes Programm). Denkbar ist z. B. auch eine automatische Hinweismeldung durch diesen Aufruf an einen Sachbearbeiter.

AutoAuszug als Dienst

Die Funktionserweiterung AutoAuszug ist eine Anwendung, welche nicht als Dienst konzipiert ist. Aus der Anwendung AutoAuszug kann allerdings mittels der Windows-Funktion Sc.exe ein Windows-Dienst erstellt werden.
Für die Integration der Windows-Anwendung Sc.exe wenden Sie sich bitte an Ihren Systemadministrator.

Protokoll über Aktivitäten des windata-AutoAuszug

windata-Menü

Im windata-Menü kann das AutoAuszug-Protokoll aufgerufen werden:

ProtokollAA.PNG

In der Protokolldatei AutoAuszug.log ist jede Aktion des windata-AutoAuszugs dauerhaft protokolliert.

Protokolldatei

Ab der windata-Version 8.7.0.31 vom 22.12.2014 wird mit der Ausführung des windata-AutoAuszugs eine sehr ausführliche log-Datei erzeugt. Dieses Detailprotokoll wird im windata-Installationsverzeichnis, Unterordner \Daten\Protokoll, unter dem Dateinamen <Computername>-<windata-Benutzer>-AutoAuszug-bbcf.log gespeichert.

Probleme, Ursache & Lösung

  • Falls der AutoAuszug zum definierten Zeitpunkt innerhalb des AutoAuszugs nicht startet, ist die Hintergrundanwendung "AutoAuszug" nicht aktiv.
  • Falls der AutoAuszug zum definierten Batch-Aufruf (Windows Taskplaner) nicht vollständig ausgeführt wird, ist der Rechner / Server nicht angemeldet. Der windata AutoAuszug kann nur im angemeldeten Windows-Zustand ausgeführt werden. Die Sitzung darf gesperrt sein.
  • Falls sich der AutoAuszug nach dem Abruf der Umsätze nicht ordentlich beendet, müssen die angelegten HBCI- und EBICS-Zugänge einmal synchronisiert werden. In diesem Fall werden Konten angesprochen, welche über das jeweilige Verfahren nicht mehr erreichbar sind.
  • Falls der AutoAuszug unter windows 7 bzw. windows 8 während eines Abrufs per HBCI abstürzt, muss die Anwendung "mAA.exe" im Kompatibilitätsmodus ausgeführt werden.
  • Falls der AutoAuszug unter windows 7 bzw. windows 8 während eines EBICS-Abrufs abstürzt, muss die Anwendung "mAA.exe" und "dodfue.exe" im Kompatibilitätsmodus ausgeführt werden. Ebenfalls muss sichergestellt werden, dass die windows-Datenausführungsverhinderung (Data Execution Prevention, DEP) korrekt konfiguriert ist.
  • Wenn die Konfigurationen des windata-AutoAuszug täglich zurückgesetzt sind, wird die INI-Datei aus dem windata-Installationsverzeichnis "Daten\INI\<Mandant>-Auszug.ini" regelmäßig durch den Kunden zurückgesetzt. Zur Lösung muss die INI-Datei in das Image gepackt werden.