Sie zeigen eine alte Version dieser Seite an. Zeigen Sie die aktuelle Version an.

Unterschiede anzeigen Seitenhistorie anzeigen

« Vorherige Version anzeigen Version 2 Nächste Version anzeigen »

globe with meridians Language: Deutsch · English

light bulb Nuclet: VAT ID check (not yet available)

Data sheet and documentation entry point for the VAT ID check Nuclet (checking VAT IDs via the German Federal Central Tax Office web service).

CONCEPT INTEGRATORS UPDATED: JUL 2026 APPLIES TO NUCLOS 4.2026.X

On this page

Machine-translated – under review

This page was machine-translated from German as a first draft and is currently under review. The authoritative source remains the German original (see the language switch above).

Releases

Version

Date

Notes

Compatibility

1.0.020.01.2023First published versionfrom Nuclos 4.2022.25.1

Overview

For shipments of goods to commercial customers abroad, a check of the VAT ID is necessary. The German Federal Central Tax Office provides a web service for this: https://www.bzst.de/DE/Unternehmen/Identifikationsnummern/Umsatzsteuer-Identifikationsnummer/AuslaendischeUSt-IdNr/auslaendische_ust_idnr_node.html

This check must be carried out when confirming an order and when loading a delivery note.

Version 1.0

Description of version 1.0.0

Topic

Description

USt-ID-ProtokollThe BO System > USt-ID-Protokoll logs all checks generated by the Nuclet
Protokolle USt-ID-PrüfungVia the dynamic BO Protokolle USt-ID-Prüfung the check logs can be made visible for each BO via a generic reference ID (e.g. in the order, delivery note, customer, etc.)
Use in rulesThe class PruefungUStIDUtils provides several methods for this

Use in the rule programming of version 1.0.0

Class PruefungUStIDUtils


static UStIDProtokoll execute(PruefungUStIDObjekt pruefungsObjekt)
Performs a request with the properties specified in pruefungsObjekt .
Example GLS shipping order (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 of version 1.0.0

The integration after a successful Nuclet import (see Nuclet import) is to be carried out as follows.

Step

Description

Screenshot

1Run the jobs once Initialisiere Nuclet REST-Client-Utils and Initialisiere Nuclet PruefungUStID (under Administration > Job control)

Related pages

open book Supporting Nuclets

Back to Supporting Nuclets

Open →

open book Nuclet Wiki

Nuclet Wiki home

Open →

  • Keine Stichwörter