Übertragung von Veräußerungsanzeigen an XNP/eNoVA

Advoware bietet die Möglichkeit, die Daten zu Veräußerungsanzeigen (§ 18 GrEStG) als strukturierte Datensätze direkt nach XNP/eNoVA zu übertragen. 

Im Modul "Referatspezifische Daten" übermittelt die Schaltfläche "Veräußerungsanzeige -> XNP" die Anzeige direkt als Strukturdatensatz an den lokal installierten XNP-Client. Alternative ist der Weg über die Programmstartleiste → Notariat → Formulare → Veräußerungsanzeige.

Die fachliche Prüfung, Ergänzung und Freigabe der Veräußerungsanzeige erfolgt anschließend direkt in XNP.

Voraussetzungen

  • Sie müssen an den lokalen XNP-Client angemeldet sein.
  • Advoware benötigt einige Anmeldeinformationen für XNP. Diese sind einmalig pro Person in den Grundeinstellungen "Mitarbeiter" - Reiter "Notarangaben" zu hinterlegen.

Hinterlegung der Einstellungen in XNP

Für die spezielle XNP-Schnittstellen-Funktion zu Advoware ist es notwendig, dass sich XNP und Advoware gegenseitig vertrauen. Diese Vertrauensstellung wird durch einen speziellen Schlüssel in der Anwendung hinterlegt - dem so genannten “API-Key”. Dieser Schlüssel muss von jedem Nutzer selbständig in der XNP-Konfiguration (siehe unten) hinterlegt werden. Der API-Key wird verschlüsselt in der Konfigurationsdatei gespeichert und ist in verschlüsselter Form nicht zwischen unterschiedlichen Installationen von XNP übertragbar. 

Konfiguration der Schnittstelle in den Einstellungen - Schritt-für-Schritt-Anleitung

  • Starten Sie den XNP-Client.
  • Öffnen Sie das Benutzermenü und klicken Sie auf Einstellungen.

  • Wählen Sie Meine Einstellungen (Nutzer).
  • Klicken Sie dort auf den Reiter Plattform, um in die Plattform-Einstellungen zu gelangen.

  • Klicken Sie auf die Schaltfläche Notariatssoftware-Schnittstelle konfigurieren, um den Dialog zum Bearbeiten der Einstellungen zu öffnen.

  • Es öffnet sich der Dialog zur Nutzer-Konfiguration der Schnittstelle.
  • Über das Auswahlelement Notariatssoftware-Schnittstelle aktiv können Sie die Schnittstelle de- bzw. aktivieren.

  • Sie können den zu verwendenden Port, auf den die Schnittstelle Anfragen entgegennehmen kann, manuell festlegen. Bei der Erstinstallation von XNP wird versucht, den Port “12774” zu nutzen (bzw. den nächsten verfügbaren bis 12784).
  • Über Validieren können Sie prüfen, ob der von Ihnen gewünschte Port für die Schnittstelle verwendet werden kann.
  • Eine Änderung des verwendeten Ports muss auch in Advoware berücksichtigt bzw. hinterlegt werden.

  • Erzeugen Sie einen API-Key. Dieser dient alleinig der Absicherung der Anmeldungs-Funktion durch Advoware. 

  • Wenn Sie mit der Konfiguration fertig sind, können Sie die Einstellungen über die Schaltfläche Speichern übernehmen.

Hinterlegung der Einstellungen in Advoware

Nachdem Sie den API-Key und den Port in XNP erzeugt bzw. festgelegt haben sind die Angaben einmalig auch in Advoware zu hinterlegen – zusammen mit dem XNP-Benutzernamen und der Amtstätigkeits-ID (KVZ-ID). Erst dann kann sich Advoware gegenüber der lokalen XNP-Schnittstelle authentifizieren.

