# E-Banking Splitter für PROFFIX

Mit diesem Tool können E-Bankingeinträge aus PROFFIX automatisch gesplittet und aufgeteilt werden.

Anschliessend kann in PROFFIX eine automatische Verbuchung erstellt werden.

Vereinfacht macht das Tool aus folgendes:

alt text

alt text

Die so aufgesplitteten Kontobewegungen können anschliessend automatisch über PROFFIX verbucht werden.

alt text

# Features

  • Regex Filter mit zusätzlicher Eingrenzung nach Datum von / bis
  • Unbeschränkt viele Filter und Kombinationsmöglichkeiten
  • Unterschiedlicher Text pro Filter (z.B. Kommission 1, Spesen, Gebühren...)
  • Brutto / Netto Funktion (d.h. Kommission minus oder plus)
  • Zusätzlicher Eingrenzungsfilter für unterschiedliche Provider
  • "Reset-Funktion" / Komplett oder nur für eingegrenzte Zeiträume
  • Klein und schnell

# Beispiel-Konfiguration

Sämtliche Konfiguration erfolgt über eine config.json welche sich im selben Verzeichnis wie das Tool befinden muss.

Beispiel:

{
  "Licence": "",
  "Database": {
    "Username": "sa",
    "Password": "1234",
    "Database": "DEMODB",
    "Instance": "PROFFIX",
    "Hostname": "SQLSERVER1",
    "Port": 1433,
    "Parameter": "?connection+timeout=30"
  },
  "Filter": [
    {
      "Contains": "",
      "DateFrom": "01.01.2018",
      "DateTo": "31.12.2018",
      "Regex": " KOM (.*?) TRX",
      "Original": {
        "Calculation": "ES_Betrag",
        "PostingText": "ORIGINAL ES_Buchungstext"
      },
      "Splitted": {
        "Calculation": "ES_Kommission*(-1)",
        "PostingText": "SPLITTED ES_Buchungstext"
      }
    },
    {
      "Contains": "DEMO PROVIDER",
      "DateFrom": "01.01.2018",
      "DateTo": "31.12.2018",
      "Regex": " KOMM(.*?)",
      "Original": {
        "Calculation": "ES_Betrag",
        "PostingText": "ES_Buchungstext"
      },
      "Splitted": {
        "Calculation": "ES_Kommission*(-1)",
        "PostingText": "Kommission ES_Buchungstext"
      }
    }
  ],
  "Reset": {
    "Active": false,
    "DateFrom": "01.01.2018",
    "DateTo": "31.12.2018"
  }
}

# Parameter

# Database

Parameter Typ Bemerkung
Username string Benutzername SQL - Server
Password string Passwort SQL - Server
Database string PROFFIX Datenbank
Hostname string Hostname des SQL - Servers; kann auch IP sein
Port int Port des SQL Servers
Parameter string Div. Parameter für SQL-Server
Instance string Wenn vorhanden: Instanz des SQL - Servers

# Filter

Parameter Typ Optional Bemerkung
Contains string ja Prüft ob ein Wort in der Bewegung enthalten ist. Die Aufteilung wird nur vorgenommen, wenn diese zutrifft!
Regex string Regex - Ausdruck mit Selektion
DateFrom date ja Zusätzliche Bedingung welche nur Bewegungen ab diesem Datum splittet
DateTo date ja Zusätzliche Bedingung welche nur Bewegungen bis zu diesem Datum splittet
Original array Siehe nächste Tabelle
Splitted array Siehe nächste Tabelle

Original / Splitted

Parameter Typ Optional Bemerkung
PostingText string Zu erstellender Buchungstext; Platzhalter können verwendet werden.
Calculation string Die Berechnung des Betrages; Platzhalter können verwendet werden.

Berechnungsbeispiele:

  "Calculation": "ES_Kommission*(-1)"       // Schreibt Kommission als Belastung
  "Calculation": "ES_Kommission"            // Schreibt Kommission als Vergütung
  "Calculation": "ES_Betrag-ES_Kommission"  // Zieht Kommission vom Originalbetrag ab

# Buchungstext / Berechnung Platzhalter

Der Buchungstext und die Berechnung für die gesplittete Kommissionsbewegung kann mit Platzhaltern angereichert werden:

Platzhalter Effekt
ES_Kommission Kommissionsbetrag (gemäss Regex)
ES_Buchungstext Original-Buchungstext
ES_Betrag Betrag der Original - Buchungsbewegung
ES_BetragSW BetragSW
ES_Datum Datum der Bewegung

Beispiel:

   "PostingText": "KOMMISSION #Kommission# #Datum# #Buchungstext#"

TIP

Der entsprechende Regex-Ausdruck kann z.B. mittels Online - Tools wie etwa Regex101.com (opens new window) erstellt werden. Ein effektives Beispiel finden Sie hier (opens new window). Der Betrag für die Aufteilung wird jeweils nur aus der Selektionsgruppe 1 genommen.

# Reset

Parameter Typ Optional Bemerkung
Active bool Reset wird nur durchgeführt wenn wahr
DateFrom date ja Einschränkungskriterium für Reset
DateTo date ja Einschränkungskriterium für Reset

WARNING

Damit die E-Bankingbelege korrekt zurückgesetzt werden können, schreibt der E-Banking Splitter sämtliche Logs inkl. der jeweiligen PROFFIX - Versionen und LaufNr in eine Zusatztabelle PITW_EbankingSplitter.

# Installation

Der E-Banking Splitter besteht aus einer einzigen, ausführbaren Datei undmuss entsprechend nicht installiert sondern einfach ausgeführt werden.