Transportverfahren | via SFTP |
|---|---|
Objekt | Textdateien mit fester Länge, die die (geänderten) Stammdaten und Honorardaten s.u. beinhaltet |
Trigger | manueller Export via Statusstufe oder automatisiert zu einem definierten Zeitpunkt z. B. zum Monatsersten Export aller Honorare mit Status “geprüft” Stammdaten: manueller Export via Menüpunkt im Menü “Honorarsystem” oder automatisiert zu einem Definierten Zeitpunkt |
Unterstützte Drittsysteme | z. B. SAP |
Über einen manuellen Export via Statusstufe oder automatisiert zu einem definierten Zeitpunkt, z. B. zum Monatsersten, wenn Status “Geprüft”, werden die Honorarleistungen in einer Textdatei mit fester Länge exportiert. Jedes Honorar erhält nach Export den Status übergeben. in einem zweiten Workflow werden seit dem letzten Export geänderte Stammdaten als Textdatei mit fester Satzlänge exportiert.
Funktionalitäten der Schnittstelle
Export der Honorare in PRINT NGEN manuell und automatisiert
Kennzeichnung der übergebenen Honorarabrechnungen
Export geänderter Stammdaten
Bereitstellung auf dem SFTP zur Weiterverarbeitung in angrenzenden Abrechnungs-Tools wie SAP
Inhaltsverzeichnis
Honorarexport
Die Honorardaten geprüfter Honorare müssen für die Weiterverarbeitung an externe Buchhaltungssysteme übergeben werden. Parallel sind die Stammdatensätze aller Honorarempfänger:innen zu übergeben, die sich seit dem letzten Export geändert haben.
Zu definierbaren Zeitpunkten werden Workflows für Honorardaten- und Stammdatenexport ausgeführt. Alternativ kann der Export der Honorarleistungen auch manuell ausgeführt werden (Menüpunkt “Honoradaten Export” im Menü Honorarsystem, sofern verfügbar).
Export der Stammdaten
Die Stammdatensätze aller Honorarempfänger:innen, bei denen es seit dem letzten Stammdatenexport zu Änderungen kam, werden in einer Text-Datei mit fester Satzlänge zusammengefasst und exportiert. Berücksichtigt werden dabei nur Honorarempfänger:innen, die dem Modul “Honorar” zugeordnet sind. Die Dateien werden im SFTP-Laufwerk Export_Stammdaten bereitgestellt. Im Dateinamen sind Datum und Uhrzeit der Dateierzeugung enthalten, z. B. HonStammdatenExport_20230701_123019.txt
Die Stammdatendatei ist an der Kennung "HonStammdatenExport" im Dateinamen zu erkennen. Datum und Uhrzeit werden ohne Trenner im Dateinamen ausgegeben.
Die Ausprägung der Datei erfolgt nach Vorgaben per Mitwirkungspflicht durch PEIQ. Für die Formatierung können folgende Angaben für jedes Feld gemacht werden:
Bündigkeit: RECHTS für rechtsbündiges Ausgeben, keine Angabe bedeutet linksbündig
Füllzeichen: SPACE ist anzugeben, wenn Leerzeichen zum Auffüllen verwendet werden sollen. Das ist auch der Default. Ansonsten kann beispielsweise mit Nullen aufgefüllt werden.
Die Exportdatei ist im PEIQ-Standard wie folgt aufgebaut:
Nr. | Position | Feld | Länge | Text | Bündigkeit | Füllzeichen |
|---|---|---|---|---|---|---|
1 | 1 | MANDT | 4 | Mandant | SPACE | |
2 | 5 | LIFNR | 10 | Kreditor | RECHTS | 0 |
3 | 15 | ERDAT | 8 | Zeitpunkt der Anlage des Honorarempfängers | ||
4 | 23 | ERNAM | 12 | Benutzer:in, der bzw. die den Honorarempfänger angelegt hat | ||
5 | 35 | KTOKK | 4 | |||
6 | 39 | LAND1 | 3 | Land | SPACE | |
7 | 42 | NAME1 | 35 | Nachname | ||
8 | 77 | NAME2 | 35 | Vorname | ||
9 | 112 | ORT01 | 35 | Wohnort | ||
10 | 147 | PFACH | 10 | Postfachnummer | ||
11 | 157 | PSTLZ | 10 | PLZ | SPACE | |
12 | 167 | SORTL | 0 | |||
13 | 167 | SPERR | 1 | Sperrvermerk | ||
14 | 168 | SPRAS | 1 | Sprachschlüssel | ||
15 | 169 | STCD1 | 16 | |||
16 | 185 | STCD2 | 11 | |||
17 | 196 | STKZA | 1 | |||
18 | 197 | HAUSN | 6 | Hausnummer | ||
19 | 203 | STRAS | 35 | Straße | ||
20 | 238 | TELF1 | 16 | Telefon geschäftlich Vorwahl | ||
21 | 354 | E_MAIL | 45 | E-Mail geschäftlich | ||
22 | 299 | BANKS | 3 | Bank Land | ||
23 | 302 | IBAN | 34 | IBAN | ||
24 | 336 | BIC | 11 | BIC | ||
25 | 347 | BANKL | 15 | Bankleitzahl | ||
26 | 362 | BANKN | 18 | Kontonummer | ||
27 | 380 | BKONT | 2 | |||
28 | 382 | KVERM2 | 1 | KSV-Pflicht | ||
29 | 383 | KVERM3 | 2 | USt-Art | ||
30 | 385 | PERNR | 10 | Personalnummer | ||
31 | 395 | RSSRT | 20 | Ressort | ||
415 |
Der Stammdatenexport erfolgt in definierbaren Abständen. Die Zeitpunkte, zu denen der Export ausgeführt werden soll, werden in der Abbildung ZeitpunkteStammdatenexport kundenindividuell festgelegt.
Export der Honorare
Der Workflow für den Honorarexport erfolgt ebenfalls in definierbaren Abständen. Das Intervall für die Warteschlange wird kundenindividuell in der Abbildung ZeitpunkteHonorarexport festgelegt.
Die Warteschlange für den Honorarexport führt eine komplexe Aktion aus, welche für alle Honorare mit “Status=Geprüft,Storniert”, die zu einer Honorarkondition mit “Status=Gültig” gehören, die Honorarleistungen exportiert. Ergebnis ist eine Textdatei mit fester Satzlänge ohne Überschriften mit dem Dateinamen
Dateinanme: honorar_<Export-Datum>_<Dateinummer>.txt
Die Datei wird im SFTP-Verzeichnis Export_Honorar/Export bereitgestellt.
Wurden die Leistungen der Honorarsätze exportiert übergeben, so werden diese in PRINT NGEN in den Status „Übergeben“ gestuft und eine eindeutige Leistungsnummer zugewiesen. In diesem Status können diese in PRINT NGEN nicht mehr verändert werden. Auch der zugehörige Honorarsatz wird beim Export auf "Übergeben" gestuft. Durch die automatische Honorarvergabe können jedoch zum Honorarsatz wieder neue Leistungen hinzukommen, z.B. durch ein Nachhonorar. Dann wird dieser wieder auf "Prüfen" gestuft.
Die Leistungsnummern der Honorarleistungen werden in der Form <Jahreszahl zweistellig><auffüllende Nullen><Leistungsnummer> (insgesamt 8-stellig) vergeben.
Die Ausprägung der Export-Datei erfolgt nach Vorgaben per Mitwirkungspflicht durch PEIQ. Für die Formatierung können folgende Angaben für jedes Feld gemacht werden:
Bündigkeit: RECHTS für rechtsbündiges Ausgeben, keine Angabe bedeutet linksbündig
Füllzeichen: SPACE ist anzugeben, wenn Leerzeichen zum Auffüllen verwendet werden sollen. Das ist auch der Default. Ansonsten kann beispielsweise mit Nullen aufgefüllt werden.
Video-Tutorial zum Honorar-Export
Im folgenden Video wird der Honorar-Export erklärt:
https://www.youtube.com/watch?v=wDBoDUedNbcDatenformat und Beispielexport
Der Export einer Honorarabrechnung erfolgt als txt-Datei mit fester Länge. Nachfolgend die Aufgliederung dieser Txt-Datei im PEIQ-Standard ersichtlich:
01180000SAP1232021030420210218Text 000000730700291101000000000012920+2DEUR 000000021000227Mein Titel 00000000000006120011X |
Nr | Feld | Typ | Länge | Position | Text | Bemerkung | Auffüllen | Eigenschaft NGen | Tabelle | Abbildung |
1 | BUKRS | CHAR | 4 | 1 | Buchungskreis | ggf. mit führenden Nullen | führende Nullen | DHSBuchungskreis | DHonSatz | |
2 | KRENR | CHAR | 10 | 5 | Kreditor | Autor | führende Nullen | DHSKunNummerExt | DKunde | |
3 | ABRDAT | CHAR | 8 | 15 | Abre-Datum | YYYYMMDD | führende Nullen | aktuelles Datum (wird in der Leistung der Preisberechnung in BillDate bzw. bei Storno in BillDate2 gesetzt) | DHonSatz | |
4 | ERSCHDAT | CHAR | 8 | 23 | Ersch.Datum | YYYYMMDD | führende Nullen | Leistungsdatum - Inhalt des XML-Tags <DOI> der jeweiligen Leistung in der Eigenschaft DHSPreisBer des Honorarsatzes (Tabelle DHonSatz); Das Tag <DOI> wird bei der Honorarvergabe gefüllt und entspricht dem jeweiligen Erscheinungsdatum | DHonSatz | |
5 | HGR | CHAR | 20 | 31 | Hon.Gruppe | Text / Bild / Pauschal | rechts Spaces | DHSGruppe | DHonSatz | |
6 | KST | CHAR | 10 | 51 | Kostenstelle | führende Nullen | DHSKostenstelle | DHonSatz | ||
7 | OBJ | CHAR | 8 | 61 | Objekt | führende Nullen | DHSObjekt | DHonSatz | ||
8 | NETTO | CHAR | 14 | 69 | Netto-Betrag | (2 Dezimalen - ohne Trenner) | führende Nullen | Inhalt des XML-Tags <Pos Name="Netto"> der jeweiligen Leistung in der Eigenschaft DHSPreisBer des Honorarsatzes (Tabelle DHonSatz) | DHonSatz | |
9 | VZ | CHAR | 1 | 83 | Vorzeichen | Vorzeichen des Nettobetrags (- bei Gutschriften) | ||||
10 | MWSKZ | CHAR | 2 | 84 | Mws-Kennz. | führende Nullen | DAufUSTArt | DKunde | ExportSAPUSTArt | |
11 | KSVKZ | CHAR | 1 | 86 | KSV-Kennz | führende Nullen | DHSKSVPflicht | DHonSatz | ExportSAPKSV | |
12 | WAERS | CHAR | 5 | 87 | Währ. | ISO | rechts Spaces | keine Eigenschaft - nur EUR mitgeben | ||
13 | RENR | CHAR | 15 | 92 | Rechnungsnummer | Honorarnummer | 8stellige Nummer, die sich zusammensetzt aus Jahr (2stellig) und SAPLeistungsnummer(6stellig, DBSequence DHSSAPLeistungsNr), wird auch in der Preisberechnung am Honorarsatz gespeichert im Tag <BillNr> bzw. <BillNr2> bei Storno | DHonSatz | ||
14 | STICHW | 35 | 107 | Stichwort | Artikelüberschrift | rechts Spaces | DHSTitel | DHonSatz | ||
15 | ABW | CHAR | 10 | 142 | abw. ZE Kreditor | abweichende Zahlungsempf. | führende Nullen | DHSDUV - nicht verwendet | DHonSatz | |
16 | SAKNR | CHAR | 10 | 152 | Sachkonto | Sachkonto | führende Nullen | Inhalt des XML-Tags <PosStat / Konto> aus der Position Netto der jeweiligen Leistung in der Eigenschaft DHSPreisBer des Honorarsatzes (Tabelle DHonSatz) | ||
17 | ENDE | CHAR | 1 | 162 | Zeilen-Ende | X | am Ende steht X | |||
163 |
Anleitung zum Set-up
Voraussetzung für den Export ist das Honorarmodul siehe Honorar
Mögliche Anpassungsbereiche:
Abbildungen ZeitpunkteHonorarexport und ZeitpunkteStammdatenexport zur Festlegung der Zeitpunkte für Honorar- und Stammdatenexporte.
Auf Anfrage
Dies ist eine Ergänzung zur Dokumentation dieser Schnittstelle und befindet sich im Core-Bereich. Sie ist somit exklusiv für berechtigte Nutzer:innen vorbehalten. /wiki/spaces/CORE/pages/811892972
Verwandte Seiten
Disclaimer
Für die vorliegende Systemübersicht/Publikation behalten wir uns alle Rechte vor. Nachdruck, Vervielfältigung und Verbreitung (auch auszugsweise) ist nur mit schriftlicher Genehmigung der PEIQ GmbH erlaubt. Wir behalten uns vor, die Systemübersicht/Publikation jederzeit ohne vorherige Ankündigung zu ändern und/oder zu erweitern. Die vorliegenden Angaben dienen lediglich Informationszwecken. Die PEIQ GmbH übernimmt keinerlei Haftung und/oder Garantie für Fehler und/oder unvollständige Angaben in der Systemübersicht/Publikation, mit Ausnahme von vorsätzlich falschen oder arglistig verschwiegenen Angaben. Da unsere Software laufend weiter entwickelt wird, handelt es sich bei den vorliegenden nur um allgemeine Angaben. Es handelt sich weder um eine Zusicherung von Mindestvertragsinhalten, noch um Beschaffenheitsgarantien im Sinne des § 443 BGB.