Ausgangsschnittstelle AVVISO

Ausgangsschnittstelle AVVISO#

SASKIA.H2R unterstützt die Schnittstelle AVVISO. Die Beschreibung der Schnittstelle basiert auf der Dokumentation (DATA-TEAM) vom März 2009 (Version 0.6)

Für die korrekte Erstellung einer AVVISO-Schnittstellendatei sind zunächst im Menüpunkt Mandantenverwaltung die Parameter F11 bzw. F12 zu definieren.

Hauptforderungen

Die Datenübergabe an das Vollstreckungsprogramm AVVISO läuft in folgenden 3 Schritten ab:

Markieren der Erstdaten Dazu wird getestet, ob es einen neuen Mahnlauf gibt. Falls ja, so werden alle gemahnten Positionen (jeweils pro PK) markiert und der für die Mahnung benutzte Betrag vorgemerkt und gekennzeichnet.
Markieren der Folgedaten Als Folgedaten werden prinzipiell nur Buchungen betrachtet, welche später als der letzte Mahnlauf (MG=Vollstreckung) gebucht wurden. Dabei werden alle Buchungen, die zu einer Veränderung des ursprünglichen OP's geführt haben (Zahlungen, Sollveränderungen, ...) in die Betrachtung einbezogen und gekennzeichnet.
Aufbereiten der Daten im Schnittstellenformat und Erstellung von Datenträger bzw. Report Die gekennzeichneten Fälle (s. o.) werden nach Satzart (Forderung/Zahlung) aufbereitet und an das Ausgabesystem übergeben. Dort wird mittels hinterlegten Schnittstellenmakros eine Datei erzeugt, die im Einleseformat des AVVISO-Programms bereit gestellt wird. Buchungszeichen und Schuldnernummer SC:Mandant und Adressnummer BU:Mandant und Adressnummer

Der Schuldner wird damit durch das eindeutige Buchungszeichen identifiziert. Der SC und der BU-Satz werden bei erstmaliger Übergabe dieses Buchungszeichens an AVVISO erstellt. Optional ist auch eine spätere Übergabe zum Zwecke eines Datenabgleiches möglich. Der übergebene Forderungssatz entspricht einer debitorischen Sollstellung. Übergebene Zahlungssätze entsprechen debitorischen Habenbuchungen. Grundsätzlich erfolgt auch immer die Übergabe der kompletten OP-Historie, um auch einen notwendigen Nachweis für die Vollstreckung zu haben. Nebenforderungen

Für AVVISO sind folgende Nebenforderungen relevant:

Forderungsart	Einnahmeart
500	Buchungsstelle für die Verbuchung der Mahngebühren z. B. 9000
600	Buchungsstelle für die Verbuchung der Verzugszinsen z. B. 9001
700	Buchungsstelle für die Verbuchung der Säumniszuschläge z. B. 9002

Dabei dürfen die Einnahmearten sich nicht überschneiden. Es sind also auf jeden Fall getrennte Einnahmearten für die oben aufgeführten Schlüssel zu definieren.

Nebenforderungen werden prinzipiell genau so behandelt wie Hauptforderungen. Lediglich in der Schnittstelle wird die Nebenforderung als solche gekennzeichnet. Bei Zinsen (Säumniszuschläge etc.) wird außerdem ermittelt, wann der letzte Mahnlauf (MG=Vollstreckung) war. Dieser Zeitpunkt wird an AVVISO übergeben, als Wert "Berechnet bis". Das Zuordnen von Nebenforderung zu einer Hauptforderung (z. B. Säumniszuschläge) erfolgt im AVVISO-Programm automatisch in Folge der Schlüsselbeziehung. Ist eine Nebenforderung einer Hauptforderung nicht direkt zuordenbar (z. B. Mahngebühren) wird sie immer der ersten an AVVISO übergebenen Hauptforderung zugeordnet.

FO - Forderung

