dannyvankooten/vat

Go package for dealing with EU VAT. Does VAT number validation & rates retrieval.

Package vat

Package for validating VAT numbers & retrieving VAT rates (from ibericode/vat-rates) in Go.

Installation

Use go get.

go get github.com/dannyvankooten/vat

Then import the package into your own code.

import "github.com/dannyvankooten/vat"

Usage

Validating VAT numbers

VAT numbers can be validated by format, existence or both. VAT numbers are looked up using the VIES VAT validation API.

package main

import "github.com/dannyvankooten/vat"

func main() {
  // Validate number by format + existence
  validity, err := vat.ValidateNumber("NL123456789B01")

  // Validate number format
  validity, err := vat.ValidateNumberFormat("NL123456789B01")

  // Validate number existence
  validity, err := vat.ValidateNumberExistence("NL123456789B01")
}

Retrieving VAT rates

This package relies on a community maintained repository of vat rates. We invite you to toggle notifications for that repository and contribute changes to VAT rates in your country once they are announced.

To get VAT rate periods for a country, first get a CountryRates struct using the country's ISO-3166-1-alpha2 code.

You can get the rate that is currently in effect using the GetRate function.

package main

import (
  "fmt"
  "github.com/dannyvankooten/vat"
)

func main() {
  c, err := vat.GetCountryRates("NL")
  r, err := c.GetRate("standard")

  fmt.Printf("Standard VAT rate for NL is %.2f", r)
  // Output: Standard VAT rate for NL is 21.00
}

License

MIT licensed. See the LICENSE file for details.

vat's Issues

Add rates client that uses ibericode/vat-rates repository

A client that fetches rates from ibericode/vat-rates instead of jsonvat.com.

Source of Information

Where are the VAT rates coming from?
I know https://jsonvat.com/ but who is running that site and where does (s)he gets the rates from?

Add MOSS helper func's

For example, a function that returns true when the given country code is inside the EU?

Export VIES API response info

Right now the response struct is unexported but it might be useful for some to have that information publicly available.

let validateNumberFormat return if vatnumer is not EU

Is it possible that validateNumberFormat will return err when it cannot find the landcode in patterns?
So change:

pattern, ok := patterns[n[0:2]]
if !ok {
	return false, nil
}

to

var CountryNotFound = errors.New("countryNotFound")

pattern, ok := patterns[n[0:2]]
if !ok {
	return false, CountryNotFound
}

Add tests for validateExistence method

Not sure if we want the tests to hit the VIES API. We'd have to check how remote requests are mocked in Go....

Add support for getting country specific VAT rates

Something like this, spec needs work tho:

import vat/rates

c := rates.Country("NL")
c.Rate.Standard // 21
c.Rate.Reduced // 6

Also see: https://github.com/adamcooke/json-vat

Add more VAT number tests for validateFormat

The more, the merrier.