Turning Off Validation

You may want to turn off validation for specific use cases.

You can turn off validation in the API request or you can set this per country in the Vertex Validator Settings UI.

To do so using the API, ensure that the customer.taxRegistrations.validationResult.isValid field is set to true in your requests:

customer.taxRegistrations.validationResult.isValid: true

Example

The following example shows how to turn off validation in a request.

Request

{
    "saleMessageType": "QUOTATION",
    "deliveryTerm": "SUP",
    "customer": {
        "customerCode": {
            "value": "customer1"
        },
        "destination": {
            "country": "Poland"
        },
        "taxRegistrations": [
            {
                "isoCountryCode": "PL",
                "taxRegistrationNumber": "will-not-be-validated",
                "taxRegistrationType": "VAT Registration",
                "validationResult": {
                    "isValid": true
                }
            }
        ]
    },
    "lineItems": [
        {
            "extendedPrice": 100
        }
    ],
    "seller": {
        "company": "seller1",
        "physicalOrigin": {
            "country": "DE"
        }
    },
    "transactionType": "SALE"
}

Response

{
    "data": {
        "customer": {
            "customerCode": {
                "isBusinessIndicator": true,
                "value": "customer1"
            },
            "destination": {
                "country": "Poland",
                "taxAreaId": "806160000"
            },
            "isTaxExempt": false,
            "taxRegistrations": [
                {
                    "isoCountryCode": "PL",
                    "taxRegistrationNumber": "will-not-be-validated",
                    "taxRegistrationType": "VAT Registration",
                    "validationResult": {
                        "isValid": true
                    }
                }
            ]
        },
        "deliveryTerm": "SUP",
        "documentDate": "2025-07-23",
        "lineItems": [
            {
                "backToBackInvoice": {
                    "country": "DE"
                },
                "customer": {
                    "customerCode": {
                        "isBusinessIndicator": true,
                        "value": "customer1"
                    },
                    "destination": {
                        "country": "Poland",
                        "taxAreaId": "806160000"
                    },
                    "isTaxExempt": false,
                    "taxRegistrations": [
                        {
                            "isoCountryCode": "PL",
                            "taxRegistrationNumber": "will-not-be-validated",
                            "taxRegistrationType": "VAT Registration",
                            "validationResult": {
                                "isValid": true
                            }
                        }
                    ]
                },
                "deliveryTerm": "SUP",
                "extendedPrice": 100.0,
                "fairMarketValue": 100.0,
                "quantity": {
                    "value": 1.0
                },
                "seller": {
                    "company": "seller1",
                    "physicalOrigin": {
                        "country": "DE",
                        "taxAreaId": "802760004"
                    },
                    "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": "89445",
                            "jurisdictionType": "COUNTRY",
                            "value": "HELIGOLAND"
                        },
                        "maxTaxIndicator": false,
                        "nonTaxable": 0.0,
                        "notRegisteredIndicator": false,
                        "situs": "PHYSICAL_ORIGIN",
                        "taxCollectedFromParty": "BUYER",
                        "taxRateReductionExempt": 0.0,
                        "taxResult": "NO_TAX",
                        "taxType": "NONE",
                        "taxable": 0.0
                    },
                    {
                        "buyerRegistrationId": "will-not-be-validated",
                        "calculatedTax": 23.0,
                        "calculationRuleId": {
                            "salesTaxHolidayIndicator": false,
                            "userDefined": false,
                            "value": "v301086010"
                        },
                        "effectiveRate": 0.23,
                        "exempt": 0.0,
                        "imposition": {
                            "impositionId": "1",
                            "jurisdictionId": "78327",
                            "userDefined": false,
                            "value": "VAT"
                        },
                        "impositionType": {
                            "impositionTypeId": "v19",
                            "userDefined": false,
                            "value": "VAT"
                        },
                        "inputOutputType": "OUTPUT",
                        "invoiceTextCodes": [
                            9,
                            18,
                            21
                        ],
                        "isService": false,
                        "jurisdiction": {
                            "effectiveDate": "1900-01-01",
                            "expirationDate": "9999-12-31",
                            "jurisdictionId": "78327",
                            "jurisdictionType": "COUNTRY",
                            "value": "POLAND"
                        },
                        "maxTaxIndicator": false,
                        "nominalRate": 0.23,
                        "nonTaxable": 0.0,
                        "notRegisteredIndicator": false,
                        "postCalculationEvaluationRuleId": {
                            "salesTaxHolidayIndicator": false,
                            "userDefined": false,
                            "value": "v318456382"
                        },
                        "rateClassification": "Standard Rate",
                        "situs": "DESTINATION",
                        "taxCollectedFromParty": "BUYER",
                        "taxLiabilityOwner": "MARKETPLACE",
                        "taxLiabilityRule": "physical-shipment-inside-EU-seller-outside-EU",
                        "taxRateReductionExempt": 0.0,
                        "taxResult": "TAXABLE",
                        "taxStructure": "SINGLE_RATE",
                        "taxType": "VAT",
                        "taxable": 100.0
                    }
                ],
                "totalTax": 23.0,
                "transactionType": "SALE"
            }
        ],
        "returnAssistedParametersIndicator": true,
        "roundAtLineLevel": false,
        "saleMessageType": "QUOTATION",
        "seller": {
            "company": "seller1",
            "physicalOrigin": {
                "country": "DE",
                "taxAreaId": "802760004"
            },
            "taxRegistrations": []
        },
        "subTotal": 100.0,
        "total": 123.0,
        "totalTax": 23.0,
        "transactionType": "SALE"
    },
    "meta": {
        "app": "vertex-ws.war v9.0.20.1.25",
        "extension": "oseries-plus 20250723095736-9b25506a74da7a403dc802e3b48c920b202ace1e",
        "timeElapsed(ms)": 18,
        "timeReceived": "2025-07-23T11:57:12.306Z"
    }
}

delete