Beschreibung Feld	Länge	Position	von	bis	Füllung Sollzugang	Füllung Sollabgang
version	3	1	1	3	5.1
satzkennung	2	4	4	5	FO
flag	1	6	6	6
mand_nr	10	7	7	16	OP.mand
hhstelle	50	17	17	66	OP.prod / OP.kto / OP.mas
bz	50	67	67	116	OP.mand -- '-' -- OP.adr_nr
verfdat	8	117	117	124	OP.dat_beleg
faelldat	8	125	125	132	OP.dat_faell
betrag	12	133	133	144	ABS (OP.op_soll_a - OP.op_haben_a)
fo_art	1	145	145	145	1,2,2,2,3,3,3,2	4,8,8,8,8,8,8,8
kuerzel	10	146	146	155	,MG,VS,SG,SK,SM,SZ	,MG,VS,SG,SM,SK,SZ,
bezeichnung	250	156	156	405	OP.rech_nr -- OP.eart -- OP.objekt -- OP.btext1 -- OP.btext2 -- ObjektBez
key	50	406	406	455	OP.kb_op_pid
keine_sz	1	456	456	456	0/1 aus FO_ART
hkr_key	50	457	457	506	OP.kb_op_id
eakuerzel	25	507	507	531	OP.EART
hh_jahr	4	532	532	535	Übergabejahr
zinsen_hkr_bis	8	536	536	543	OP.dat_mahn (A - OP)
fo_key	50	544	544	593	OP.kb_op_pid
insolvenz	1	594	594	594
rechnzugangdat	8	595	595	602	OP.dat_eing
begruendedat	8	603	603	610	OP.dat_beleg
startzinsberdat	8	611	611	618
mahndat	8	619	619	626	OP.dat_mahn
mahnzugangdat	8	627	627	634
rechtsgeschaeft	1	635	635	635
datum_n_übergabe	8	636	636	643
mahnstufe	3	644	644	646	OP.mahngrad
übergabegrund	3	647	647	649
kontierungsinfo	50	650	650	699
Satzlänge		699

ZA - Zahlung

Beschreibung Feld	Länge	Position	von	bis	Füllung
version	3	1	1	3	5.1
satzkennung	2	4	4	5	ZA
flag	1	6	6	6
mand_nr	10	7	7	16	OP.mand
hhstelle	50	17	17	66	OP.prod / OP.kto / OP.mas
bz	50	67	67	116	OP.mand -- '-' -- OP.adr_nr
schuld_nr	25	117	117	141	OP.mand -- OP.adr_nr
buchungsdat	8	142	142	149	OP.dat_buch
eingdat	8	150	150	157	OP.dat_valuta
betrag	12	158	158	169	OP.op_haben_a
zahlweg	10	170	170	179	OP.zahlweg
bezeichnung	250	180	180	429	OP.rech_nr -- OP.eart -- OP.objekt --OP.btext1 -- OP.btext2 -- ObjektBez
key	50	430	430	479	OP.kb_op_pid
hkr_key	50	480	480	529	OP.kb_op_id
za_key	50	530	530	579	OP.kb_op_pid
Satzlänge		579

Kennzeichen kz_avviso1

leer keine Übergaben an AVVISO
ADaten aus Mahnlauf (gemahnte Fälligkeit), wird nur temporär vergeben
BFolgedaten, wird nur temporär vergeben
XBuchung an AVVISO übergeben

Die nachfolgenden notwendigen Einträge sind bereits vorhanden und mit einem Standardwert belegt. Für die Anpassung ist der Menüpunkt "Pflege Mandant – Registerkarte Kasse" zu benutzen.

Für AVVISO sind folgende Nebenforderungen relevant:

MAHNGEintrag HH-Stelle für die Verbuchung der Mahngebühren SAEUMEintrag HH-Stelle für die Verbuchung der Säumniszuschläge bei Mahnung öffentlich-rechtlicher Forderungen VERZZEintrag HH-Stelle für die Verbuchung der Verzugszinsen

Dabei dürfen die Einnahmearten sich nicht überschneiden. Es sind also auf jeden Fall getrennte Einnahmearten für die oben aufgeführten Schlüssel zu definieren.

Code K15 Startwert (LfdNr) Mahnung

Falls dieser Wert angegeben wird, werden die Daten an AVVISO erst ab diesem Mahnlauf übergeben.

Hauptforderungen

Die Datenübergabe an das Vollstreckungsprogramm AVVISO läuft in 3 Schritten ab: Markierung der ErstdatenMarkierung der FolgedatenAufbereiten der Daten im Schnittstellenformat und erzeugen Datenträger bzw. Report

Markieren der Erstdaten

Dazu wird getestet ob es einen neuen Mahnlauf gibt. Falls ja, so werden alle gemahnten Positionen (jeweils pro PK) in der Tabelle KB_SACHBUCH markiert und der für die Mahnung benutzte Betrag vorgemerkt (Kennzeichen "A"). Außerdem werden alle SOLL=IST Buchungen der Einnahmeart Säumniszuschläge vorgemerkt (Kennzeichen "A"). Problematisch sind an dieser Stelle Mahngebühren und Säumniszuschläge, welche erst durch diesen Mahngrad entstanden sind, also NICHT mit gemahnt wurden. Diese müssen aber ebenfalls an AVVISO übergeben werden. Dies wird dadurch erreicht, dass die Sollbuchungen dieser Einnahmearten, welche den Vollstreckungsmahngrad besitzen und noch nicht an AVVISO übergeben wurden, markiert werden (Kennzeichen "A").

