VIES checker

European VIES VAT number validator (https://ec.europa.eu/taxation_customs/vies)

Installation

npm install vies-checker

Usage

Require/Import the module

const { isValid } = require('vies-checker');

import { isValid } from 'vies-checker';

Use the isValid function

const COUNTRY_CODE = 'IT';
const VAT_NUMBER = 'B12345678';

// isValid returns a boolean. If something is wrong, it will throw an error
try {
  const validVAT = await isValid(COUNTRY_CODE, VAT_NUMBER);
  console.log(`VAT number ${(validVAT ? 'is' : 'is not')} in VIES`);
} catch (e) {
  console.error(e);
}

Errors

These are the errors that might occur. Use a try/catch to handle them properly.

| Error name | Description | |---|---| | GLOBAL_MAX_CONCURRENT_REQ | Your Request for VAT validation has not been processed; the maximum number of concurrent requests has been reached | | MS_MAX_CONCURRENT_REQ | Your Request for VAT validation has not been processed; the maximum number of concurrent requests for this Member State has been reached | | SERVICE_UNAVAILABLE | An error was encountered either at the network level or the Web application level, try again later | | MS_UNAVAILABLE | The application at the Member State is not replying or not available | | TIMEOUT | The application did not receive a reply within the allocated time period, try again later |

Thanks to @pano9000 for pointing out these errors