Switzerland
Read about how to validate Swiss Tax IDs.
You can include a specific suffix in your Swiss Tax IDs. These represent different languages.
{Swiss_tax_id}{suffix}
For example:
{Swiss_tax_id} MWST
You must use one of the following suffixes to ensure a valid response:
- MWST
- IVA
- ITA
Tax IDs that use a different suffix, like HR, result in an invalid response for a Swiss DB validation.
Example
This example shows how a Swiss Tax ID can be validated.
Request
{
"saleMessageType": "QUOTATION",
"deliveryTerm": "SUP",
"customer": {
"customerCode": {
"value": "customer1"
},
"customerName": "Swiss Watches",
"destination": {
"country": "CH"
},
"taxRegistrations": [
{
"isoCountryCode": "CH",
"taxRegistrationNumber": "CHCHE-116.294.121",
"taxRegistrationType": "VAT Registration"
}
]
},
"lineItems": [
{
"extendedPrice": 100,
"taxIncludedIndicator": false
}
],
"seller": {
"company": "seller1",
"physicalOrigin": {
"country": "PL"
}
},
"transactionType": "SALE"
}
Response
{
"data": {
"customer": {
"customerCode": {
"isBusinessIndicator": true,
"value": "customer1"
},
"customerName": "MWST-Gruppe, Swiss Watches SA",
"destination": {
"country": "CH",
"taxAreaId": "807560000"
},
"isTaxExempt": false,
"taxRegistrations": [
{
"isoCountryCode": "CH",
"taxRegistrationNumber": "CHCHE-116.294.121",
"taxRegistrationType": "VAT Registration",
"validationResult": {
"cacheTimestamp": "2025-07-23T09:35:34.4650Z",
"cached": true,
"isSyntaxValid": true,
"isValid": true,
"name": "MWST-Gruppe, Swiss Watches SA",
"taxNumberService": "uid.admin.ch",
"taxRegistrationNumberNormalized": "CHE116.294.121",
"validationInfo": "TAX_NUMBER_VALID_ACCORDING_TO_EXTERNAL_SERVICE"
}
}
]
},
"deliveryTerm": "SUP",
"documentDate": "2025-07-23",
"lineItems": [
{
"customer": {
"customerCode": {
"isBusinessIndicator": true,
"value": "customer1"
},
"customerName": "MWST-Gruppe, The Swatch Group SA",
"destination": {
"country": "CH",
"taxAreaId": "807560000"
},
"isTaxExempt": false,
"taxRegistrations": [
{
"isoCountryCode": "CH",
"taxRegistrationNumber": "CHCHE-116.294.121",
"taxRegistrationType": "VAT Registration",
"validationResult": {
"cacheTimestamp": "2025-07-23T09:35:34.4650Z",
"cached": true,
"isSyntaxValid": true,
"isValid": true,
"name": "MWST-Gruppe, Swiss Watches SA",
"taxNumberService": "uid.admin.ch",
"taxRegistrationNumberNormalized": "CHE116.294.121",
"validationInfo": "TAX_NUMBER_VALID_ACCORDING_TO_EXTERNAL_SERVICE"
}
}
]
},
"deliveryTerm": "SUP",
"extendedPrice": 100.0,
"fairMarketValue": 100.0,
"quantity": {
"value": 1.0
},
"seller": {
"company": "seller1",
"physicalOrigin": {
"country": "PL",
"taxAreaId": "806160000"
},
"taxRegistrations": []
},
"taxIncludedIndicator": false,
"taxes": [
{
"calculatedTax": 0.0,
"effectiveRate": 0.0,
"exempt": 0.0,
"invoiceTextCodes": [
1,
16
],
"isService": false,
"jurisdiction": {
"effectiveDate": "1900-01-01",
"expirationDate": "9999-12-31",
"jurisdictionId": "78327",
"jurisdictionType": "COUNTRY",
"value": "POLAND"
},
"maxTaxIndicator": false,
"nonTaxable": 0.0,
"notRegisteredIndicator": false,
"situs": "PHYSICAL_ORIGIN",
"taxCollectedFromParty": "BUYER",
"taxRateReductionExempt": 0.0,
"taxResult": "NO_TAX",
"taxType": "NONE",
"taxable": 0.0
},
{
"buyerRegistrationId": "CHCHE-116.294.121",
"calculatedTax": 8.1,
"calculationRuleId": {
"salesTaxHolidayIndicator": false,
"userDefined": false,
"value": "v315211496"
},
"effectiveRate": 0.081,
"exempt": 0.0,
"imposition": {
"impositionId": "1",
"jurisdictionId": "78294",
"userDefined": false,
"value": "VAT"
},
"impositionType": {
"impositionTypeId": "v19",
"userDefined": false,
"value": "VAT"
},
"inputOutputType": "OUTPUT",
"invoiceTextCodes": [
9,
21
],
"isService": false,
"jurisdiction": {
"effectiveDate": "1900-01-01",
"expirationDate": "9999-12-31",
"jurisdictionId": "78294",
"jurisdictionType": "COUNTRY",
"value": "SWITZERLAND"
},
"maxTaxIndicator": false,
"nominalRate": 0.081,
"nonTaxable": 0.0,
"notRegisteredIndicator": false,
"rateClassification": "Standard Rate",
"situs": "DESTINATION",
"taxCollectedFromParty": "BUYER",
"taxRateReductionExempt": 0.0,
"taxResult": "TAXABLE",
"taxStructure": "SINGLE_RATE",
"taxType": "VAT",
"taxable": 100.0
}
],
"totalTax": 8.1,
"transactionType": "SALE"
}
],
"returnAssistedParametersIndicator": true,
"roundAtLineLevel": false,
"saleMessageType": "QUOTATION",
"seller": {
"company": "seller1",
"physicalOrigin": {
"country": "PL",
"taxAreaId": "806160000"
},
"taxRegistrations": []
},
"subTotal": 100.0,
"total": 108.1,
"totalTax": 8.1,
"transactionType": "SALE"
},
"meta": {
"app": "vertex-ws.war v9.0.20.1.25",
"extension": "oseries-plus 20250723095736-9b25506a74da7a403dc802e3b48c920b202ace1e",
"timeElapsed(ms)": 15,
"timeReceived": "2025-07-23T12:00:09.446Z"
}
}
Updated 3 days ago