validate vat
This block is part of the banking group and was last modified in core v14.0.1.
validate vat v10.6.2 Updated v14.0.1Request VAT code validation using the ec.europa.eu API, allowing you to validate VAT numbers of your customers
- flow
flow - VAT required
value
- flow
flow - Valid
condition - company
v14.0.1valueThe name of the company this VAT number is registered to, for example "RUAL"
- address
v14.0.1valueFull address format of the company if available: {street} {number}, {zipcode} {city}
- country
v14.0.1valueISO ALPHA 2 Country Code (NL)
- Error
value
Validates a European VAT number against the live VIES SOAP service at ec.europa.eu: spaces, dots and dashes are stripped, the first 2 characters become the country code. valid mirrors the service verdict, with company, address and country filled from the response : a field the member state does not disclose (VIES sends "---") comes back empty, and the multi-line address is joined with ", ". valid=false with an EMPTY error pin is a genuine "not a VAT number" verdict; valid=false WITH an error means the check could not be completed: VALUE_EMPTY when the pin is unwired, INVALID_FORMAT when the cleaned number is under 3 characters, the uppercased SOAP faultstring (MS_UNAVAILABLE, MS_MAX_CONCURRENT_REQ, SERVICE_UNAVAILABLE, INVALID_INPUT_COUNTRY, TIMEOUT) when VIES or the member state refuses, INVALID_RESPONSE when the reply carries no readable verdict (missing, empty or not one of true/false/1/0), PARSE_ERROR on unreadable XML, or the network error when the service is unreachable.
A typical wiring for validate VAT: a function trigger starts the flow; value feeds the vat pin; the flow out pin feeds debug.
Version history
Introduced in v10.6.2.
Last modified in v14.0.1.
Back to
banking Return to the main group to view all sub-groups Back to webhooks Return to the group to view all blocks within this group