Saldo öffentlicher Schulden — Systembeschreibung
Datenmodell der NAV-Abfrage des Saldos öffentlicher Schulden, Regeln der Firmenauswahl und Antwortverarbeitung, Hintergrundaufgabe des täglichen Zeitplans und Berechtigungsschlüssel.
Überblick
NAV-Saldo öffentlicher Schulden (M2M-Abfrage) je Firma und Steuerart mit Abfragedatum; mit einer täglichen Zeitplankonfiguration je Mandant.
Datenmodell
Die Tabellennamen tragen in der Datenbank das eigene Präfix der Installation.
| Tabelle | Zweck | Hauptfelder |
|---|---|---|
nav_tax_debt | eine abgefragte Saldozeile | Firma, Steuer-ID, Steuerart, Saldo mit Vorzeichen (negativ = Schuld), Währung, Abfragedatum, Quelle (manual/cron), NAV-Meldung |
nav_tax_debt_config | täglicher Zeitplan je Mandant | Gültigkeit von–bis, make_pdf, Status, letzter Lauf und Ergebnis |
Ablauf
- Liste: Filter nach Unternehmensgruppe und Mandant (bei nur einer Gruppe oder Firma automatisch gewählt und gesperrt), Steuerart (aus abgefragten Zeilen), Datum (Schnellauswahl, Standard aktuelles Jahr), Richtung, nur letzter Stand; Summen für Schulden und Überzahlung. Meldet, wenn die Tabelle noch fehlt oder NAV-M2M nicht konfiguriert ist.
- Manuelle Abfrage: folgt dem Filter (eine Firma; nur Gruppe: deren aktive Firmen; leerer Filter: alle aktiven Mandantenfirmen im Berechtigungsbereich, geschnitten mit der Inhaltsberechtigung). Je Firma eine M2M-Abfrage zur Steuernummer, bevorzugt zur Gruppen-USt-Kennung, mit dem Periodenende als Parameter; die Posten werden gespeichert; eine unbekannte Antwortstruktur wird protokolliert und als Fehler gemeldet (die Rohantwort nur mit Recht
debugsichtbar); ein ablehnender NAV-Code ergibt einen Fehler, bei einem Berechtigungscode mit Erläuterung; eine leere erfolgreiche Antwort ergibt „keine öffentlichen Schulden“; der letzte Lauf wird in die Konfiguration geschrieben. - Zeitplan: Liste, Speichern, Löschen; das Von-Datum darf nicht nach dem Bis-Datum liegen.
Hintergrundaufgabe
Eine globale, vorab angelegte Hintergrundaufgabe nav_tax_debt. Für fällige Konfigurationen (Status 1, heute im Von–bis-Fenster, heute noch nicht gelaufen) führt sie dieselbe Abfrage katalogseitig aus, speichert das Ergebnis und vermerkt den Lauf.
Berechtigungen
- Ebene 1: Abfrage sowie Speichern und Löschen eines Zeitplans verlangen zusätzlich das Änderungsrecht.
- Ebene 2:
list,query,config,debug(SQL und die rohe NAV-Antwort). - Ebene 3: Die Liste ist auf erlaubte Firmen beschränkt; die Firmenliste der Abfrage und der Zeitplan sind mit der Inhaltsberechtigung geschnitten.