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.
Grundeinrichtung
Bevor die Digitale Rentenübersicht genutzt werden kann, müssen einige Einrichtungsschritte in Business Central durchgeführt werden. Diese Seite beschreibt die notwendigen Einstellungen sowie die Befüllung der Stammdatentabellen und gibt einen Überblick über die Transaktionsdatentabellen, die im Rahmen der Projektimplementierung durch kundenspezifische Entwicklung befüllt werden.
Voraussetzungen
Stellen Sie vor der Einrichtung sicher, dass die folgenden Voraussetzungen erfüllt sind:
- Die unitop-Lizenz für die Digitale Rentenübersicht ist aktiv und bezahlt.
- Die Extension unitop Altersversorgung ist eingerichtet und ein Protokollartencode ist vorhanden, der für die Prüflauf-Protokollierung verwendet werden kann.
- Die technische Schnittstelleninfrastruktur (Azure Function Proxy) ist eingerichtet. Weitere Informationen finden Sie hier.
- Eine projektspezifische Extension zur Befüllung der Transaktionsdaten ist implementiert oder in Entwicklung.
Quickstart-Einrichtungen
Die folgenden Szenarien beschreiben die empfohlene Vorgehensweise für typische Einrichtungsschritte. Ausführliche Feldbeschreibungen und eine Übersicht aller Einrichtungsaktionen finden Sie in den nachfolgenden Abschnitten dieser Seite.
Ersteinrichtung nach Neuinstallation
Das folgende Szenario beschreibt die empfohlene Vorgehensweise bei der Ersteinrichtung des DPI-Moduls nach einer Neuinstallation.
DPI Einrichtung öffnen: Öffnen Sie über die Suche die "DPI Einrichtung".
Schnittstelle aktivieren: Aktivieren Sie im Bereich "Allgemein" das Feld "Schnittstelle aktiv", sobald die Schnittstelle produktiv genutzt werden soll.
Adressdaten eintragen: Tragen Sie im Bereich "Unternehmen" die Adressdaten Ihres Unternehmens ein (Straße, Hausnummer, PLZ, Ort, Land und optional Postfach und URL).
Protokollartencode hinterlegen: Hinterlegen Sie im Feld "DPI Prüflauf Protokollartencode" den gewünschten Protokollartencode für die Fehlerprotokollierung des Prüflaufs.
Ersteinrichtung starten: Wählen Sie im Menüband den Reiter "Einrichten" und dann "Erstelle Ersteinrichtungen".
Sicherheitsabfrage bestätigen: Bestätigen Sie die Sicherheitsabfrage, dass vorhandene Daten überschrieben werden können.
Tabellen befüllen: Das System füllt alle Stammdatentabellen (Fehlerkatalog, Produktarten, Unterbausteinarten, Intervalle Rentenangabe, Wert Typen, Ratenzahlungen, Leistungsarten) mit den gesetzlich vorgesehenen Vorgabewerten.
Abschlussmeldung prüfen: Nach erfolgreicher Ausführung erscheint eine Bestätigungsmeldung.
Tipp
Prüfen Sie nach der Ersteinrichtung die einzelnen Stammdatenlisten über den Reiter "Start", um sicherzustellen, dass alle Vorgabewerte korrekt angelegt wurden.
Einzelne Stammdatentabelle neu befüllen
Wenn Sie eine einzelne Stammdatentabelle erneut mit Vorgabewerten befüllen möchten, ohne alle anderen Tabellen zu beeinflussen, gehen Sie wie folgt vor:
Öffnen Sie über die Suche die "DPI Einrichtung".
Wählen Sie im Menüband den Reiter "Einrichten".
Wählen Sie die gewünschte Einzelaktion, z. B. "Erstelle Vorgabewerte für DPI Produktarten".
Bestätigen Sie die Sicherheitsabfrage, falls die Tabelle bereits Daten enthält.
Das System befüllt ausschließlich die gewählte Tabelle neu.
Warnung
Wenn Sie Einträge in einer Stammdatentabelle manuell angepasst haben, können diese durch die erneute Ausführung der Ersteinrichtungsaktion überschrieben werden. Sichern Sie Ihre Anpassungen vor der Ausführung.
DPI Einrichtung
Öffnen Sie die "DPI Einrichtung" über die Suche in Business Central oder über das DPI-Rollencenter.
Hinweis
Die Einrichtungskarte enthält genau einen Datensatz. Das Anlegen und Löschen von Einträgen ist nicht möglich. Der Einrichtungsdatensatz wird beim erstmaligen Öffnen der Seite automatisch angelegt.
Allgemein
| Feld | Beschreibung |
|---|---|
| Schnittstelle aktiv | Aktiviert oder deaktiviert die Schnittstelle zur Zentralen Stelle für die Digitale Rentenübersicht (ZfDR). Solange dieses Feld nicht gesetzt ist, werden keine Daten übermittelt. |
| DPI Prüflauf Protokollartencode | Code der Protokollart (aus dem unitop Contract Management Pensions), unter der Prüflauf-Ergebnisse protokolliert werden. Dieses Feld muss gesetzt sein, bevor ein Prüflauf gestartet werden kann. |
Unternehmensinformationen
Diese Felder beschreiben die Adresse des meldenden Unternehmens. Die Angaben werden bei der Datenübermittlung an die ZfDR verwendet.
| Feld | Beschreibung |
|---|---|
| Straße | Straßenname der Unternehmensadresse. |
| Hausnummer | Hausnummer der Unternehmensadresse. |
| PLZ | Postleitzahl. |
| Ort | Ortsname. |
| Land | Länderkennzeichen. |
| Postfach | Optionales Postfach der Unternehmensadresse. |
| URL | URL der Unternehmenswebseite. |
Ersteinrichtungen durchführen
Über die Aktion "Einrichten" im Menü der "DPI Einrichtung" stehen Aktionen zur Verfügung, mit denen alle Stammdatentabellen mit den gesetzlich vorgesehenen Vorgabewerten befüllt werden können. Neben der vollständigen Ersteinrichtung steht für jede Stammdatentabelle auch eine Einzelaktion zur Verfügung.
Warnung
Alle Ersteinrichtungsaktionen können vorhandene Daten überschreiben. Das System fragt vor der Ausführung nach einer Bestätigung. Die Ersteinrichtung ist ausschließlich in deutscher Systemsprache verfügbar. Bei abweichender Sprache erfolgt ein zusätzlicher Hinweis.
Erstelle Ersteinrichtungen
Öffnen Sie die "DPI Einrichtung" und wählen Sie im Menüband den Reiter "Einrichten" und dann "Erstelle Ersteinrichtungen". Diese Aktion führt alle nachfolgenden Ersteinrichtungsaktionen in einem Schritt aus. Folgende Tabellen werden dabei befüllt:
| Aktion | Befüllte Tabelle | Beschreibung |
|---|---|---|
| Erstelle Ersteinrichtung Fehlerkatalog | DPI Fehlerkatalog | Befüllt die Tabelle mit den vordefinierten Fehlercodes und -beschreibungen. |
| Erstelle Vorgabewerte für DPI Produktarten | DPI Produktarten | Befüllt die Tabelle mit den gesetzlich definierten Produktartcodes für alle Kategorien der gesetzlichen, betrieblichen und privaten Altersvorsorge. |
| Erstelle Vorgabewerte für Unterbausteinarten | DPI Unterbausteinarten | Befüllt die Tabelle mit den vordefinierten Unterbausteinarten für Ansprüche. |
| Erstelle Vorgabewerte für Intervalle der Rentenangaben | DPI Intervalle Rentenangabe | Befüllt die Tabelle mit den Vorgabewerten für Rentenzahlungsintervalle (z. B. Monatsrente, Quartalsrente). |
| Erstelle Vorgabewerte für Wert Typen | DPI Wert Typen | Befüllt die Tabelle mit den vordefinierten Codes für garantierte und prognostizierte Renten- und Kapitalwerte. |
| Erstelle Vorgabewerte für Ratenzahlungen | DPI Ratenzahlungen | Befüllt die Tabelle mit den Vorgabewerten für mögliche Ratenzahlungsoptionen. |
| Erstelle Vorgabewerte für die Leistungsart | DPI Leistungsarten | Befüllt die Tabelle mit den Vorgabewerten für Leistungsarten (Kombination, Wahlrecht). |
Hinweis
Verwenden Sie diese Aktion bei einer Neuinstallation, um alle Stammdatentabellen in einem Schritt einzurichten.
Ablauf der Ersteinrichtung
- Sicherheitsabfrage: Business Central fragt, ob die Ersteinrichtung tatsächlich durchgeführt werden soll, da dabei vorhandene Daten überschrieben werden können.
- Sprachprüfung: Die Standardwerte stehen ausschließlich auf Deutsch zur Verfügung (Sprachcode 1031). Die Funktion prüft, ob die aktuelle Spracheinstellung kompatibel ist.
- Befüllung der Stammdatentabellen: Alle sieben Stammdatentabellen werden mit den vordefinierten Standardwerten befüllt. Vorhandene Einträge werden dabei aktualisiert.
- Abschlussmeldung: Nach erfolgreichem Abschluss erscheint die Meldung "Ersteinrichtung wurde erfolgreich abgeschlossen."
Tipp
Führen Sie die Ersteinrichtung direkt nach der Installation der Extension aus, bevor Sie mit der eigentlichen Einrichtung beginnen. So stellen Sie sicher, dass alle Stammdatentabellen korrekt befüllt sind.
Stammdatentabellen
Die folgenden Stammdatentabellen werden durch die Ersteinrichtung befüllt und können bei Bedarf manuell gepflegt werden. Sie sind über den Menüpunkt "Start" der "DPI Einrichtung" direkt aufrufbar sowie über die Suche in Business Central.
DPI Fehlerkatalog
Der "DPI Fehlerkatalog" enthält die definierten Fehlercodes mit Kurz- und ausführlicher Beschreibung. Diese Fehler werden im Rahmen des DPI-Verarbeitungsprozesses zur Protokollierung und Auswertung herangezogen.
| Feld | Beschreibung |
|---|---|
| Fehlernummer | Gibt die Fehlernummer an. |
| Kurzbeschreibung | Gibt die Kurzbeschreibung des Fehlers an. |
| Vollständige Beschreibung 1 | Gibt die vollständige Beschreibung des Fehlers an (erster Teil). |
| Vollständige Beschreibung 2 | Gibt die vollständige Beschreibung des Fehlers an (zweiter Teil, falls der Text die Zeichengrenze überschreitet). |
Vorgabewerte nach Ersteinrichtung:
| Fehlernummer | Kurzbeschreibung |
|---|---|
| 0001 | JSON Daten Schemaverstoß |
| 0002 | PDF Datei größer 2,6 MB |
| 0003 | standmitteilung_referenz und XStandmitteilung-Referenz Header passen nicht zusammen |
| 0004 | PDF Anlage fehlerhaft |
| 0005 | Keine strukturierten JSON Daten in der Antwort enthalten |
DPI Produktarten
Die "DPI Produktarten" enthalten die nach gesetzlicher Vorgabe definierten Produktarten der Altersvorsorge. Diese Codes werden bei der DPI-Datenerfassung zur Klassifizierung der Altersvorsorgeprodukte verwendet.
| Feld | Beschreibung |
|---|---|
| Produktart | Gibt den Code der Produktart an (max. 6 Zeichen). |
| Beschreibung | Gibt die Beschreibung der Produktart an. |
| Gesperrt | Gibt an, ob die Produktart gesperrt ist. Gesperrte Produktarten stehen bei der Dateneingabe nicht zur Auswahl. |
Vorgabewerte nach Ersteinrichtung (Auswahl):
| Code | Beschreibung |
|---|---|
| _1_1_0 | Gesetzliche Rentenversicherung |
| _1_2_0 | Alterssicherung der Landwirte |
| _1_3_0 | Berufsständische Versorgung |
| _1_4_0 | Beamtenversorgung |
| _2_1_0 | Direktzusage |
| _2_2_0 | Unterstützungskasse |
| _2_3_0 | Pensionsfonds |
| _2_4_0 | Pensionskasse |
| _2_4_5 | Zusatzversorgung des öffentlichen Dienstes |
| _2_5_0 | Direktversicherung |
| _2_6_0 | Pensions-Sicherungs-Verein und Versicherungsverein auf Gegenseitigkeit |
| _3_1_0 | Geförderte Altersvorsorge nach § 10 Abs. 1 Nr. 2 Satz 1 Buchst. b EStG "Basis-Rente" |
| _3_2_0 | Geförderte Altersvorsorge nach § 10a i.V.m. Abschnitt XI EStG "Riester-Verträge" |
| _3_9_0 | Sonstige private Altersvorsorge |
DPI Unterbausteinarten
Die "DPI Unterbausteinarten" definieren, welche Art von Anspruch einem DPI-Unterbaustein zugrunde liegt.
| Feld | Beschreibung |
|---|---|
| Unterbausteinart | Gibt den Code der Unterbausteinart an (max. 3 Zeichen). |
| Beschreibung | Gibt die Beschreibung der Unterbausteinart an. |
| Gesperrt | Gibt an, ob die Unterbausteinart gesperrt ist. |
Vorgabewerte nach Ersteinrichtung:
| Code | Beschreibung |
|---|---|
| 02a | Anspruch – Keine Standmitteilung |
| 02b | Anspruch – Nur Rentenzahlung |
| 02c | Anspruch – Nur Einmalbetrag |
| 02d | Anspruch – Kombination oder Wahlrecht |
DPI Intervalle Rentenangabe
Die "DPI Intervalle Rentenangabe" definieren das Zahlungsintervall einer Rente, das für die DPI-Datenmeldung benötigt wird.
| Feld | Beschreibung |
|---|---|
| Code | Gibt den Code für ein Zeitintervall an. |
| Intervall Rentenangabe | Gibt das Zeitintervall der Rentenzahlung an. |
| Gesperrt | Gibt an, ob der Code für ein Zeitintervall gesperrt ist. |
Vorgabewerte nach Ersteinrichtung:
| Code | Beschreibung |
|---|---|
| M | Monatsrente |
| Q | Quartalsrente |
| H | Halbjahresrente |
| J | Jahresrente |
| K | Kapitalangabe |
DPI Wert Typen
Die "DPI Wert Typen" klassifizieren die in der DPI-Datenmeldung ausgewiesenen Renten- und Kapitalwerte nach ihrer Wertbasis (garantiert oder prognostiziert) und ihrem Status (erreicht oder erreichbar).
| Feld | Beschreibung |
|---|---|
| Code | Gibt den Code für einen Wert Typ an. |
| Wert Typ | Gibt die Bezeichnung des Wert Typs an. |
| Gesperrt | Gibt an, ob der Code für einen Wert Typ gesperrt ist. |
Vorgabewerte nach Ersteinrichtung:
| Code | Beschreibung |
|---|---|
| RENTE G E | Garantiert erreichte Rente |
| RENTE P E | Prognostiziert erreichte Rente |
| RENTE G EB | Garantiert erreichbare Rente |
| RENTE P EB | Prognostiziert erreichbare Rente |
| KW G E | Garantiert erreichter Kapitalwert |
| KW P E | Prognostiziert erreichter Kapitalwert |
| KW G EB | Garantiert erreichbarer Kapitalwert |
| KW P EB | Prognostiziert erreichbarer Kapitalwert |
| EB G E | Garantiert erreichter Einmalbetrag |
| EB P E | Prognostiziert erreichter Einmalbetrag |
| EB G EB | Garantiert erreichbarer Einmalbetrag |
| EB P EB | Prognostiziert erreichbarer Einmalbetrag |
| KAP STAND | Stand Kapital |
DPI Ratenzahlungen
Die "DPI Ratenzahlungen" definieren, ob und in welcher Form eine Ratenzahlung für eine Leistung vorgesehen ist.
| Feld | Beschreibung |
|---|---|
| Code | Gibt den Code für eine Ratenzahlung an. |
| Ratenzahlung | Gibt an, ob eine Ratenzahlung möglich ist. |
| Gesperrt | Gibt an, ob der Code für eine Ratenzahlung gesperrt ist. |
Vorgabewerte nach Ersteinrichtung:
| Code | Beschreibung |
|---|---|
| N | nicht vorgesehen |
| O | optional |
| Z | zwingend |
DPI Leistungsarten
Die "DPI Leistungsarten" bestimmen, welche Auszahlungsform für eine DPI-Leistung vorgesehen ist.
| Feld | Beschreibung |
|---|---|
| Code | Gibt den Code für eine Leistungsart an. |
| Leistungsart | Gibt die Bezeichnung der Leistungsart an. |
| Gesperrt | Gibt an, ob der Code für eine Leistungsart gesperrt ist. |
Vorgabewerte nach Ersteinrichtung:
| Code | Beschreibung |
|---|---|
| K | Kombination |
| OHNE | Wahlrecht keine Vorauswahl |
| RENTE | Wahlrecht Vorauswahl Rente |
| EINMAL | Wahlrecht Vorauswahl Einmalbetrag |
Transaktionsdaten
Die folgenden Tabellen bilden das Datenhaltungsmodell der Digitalen Rentenübersicht. Sie enthalten die Renten- und Kontaktdaten, die bei einer Abfrage durch die ZfDR über die API bereitgestellt werden.
Die Extension stellt diese Tabellen als öffentlich zugängliches Datenmodell bereit. Die Befüllung der Tabellen ist nicht Bestandteil der Extension selbst, sondern erfolgt im Rahmen der kundenspezifischen Projektimplementierung durch eine abhängige Extension. Diese projektspezifische Entwicklung liest die relevanten Daten aus den vorhandenen unitop-Datenquellen (z. B. unitop Altersversorgung) aus und schreibt sie in die DPI-Tabellen.
Die zugehörigen API-Seiten sind ausschließlich für den Lesezugriff durch die ZfDR konfiguriert. Ein Einfügen, Ändern oder Löschen von Datensätzen über die API-Endpunkte ist nicht möglich.
Hinweis
Die Extension veröffentlicht Integration Events im Bereich des Prüflaufs und der Datenlöschung, über die Projektentwicklungen den Verarbeitungsablauf erweitern oder anpassen können. Für die initiale Datenbefüllung sind keine spezifischen Import-Events vorgesehen – die Tabellen sind über abhängige Extensions direkt beschreibbar.
DPI Stammdaten
Enthält einen Datensatz je Kontakt mit den Grundinformationen, die für die Identifikation bei der ZfDR notwendig sind.
Seite: DPI Stammdaten (5578305)
| Feld | Beschreibung |
|---|---|
| Kontaktnr. | Nummer des zugeordneten Business-Central-Kontakts (Tabelle Kontakt). |
| Identifikationsnummer | Steuerliche Identifikationsnummer der versicherten Person. |
| Geburtsdatum | Geburtsdatum der versicherten Person. |
| Kontaktname | Name des Kontakts, wie er in Business Central hinterlegt ist. |
| Prüfung erfolgreich | Gibt an, ob der letzte Prüflauf für diesen Kontakt ohne Fehler abgeschlossen wurde. |
| Prüfungsfehler | Enthält eine Beschreibung des letzten Prüfungsfehlers, sofern die Prüfung nicht erfolgreich war. |
DPI Unterbausteine
Enthält die Unterbausteine je Kontakt. Ein Kontakt kann mehrere Unterbausteine unterschiedlicher Arten haben.
Seite: DPI Unterbausteine (5578307)
| Feld | Beschreibung |
|---|---|
| Kontaktnr. | Zugehöriger Kontakt. |
| Art | Unterbaustein-Code: 02a (Basis), 02b (Rente), 02c (Einmalbetrag) oder 02d (Sonstiges). |
| Gesellschaft | Name der meldenden Gesellschaft. |
| Produkt | Bezeichnung des gemeldeten Produkts. |
| Stichtag Wertangabe | Datum, auf das sich die Wertangaben beziehen. |
| Datum Leistungsbeginn Rente | Bei Typ 02b: Beginn der Rentenleistung. |
| Intervall Rentenangabe | Bei Typ 02b: Zahlungsintervall der Rente. |
| Datum Leistungsbeginn Einmalbetrag | Bei Typ 02c: Zeitpunkt der Einmalzahlung. |
| Ratenzahlung | Bei Typ 02c: Art der Ratenzahlung. |
| Ordnungsbegriff | Bei Typ 02d: Eindeutiger Ordnungsbegriff. |
| Produktart | Bei Typ 02d: Art des Produkts. |
| Standmitteilungs-Referenz | Verweis auf den zugehörigen Standmitteilungs-Eintrag (bei 02b, 02c, 02d). |
DPI Unterbaustein Beträge
Enthält die Beträge je Unterbaustein. Einem Unterbaustein können mehrere Betragseinträge zugeordnet sein.
Seite: DPI Unterbaustein Beträge (5578310)
| Feld | Beschreibung |
|---|---|
| Kontaktnr. | Zugehöriger Kontakt. |
| Unterbaustein-Referenz | Verweis auf den übergeordneten Unterbaustein. |
| Betragsart | Klassifikation des Betrags gemäß den DPI Wert Typen. |
| Wert-Typ | Typ des gemeldeten Werts. |
| Betrag | Gemeldeter Geldbetrag. |
DPI Standmitteilungen
Enthält die Standmitteilungen in Form von PDF-Dokumenten je Kontakt.
Seite: DPI Standmitteilungen (5578312)
| Feld | Beschreibung |
|---|---|
| Kontaktnr. | Zugehöriger Kontakt. |
| Referenz | Eindeutige Referenz auf diese Standmitteilung, die in DPI Unterbausteinen verwendet wird. |
| PDF-Datei | Das Standmitteilungs-Dokument als BLOB (PDF). |
Hinweis
Jeder Standmitteilungs-Eintrag muss eine PDF-Datei enthalten. Fehlt die Datei, schlägt der Prüflauf für den betreffenden Kontakt fehl. Weitere Informationen zum Prüflauf finden Sie unter Prüflauf.
Technisches Hintergrundwissen
Abhängigkeiten zu anderen Modulen
Das DPI-Modul setzt auf folgende Abhängigkeiten:
- GOB Protokollarten: Das Feld "DPI Prüflauf Protokollartencode" referenziert die Tabelle "GOB Protocol Type". Diese muss im System gepflegt sein, bevor der Prüflauf ausgeführt werden kann.
- GOB File Handling: Das Feld "Datei-Handling Konto Import" verweist auf die Tabelle "GOB File Handling Account". Dieses Feld wird für den Dateiimport im Rahmen des DPI-Prozesses benötigt.
Verhalten der Ersteinrichtung
- Alle Ersteinrichtungsaktionen prüfen zunächst, ob die Zieltabelle bereits Daten enthält. Bei vorhandenen Daten erscheint eine Bestätigungsabfrage.
- Die Ersteinrichtungstexte (Beschreibungen der Vorgabewerte) sind ausschließlich in deutscher Sprache verfügbar. Bei abweichender Systemsprache erscheint ein entsprechender Hinweis.
- Die Aktion "Erstelle Ersteinrichtungen" führt intern alle beteiligten Einzelaktionen aus, ohne deren individuelle Sicherheitsabfragen anzuzeigen. Die übergreifende Bestätigungsabfrage erfolgt einmalig zu Beginn.
Tabellen und Schlüssel
| Tabelle | Primärschlüssel | Beschreibung |
|---|---|---|
| DPI Einrichtung | Primärschlüssel (leer) | Einzeldatensatz-Tabelle für die Modulkonfiguration. |
| DPI Fehlerkatalog | Fehlernummer | Fehlercodes für die DPI-Verarbeitung. |
| DPI Produktart | Produktart | Codes für Altersvorsorgeprodukte gemäß gesetzlicher Definition. |
| DPI Unterbausteinart | Unterbausteinart | Klassifizierung von DPI-Ansprüchen. |
| DPI Intervall Rentenangabe | Code | Zahlungsintervalle für Rentenangaben. |
| DPI Wert Typ | Code | Klassifizierung von Renten- und Kapitalwerten. |
| DPI Ratenzahlung | Code | Optionen für Ratenzahlungsvereinbarungen. |
| DPI Leistungsart | Code | Auszahlungsformen für DPI-Leistungen. |