Versionen im Vergleich

Alte Version 1

changes.mady.by.user Ramin Göttlich

Gespeichert am

verglichen mit

Neue Version 2

changes.mady.by.user Ramin Göttlich

Gespeichert am

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

Inhalt
maxLevel5

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)

...