Die Einstellungen sind benutzerbezogen und müssen unter der Grundeinstellung "Mitarbeiter" - Reiter "Notarangaben" hinterlegt werden. Bei der Übergabe an XNP verwendet Advoware die Zugangsdaten des in Advoware in der Akte eingestellten Notars.

  • Tragen Sie im Feld Benutzername den XNP-Benutzernamen ein.
  • Tragen Sie im Feld Amtstätigkeits-ID (KVZ-ID) die Amtstätigkeits-ID ein.
  • Tragen Sie im Feld API-Key den in XNP erzeugten API-Key ein.
  • Tragen Sie im Feld Port den in XNP konfigurierten Port ein.

Veräußerungsanzeige an XNP übermitteln

Sobald die Schnittstelle in XNP und in Advoware konfiguriert ist, können Sie Veräußerungsanzeigen direkt übermitteln:

  • Öffnen Sie die betreffende Akte und wählen Sie das bzw. die Grundbücher aus, für die eine Veräußerungsanzeige übermittelt werden soll.
  • Wählen Sie aus den referatspezifischen Daten (Strg + Umschalt + d) den Programmpunkt Veräußerungsanzeige → XNP.
  • Auswahl des Grundbuchs und der Urkunde im Grundbuch-Dialog: Hat eine Akte mehrere Urkunden, wählen Sie die Urkunde aus. Gibt es nur eine Urkunde, ist diese vorausgewählt.

  • Sie können mehrere Grundbücher auswählen. Für jedes Grundbuch wird in XNP ein eigener Vollzugsschritt angelegt.
  • Klicken Sie auf "Ok". Advoware ermittelt automatisch die erforderlichen Daten aus der Akte und übermittelt sie an den lokal auf Ihrem Rechner laufenden XNP-Client.

Je nach Ergebnis der Übermittlung erhalten Sie eine der folgenden drei Rückmeldungen, die zusätzlich in der Aktengeschichte dokumentiert wird:

Erfolgreiche Übermittlung

Advoware meldet die erfolgreiche Übermittlung und zeigt die von XNP vergebene Vorgangs-ID (sdsId) an. Die Veräußerungsanzeige ist damit an XNP übergeben.

Fachliche Ablehnung durch XNP (Validierungsfehler)

XNP prüft die übermittelten Daten fachlich und kann die Anzeige ablehnen, wenn Pflichtangaben fehlen oder fehlerhaft sind. Advoware zeigt in diesem Fall die von XNP zurückgemeldeten Fehlermeldungen an. Bitte korrigieren Sie die betroffenen Angaben in der Akte und übermitteln Sie die Veräußerungsanzeige anschließend erneut.

Technischer Fehler (z. B. XNP nicht erreichbar)

Kann Advoware keine Verbindung zur lokalen XNP-Schnittstelle aufbauen – zum Beispiel, weil der XNP-Client nicht gestartet ist –, erscheint eine entsprechende Fehlermeldung. Prüfen Sie in diesem Fall, ob XNP auf Ihrem Rechner gestartet und angemeldet ist, und versuchen Sie die Übermittlung anschließend erneut. Besteht das Problem weiterhin, wenden Sie sich bitte an den Support.

Wenn Sie beim Übertragunsversuch folgenden Fehler erhalten, prüfen Sie bitte, ob die in XNP und in Advoware hinterlegten Zugangsdaten (API-Key, Amtstätigkeits-ID (KVZ-Nr) und Port) mit den Grundeinstellungen "Mitarbeiter" übereinstimmen. Starten Sie dann sowohl Advoware als auch den XNP-Client neu.

Wichtige Hinweise

Nach erfolgreicher Übertragung in XNP ist die Veräußerungsanzeige in XNP sorgfältig zu prüfen.

bekannte Einschränkungen:

  • Aufschiebende Bedingung und einige Genehmigungs-/Wirksamkeitsdaten können Advoware-seitig nicht abgebildet werden.
  • Verwandtschaftsgrad je Gegenpartei bei MEHREREN Veräußerern bleibt in XNP leer, weil Advoware den Verwandtschaftsgrad in diesem Fall nicht eindeutig zuordnen kann.
  • Sonstige Leistungen: Wenn sowohl das Feld "Sonstige Leistungen" als auch "Sonstige Leistungen 2" ausgefüllt werden, erscheint in XNP bei der Validierung eine Fehlermeldung, die manuell aufgelöst werden muss

