UST Id Prüfung nur noch über REST-API (BC25.5) ?

Hallo Zusammen

mein Kunde möchte aus BC25.5 heraus ab jetzt die qualifzierte USt-Id Prüfung vornehmen und dafür den UST-Validierungsdienst nutzen.
Jetzt habe ich erfahren, dass es beim Bundeszentralamt für Steuern ab dem 30. November 2025 nur noch über die neue REST-API geht, da die alte die bisherige XML-RPC-Schnittstelle für die Umsatzsteuer-Identifikationsnummern-Prüfung (USt-ID-Prüfung) zum 30. November 2025 deaktiviert wurde.

In BC25.5 (und auch in BC27) ist dort aber weiterhin nur die alte URL zu finden = http://ec.europa.eu/taxation_customs/vies/services/checkVatService

Ich bekomme auch keinerlei Antwort in den Details zu Name + Anschrift, wenn ich die Validierungsvorlage anwende. Es wird weiterhin nur auf der vordersten Ebene die USt-ID geprüft. Aber der Name und die Anschrift nicht.

Und ich finde leider auch nichts dazu, wann wo oder wie Microsoft die REST-API im Standard anbieten wird.

Könnt ihr mir da eventuell helfen?

VG
Anke

Bei mir läuft in BC 27 SaaS die Validierung über den Dienst, aber ich bekomme "Nicht gültig" Meldungen wenn ich Name, Straße, Ort, PLZ validieren anhake. Meinst du das?

Es gab 2020 schon mal eine Anfrage, so etwas als Stapellauf einzubauen, die aber wegen Überlastungsgefahr des Dienstes abgelehnt wurde.
https://experience.dynamics.com/ideas/i ... 03ff68dcc1

Mit Verweis auf die neue API in DE könnte man es ja noch mal versuchen.
Mehr Doku als diese beiden JSON-Dateien scheint es nicht zu geben.
https://api.evatr.vies.bzst.de/api-docs
https://api.evatr.vies.bzst.de/v1/info/statusmeldungen

BZSt: Bestätigung ausländischer USt-IdNrn

Inoffizieller Wrapper für die API: https://github.com/rechtlogisch/evatr-php

Hallo Kowa

Danke Dir! Aber das bedeutet dann aber auch, - wenn ich das richtig verstehe - , dass dies in BC aktuell auch noch nicht vorhanden ist. Also auch in der BC27 nicht

Es ist bereits seit dem 20. Juli 2025 eine rechtliche Verpflichtung die Umsatzsteueridentifikationsnummer elektronisch zu prüfen. Und seit dem 30. November 2025 geht das wohl auch nur noch über die neue REST-API.
Die Grundlage dafür ist eine Änderung im Umsatzsteueranwendungserlass von §18e UStG.

Somit hat Microsoft eine seit Monten bestehende gesetzliche Anforderung bisher nicht umgesetzt und müsste dringend nachliefern, oder?!

Hallo enh
In der ersten Ebene steht bei der USt-ID Nr. der Status = Gültig. Das ist aber nur die Antwort für die einfache Prüfung.
Aber in den Details liefert der Validierunsgdienst keine Antwort für die qualifizierte Prüfung auf Firmenname und Anschrift. Es werden mir zwar die Daten aus der Debitorenkarte in den Detailsl angezeigt, weils ich diese in der Vorlage angehakt habe - aber im Feld Antwort steht nichts und die möglichen Aktionen in der Page sind ausgegraut.

VG
Anke

Ich habe die REST-API bei Microsoft als New Idea adressiert

https://experience.dynamics.com/ideas/i ... 1e52e3a65c

Hallo,

grundsätzlich funktioniert die Validierung der Ust-ID immer noch auch in BC25, weil dort nicht die BZST-Api verwendet wird, sondern eine europäische.

Nicht in allen Ländern (z.B. auch Deutschland nicht) wird die Adresse der Firma als Antwort zurückgeliefert und für die anderen Länder gilt das auch nur als Info Feld.
(es nützt dir nichts, wenn du bei einer griechischen oder bulgarischen Firma den Namen in griechischen oder kyrillischen Buchstaben zurückgeliefert bekommst, kannst du damit nicht viel anfangen. Mir unlängst passiert)

Das einzige was du prüfen kannst ist die UST-ID,bzw. ob die Adresse, die du bei der qualifizierten Anfrage mitgegeben hast, zur Ust-ID passt. Mehr nicht.

Gruß Fiddi

Ich habe die REST-API bei Microsoft als New Idea adressiert
https://experience.dynamics.com/ideas/i ... 1e52e3a65c

Das kann Jahre dauern , gesetzliche Anforderungen besser hier melden (vermutlich nur für Partner nutzbar).

