class VatIdCheckWs extends SoapClient (View source)

Check a vat id by the finanzonline UidAbfrage webservice.

Requirements for this service:

  • A registration for FinanzOnline
  • A user for the web service, which can be created in the user administration of FinanzOnline

Return codes

  • 0 = Die UID des Erwerbers ist gültig.
  • -1 = Die Session ID ist ungültig oder abgelaufen.
  • -2 = Der Aufruf des Webservices ist derzeit wegen Wartungsarbeiten nicht möglich.
  • -3 = Es ist ein technischer Fehler aufgetreten.
  • -4 = Dieser Teilnehmer ist für diese Funktion nicht berechtigt.
  • 1 = Die UID des Erwerbers ist nicht gültig.
  • 4 = Die UID-Nummer des Erwerbers ist falsch.
  • 5 = Die UID-Nummer des Antragstellers ist ungültig.
  • 10 = Der angegebene Mitgliedstaat verbietet diese Abfrage.
  • 101 = UID beginnt nicht mit ATU.
  • 103 = Die angefragte UID-Nummer kann im FinanzOnline nur in Stufe 1 bestätigt werden, da diese UID-Nummer zu einer Unternehmensgruppe (Umsatzsteuergruppe) gehört.
  • 104 = Die angefragte UID-Nummer kann im FinanzOnline nur in Stufe 1 bestätigt werden, da diese UID-Nummer zu einer Unternehmensgruppe (Umsatzsteuergruppe) gehört.
  • 105 = Die UID-Nummer ist über FinanzOnline einzeln abzufragen.
  • 1511 = Der angegebene Mitgliedstaat ist derzeit nicht erreichbar.

Constants

WSDL

Online WSDL url.

WSDL_LOCAL

Local WSDL file.

deprecated LEVEL_SIMPLE_CHECK

Check at level one.

deprecated LEVEL_FULL_CHECK

Check at level two.

VALID_RETURN_CODES

All return code numbers for valid vat id's.

NOT_VALID_RETURN_CODES

All return code numbers for invalid vat id's.

Methods

__construct(SessionWs $sessionWs, array $soapOptions = [])

Constructor.

check(string $uid, VatIdCheckLevel|int $level = VatIdCheckLevel::SimpleCheck)

Check an uid (vat id).

Details

__construct(SessionWs $sessionWs, array $soapOptions = [])

Constructor.

Parameters

SessionWs $sessionWs

Session web service

array $soapOptions

PHP SOAP client options

VatIdCheckInvalid|VatIdCheckValidLevelOne|VatIdCheckValidLevelTwo check(string $uid, VatIdCheckLevel|int $level = VatIdCheckLevel::SimpleCheck)

Check an uid (vat id).

Parameters

string $uid

Vat id to check

VatIdCheckLevel|int $level

Check level (use VatIdCheckLevel enum, int support deprecated)

Return Value

VatIdCheckInvalid|VatIdCheckValidLevelOne|VatIdCheckValidLevelTwo