PEIQ Knowledge Base

[0-12] OUTBOUND Honorar Daten

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

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=wDBoDUedNbc

 

Datenformat 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 00000073070029110100000000001292+02DEUR 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. https://peiq.atlassian.net/wiki/spaces/CORE/pages/811892972

 

Verwandte Seiten