Tipp: 

Wenn Sie in den Optionen das Häkchen "PDF" setzen, öffnet Advoware bei der Übergabe automatisch ein PDF. Die PDF-Erstellung dient ausschließlich Kontrollzwecken. In XNP fehlende Daten können Sie schnell per Zwischenablage übernehmen. Es erfolgt keine elektronische Übermittlung an Finanzbehörden und keine Speicherung des PDFs in Aktengeschichte oder Posteingang. 

Bei aktiviertem Debug-Modus wird die von Advoware für die Übertragung genutzte json-Datei im lokalen Temp-Ordner des Benutzers vorgehalten und erst bei Beendigung von Advoware gelöscht. Im Falle eines Problems oder Fehlers kann diese vom Support für die Problemanalyse genutzt werden. Bei deaktiviertem Debug-Modus wird die Datei unmittelbar nach der Übergabe gelöscht.

Erweiterungen/Korrekturen in Advoware 6.9.4

  • Validierungsfehler "Required as RFC 3986 compliant local file URI": Die Urkunden-Datei wird jetzt als vollständige Datei-URI übergeben. Leerzeichen, %, # und Umlaute im Pfad oder Dateinamen werden dabei bei der Übergabe automatisch kodiert. Es ist keine manuelle Umbenennung mehr erforderlich.
  • Fehlermeldungen von XNP: Lange Meldungen werden jetzt an Wortgrenzen umgebrochen, statt das Meldungsfenster in die Breite zu ziehen.
  • Die Hausnummer der Beteiligten wird von der Straße getrennt übermittelt, sofern die Trennung eindeutig ist.
  • Eine in Advoware hinterlegte Verwandtschaft "kein" wird jetzt korrekt als "keine begünstigte Person im Sinne von § 3 Nr. 3–8 GrEStG§ übermittelt. Bei mehreren Veräußerern verweist der Eintrag auf alle Veräußerer.
  • Kontaktdaten: Telefon- und Faxnummern der Beteiligten werden aus Datenschutzgründen und dem Prinzip der Datenminimierung nicht mehr übermittelt. E-Mail-Adressen werden weiterhin übermittelt, weil § 19 Abs. 4 Nr. 7 ERVV sie ab 01.01.2027 für die Mitteilung an den Gutachterausschuss verlangt. Bei Bedarf können Sie diese in XNP herauslöschen.
  • Keine Doppelungen: Steht eine Person in mehreren ausgewählten Grundbüchern, wird sie nur einmal übermittelt, mit dem Anteil aus dem ersten Grundbuch.
  • Auswahl der Urkunde im Grundbuch-Dialog: Hat eine Akte mehrere Urkunden, wählt man die Urkunde vorab im Dialog aus. XNP-Export und PDF verwenden dieselbe Urkunde. Gibt es nur eine Urkunde, ist sie vorausgewählt. Die alte Rückfrage aus dem PDF entfällt.
  • Grundbuchdaten werden in XNP übernommen: Das betrifft Grundbuchamt, Grundbuch von, Gemarkung, Grundbuchart, Blatt und Bebauung. Dafür wird das Grundbuchamt als reiner Ortsname übermittelt.
  • Lage des Grundstücks: Straße, Hausnummer und Ort werden jetzt aus dem Bestandsverzeichnis übermittelt, also aus Lage und Gemeinde. Passt die Gemeinde nicht zu Grundbuchamt bzw. Gemarkung, bleiben in XNP die Angaben Grundbuchart, Blatt und Bebauung leer, und es erscheinen Validierungshinweise.
  • Mehrere Grundbücher: Bisher wurde nur das erste ausgewählte Grundbuch exportiert. Jetzt wird jedes Grundbuch als eigenes Grundstück mit eigenem Vollzugsschritt übermittelt.

 

 

Verknüpfung mit