Hier ist ein Codebeispiel für die einfache (unqualifizierte) Abfrage. Mit Status evatr-0000 in der Response ist die Ust-ID in Ordnung, bei den verwendeten Demodaten auch nicht anders zu erwarten , alle Codes in https://api.evatr.vies.bzst.de/v1/info/statusmeldungen.

In der Datei vor dem Request immer ### einfügen ("Lattenzaun" , trennt verschiedene Requests in einer Datei), dann erscheint das Send Request.

Code:

POST https://api.evatr.vies.bzst.de/app/v1/abfrage HTTP/1.1
Content-Type: application/json
 
{
  "anfragendeUstid":"DE123456789",
  "angefragteUstid":"ATU12345678"
}

Verwendeter REST-Client: https://marketplace.visualstudio.com/items?itemName=humao.rest-client

VATVIESsample.png

Mit GUI geht es natürlich auch z.B. http://www.postman.com (erfordert aber ein Konto, der obige für VS Code nicht), auch als Extension für VS Code verfügbar.

Du hast keine ausreichende Berechtigung, um die Dateianhänge dieses Beitrags anzusehen.

So sehen die qualifizierte Abfrage (zusätzliche Felder sind markiert, “strasse” und “plz” sind dabei optional) und die Response dazu aus.

Code:

POST https://api.evatr.vies.bzst.de/app/v1/abfrage HTTP/1.1
Content-Type: application/json
 
{
  "anfragendeUstid":"DE123456789",
  "angefragteUstid":"ATU12345678",
  "firmenname": "Musterhaus GmbH & Co KG",
  "strasse":"Musterstrasse 22",
  "plz":"12345",
  "ort":"musterort"
}

VATVIESsample2.png

Du hast keine ausreichende Berechtigung, um die Dateianhänge dieses Beitrags anzusehen.

Super, Danke Dir Kowa !

Dann schaue ich mir das auch mal mit einem Entwicklerkollegen zusammen an. Wir bzw. unsere Kunden können ja nicht abwarten, bis Microsoft da mal in die Pötte kommt.

VG
Anke

Hallo,

Kann mich mal irgendwer aufklären.

Die qualifizierte Prüfung ist doch schon in NAV2018 mit der SOAP- Schnittstelle über die EU-URL möglich (BC25 verwendet die gleiche), die, wenn man sich mal dir möglichen Fehlercodes anschaut (z.B.: Dienst in Mitgliedsstaat nicht erreichbar), die Anfrage doch eh nur durchreicht.

Evtl. muss man die Validierungs- Vorlagen dafür anpassen. (sprich: einrichten)

Warum muss man jetzt eine spezielle für das BZSt bauen?

Übrigens auch die EU bietet den Dienst als REST-API an.

Gruß Fiddi

Die qualifizierte Prüfung ist doch schon in NAV2018 mit der SOAP- Schnittstelle über die EU-URL möglich

SOAP wird meist nur noch da verwendet, wo es vor vielen Jahren mal eingebaut wurde. REST ist in der Handhabung der Anfragen viel einfacher zu programmieren (ggf. kombiniert mit OData wie z.B. bei SAP) und in der Praxis auch schneller, da JSON-Responses kleiner als entsprechende XMLs sind, SOAP aber nur XML kann (daran erkennt man das Alter ).

Hier ein Vergleich, wie viel SOAP bzw. wie wenig REST erfordert: SOAP vs REST API Explained Simply: What Developers Should Know

Aus BC wird SOAP auch in absehbarer Zeit entfernt.
Learn: Business Central web services (SOAP)

SOAP is replaced by OData V4. The support for SOAP endpoints will be removed in a later release. We recommend that you migrate integrations to OData V4 or REST API web services as soon as possible.

Hallo,

das ist aber immer noch keine Antwort auf meine eigentliche Frage:

Auch mit der Rest-API wirst du von BZSt in DE auch bei der qualifizierten Anfrage nur die Antwort bekommen, ob die Daten, die du übergeben hast, den hinterlegten entsprechen oder nicht.

Aber du bekommst in Deutschland keine, wie Anke wahrscheinlich hofft, beim BZSt hinterlegten Firmendaten für deutsche Firmen. Wahrscheinlich wg. Datenschutz.

Also wird der Aufwand eine REST-API für DE zu nutzen wahrscheinlich nutzlos für die Funktion sein, weil sie kein anderes Ergebnis liefert.

Gruß Fiddi

Aber du bekommst in Deutschland keine, wie Anke wahrscheinlich hofft, beim BZSt hinterlegten Firmendaten für deutsche Firmen.

Wo steht denn, dass das möglich sein soll?
An den Inhalten hat sich doch nichts geändert. Man kann keine Adressdaten erhalten, nur prüfen. Die einem selbst bekannten Firmendaten gibt man wie bisher in der Anfrage (also deren Payload) mit, und die Response zeigt dann entweder

