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

Unterschiede anzeigen Seitenhistorie anzeigen

« Vorherige Version anzeigen Version 3 Aktuelle »

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
VAT ID check logsVia the dynamic BO VAT ID check logs 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("The VAT ID check is only necessary/possible for non-private customers from other EU countries.");
} 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() 
                        + "\" was not successful: \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