Zum Inhalt
Sie verwenden eine veraltete Dokumentation Zur aktuellen Version wechseln

# 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:

1. 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.

2. 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.

3. 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 | Ist | MG | KZ1 | AVVISO | Bemerkung
--- | --- | --- | --- | --- | --- | --- | ---
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 | MG | 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 | Ist | MG | KZ1 | AVVISO | Bemerkung
--- | --- | --- | --- | --- | --- | --- | ---
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 | MG | 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 | Ist | MG | KZ1 | AVVISO | Bemerkung
--- | --- | --- | --- | --- | --- | --- | ---
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 | MG | 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

28. August 2025
12. Juni 2025