{
  "id" : "CONTENT",
  "content" : "<p>The <strong>VIES on the WEB</strong> (<strong>VoW</strong>) interfaces (Web-Interactive and SOAP-API) are regularly upgraded to meet new security requirements and not only. </p><p>Therefore:</p><ol><li data-list=\"bullet\"><span class=\"ql-ui\" contenteditable=\"false\"></span>If you are using VIES on the WEB through the <strong>Web-Interactive</strong> interface, please be informed that the service is accessible via the following web link: </li></ol><p class=\"ql-indent-1\"><strong><a href=\"https://ec.europa.eu/taxation_customs/vies/#/vat-validation\" rel=\"noopener noreferrer\" target=\"_blank\">https://ec.europa.eu/taxation_customs/vies/#/vat-validation</a></strong></p><ol><li data-list=\"bullet\"><span class=\"ql-ui\" contenteditable=\"false\"></span>If you are using VIES on the WEB through the <strong>SOAP API</strong> interface, the service is currently accessible via the following links:</li></ol><p class=\"ql-indent-1\"><strong><a href=\"https://ec.europa.eu/taxation_customs/vies/services/checkVatService.wsdl\" rel=\"noopener noreferrer\" target=\"_blank\">https://ec.europa.eu/taxation_customs/vies/services/checkVatService.wsdl</a> </strong>(encrypted)</p><p class=\"ql-indent-1\"><strong><a href=\"http://ec.europa.eu/taxation_customs/vies/services/checkVatService.wsdl\" rel=\"noopener noreferrer\" target=\"_blank\">http://ec.europa.eu/taxation_customs/vies/services/checkVatService.wsdl</a> </strong>(unencrypted)</p><ol><li data-list=\"bullet\"><span class=\"ql-ui\" contenteditable=\"false\"></span>If you are using VIES on the WEB through the <strong>REST API</strong> interface, please be informed that the service is now accessible via the following web link: </li></ol><p class=\"ql-indent-1\"><strong><a href=\"https://ec.europa.eu/assets/taxud/vow-information/swagger_publicVAT.yaml\" rel=\"noopener noreferrer\" target=\"_blank\">https://ec.europa.eu/assets/taxud/vow-information/swagger_publicVAT.yaml</a></strong></p><ol><li data-list=\"bullet\"><span class=\"ql-ui\" contenteditable=\"false\"></span>If you are using VIES on the WEB through the <strong>BATCH</strong> interface, please be informed that the service is accessible via the following web link: </li></ol><p class=\"ql-indent-1\"><strong><a href=\"https://ec.europa.eu/taxation_customs/vies/#/batch-validation\" rel=\"noopener noreferrer\" target=\"_blank\">https://ec.europa.eu/taxation_customs/vies/#/batch-validation</a></strong></p><p>Further information about the use of these interfaces as well as some documentation concerning the SOAP (API) as well as REST (API) services may be found in the sections below and:</p><ol><li data-list=\"bullet\"><span class=\"ql-ui\" contenteditable=\"false\"></span>Help page: <a href=\"https://ec.europa.eu/taxation_customs/vies/#/help\" rel=\"noopener noreferrer\" target=\"_blank\">https://ec.europa.eu/taxation_customs/vies/#/help</a></li><li data-list=\"bullet\"><span class=\"ql-ui\" contenteditable=\"false\"></span>FAQ page: <a href=\"https://ec.europa.eu/taxation_customs/vies/#/faq\" rel=\"noopener noreferrer\" target=\"_blank\">https://ec.europa.eu/taxation_customs/vies/#/faq</a></li><li data-list=\"bullet\"><span class=\"ql-ui\" contenteditable=\"false\"></span>Specific Disclaimer: <a href=\"https://ec.europa.eu/taxation_customs/vies/#/disclaimer\" rel=\"noopener noreferrer\" target=\"_blank\">https://ec.europa.eu/taxation_customs/vies/#/disclaimer</a></li></ol><p><br></p><p><strong>Twitter Update</strong></p><p>Please be informed that, on top of the usual homepage announcement, we have created a dedicated hashtag on <strong>X</strong> in order for you to check upon scheduled/unscheduled downtimes of the service. You may follow the link <a href=\"https://x.com/EU_Taxud\" rel=\"noopener noreferrer\" target=\"_blank\">https://x.com/EU_Taxud</a> and there, when a downtime occurs, you will find it under the hashtag <a href=\"https://x.com/hashtag/TAXUDVOW?src=hashtag_click\" rel=\"noopener noreferrer\" target=\"_blank\">#TAXUDVOW</a>.</p><p><br></p><p><strong>API protocols</strong></p><p>The Vies-on-the-Web system started offering the <strong>testing</strong> <strong>facility </strong>to the development teams trying to:</p><ol><li data-list=\"bullet\"><span class=\"ql-ui\" contenteditable=\"false\"></span>Perform integration testing of their own applications;</li><li data-list=\"bullet\"><span class=\"ql-ui\" contenteditable=\"false\"></span>Verify the availability of the VIES-on-the-Web application.</li></ol><p>These testing facilities are available for the VAT validation via:</p><p>(1) <strong>Interactive </strong>web interface;</p><p>(2) <strong>SOAP </strong>web services API;</p><p>(3) <strong>REST </strong>web services API.</p><p>(1) For the <strong><u>Interactive</u> </strong>service:</p><ol><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span>Connect to <a href=\"https://ec.europa.eu/taxation_customs/vies/#/vat-validation\" rel=\"noopener noreferrer\" target=\"_blank\">Vies on-the-Web - European Commission (europa.eu)</a>;</li><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span>Select Member State and in field “VAT Number”, please input the following exact text “TESTVATNUMBER”;</li><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span>Push “Verify”;</li><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span>The reply to be received should be: “No, invalid VAT number”.</li></ol><p><strong>→ </strong><em>The aforementioned reply means that the Service is available</em>.</p><p>(2) For the <strong><u>SOAP</u> </strong>service, three WSDLs are available:</p><ol><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span><a href=\"https://ec.europa.eu/taxation_customs/vies/services/checkVatService.wsdl\" rel=\"noopener noreferrer\" target=\"_blank\">https://ec.europa.eu/taxation_customs/vies/services/checkVatService.wsdl</a> to verify the validity of a VAT number;</li><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span><a href=\"https://ec.europa.eu/taxation_customs/vies/checkVatTestService.wsdl\" rel=\"noopener noreferrer\" target=\"_blank\">https://ec.europa.eu/taxation_customs/vies/checkVatTestService.wsdl</a> to verify the integration with the original service by using the below values (common for all Member States / CountryCodes) for each required result:</li><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span> “vatNumber” value=100, response= VALID;</li><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span> &nbsp;“vatNumber” value=200, response = INVALID;&nbsp;</li><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span><a href=\"https://ec.europa.eu/taxation_customs/vies/checkStatusService.wsdl\" rel=\"noopener noreferrer\" target=\"_blank\">https://ec.europa.eu/taxation_customs/vies/checkStatusService.wsdl</a>&nbsp;to retrieve the current status of the application and status of each member state service.&nbsp;</li></ol><p>→<em> Please note that more information (i.e., values, responses) is included in the WSDL files.</em></p><p>→<em> </em><em style=\"color: rgb(64, 64, 64); background-color: rgb(251, 251, 251);\">For more detailed information, please also read the following documentation:</em></p><p class=\"ql-indent-1\"><a href=\"https://taxation-customs.ec.europa.eu/document/13d951e7-822a-40b4-a0df-ea6dc94b7fbb_en\" rel=\"noopener noreferrer\" target=\"_blank\">SDEV-VoW-SSD-v1.50 | Taxation and Customs Union (europa.eu)</a></p><p>(3)&nbsp;&nbsp;For the <strong>REST</strong> web services:</p><p>The VoW application exposes the validation services using the Representational state transfer (REST) architectural style over the JavaScript Object Notation (JSON) format. This will allow any third-party application to verify the validity of a VAT number one by one, retrieve the status of the member state service, and test the integration of the VAT validation service.</p><p>The user should go on the following link: <a href=\"https://editor.swagger.io/\" rel=\"noopener noreferrer\" target=\"_blank\">editor.swagger.io</a>. Then, by selecting the file&nbsp;<a href=\"https://ec.europa.eu/assets/taxud/vow-information/swagger_publicVAT.yaml\" rel=\"noopener noreferrer\" target=\"_blank\">https://ec.europa.eu/assets/taxud/vow-information/swagger_publicVAT.yaml</a>&nbsp;and by clicking on “Open”, the user can view the exposed endpoints on the right part of the screen. For each endpoint, the user can find two sections: one related to the parameters and another one describing the responses. The endpoint URL for the specific service are:</p><ol><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span><u>https://ec.europa.eu/taxation_customs/vies/rest-api//check-vat-number</u></li><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span><u>https://ec.europa.eu/taxation_customs/vies/rest-api//check-vat-test-service</u></li><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span><u>https://ec.europa.eu/taxation_customs/vies/rest-api//check-status</u></li></ol><p>In the <strong>parameters </strong>section, the user can visualize the structure of the parameters required for the endpoint, including an example value and the schema which describes the fields of the request including the type and a description. The <strong>responses</strong> section describes the different responses for each HTTP code, including 200, 400, 403 and 500. For each code, the user can preview an example value and the schema of the response, similarly to parameters.&nbsp;</p><p>→<em> </em><em style=\"background-color: rgb(251, 251, 251); color: rgb(64, 64, 64);\">For more detailed information, please read the following documentation:</em></p><p class=\"ql-indent-1\"><a href=\"https://taxation-customs.ec.europa.eu/document/2e78eb36-537f-46a8-b6b6-393365254869_en\" rel=\"noopener noreferrer\" target=\"_blank\">SDEV-VoW-EIS-v1.21 | Taxation and Customs Union (europa.eu)</a></p><p><br></p><p><strong>Batch Requests</strong></p><p>The batch requests feature allows traders to submit multiple VAT numbers to be validated at once in a single request. The submitted VAT numbers can concern different MSs.</p><p>The batch requests feature is implemented only on the interactive interface of VoW, meaning that the Application Programming Interface (API) interface is not modified. The workflow involved in the processing of batch requests involves the following steps:</p><ol><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span>The user uploads a file containing the set of VAT numbers to be validated. More information on the supported file format is available below.</li><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span>A first set of validations is performed against this file submission.</li><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span>In case the above validations fail, the user stays on the upload page and errors are displayed.</li><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span>If the first set of validation succeeds, the notice page is displayed, and the processing of the request is done asynchronously. A token is generated and allows the user to leave the page and return later to consult the status of the process, provided he kept his token.</li><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span>The page is refreshed regularly to update the status of process until it is completed.</li><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span>At the end of the processing the user can download the file containing the result of each individual validation request.</li></ol><p><em>→&nbsp;More info at:&nbsp;</em><a href=\"https://ec.europa.eu/taxation_customs/vies/#/batch-validation\" rel=\"noopener noreferrer\" target=\"_blank\">Vies on-the-Web - European Commission (europa.eu)</a>.</p><p><br></p><p><strong>VAT number pre-processing</strong></p><p>The objective of this feature is to add a pre-processing mechanism to remove common mistakes on VAT numbers by automatically correcting them and transmitting the corrected VAT number to the VIES applications. The response of the validation clearly indicates when a correction has been performed to the VAT number and that the result reflects the validation of the changed number and not the original one to avoid any misinterpretation by the user.&nbsp;The end-user does not have the possibility to skip the correction automatically applied to validate the VAT number.</p><p>The feature will be integrated in:</p><ol><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span>the interactive interface for single VAT number validation;</li><li data-list=\"ordered\"><span class=\"ql-ui\" contenteditable=\"false\"></span>the batch requests validations.</li></ol><p>Corrections done on the VAT number are displayed later on the Web Page or on the batch requests result. The web page is improved to add new fields about the VAT number correction when VAT number is corrected, otherwise, new fields are not displayed. In the case of batch requests results, columns about correction are always present but empty if there is no correction done. Raw data are updated to add information about VAT number correction. For each Member state, it is possible to configure if the rule is to be applied or not.&nbsp;</p><p><em>For more detailed information, please read the documentation:&nbsp;</em></p><p><em><a href=\"https://ec.europa.eu/assets/taxud/vow-information/SDEV-VoW-UMN-VoW-Public-v1.00.docx\" rel=\"noopener noreferrer\" target=\"_blank\">https://ec.europa.eu/assets/taxud/vow-information/SDEV-VoW-UMN-VoW-Public-v1.00.docx</a></em></p><p><br></p><p>&nbsp;</p>"
}