Mit diesem Formular können Sie fehlende, unklare oder fehlerhafte Inhalte in der Dokumentation melden und Verbesserungsvorschläge machen. Ihr Feedback hilft uns, die Qualität und Vollständigkeit kontinuierlich zu verbessern.
DPI Stammdatensätze vor der Übermittlung prüfen (Prüflauf)
Der Prüflauf ist eine Validierungsroutine, die auf Basis der DPI Stammdatensätze die Vollständigkeit und Konsistenz der Kontaktdaten prüft, bevor diese an die Zentrale Fachstelle Digitale Renteninformation (ZfDR) übermittelt werden. Jeder Kontakt, der über die Digitale Rentenübersicht gemeldet werden soll, benötigt einen zugehörigen DPI Stammdatensatz, er bildet den Ausgangspunkt für die gesamte Validierung.
Erst wenn ein Kontakt den Prüflauf fehlerfrei durchläuft, wird das Feld "Prüfung erfolgreich" gesetzt. Nur dann akzeptiert die ZfDR-Schnittstelle den Datensatz bei einer späteren Abfrage. Es empfiehlt sich, den Prüflauf regelmäßig durchzuführen, insbesondere nach Aktualisierungen der Transaktionsdaten durch die projektspezifische Implementierung.
Prüflauf starten
Der Prüflauf steht in zwei Varianten zur Verfügung – abhängig davon, ob alle Kontakte geprüft oder nur ein einzelner Datensatz validiert werden soll.
Vollständiger Prüflauf
Ausgangspunkt: Öffnen Sie die "DPI Stammdatensätze" über die Suche.
Prüflauf starten: Über die Aktion "Vollständiger Prüflauf" (Codeunit 5578587) werden alle vorhandenen DPI-Stammdatensätze geprüft. Diese Variante eignet sich für die regelmäßige Massenprüfung aller Kontakte.
Ergebnis auswerten: Nach Abschluss des vollständigen Prüflaufs gilt:
- Sind alle Datensätze fehlerfrei, erscheint die Meldung "Prüflauf ohne Fehler abgeschlossen."
- Gibt es Fehler, öffnet sich automatisch eine gefilterte Liste der DPI Stammdaten, die ausschließlich Kontakte mit "Prüfung erfolgreich = Nein" anzeigt. So können fehlerhafte Datensätze direkt eingesehen werden.
Einzelprüfung
Ausgangspunkt: Öffnen Sie die "DPI Stammdatensätze" über die Suche.
Einzelprüfung starten: Über die Aktion "Einzelprüfung" (Codeunit 5578589) wird nur der aktuell geöffnete Kontakt geprüft. Diese Variante eignet sich, wenn ein einzelner Datensatz gezielt geprüft oder nach einer Korrektur erneut validiert werden soll.
Ergebnis auswerten: Nach Abschluss der Einzelprüfung erscheint die Meldung "Prüflauf beendet.", unabhängig davon, ob Fehler aufgetreten sind. Das Ergebnis ist am Datensatz in den Feldern "Prüfung erfolgreich" und "Prüfungsfehler" ablesbar.
Tipp
Nutzen Sie die Einzelprüfung, um nach einer Korrektur eines Stammdatensatzes gezielt zu prüfen, ob der Fehler behoben wurde, ohne einen vollständigen Durchlauf aller Datensätze starten zu müssen.
Was wird geprüft?
Der Prüflauf durchläuft für jeden Kontakt sechs Schritte in fester Reihenfolge. Schlägt ein Schritt fehl, wird der Fehler protokolliert und der Datensatz als fehlerhaft markiert. Die ersten beiden Schritte sind globale Voraussetzungen – schlagen sie fehl, bricht der gesamte Prüflauf ab, ohne dass ein einziger Kontakt geprüft wird.
Das folgende Diagramm zeigt den vollständigen Prüfablauf mit allen möglichen Abbruch- und Fehlerpfaden.
flowchart LR
S(["▶ Start"]) --> P1["Lizenzprüfung"]
P1 -->|"ungültig"| A1(["⛔ Abbruch"])
P1 -->|"OK"| P2["Einrichtungsprüfung"]
P2 -->|"nicht konfiguriert"| A2(["⛔ Abbruch"])
P2 -->|"OK"| P3["Stammdaten vorhanden?"]
P3 -->|"fehlt"| E(["❌ fehlerhaft"])
P3 -->|"OK"| P4["Pflichtfelder Stammdaten"]
P4 -->|"unvollständig"| E
P4 -->|"OK"| P5["Unterbausteine prüfen"]
P5 -->|"ungültig"| E
P5 -->|"OK"| P6["PDF vorhanden?"]
P6 -->|"fehlt"| E
P6 -->|"OK"| OK(["✅ Prüfung erfolgreich"])
style S fill:#fff,stroke:#0098a1,stroke-width:1px,color:#000000
style P1 fill:#fff,stroke:#0098a1,stroke-width:1px,color:#000000
style P2 fill:#fff,stroke:#0098a1,stroke-width:1px,color:#000000
style P3 fill:#fff,stroke:#0098a1,stroke-width:1px,color:#000000
style P4 fill:#fff,stroke:#0098a1,stroke-width:1px,color:#000000
style P5 fill:#fff,stroke:#0098a1,stroke-width:1px,color:#000000
style P6 fill:#fff,stroke:#0098a1,stroke-width:1px,color:#000000
style A1 fill:#fff,stroke:#425253,stroke-width:1px,color:#000000
style A2 fill:#fff,stroke:#425253,stroke-width:1px,color:#000000
style E fill:#fff,stroke:#425253,stroke-width:1px,color:#000000
style OK fill:#fff,stroke:#0098a1,stroke-width:1px,color:#000000
| # | Prüfschritt | Bedingung | Bei Fehler |
|---|---|---|---|
| 1 | Lizenzprüfung | Die unitop-Lizenz für die Digitale Rentenübersicht muss aktiv und bezahlt sein. | Gesamter Prüflauf bricht ab. |
| 2 | Einrichtungsprüfung | Der "DPI Prüflauf Protokollartencode" in der DPI Einrichtung muss gesetzt sein. | Prüflauf bricht ab – keine Datensätze werden geprüft, kein Protokoll wird geschrieben. |
| 3 | Existenz des Stammdatensatzes | Für den Kontakt muss ein Eintrag in der Tabelle "DPI Stammdaten" vorhanden sein. | Kontakt wird als fehlerhaft markiert. |
| 4 | Pflichtfelder Stammdaten | Identifikationsnummer: Steuerliche Identifikationsnummer der versicherten Person muss gefüllt sein. Geburtsdatum: Geburtsdatum der versicherten Person muss gefüllt sein. |
Kontakt wird als fehlerhaft markiert. |
| 5 | Prüfung der Unterbausteine | a) Unterbaustein-Code: Muss 02a, 02b, 02c oder 02d sein.b) Standmitteilungs-Referenz: Typ 02a → muss leer sein. Typ 02b/02c/02d → muss gefüllt sein.c) Pflichtfelder je Typ: 02b (Rente): Stichtag Wertangabe, Datum Leistungsbeginn Rente, Intervall Rentenangabe.02c (Einmalbetrag): Stichtag Wertangabe, Datum Leistungsbeginn Einmalbetrag, Ratenzahlung.02d (Sonstiges): Ordnungsbegriff, Produktart.d) Betragseintrag: Mindestens ein Eintrag in "DPI Unterbaustein Beträgen" muss vorhanden sein. e) Standmitteilung: Referenzierter Eintrag muss in "DPI Standmitteilungen" vorhanden sein. |
Kontakt wird als fehlerhaft markiert. |
| 6 | PDF-Prüfung | Jeder referenzierte Standmitteilungs-Eintrag muss ein befülltes PDF-Dokument enthalten. Ein leeres BLOB-Feld ist ein Fehler. | Kontakt wird als fehlerhaft markiert. |
Warnung
Ist der DPI Prüflauf Protokollartencode nicht eingerichtet, kann kein Prüflauf gestartet werden. Tragen Sie zunächst den Code in der DPI Einrichtung ein.
Ergebnisse und Zustände
Bei einer Anfrage durch die ZfDR weist jeder DPI-Stammdatensatz einen Response Status auf, der beschreibt, wie Business Central die Anfrage bewertet hat. Dieser Status wird in der Tabelle Anfragedatenprotokoll gespeichert und gibt Aufschluss darüber, ob und warum ein Datensatz von der ZfDR angenommen oder abgelehnt wurde.
| Status | Wert | Bedeutung |
|---|---|---|
| ID not recognized | 0 | Die übermittelte Identifikationsnummer konnte in den DPI Stammdaten nicht gefunden werden. |
| ID recognized but date of birth differs | 1 | Die Identifikationsnummer wurde gefunden, das zugehörige Geburtsdatum stimmt jedoch nicht mit dem übermittelten Wert überein. |
| ID recognized | 2 | Identifikationsnummer und Geburtsdatum stimmen überein. Der Datensatz wurde von der ZfDR akzeptiert. |
| PreCheck failed | 3 | Identifikationsnummer und Geburtsdatum passen zusammen, aber "Prüfung erfolgreich" ist nicht gesetzt. Der Datensatz wurde übermittelt, bevor ein erfolgreicher Prüflauf durchgeführt wurde. |
Ermittlung des Status
Business Central ermittelt den Status bei Eingang einer Anfrage anhand einer zweistufigen Suche. Das folgende Diagramm zeigt die Entscheidungslogik im Überblick.
flowchart LR
A(["ZfDR-Anfrage"]) --> B{"ID + Geburtsdatum gefunden?"}
B -->|"Ja"| C{"Prüfung erfolgreich?"}
C -->|"Ja"| S2["Status 2 ID recognized"]
C -->|"Nein"| S3["Status 3 PreCheck failed"]
B -->|"Nein"| D{"Nur ID gefunden?"}
D -->|"Ja"| S1["Status 1 ID recognized but date of birth differs"]
D -->|"Nein"| S0["Status 0 ID not recognized"]
style A fill:#fff,stroke:#0098a1,stroke-width:1px,color:#000000
style B fill:#fff,stroke:#425253,stroke-width:1px,color:#000000
style C fill:#fff,stroke:#425253,stroke-width:1px,color:#000000
style D fill:#fff,stroke:#425253,stroke-width:1px,color:#000000
style S0 fill:#fff,stroke:#425253,stroke-width:1px,color:#000000
style S1 fill:#fff,stroke:#425253,stroke-width:1px,color:#000000
style S2 fill:#fff,stroke:#0098a1,stroke-width:1px,color:#000000
style S3 fill:#fff,stroke:#425253,stroke-width:1px,color:#000000
- Erste Suche: Es wird geprüft, ob ein Stammdatensatz mit der übermittelten Identifikationsnummer und dem Geburtsdatum vorhanden ist.
- Ist ein solcher Datensatz vorhanden und Prüfung erfolgreich = Ja → Status ID recognized
- Ist ein solcher Datensatz vorhanden und Prüfung erfolgreich = Nein → Status PreCheck failed
- Zweite Suche: Wird kein Treffer mit Identifikationsnummer und Geburtsdatum gefunden, wird die Suche ohne das Geburtsdatum wiederholt.
- Wird ein Datensatz nur über die Identifikationsnummer gefunden → Status ID recognized but date of birth differs
- Kein Treffer: Wird auch so kein Datensatz gefunden → Status ID not recognized
Fehlerprotokoll
Fehler, die während des Prüflaufs auftreten, werden im GOB Protokoll erfasst und am jeweiligen DPI-Stammdatensatz ausgewiesen. Dabei wird die Protokollart verwendet, die in der DPI Einrichtung unter "DPI Prüflauf Protokollartencode" hinterlegt ist.
Am DPI-Stammdatensatz werden nach jedem Prüflauf die Felder "Prüfung erfolgreich" und "Prüfungsfehler" aktualisiert:
- Prüfung erfolgreich: Wird auf Ja gesetzt, wenn alle Prüfschritte fehlerfrei durchlaufen wurden. Bei einem Fehler wird das Feld auf Nein zurückgesetzt.
- Prüfungsfehler: Enthält eine lesbare Beschreibung des letzten aufgetretenen Fehlers. Bei einem erfolgreichen Prüflauf wird das Feld geleert.
Die detaillierten Protokollzeilen können über die Aktion "Protokollzeilen" am DPI-Stammdatensatz eingesehen werden. Die Protokollzeilen enthalten Datum, Uhrzeit und eine genaue Fehlerbeschreibung für jede fehlgeschlagene Prüfung.