Syntax-Only Check
You can set the service so that only the syntax of the Tax ID is checked.
To enable a syntax-only check, use the Validation Strategy setting in the Vertex Validator Settings UI to set the country to syntax only.
This example sets syntax-only validation for the European Union (EU):
EU Setting
Example
The following example shows a request and response for a syntax-only check. In this case, the Tax ID is not checked against the database. It is only checked to see that the ID is formatted in the correct way.
Request
{
"saleMessageType": "QUOTATION",
"deliveryTerm": "SUP",
"customer": {
"destination": {
"country": "Poland"
},
"taxRegistrations": [
{
"isoCountryCode": "PL",
"taxRegistrationNumber": "PL1111111111"
}
]
},
"lineItems": [
{
"extendedPrice": 100
}
],
"currency": {
"isoCurrencyCodeAlpha": "PLN"
},
"transactionType": "SALE",
"seller": {
"company": "seller_1",
"physicalOrigin": {
"country": "Germany"
},
"taxRegistrations": [
{
"isoCountryCode": "PL",
"taxRegistrationNumber": "PL00001"
}
]
}
}
Response
{
"data": {
"currency": {
"isoCurrencyCodeAlpha": "PLN",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "Zloty"
},
"customer": {
"destination": {
"country": "Poland",
"taxAreaId": "806160000"
},
"taxRegistrations": [
{
"isoCountryCode": "PL",
"taxRegistrationNumber": "PL1111111111",
"validationResult": {
"isSyntaxValid": true,
"isValid": true,
"taxRegistrationNumberNormalized": "1111111111",
"validationInfo": "TAX_NUMBER_SYNTAX_VALID"
}
}
]
},
"deliveryTerm": "SUP",
"documentDate": "2025-11-06",
"lineItems": [
{
"customer": {
"destination": {
"country": "Poland",
"taxAreaId": "806160000"
},
"taxRegistrations": [
{
"isoCountryCode": "PL",
"taxRegistrationNumber": "PL1111111111",
"validationResult": {
"isSyntaxValid": true,
"isValid": true,
"taxRegistrationNumberNormalized": "1111111111",
"validationInfo": "TAX_NUMBER_SYNTAX_VALID"
}
}
]
},
"deliveryTerm": "SUP",
"extendedPrice": 100,
"fairMarketValue": 100,
"quantity": {
"value": 1
},
"seller": {
"company": "seller_1",
"physicalOrigin": {
"country": "Germany",
"taxAreaId": "802760000"
},
"taxRegistrations": [
{
"isoCountryCode": "PL",
"jurisdictionId": "0",
"taxRegistrationNumber": "PL00001"
}
]
},
"taxIncludedIndicator": false,
"taxes": [
{
"calculatedTax": 0,
"effectiveRate": 0,
"exempt": 0,
"invoiceTextCodes": [
16,
27
],
"isService": false,
"jurisdiction": {
"effectiveDate": "1900-01-01",
"expirationDate": "9999-12-31",
"jurisdictionId": "78283",
"jurisdictionType": "COUNTRY",
"value": "GERMANY"
},
"maxTaxIndicator": false,
"nonTaxable": 0,
"notRegisteredIndicator": false,
"situs": "PHYSICAL_ORIGIN",
"taxCollectedFromParty": "BUYER",
"taxRateReductionExempt": 0,
"taxResult": "NO_TAX",
"taxType": "NONE",
"taxable": 0
},
{
"calculatedTax": 23,
"calculationRuleId": {
"salesTaxHolidayIndicator": false,
"userDefined": false,
"value": "v301086010"
},
"effectiveRate": 0.23,
"exempt": 0,
"imposition": {
"impositionId": "1",
"jurisdictionId": "78327",
"userDefined": false,
"value": "VAT"
},
"impositionType": {
"impositionTypeId": "v19",
"informationOnly": false,
"userDefined": false,
"value": "VAT"
},
"inputOutputType": "OUTPUT",
"invoiceTextCodes": [
2,
27
],
"isService": false,
"jurisdiction": {
"effectiveDate": "1900-01-01",
"expirationDate": "9999-12-31",
"jurisdictionId": "78327",
"jurisdictionType": "COUNTRY",
"value": "POLAND"
},
"maxTaxIndicator": false,
"nominalRate": 0.23,
"nonTaxable": 0,
"notRegisteredIndicator": false,
"postCalculationEvaluationRuleId": {
"salesTaxHolidayIndicator": false,
"userDefined": false,
"value": "v318456382"
},
"rateClassification": "Standard Rate",
"sellerRegistrationId": "PL00001",
"situs": "DESTINATION",
"taxCollectedFromParty": "BUYER",
"taxLiabilityOwner": "SELLER",
"taxLiabilityRule": "physical-shipment-inside-EU-b2b-intra-community",
"taxRateReductionExempt": 0,
"taxResult": "TAXABLE",
"taxStructure": "SINGLE_RATE",
"taxType": "VAT",
"taxable": 100
}
],
"totalTax": 23,
"transactionType": "SALE"
}
],
"returnAssistedParametersIndicator": true,
"roundAtLineLevel": false,
"saleMessageType": "QUOTATION",
"seller": {
"company": "seller_1",
"physicalOrigin": {
"country": "Germany",
"taxAreaId": "802760000"
},
"taxRegistrations": [
{
"isoCountryCode": "PL",
"jurisdictionId": "0",
"taxRegistrationNumber": "PL00001"
}
]
},
"subTotal": 100,
"total": 123,
"totalTax": 23,
"transactionType": "SALE"
},
"meta": {
"app": "vertex-ws.war v9.0.21.0.197",
"extension": "oseries-plus 0.0.0-SNAPSHOT",
"timeElapsed(ms)": 8,
"timeReceived": "2025-11-06T11:36:31.37Z"
}
}
Updated 9 days ago