• A = stimmt überein
• B = stimmt nicht überein
• C = nicht angefragt
• D = vom EU-Mitgliedsstaat nicht mitgeteilt

Zumindest innerhalb von DE kann man sich wohl auch auf lateinische Buchstaben verlassen , kyrillische und griechische verkomplizieren es natürlich.

Hallo,

gibt die Rest-API den diese Prüf- Informationen für die Adresse in DE zurück?
Bei der SOAP tut sie anscheinend nicht.

Gruß Fiddi

Hallo fiddi

Zwichen 2 deutschen Unternehmen brauchst Du eigentlich nie prüfen, weil im Inland die USt ID Nr keine Relevanz besitzt für den Vorsteuerabzug / die Umsatzsteuerberechnung.

Die qualifizierte Prüfung der Ust ID Nr. kann aber auch nur von einem Unternehmen, welches selber über eine USt-ID-Nr. verfügt, angefragt werden. Dein erwähnter Datenschutz greift nicht, da zur qualifizierten Prüfung einer USt -ID Nr. die Firmierung und der Firmensitz benötigt werden. Dies erscheint immer nur trügerisch bei Einzelunternehmen, wenn dort der perönliche Name dem Firmennamen und der Sitz des Unternehmens der Privatanschrift entsprechen.

Problem ist, dass seit dem 30. November die alte Schnittstelle beim BZSt weggefallen ist. Ich erhalte - trotz eingerichteter Vorlage - in den Validierungsdetails keine Antwort für Name und Anschriftsdaten angezeigt.
Ich habe allerdings damit im Cronus mit einer deutschen USt-Id.-Nr. rum gespielt/getestet - da die einfache Prüfung diese ja auch immer prüft.
Vielleicht funktioniert die qualifizierte Prüfung ja nur mit ausländischen USt-ID Nr. (?). Aber dann müsste sie trotzdem über die REST-API laufen, da die alte Schnittstelle weggefallen ist für die qualifizierte Prüfung.
Das müsste ich mal testen.

VG
Anke

Die qualifizierte Prüfung der Ust ID Nr. kann aber auch nur von einem Unternehmen, welches selber über eine USt-ID-Nr. verfügt, angefragt werden.

Da die API keine Anmeldung erfordert, dann müsste sonst noch mindestens

Code:

Authorization: Basic <Username> <Password>

zusätzlich für die HTTP-Authentifizierung mitgeschickt werden, wird bislang allerdings nicht geprüft, ob die Anfrage auch tatsächlich von diesem Unternehmen kommt. Das zumindest in DE die USt-ID des Händlers praktisch auf jedem Kassenbon vorhanden bzw. im Impressum einer Webseite einsehbar ist, gibt es da auch keinen Datenschutz.

Hi Kowa

es gibt da meines Wissens nach keine Anmeldung - aber genau deswegen --> Die qualifizierte Prüfung der Ust ID Nr. kann aber auch nur von einem Unternehmen, welches selber über eine USt-ID-Nr. verfügt, angefragt werden. --> muss in die Anfrage auch die Angabe der anfragenden USt-ID Nr. mit rein.

VG
Anke

Hallo,

Die qualifizierte Prüfung der Ust ID Nr. kann aber auch nur von einem Unternehmen, welches selber über eine USt-ID-Nr. verfügt, angefragt werden

Wie Kai schon schrieb, müsste die korrekte Schreibweise eigentlich lauten:
"Die qualifizierte Prüfung der Ust ID Nr. kann von jedem der eine gültige USt-ID-Nr. kennt durchgeführt werden." Egal ob Unternehmen oder nicht.

Das ist eigentlich auch egal, den normalerweise interessieren sich nur Firmen für diese Information. Und da zumindest in Deutschland keine Adressdaten zurückgeliefert werden, kann man damit auch keine Daten abgreifen.

BTW: habe das mal gerade mit dem Rester-Addon vom Firefox ausprobiert, der ist ein bisschen einfacher als Postman, kann aber auch schon einiges.
- Der EU- Rest-Service scheint keine Adressdaten zu prüfen, liefert aber im Zweifel die Adresse zurück, aber nicht in den eigentlich dafür vorgesehenen Feldern.
- eine fehlerhafte Adresse, kann mit der BZSt- API - zumindest für Östereich - als Ergebnis auch ein "D" zurück liefern, obwohl "B" eigentlich richtig wäre. Liefert aber dann ein "A", wenn das Feld korrekt gefüllt ist.

Gruß Fiddi

Vielen Dank für eurer Feedback

Ich habe inzwischen über die Prüfroutine Antworten erhalten --> man muss wirklich eine ausländische USt-Id-Nr. prüfen, dann kommt eine Antwort in den Details. Nur eben nicht ganz korrekt zugeordnet bzw. falsch übernommen bei ACCEPT.

