Sprache: Deutsch · English

Nuclet: Prüfung USt-ID(noch nicht verfügbar)

Nuclet: Prüfung USt-ID(noch nicht verfügbar) – Referenz zum Nuclet.

REFERENZ INTEGRATOREN STAND: JUL 2026 GILT FUER NUCLOS 4.2026.X

Auf dieser Seite

Releases

Version	Datum	Hinweise	Kompatibilität
1.0.0	20.01.2023	Erste veröffentlichte Fassung	ab Nuclos 4.2022.25.1

Überblick

Bei Warensendungen an gewerbliche Kunden ins Ausland ist eine Prüfung der Umsatzsteuer-ID notwendig. Das Bundeszentralamt für Steuern stellt dafür einen Webservice zur Verfügung: https://www.bzst.de/DE/Unternehmen/Identifikationsnummern/Umsatzsteuer-Identifikationsnummer/AuslaendischeUSt-IdNr/auslaendische_ust_idnr_node.html

Diese Prüfung muss bei Bestätigung eines Auftrags und beim Verladen eines Lieferscheins durchgeführt werden.

Version 1.0

Beschreibung von Version 1.0.0

Thema	Beschreibung
USt-ID-Protokoll	Das BO System > USt-ID-Protokoll protokolliert alle vom Nuclet generierten Prüfungen
Protokolle USt-ID-Prüfung	Über das dynamische BO Protokolle USt-ID-Prüfung können die Prüfungsprotokolle über eine generische Referenz-ID zu jedem BO sichtbar gemacht werden (z.B. im Auftrag, Lieferschein, Kunden, etc.)
Verwendung in Regeln	Die Klasse PruefungUStIDUtils stellt dazu mehrere Methoden bereit

Verwendung in der Regelprogrammierung von Version 1.0.0

Klasse PruefungUStIDUtils
static UStIDProtokoll execute(PruefungUStIDObjekt pruefungsObjekt)	Führt einen Request durch, mit den in pruefungsObjekt angegebenen Eigenschaften
Beispiel GLS Versandauftrag (JSON)
	PruefungUStIDObjekt pruefungsObjekt = new PruefungUStIDObjekt(); if (!testIsNecessary(kunde)) { throw new BusinessException("Die Prüfung der UST-ID ist nur für Nicht-Privat-Kunden aus dem EU-Ausland notwendig/möglich."); } else { Adresse adresse = getRechnungsadresse(kunde); pruefungsObjekt.setUrl(ParameterProvider.getNucletParameter(PruefungUSTIDNucletParameter.URLPruefung)); pruefungsObjekt.setReferenzObjekt("Kunde"); pruefungsObjekt.setIdReferenz(kunde.getId()); pruefungsObjekt.setPruefling(kunde.getKundennr() + " - " + kunde.getKundenname()); pruefungsObjekt.setIdAdresse(adresse.getId()); pruefungsObjekt.setValue(PruefungUStIDUtils.Parameter.UST_ID_1, "<Eigene USt-ID>"); pruefungsObjekt.setValue(PruefungUStIDUtils.Parameter.UST_ID_2, getUStID(kunde)); pruefungsObjekt.setValue(PruefungUStIDUtils.Parameter.FIRMENNAME, kunde.getKundenname()); pruefungsObjekt.setValue(PruefungUStIDUtils.Parameter.ORT, adresse.getOrt()); pruefungsObjekt.setValue(PruefungUStIDUtils.Parameter.PLZ, adresse.getPlz()); pruefungsObjekt.setValue(PruefungUStIDUtils.Parameter.STRASSE, adresse.getStrasse()); UStIDProtokoll protokoll = PruefungUStIDUtils.getTestResult(pruefungsObjekt); if (protokoll != null && !protokoll.getErfolg()) { throw new BusinessException("Der Test der USt-ID " + kunde.getUstid() + " des Kunden \"" + kunde.getKundennr() + " - " + kunde.getKundenname() + "\" war nicht erfolgreich: \n" + protokoll.getErgebnistext()); } }

Integration von Version 1.0.0

Die Integration nach erfolgtem Nuclet-Import (siehe Nuclet Import) ist wie folgt vorzunehmen.

Schritt	Beschreibung	Screenshot
1	Führen Sie einmalig die Jobs Initialisiere Nuclet REST-Client-Utils und Initialisiere Nuclet PruefungUStID (unter Administration > Jobsteuerung) aus

Seitenhierarchie