Customer Registration Number (VAT) validation API

We have introduced an external check on the CIF/NIF/VAT/business ID in Portugal, Spain & Finland against the European Commission’s VAT Information Exchange System (VIES). – see: https://europa.eu/youreurope/business/taxation/vat/check-vat-number-vies/index_en.htm.   The reason is to improve the accuracy and validity of orders for new numbers and ports as explained below:

• The VAT ID/CIF is included in the CVP generated by Colt for an end-customer and is highly confidential.  The CVP was introduced by the PT Regulator, Anacom, to give greater security to end-customers.  End-customers must include their CVP in a future port order to prove their request is genuine.
• As requested by the ES Regulator, CNMC, the VAT ID/CIF/NIF must be uploaded into the emergency database in Spain and be an exact match to the registered end-customer name.
• As requested by the Finnish Regulator, the business ID & legitimate signee’s name must be uploaded into the central database in Finland.

In Numbers on Demand portal you will see the extra validation step on the CIF/NIF/VAT/business ID in Portugal, Spain & Finland when activating a number, porting-in a number and updating an end-customer address, including bulk orders.  In Portugal, Spain & Finland if your end-customer has only recently registered for VAT and their details are not yet in VIES, then you can enter their VAT/business ID by selecting “NIF//CIF/VAT ID not registered” and your order will proceed as normal.

• A REST API is available for VAT validation based on VIES API (check-vat-number) and make available to the customer.

• NIF/VAT is mandatory parameter for PT and FI.
• NIF/CIF/VAT and customer name is mandatory parameter for ES.

Please refer to OAS Specification for VAT, CIF/NIF validation APIs for the OAS Specification for VAT validation APIs

Please note: the Vies API doesn't not support the check of freelancers' DNI IDs as part of the VAT ID checker.  Please select the VAT ID not registered option to bypass the check.

• field “companyNumberRegistered” in order details API

• Vies API  will validate VAT/NIF for PT and FI.
• Vies API will validate VAT/CIF/NIF + customer name for ES.

• field “companyNumberRegistered” as an optional parameter in below APIs with accepted values as ‘true’ and ‘false’:

• /v1/activation/order
• /v1updateCustomer/order
• /v1/portIn/order

Please note: you can also use these external links to check the end-customer has a valid VAT/business ID & signee in Finland to ensure accuracy:

• www.ytj.fi
• www.finder.fi