Ich werde das Thema jetzt an Microsoft direkt adressieren, da hier nicht nur die REST-API seit dem 30. November 2025 fehlt sondern auch immer noch die Antworten falsch verarbeitet werden

Folgende Probleme habe ich in BC27.2 erkannt und werde ich adressieren:

The values returned for the address are not taken over to the correct fields on customer/Vendor if accepted by the user
- returned values for Street , ZIP and City are returned in 1 field only – but if you accept this line, the system overwrites the field Address on the customer/Vendor with the returned value, but ZIP and city are still not updated and therefore, still incorrect on Customer / Vendor

- If Name was checked once and the returned value is accepted by the user it will not be checked at any new validation run although the value was changed an customer/vendor later


Wenn ich was Neues dazu höre, gebe ich hier gerne Bescheid

VG
Anke

Hallo,

Soweit ich mich erinnere, unterscheidet sich das zurückgelieferte Format auch je Land.

und aus den z.B. aus Östereich zurückgelieferten Daten kann man nicht zuverlässig die einzelnen Adressfelder der Anfrage zu regenerieren.
Da kommt nur Mist raus, wenn der Straßenname etwas komplizierter wird, oder der Ort.

Das kann man eigentlich nur manuell lösen. Man muss es aber auch können.

Gruß Fiddi

Hallo Zusammen

Microsoft möchte von mir die Adresse der REST-API, die aufgerufen werden soll. Kennt die jemand ?

VG
Anke

Kowa hatte die hier genannt: https://api.evatr.vies.bzst.de/app/v1/abfrage

Hallo,

hier hast du den kompletten Request von Kai oben:

Code:

POST https://api.evatr.vies.bzst.de/app/v1/abfrage HTTP/1.1
Content-Type: application/json
 
{
  "anfragendeUstid":"DE123456789",
  "angefragteUstid":"ATU12345678",
  "firmenname": "Musterhaus GmbH & Co KG",
  "strasse":"Musterstrasse 22",
  "plz":"12345",
  "ort":"musterort"
}

Die Url oben ist die deutsche URL

Gruß fIDI

Der obige Request für die Prüfung ist ein HTTP POST, der somit zusätzliche Daten in einem Body (der Payload) überträgt. Diese müssen bei den Feldbezeichnungen exakt stimmen, sonst erhält man eine Fehlermeldung.
In der API können mit u.a. mit einer anderen URL über HTTP GET die EU-Mitgliedsstaaten abgerufen werden. Dieser GET hat dann keine Payload, so wie auch beim Abruf der verschiedenen Statusmeldungen oben.

Code:

GET https://api.evatr.vies.bzst.de/app/v1/info/eu_mitgliedstaaten

VATVIES3.png

Response (JSON Array of Objects)

[{"alpha2":"AT","name":"Österreich","verfuegbar":true},{"alpha2":"BE","name":"Belgien","verfuegbar":true},{"alpha2":"BG","name":"Bulgarien","verfuegbar":true},{"alpha2":"CY","name":"Zypern","verfuegbar":true},{"alpha2":"CZ","name":"Tschechien","verfuegbar":true},{"alpha2":"DE","name":"Deutschland","verfuegbar":true},{"alpha2":"DK","name":"Dänemark","verfuegbar":true},{"alpha2":"EE","name":"Estland","verfuegbar":true},{"alpha2":"EL","name":"Griechenland","verfuegbar":true},{"alpha2":"ES","name":"Spanien","verfuegbar":true},{"alpha2":"FI","name":"Finnland","verfuegbar":true},{"alpha2":"FR","name":"Frankreich","verfuegbar":true},{"alpha2":"HR","name":"Kroatien","verfuegbar":true},{"alpha2":"HU","name":"Ungarn","verfuegbar":true},{"alpha2":"IE","name":"Irland","verfuegbar":true},{"alpha2":"IT","name":"Italien","verfuegbar":true},{"alpha2":"LT","name":"Litauen","verfuegbar":true},{"alpha2":"LU","name":"Luxemburg","verfuegbar":true},{"alpha2":"LV","name":"Lettland","verfuegbar":true},{"alpha2":"MT","name":"Malta","verfuegbar":true},{"alpha2":"NL","name":"Niederlande","verfuegbar":true},{"alpha2":"PL","name":"Polen","verfuegbar":true},{"alpha2":"PT","name":"Portugal","verfuegbar":true},{"alpha2":"RO","name":"Rumänien","verfuegbar":false},{"alpha2":"SE","name":"Schweden","verfuegbar":true},{"alpha2":"SI","name":"Slowenien","verfuegbar":true},{"alpha2":"SK","name":"Slowakei","verfuegbar":true},{"alpha2":"XI","name":"Nordirland","verfuegbar":true}]

Du hast keine ausreichende Berechtigung, um die Dateianhänge dieses Beitrags anzusehen.