GUS icon

GUS

Consume GUS (Polish Statistics Office) API with native SOAP implementation, VAT whitelist verification, KRS registry check, and EU VIES validation

Actions7

Company → Check VIES

AI-generated

Summary

Checks an EU VAT number against the VIES service and returns its validity and available trader details. The request uses the supplied country code and VAT number, plus requester details from the required GUS credentials; the optional Check Date is used in the generated Azure Storage URL.

Inputs

  • Country Code (required) — EU country code from the listed options; defaults to PL.
  • VAT Number (required) — VAT number without its country prefix. Spaces and hyphens are removed before checking.
  • Check Date — Optional date in YYYY-MM-DDT00:00:00 format. Leave blank for the current date; the operation uses it to build the Azure Storage URL.
  • GUS credentials (required) — The node requires gusApi credentials. VIES requests use the configured requester country and NIP; if the requester country is OTHER, the custom country code is used. The request falls back to PL when no requester country is set and sends an empty requester number when no NIP is set.

Output shape

One output item per input item, containing a JSON result and a vies_report binary attachment when raw response data is available.

The JSON result includes countryCode, vatNumber, requestDate, valid, requestIdentifier, name, address, trader details and match fields, plus an Azure Storage URL. Missing trader and match values receive defaults. The raw API response and API URL are removed from JSON when the binary attachment is created. A 404 returns a not-found result; other request errors fail the item unless Continue On Fail is enabled. The check date does not alter the VIES request body.

Links

Discussion