Markieren der Folgedaten

Als Folgedaten werden prinzipiell nur Buchungen betrachtet, welche später als der letzte Mahnlauf (MG=Vollstreckung) gebucht wurden. Als Folgedaten werden 3 verschiedene Gruppen von Buchungen unterschieden:

Buchungen auf einer bereits nach AVVISO übergebenen Fälligkeit. (Dabei spielt der Mahngrad der Buchung keine Rolle)

Sollabgänge denen kein positives Soll gegenübersteht (pro Fälligkeit)

Istbuchungen denen kein positives Soll gegenübersteht (pro Fälligkeit)

Die so ermittelten Buchungen werden mit "B" gekennzeichnet.

Aufbereiten der Daten ...

Die gekennzeichneten Fälle ("A","B") werden nach Satzart (Forderung/Zahlung) aufbereitet und an das Ausgabesystem übergeben. Dieses wiederum kann mittels der DTR-Datei einen Datenträger bereitstellen (Diskette oder Datei).

Buchungszeichen und Schuldnernummer

SC:keine Schuldnernummer BU:Adressnummer + Einnahmeart + ObjektAAAAAAAEEEEOO Der Schuldner wird damit durch das eindeutige Buchungszeichen identifiziert Der SC und der BU Satz werden nur bei erstmaliger Übergabe dieses Buchungszeichens an AVVISO erstellt.

Nebenforderungen

Nebenforderungen werden prinzipiell genau so behandelt wie Hauptforderungen. Lediglich in der Schnittstelle wird die Nebenforderung als solche gekennzeichnet. Bei Zinsen (Säumniszuschläge etc.) wird außerdem ermittelt, wann der letzte Mahnlauf (MG=Vollstreckung) war. Dieser Zeitpunkt wird an AVVISO übergeben, als Wert "Berechnet bis". Das Zuordnen der Nebenforderung zu einer Hauptforderung ist definitiv nicht möglich. Die Nebenforderung wird immer der ersten an AVVISO übergebenen Hauptforderung zugeordnet. Durch das Zusammenführen in AVVISO anhand des Schuldnernamens ist diese jedoch in aller Regel eindeutig sichtbar.

Beispiele und Ablauf

ID	Fälligkeit	Soll	MG	KZ1	AVVISO
1	15.02	100	2	1	FO 100
2	15.05	100	2	1	FO 100
3	15.08	100	2	1	FO 100

ID	Fälligkeit	Soll	Ist	KZ1	AVVISO	Bemerkung
10	15.02	-100		1	FO -100	normaler Sollabgang auf Fälligkeit
11	15.05		50	1	ZA 50	normale Istzahlung auf Fälligkeit
14	15.08	10				komplette Übergabe weil auf einer relevanten Fälligkeit
15	15.08	-10
16	20.05		10	1	ZA 10	Ist ohne Soll wird übergeben
17	25.05	20				Soll wird nicht übergeben
18	25.05		10			Ist mit Soll wird nicht übergeben

Sollabgang außerhalb einer Fälligkeit

ID	Fälligkeit	Soll	MG	KZ1	AVVISO
1	15.02	100	2	1	FO 100
2	15.05	100	2	1	FO 100
3	15.08	100	2	1	FO 100

ID	Fälligkeit	Soll	KZ1	AVVISO	Bemerkung
10	15.06	-200	1	FO -200	Sollabgang außerhalb Fälligkeit
11	15.09	55			keine Übergabe weil es Sollbuchung für diese Fälligkeit gibt
12	15.09	-55

Mit MG1 und MG2

ID	Fälligkeit	Soll	MG	KZ1	AVVISO
1	15.02	100	2	1	FO 100
2	15.05	100	2	1	FO 100
3	15.08	100	1

ID	Fälligkeit	Soll	Ist	KZ1	AVVISO	Bemerkung
10	15.06	-50		1	FO -200	Sollabgang außerhalb Fälligkeit
11	15.07	-200			FO -150	nur 150,- dann ist offenes Soll=0 f. AVVISO
12	15.08		100			keine Übergabe, weil Fälligkeit nicht übergeben