XLGen. 24 Core und Enterprise

Inhalt

Einführende Informationen


Info:

Bisheriges Vorgehen in der Middleware

Das bisherige Vorgehen der Auftragsnummernerkennung in Middleware finden Sie an folgender Stelle beschrieben: Zahlungen automatisch zuordnen.

 

Über das neue Vorgehen mittels Automatisierungsaufgaben in microtech büro+ lässt sich die beschriebene Funktionalität auch ohne Middleware nutzen, z. B. bei Verwendung eines Shopsystems, welches ohne Middleware an büro+ angebunden wurde.

Zweck der Auftragsnummer

Beim Ausgleich von Offenen Posten ist es wichtig, z. B. über eine eindeutige Auftragsnummer (https://hilfe.microtech.de/display/PROG/Auftragsnummer+auf+Positionsebene) die Zuordnung von Beträgen herzustellen - und schlussendlich eindeutig dem Offenen Posten zuordnen zu können.

Beispiel: Wenn Sie z. B. über eine Überweisung einen Geldbetrag mit einer Auftragsnummer im Verwendungszweck erhalten haben, können Sie diese Information zur Zuordnung nutzen. Diese Auftragsnummer vervollständigen Sie bitte in dem entsprechenden noch ungebuchten Vorgang in microtech büro+, (Register: Positionen) damit dieser in dem dazugehörigen Offenen Posten übertragen wird (https://hilfe.microtech.de/display/PROG/Offene+Posten+anhand+der+Auftragsnummer+zuweisen).

Info:

Ist der Vorgang schon verbucht, ist die Eingabe der Auftragsnummer im Offenen Posten (https://hilfe.microtech.de/display/PROG/Erfassungsmaske+der+Offenen+Posten - Register: BETRÄGE / KURS / MANHUNG) manuell vorzunehmen. 

Generelles Vorgehen: Auftragsnummer

Die Auftragsnummer im Vorgang ist auf dem Register: ADRESSE zu ergänzen.

Unter dem Eintrag "Versand, Bezeichnung, ..." findet sich das Feld: AUFTRAGSNUMMER.

Ablauf: Automatischer OP-Ausgleich mit Auftragsnummer

Die Beschreibung auf dieser Seite soll als eine Art "Schritt für Schritt-Anleitung" dienen.


In diesem Ablauf beschreiben wir das folgende Szenario:

  • Kunde bestellt 
  • Kunde bezahlt per Überweisung und die Auftragsnummer (welche im OP vorhanden ist) liegt im Überweisungszweck vor
  • Über reguläre Ausdrücke wird die Auftragsnummer im Vorgang ergänzt (sowie die Belegnummer im Zahlungsverkehreingang-Datensatz ergänzt)
  • In Folge dessen kann der OP dank zugeordneter Auftragsnummer einfach ausgeglichen werden


Über microtech büro+ werden zunächst die benötigten Assistenten-Schemen angelegt und in der Folge automatisiert:

  • Automatisierter Abruf der Zahlungseingänge
  • Automatisierte Zuweisung Offene Posten über Auftragsnummer (mittels regulären Ausdrücken)
  • Automatisiert Zahlungsverkehreingang buchen


Datentresor für ein bestehendes Konto einrichten (sofern nicht schon geschehen)

Bevor Sie beginnen die einzelnen Schemen der Automatisierungsaufgaben zu erfassen, vergewissern Sie sich, dass für das automatisch abzurufende Bankkonto ein Datentresor eingerichtet wurde. Dieser ist obligatorisch, da die Abfrage des Kontos automatisiert erfolgt und somit auch gewährleistet sein muss, dass bei der Abfrage die Sicherheitsmerkmale automatisch gefüllt werden können (und somit die manuelle PIN-Eigabe entfällt).

Den Datentresor konfigurieren Sie unter: DATEI - EINSTELLUNGEN - MEINE FIRMA / FILIALE / MANDANT - Register: BANKVERBINDUNG. Im Fenster "Bankverbindungen-Datensatz ändern" der abzurufenden Bankverbindung muss auf dem Register: ONLINE BANKING im Bereich "Datentresor verwenden" das Kennzeichen "Tresor verwenden" aktiviert sein und ein solcher angelegt sein. Weitere Informationen zur Einrichtung finden Sie in folgendem Hilfe-Eintrag: https://hilfe.microtech.de/x/ewyz.

Der Datentresor ist auf dem Server-Rechner einzurichten, auf dem die Automatisierung durchgeführt werden soll!

Beachten Sie deshalb folgende Vorgehensweise:
1. Anmeldung am Server-Rechner, auf dem sich die microtech Datenserver-Installation befindet und somit der Automatisierungs-Dienst ausgeführt wird
2. Sofern Sie den Datentresor auf dem Computer speichern möchten (Auswahl „Datentresor auf diesem Computer speichern“), ist es zwingend erforderlich, dass Sie sich unter Windows mit dem Administrativen Benutzer anmelden, damit der Datentresor im korrekten AppData Verzeichnis abgelegt wird
3. Starten Sie die microtech büro+ Software mit dem Benutzer, der im Automatisierungs-Dienst hinterlegt ist
4. Wechseln Sie in den Bereich MANDANT BEARBEITEN – BANKVERBINDUNGEN – in die jeweils entsprechende Bankverbindung und rufen Sie das Register „Tresor Verwaltung“ auf
5. Hinterlegen Sie im Tresor die PIN der zugehörigen Bank (Bei PayPal über REST API hinterlegen Sie als PIN das „Secret“, bei PayPal über SOAP API als PIN das „API-Passwort“)
6. Klicken Sie auf „Konto hinzufügen“
7. Verlassen Sie alle Fenster über „Speichern & schließen“

Über regulären Ausdruck: Automatische Zuweisung von OP anhand Auftragsnummer vorbereiten

Damit eine Zuweisung der Offenen Posten anhand der Auftragsnummer erfolgen kann, ist im Vorfeld ein "Regulärer Ausdruck" anzulegen, sofern noch nicht vorhanden.

Regulärer Ausdruck für die Auftragsnummer

Im Bereich der PARAMETER (Registerkarte: START - PARAMETER - SONSTIGE - REGULÄRE AUSDRÜCKE) legen Sie einen für Ihre Auftragsnummern passenden "Regulären Ausdruck" an.

In diesem Beispiel wird als Ausdruck zum Suchen innerhalb des Textes folgender regulärer Ausdruck genutzt:

EC[\d]{5}

Als Auftragsnummern gelten im Beispiel solche mit einem EC beginnend und gefolgt von 5 Zahlen

Die Zeichenkette EC wird im Beispiel in Großbuchstaben vorgegeben. Das darauf folgende [\d] mit anschließender {5} in geschweiften Klammern beschreibt, dass nach dem EC fünf Zahlen stehen müssen, damit die Bedingung erfüllt ist und als regulärer Ausdruck erkannt wird.

Vergeben Sie eine nachvollziehbare Bezeichnung, z. B.: "Auftragsnummern mit dem Aufbau EC12345 (Mit EC beginnend gefolgt von 5 Zahlen)"

Über die Auswahl ist der Eintrag "Auftragsnummern" auszuwählen.

Schema erstellen für die Funktion: Online aktualisieren

Erkennung Auftragsnummer (über Reguläre Ausdrücke) 

Mithilfe der "Regulären Ausdrücke" wird die Auftragsnummer erkannt, z. B. wenn die Funktion: ONLINE AKTUALISIEREN ausgeführt wird über: ZAHLUNGSVERKEHR - KONTOAUSZÜGE - Register: "Zahlungsverkehreingang") - Schaltfläche: WEITERE - ONLINE AKTUALISIEREN.


Im Assistenten ist nun die Bank auszuwählen.


Im nächsten Fenster wählen Sie den Eintrag: "Reguläre Ausdrücke anwenden".


In den nächsten Fenstern legen Sie nun die Vorgaben für die Zuordnung fest:

  • Vorgaben für die Zuordnung der Adressnummer: Wählen Sie hier nichts aus und wechseln Sie über Schaltfläche: WEITER zum nächsten Fenster
  • Vorgaben für die Zuordnung der Belegnummer: Wählen Sie hier nichts aus und wechseln Sie über Schaltfläche: WEITER zum nächsten Fenster
  • Vorgaben für die Zuordnung der Auftragsnummer: Auswahl des zuvor ausgelegten regulären Ausdrucks: "Auftragsnummern mit dem Aufbau EC12345 (Mit EC beginnend gefolgt von 5 Zahlen)"


Der Assistent fasst die getroffene Auswahl zusammen. Nun ist das Schema über die Split-Schaltfläche als neues Schema zu speichern.


Verwenden Sie einen später nachvollziehbaren Namen, z. B.: "Online-Abruf mit Prüfung der Auftragsnummer".


Nach dem Erfassen und Benennen des Schemas wählen Sie die Schaltfläche: WEITER und erhalten nochmals die Zusammenfassung:

  • Wählen Sie "Fertigstellen", wenn Sie das Schema jetzt ausführen (und damit auch jetzt testen und anwenden) möchten
  • Wählen Sie "Abbrechen", sofern Ihnen die Anlage des Schemas zum jetzigen Zeitpunkt genügt

Info:

Das Schema "Online-Abruf mit Prüfung der Auftragsnummer" ist nun für die spätere Auswahl in der Automatisierungsaufgabe gespeichert und vorbereitet.


Beachten Sie:

Über die Ausführung der Funktion wird auch die Belegnummer im Zahlungsverkehrs-Datensatz nachgetragen.

Schema erstellen: OP über Belegnummer zuordnen

Belegnummer wurde im Zahlungsverkehr-Datensatz nachgetragen

Da durch den zuvor getätigten Schritt die Belegnummer im Zahlungsverkehrs-Datensatz nachgetragen wurde, kann nun die Zuweisung der OP erfolgen.

Assistent: "Offene Posten zuweisen" ausführen

Im Rahmen der Funktion: "Offenen Posten zuweisen" wird bei Berücksichtigung der Option: "Belegnummer" der Offene Posten zugeordnet. Wählen Sie deshalb im Assistenten für die Zuweisung auch das Kennzeichen: "Belegnummer".

Folgendes Kennzeichen muss für die Automatisierung deaktiviert sein: "Nach der Zuweisung den Buchungs-Assistent aufrufen".

Beachten Sie:

Sollte im Assistenten das Begrüßungsfenster erscheinen, ist das Kennzeichen: "Diese Seite beim nächsten Aufruf übergehen" zwingend zu aktivieren, damit es für die Automatisierung ausgeblendet bleibt!

Als Bereich wählen Sie: "Alle Datensätze verarbeiten".

Sie erhalten nun eine Zusammenfassung. Wählen Sie über die Split-Schaltfläche die Speicherung des Schemas. Vergeben Sie einen passenden Namen für das Schema, z. B.: "OP über Belegnummer zuordnen".


Nach dem Erfassen und Benennen des Schemas wählen Sie die Schaltfläche: WEITER und Sie erhalten nochmals die Zusammenfassung:

  • Wählen Sie "Fertigstellen", wenn Sie das Schema jetzt ausführen (und damit auch testen) möchten
  • Wählen Sie "Abbrechen", sofern Ihnen die Anlage des Schemas zum jetzigen Zeitpunkt genügt

Info:

Das Schema "OP über Belegnummer zuordnen" ist nun für die spätere Auswahl in der Automatisierungsaufgabe gespeichert und vorbereitet.


Beachten Sie:

Eine Zuordnung der Offenen Posten anhand der Auftragsnummer kann nur erfolgen, wenn im Offenen Posten ebenfalls eine Belegnummer vorhanden ist.

Schema erstellen: Zahlungsverkehreingang buchen (über Zuordnung)

Abschließend erfolgt die Buchung über die Schaltfläche: WEITERE - "Zahlungsverkehreingang buchen".


Über den Assistenten ist auszuwählen, welche Datensätze verarbeitet werden sollen. Für die Automation wird der Bereich "Alle Datensätze verarbeiten" gewählt.


In den Einstellungen ist mittels Kennzeichen zu wählen, ob die Offenen Posten gebucht / ausgeglichen werden sollen und in welches Buch die Buchungssätze erstellt werden sollen.

Beachten Sie:

In dem Zeit-Intervall - in der die Automatisierungsaufgabe ausgeführt wird - sollte kein anderer Benutzer Zugriff auf die ausgewählte Tabelle haben!

Aus diesem Grund empfiehlt es sich, ein eigenes Buch für diesen Zweck der Automatisierung anzulegen. Beachten Sie hierzu bitte die geforderte Ausbaustufe und die Anleitung für das Anlegen zusätzlicher Bücher: Geschäftsvorfälle (Parameter).

Die Bücher werden im Bereich: PARAMETER - GESCHÄFTSVORFÄLLE - BÜCHER anlegt / verwaltet. Wählen Sie bei einer Neuanlage eine Bezeichnung wie z. B.: "Buch für Automatisierung". Weitere Informationen zur Anlage von Büchern finden Sie auch im weiter oben angegebenen Hilfe-Artikel.


Es folgt eine Sicherheitsabfrage, ob gewährleistet ist, dass nicht mehrere Nutzer gleichzeitig auf das Buch zugreifen können.

Setzen Sie das Kennzeichen: "Ja, ich kann dies gewährleisten". Bei der Ausführung der Automatisierungsaufgabe wird das Kennzeichen (anhand dieser Vorgabe im Schema) im Hintergrund automatisch seitens des Programms gesetzt. 


Speichern Sie nun das Schema über die Schaltfläche: SCHEMA SPEICHERN.


Vergeben Sie für das Schema einen passenden, eindeutigen Namen, z. B.: "Bedingungen: Zahlungsverkehreingang buchen"


Info:

Alle Informationen zu den Einstellungen des Assistenten: ZUWEISUNGEN IM ZAHLUNGSVERKEHREINGANG BUCHEN finden Sie in unserer Hilfe: Zahlungsverkehreingang buchen.


Nach dem Erfassen und Benennen des Schemas wählen Sie die Schaltfläche: WEITER und erhalten nochmals die Zusammenfassung:

  • Wählen Sie "Fertigstellen", wenn Sie das Schema jetzt ausführen (und damit auch testen) möchten
  • Wählen Sie "Abbrechen", sofern Ihnen die Anlage des Schemas zum jetzigen Zeitpunkt genügt

Info:

Das Schema "Bedingungen: Zahlungsverkehreingang buchen" ist nun für die spätere Auswahl in der Automatisierungsaufgabe gespeichert und vorbereitet.

Automatisierungsaufgabe für die erfassten drei Schemen anlegen

Wechseln Sie nun in den Bereich: MEINE FIRMA - AUTOMATISIERUNGSAUFGABEN.

Beachten Sie, dass im Vorfeld ein Automatisierungsdienst eingerichtet wurde und ausgeführt wird. Siehe hierzu: Automatisierungsaufgaben in microtech büro+.

Der automatische Abruf sollte in dieser Reihenfolge erfolgen

  1. Online-Abruf mit Prüfung der Auftragsnummer
  2. OP über Belegnummer zuordnen
  3. Bedingungen: Zahlungsverkehreingang buchen


Legen Sie nun auf dem Register: AUTOMATISIERUNGSAUFGABEN über die Schaltfläche: NEU eine Automatisierungsaufgabe an.


In den Feldern: "Bezeichnung" und "Suchbegriff" fassen Sie bitte den Zweck der Automatisierungsaufgabe zusammen, z. B.: "Online Abruf mit Prüfung Auftragsnummer per RegAusdrücke". Dies erleichtert die spätere Auffindbarkeit und Wartung.

In der Tabelle: "Aktionen" wählen Sie mittels Doppelklick die Neuanlage.


Legen Sie nun für alle drei zuvor erstellten Schemen eine Aktion an

Reihenfolge

Art

Bezeichnung

Ausführen

Bereich

Funktion

Schema

1Assistenten-Schemen

Kann frei vergeben werden,

z. B.: "Aktion: Online-Abruf mit Prüfung Auftragsnr.".

ImmerZahlungsverkehreingang

Kontenstand Online aktualisieren

Beachten Sie:

Im Bereich: "Funktion" muss exakt der gleiche Funktionsbereich gewählt werden, in der das Schema angelegt wurde!

Zuvor erstelltes Schema: "Online-Abruf mit Prüfung der Auftragsnummer".
2Assistenten-Schemen

Kann frei vergeben werden,

z. B.: "Aktion: OP über Belegnummer zuordnen".

Wenn Aktion zuvor ausgeführt wurdeZahlungsverkehreingangOffene Posten zuweisenZuvor erstelltes Schema: "OP über Belegnummer zuordnen".
3Assistenten-Schemen

Kann frei vergeben werden,

z. B.: "Aktion: Bedingungen Zahlungsverkehreingang buchen."

Wenn Aktion zuvor ausgeführt wurdeZahlungsverkehreingangZahlungsverkehreingang buchenZuvor erstelltes Schema: "Bedingungen: Zahlungsverkehreingang buchen".



  • Speichern Sie jede Aktion nach ihrer Anlage und überprüfen Sie noch einmal die Reihenfolge, diese kann über Pfeile im Menüband geändert werden
  • Legen Sie in der Gruppe "Trigger" fest, zu welchen Zeiten und mit welcher maximalen Ausführungszeit die Automatisierungsaufgabe mit den drei aufeinanderfolgenden Aktionen ausgeführt werden sollen
  • Bestimmen Sie die Priorität dieser Aufgabe
  • Verlassen Sie die Maske über die grüne Schaltfläche für das Speichern und Schließen


Überprüfen Sie im Anschluss die Funktion und den Status der Aufgabe. Kontrollieren Sie auch das Ereignisprotokoll, um die Ausführung der angelegten Automatisierungsaufgabe zu überprüfen und ggf. weiter anpassen zu können.

Tipp:

Das Ereignisprotokoll lässt sich über die Detail-Ansichten einblenden. Nutzen Sie diesen schnellen Zugriff, um alle wichtigen Informationen auf einen Blick zu haben.

  • No labels